Salesforce モジュール

Adobe Workfront Fusion のシナリオでは、Salesforce を使用するワークフローを自動化したり、複数のサードパーティのアプリケーションやサービスに接続したりすることができます。

Salesforce コネクタの紹介ビデオについては、以下を参照してください。

シナリオの作成方法については、 シナリオの作成:記事のインデックスの記事を参照してください。

モジュールについて詳しくは、「 モジュール:記事インデックス」の記事を参照してください。

NOTE
  • すべての Salesforce エディションで API にアクセスできるわけではありません。詳しくは、Salesforce コミュニティサイトで、 API にアクセスできる Salesforce エディションについての情報を参照してください。
  • Salesforce API から返された特定のエラーについては、Salesforce API ドキュメントを参照してください。Salesforce API のステータスをチェックして、サービス停止の可能性がないか確認することもできます。

アクセス要件

展開すると、この記事の機能のアクセス要件が表示されます。

この記事で説明している機能を使用するには、次のアクセス権が必要です。

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Adobe Workfront パッケージ 任意
Adobe Workfront プラン

新規:標準

または

現在:仕事以上

Adobe Workfront Fusion ライセンス**

現在:Workfront Fusion ライセンスは必要ありません。

または

従来のバージョン:作業の自動化と統合のためのWorkfront Fusion

製品

新規:

  • Prime Workfront パッケージを選択する:Adobe Workfront Fusion を購入する必要があります。
  • Ultimate Workfront パッケージ:Workfront Fusion が含まれています。

または

現在:Adobe Workfront Fusion を購入する必要があります。

このテーブルの情報について詳しくは、 ドキュメントのアクセス要件を参照してください。

Adobe Workfront Fusion ライセンスについて詳しくは、Adobe Workfront Fusion ライセンスを参照してください。

前提条件

Salesforce モジュールを使用するには、Salesforce アカウントが必要です。

Salesforce API の情報

Salesforce コネクタでは、以下を使用します。

ベース URL
{{connection.instanceUrl}}
API バージョン
v62.0
API タグ
v1.15.14

Salesforce オブジェクトの検索について

オブジェクトを検索する際には、個々の検索ワードを入力するか、ワイルドカードや演算子を使用してより複雑なクエリを作成できます。

  • アスタリスクのワイルドカード(「」)は、0 文字以上の文字の代わりに使用します。例えば、「Ca」と検索すると「Ca」で始まる項目が表示されます
  • 疑問符のワイルドカード(?)は、1 つの文字の代わりに使用します。例えば「Jo?n」と検索すると、「John」や「Joan」は見つかりますが、「Jon」は表示されません。
  • 完全に一致するフレーズを検索するには、引用符演算子(" ")を使用します。例:"Monday meeting"

検索の可能性について詳しくは、SOQL および SOSL に関する Salesforce 開発者向けドキュメントを参照してください。

Salesforce への接続の作成

Salesforce モジュールへの接続を作成するには、以下を実行します。

  1. 任意の Salesforce モジュールで、「接続」ボックスの横にある「Add」をクリックします。

  2. 次のフィールドに入力します。

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 layout-auto html-authored no-header
    Connection name 新しい接続の名前を入力します。
    Environment 本番環境と非本番環境のどちらに接続するかを選択します。
    Type サービスアカウントと個人アカウントのどちらに接続するかを選択します。
    Client ID Salesforce クライアント ID を入力します。
    Client Secret Salesforce クライアントの秘密鍵を入力します。
    Sandbox これがサンドボックス環境の場合は、このオプションを有効にします。
    API Version 使用するSalesforce API のバージョンを入力します。 デフォルトバージョンは 62.0 です。
  3. Continue」をクリックして接続を保存し、モジュールに戻ります。

Salesforce モジュールとそのフィールド

トリガー

Watch a field

このトリガーモジュールは、Salesforce でフィールドがアップデートされたときにシナリオを開始します。

Connection
Salesforce アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 – 基本手順を参照してください。
Record Type
モジュールで監視するフィールドが含まれているレコードのタイプを選択します。Salesforce の設定でオンになっているレコードタイプを選択する必要 Field History あります。 詳しくは、Salesforce ドキュメントでフィールド履歴のトラッキングを参照してください。
Field
モジュールで変更を監視するフィールドを選択します。
Limit
各シナリオの実行サイクル中に、モジュールが返すフィールドの最大数を入力またはマッピングします。

Watch for Records

このトリガーモジュールは、オブジェクト内のレコードが作成または更新されたときにシナリオを実行します。このモジュールは、レコードに関連付けられたすべての標準フィールドと、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Salesforce アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 – 基本手順を参照してください。
Type
モジュールで監視する Salesforce レコードのタイプを選択します。
Record Fields
モジュールで監視するフィールドを選択します。使用可能なフィールドは、レコードのタイプによって異なります。
Maximal count of records
各シナリオの実行サイクル中に、モジュールが返すレコードの最大数を入力またはマッピングします。
Watch
選択したタイプの新しいレコードのみをシナリオで監視するか、選択したタイプの新しいレコードと、そのタイプのレコードに対するその他すべての変更をシナリオで監視するかを決定します。

Watch Outbound Messages

このトリガーモジュールは、誰かがメッセージを送信したときにシナリオを実行します。このモジュールは、レコードに関連付けられたすべての標準フィールドと、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

このモジュールには、追加の設定が必要です。

  1. Salesforce 設定ページに移動します。

    設定ページにアクセスするには、Salesforce アカウントの右上隅にある「Setup」というラベルの付いたボタンを見つけてクリックします。 Salesforce 設定ページで、左側にある「Quick Find / Search」バーを見つけます。 「Workflow Rules」を検索します。

  2. Workflow Rules をクリックします。

  3. 表示された Workflow Rules ページで「New Rule」をクリックし、ルールを適用するオブジェクトタイプ(商談レコードの更新を監視する場合は「Opportunity」など)を選択します。

  4. Next をクリックします。

  5. ルール名、評価条件およびルール条件を設定し、「Save」、「Next」の順にクリックします。

  6. Done をクリックします。

  7. 新しく作成したワークフロールールから、「Edit…」をクリックします。

  8. Add Workflow Action」ドロップダウン・リストから「New Outbound Message」を選択します。

  9. 新しい送信メッセージに含める名前、説明、エンドポイント URL、フィールドを指定し、「Save」をクリックします。

    Endpoint URL フィールドには、Workfront Fusion の Salesforce Outbound Message で提供される URL が含まれます。

  10. Outbound Message イベントで始まるシナリオを設定します。

  11. 右下にある </> アイコンをクリックし、提供された URL をコピーします。

  12. Workflow Rules ページに戻り、新しく作成したルールを見つけ、「Activate」をクリックします。

このモジュールを設定する際には、次のフィールドが表示されます。

Webhook

送信メッセージの監視に使用する web フックを選択します。Webhook を追加するには、「Add」をクリックして Webhook の名前と接続を入力します。

Salesforce アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。

Record Type
モジュールでアウトバウンドメッセージを監視する Salesforce レコードのタイプを選択します。
Fields
モジュールでアウトバウンドメッセージを監視するフィールドを選択します。使用可能なフィールドは、レコードのタイプによって異なります。

アクション

Create a Record

このアクションモジュールは、オブジェクトに新しいレコードを作成します。

モジュールを使用すると、モジュールで使用可能なオブジェクトのフィールドを選択できます。これにより、モジュールを設定する際にスクロールしなければならないフィールドの数が減ります。

このモジュールは、レコードの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Salesforce アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 – 基本手順を参照してください。
Record Type
モジュールで作成する Salesforce レコードのタイプを選択します。フィールドは、「Record Type」フィールドで選択されたレコードのタイプに基づいて使用可能になります。 これらのフィールドは Salesforce API に基づいています。
Select fields to map

新しいレコードを作成する際にモジュールで設定するフィールドを選択します。必須フィールドはリストの上部にあります。

選択したフィールドがこのフィールドの下に開きます。これらのフィールドに値を入力できるようになります。

Custom API Call

このアクションモジュールでは、Salesforce API への認証済みのカスタム呼び出しを実行できます。これにより、他の Salesforce モジュールでは不可能なデータフロー自動処理を実現できます。

このモジュールは、次の値を返します。

  • Status Code (数字):HTTP リクエストの成功または失敗を示します。 これらはインターネット上で検索できる標準コードです。

  • Headers (オブジェクト):出力本文に関連しない、応答/ステータスコードのより詳細なコンテキスト。 応答ヘッダーに表示されるすべてのヘッダーが応答ヘッダーではないので、不要なヘッダーも含まれている可能性があります。

    応答ヘッダーは、モジュールの設定時に選択した HTTP リクエストによって異なります。

  • Body (オブジェクト):モジュールの設定時に選択した HTTP リクエストによっては、一部のデータが返される場合があります。 そのデータ(GET リクエストからのデータなど)は、このオブジェクトに含まれます。

このモジュールを設定する際には、次のフィールドが表示されます。

API 呼び出しの設定に必要な HTTP リクエストメソッドを選択します。詳しくは、HTTP リクエストメソッドを参照してください。

Connection
Salesforce アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 – 基本手順を参照してください。
URL

<Instance URL>/services/data/v46.0/ への相対パスを入力します。

使用可能なエンドポイントの一覧について詳しくは、Salesforce REST API 開発者ガイドを参照してください。

Method
Headers
リクエストのヘッダーを標準 JSON オブジェクトの形式で追加します。例えば、{"Content-type":"application/json"}。Workfront Fusion は認証ヘッダーを追加します。
Query String
標準の JSON オブジェクトの形式で API 呼び出しのクエリを追加します。 例: {"name":"something-urgent"}
Body

標準の JSON オブジェクトの形式で、API 呼び出しの本文の内容を追加します。

メモ:

if などの条件文を JSON で使用する場合は、条件文を引用符で囲みます。

Delete a Record

このアクションモジュールは、オブジェクト内の既存のレコードを削除します。

レコードの ID を指定します。

このモジュールは、レコードの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Salesforce アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 – 基本手順を参照してください。
Record Type
モジュールで削除する Salesforce レコードのタイプを選択します。
ID

モジュールが削除するレコードの一意の Salesforce ID を入力またはマッピングします。

ID を取得するには、ブラウザーで Salesforce オブジェクトを開いて、URL の末尾のフォワードスラッシュ(/)の後のテキストをコピーします。例: https://eu5.salesforce.com/<object ID>

Download Attachment/Document

このアクションモジュールは、レコードからドキュメントまたは添付ファイルをダウンロードします。

レコードの ID および必要なダウンロードのタイプを指定します。

このモジュールは、添付ファイルまたはドキュメントの ID、および関連するフィールドを返すほか、接続がアクセスするカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Salesforce アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 – 基本手順を参照してください。
Type of Download

Salesforce からダウンロードするファイルのタイプを指定します。

  • Attachment
  • Document
  • ContentDocument (これは、Saleforce CRM Content または Salesforce Files のライブラリにアップロードされたドキュメントです。)

ID /

Attachment ID /

ContentDocument ID

モジュールがダウンロードするレコードの一意の Salesforce ID を入力またはマッピングします。

ID を取得するには、ブラウザーで Salesforce オブジェクトを開き、URL の末尾のフォワードスラッシュ(/)の後のテキストをコピーします。例: https://eu5.salesforce.com/<object ID>

Read a Record

このアクションモジュールは、Salesforce の単一オブジェクトからデータを読み取ります。

レコードの ID を指定します。

このモジュールは、レコードの ID および関連するフィールドと共に、接続を介してアクセスされるカスタムフィールドとその値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Salesforce アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 – 基本手順を参照してください。
Record Type
モジュールで [action] 読み取る Salesforce レコードのタイプを選択します。
Record Fields
モジュールで読み取るフィールドを選択します。少なくとも 1 つのフィールドを選択する必要があります。
ID

モジュールが読み取るレコードの一意の Salesforce ID を入力またはマッピングします。

ID を取得するには、ブラウザーで Salesforce オブジェクトを開いて、URL の末尾のフォワードスラッシュ(/)の後のテキストをコピーします。例: https://eu5.salesforce.com/<object ID>

INFO
例: ​次の API 呼び出しは、Salesforce アカウントのすべてのユーザーのリストを返します。
  • URLquery

  • メソッド:GET

  • クエリ文字列

  • キーq

  • SELECT Id, Name, CreatedDate, LastModifiedDate FROM User LIMIT 10

検索の一致は、モジュールの出力の Bundle> Body >records で見つけることができます。
この例では、6 人のユーザーが返されました。
検索に一致

Update a Record

このアクションモジュールは、オブジェクト内のレコードを編集します。

モジュールを使用すると、モジュールで使用可能なオブジェクトのフィールドを選択できます。これにより、モジュールを設定する際にスクロールしなければならないフィールドの数が減ります。

このモジュールは、レコードの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Salesforce アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 – 基本手順を参照してください。
ID
更新するレコードの ID を入力またはマッピングします。
Record Type
モジュールが更新する Salesforce レコードのタイプを選択します。フィールドは、「レコードタイプ」フィールドで選択されたレコードタイプに基づいて使用可能になります。これらのフィールドは Salesforce API に基づいています。
Select fields to map

新しいレコードを作成する際にモジュールで設定するフィールドを選択します。必須フィールドはリストの上部にあります。

選択したフィールドがこのフィールドの下に開きます。これらのフィールドに値を入力できるようになります。

Upload Attachment/Document

このアクションモジュールは、ファイルをアップロードして指定したレコードに添付するか、ドキュメントをアップロードします。

このモジュールは、添付ファイルまたはドキュメントの ID、および関連するフィールドを返すほか、接続がアクセスするカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Salesforce アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 – 基本手順を参照してください。
Type of Upload
モジュールが添付ファイルまたはドキュメントのどちらをアップロードするかを選択します。
ID
添付ファイルのアップロード先のオブジェクトの ID を入力またはマッピングします。
Folder
モジュールがアップロードするファイルを含むフォルダーを選択します。
Source File
以前のモジュールで使用したソースファイルを選択するか、ソースファイルの名前とデータをマッピングします。

ファイルをアップロード

このアクションモジュールは、1 つのファイルをSalesforceにアップロードします。

検索

Search with Query

この検索モジュールは、指定された検索クエリに一致するレコードを Salesforce 内のオブジェクトで検索します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Salesforce アカウントを Workfront Fusion に接続する手順については、​ Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
Source file
以前のモジュールで使用したソースファイルを選択するか、ソースファイルの名前とデータをマッピングします。
Document linking
コンテンツドキュメントリンクを適用するかどうかを選択します。
linkedEntityId
ドキュメントのリンクを使用する場合は、リンクされたオブジェクトの ID を入力またはマップします。
ShareType

ドキュメントリンクを使用する場合は、ファイルの権限を選択します。

  • 閲覧者権限

    ユーザーはファイルを表示できます。

  • 共同作業者の権限

    ユーザーはこのファイルを表示および編集できます。

  • 推測される権限

    権限は、ライブラリなど、関連するレコードに対するユーザーの権限に基づいています。

Visibility

ドキュメントのリンクを使用する場合は、ドキュメントの表示を入力またはマッピングします。

  • AllUsers

    権限を持つすべてのユーザーが利用できます

  • InternalUsers

    権限を持つ内部ユーザーが使用できます。

  • SharedUsers

    ファイルの投稿先のフィードを表示できるユーザーが使用できます。

Connection
Salesforce アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 – 基本手順を参照してください。
Search Type

モジュールで実行する検索のタイプを選択します。

  • Simple

  • Using SOSL (Salesforce Object Search Language)

  • Using SOQL (Salesforce Object Query Language)

Type
「シンプル」検索タイプを選択した場合は、モジュールで検索する Salesforce レコードのタイプを選択します。
Query / SOSL Query / SOQL Query

検索に使用するクエリを入力します。

SOSL について詳しくは、Salesforce ドキュメントの Salesforce Object Search Language(SOSL)を参照してください。

SOQL について詳しくは、Salesforce ドキュメントの Salesforce Object Query Language(SOQL)を参照してください。

メモ:モジュールの出力は、パラメーター RETURNING の値に左右されます。LIMIT を使用すると、Fusion は Maximal count of records フィールドの設定を無視します。 制限を設定しない場合、Fusion は値 LIMIT = Maximal count of records を挿入します。

Maximal count of records
各シナリオの実行サイクル中に、モジュールが返すレコードの最大数を入力またはマッピングします。

このアクションモジュールは、指定された条件を満たすすべてのレコードを取得します。

Connection
Salesforce アカウントを Workfront Fusion に接続する手順については、​ Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
Type
検索するオブジェクトのタイプを選択します。
Search criteria
検索条件となるフィールド、クエリで使用する演算子およびそのフィールドで検索する値を選択します。AND または OR を使用してクエリを結合できます。
Outputs
モジュールの出力に含めるフィールドを選択します。
Result set
モジュールで条件に一致するすべてのレコードを返すか、条件に一致する最初のレコードのみを返すかを選択します。
Maximal
シナリオの実行サイクルごとにモジュールが取得するレコードの最大数を入力またはマッピングします。
recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3