Salesforce モジュール
Adobe Workfront Fusion のシナリオでは、Salesforce を使用するワークフローを自動化したり、複数のサードパーティのアプリケーションやサービスに接続したりすることができます。
Salesforce コネクタの紹介ビデオについては、以下を参照してください。
シナリオの作成方法については、 シナリオの作成：記事のインデックスの記事を参照してください。
モジュールについて詳しくは、「 モジュール：記事インデックス」の記事を参照してください。
- すべての 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 |
| 製品 |
新規：
または 現在：Adobe Workfront Fusion を購入する必要があります。 |
このテーブルの情報について詳しくは、 ドキュメントのアクセス要件を参照してください。
Adobe Workfront Fusion ライセンスについて詳しくは、Adobe Workfront Fusion ライセンスを参照してください。
前提条件
Salesforce モジュールを使用するには、Salesforce アカウントが必要です。
Salesforce API の情報
Salesforce コネクタでは、以下を使用します。
Salesforce オブジェクトの検索について
オブジェクトを検索する際には、個々の検索ワードを入力するか、ワイルドカードや演算子を使用してより複雑なクエリを作成できます。
- アスタリスクのワイルドカード（「」）は、0 文字以上の文字の代わりに使用します。例えば、「Ca」と検索すると「Ca」で始まる項目が表示されます
- 疑問符のワイルドカード（?）は、1 つの文字の代わりに使用します。例えば「Jo?n」と検索すると、「John」や「Joan」は見つかりますが、「Jon」は表示されません。
- 完全に一致するフレーズを検索するには、引用符演算子（" "）を使用します。例："Monday meeting"
検索の可能性について詳しくは、SOQL および SOSL に関する Salesforce 開発者向けドキュメントを参照してください。
Salesforce への接続の作成
Salesforce モジュールへの接続を作成するには、以下を実行します。
-
任意の Salesforce モジュールで、「接続」ボックスの横にある「追加」をクリックします。
-
次のフィールドに入力します。
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 クライアントの秘密鍵を入力します。 サンドボックス これがサンドボックス環境の場合は、このオプションを有効にします。 API Version 使用するSalesforce API のバージョンを入力します。 デフォルトバージョンは 62.0 です。 -
「続行」をクリックして接続を保存し、モジュールに戻ります。
Salesforce モジュールとそのフィールド
トリガー
フィールドを監視
このトリガーモジュールは、Salesforce でフィールドがアップデートされたときにシナリオを開始します。
レコードの監視
このトリガーモジュールは、オブジェクト内のレコードが作成または更新されたときにシナリオを実行します。このモジュールは、レコードに関連付けられたすべての標準フィールドと、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
アウトバウンドメッセージを監視
このトリガーモジュールは、誰かがメッセージを送信したときにシナリオを実行します。このモジュールは、レコードに関連付けられたすべての標準フィールドと、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールには、追加の設定が必要です。 アウトバウンドメッセージ用に設定されたフローが必要です。
- Salesforceのフローについては、Salesforce ドキュメントの フローを使用したタスクの自動化を参照してください。
- Salesforceでのアウトバウンドメッセージの設定について詳しくは、Salesforce ドキュメントの レコードトリガーフローからのアウトバウンドメッセージの送信を参照してください
このモジュールを設定する際には、次のフィールドが表示されます。
アクション
レコードの作成
このアクションモジュールは、オブジェクトに新しいレコードを作成します。
モジュールを使用すると、モジュールで使用可能なオブジェクトのフィールドを選択できます。これにより、モジュールを設定する際にスクロールしなければならないフィールドの数が減ります。
このモジュールは、レコードの ID および関連するフィールドと共に、接続を介してアクセスされるカスタムフィールドとその値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
カスタム API 呼び出し
このアクションモジュールは、Salesforce API に対して認証済みのカスタム呼び出しを実行します。これにより、他の Salesforce モジュールでは不可能なデータフロー自動処理を実現できます。
このモジュールは、次の値を返します。
-
ステータスコード（数値）：HTTP リクエストの成功または失敗を示します。これらはインターネット上で検索できる標準コードです。
-
ヘッダー（オブジェクト）：出力本文に関連しない応答／ステータスコードのより詳細なコンテキスト。応答ヘッダーに表示されるすべてのヘッダーが応答ヘッダーではないので、不要なヘッダーも含まれている可能性があります。
応答ヘッダーは、モジュールの設定時に選択した HTTP リクエストによって異なります。
-
本文（オブジェクト）：モジュールの設定時に選択した HTTP リクエストに応じて、一部のデータを受け取る場合があります。このデータ（GET リクエストからのデータなど）は、このオブジェクトに含まれます。
このモジュールを設定する際には、次のフィールドが表示されます。
<Instance URL>/services/data/v62.0/ への相対パスを入力します。
使用可能なエンドポイントの一覧について詳しくは、Salesforce REST API 開発者ガイドを参照してください。
{"Content-type":"application/json"}。Workfront Fusion は認証ヘッダーを追加します。{"name":"something-urgent"}標準の JSON オブジェクトの形式で、API 呼び出しの本文の内容を追加します。
メモ：
if などの条件ステートメントを JSON で使用する場合は、条件ステートメントの外側に引用符を挿入します。
例： 次の API 呼び出しは、Salesforce アカウントのすべてのユーザーのリストを返します。
-
URL：
query -
メソッド：GET
-
クエリ文字列：
-
キー：
q -
値：
SELECT Id, Name, CreatedDate, LastModifiedDate FROM User LIMIT 10
一致した検索結果は、バンドル／本文／レコード 下のモジュールの出力に表示されます。
この例では、6 人のユーザーが返されました。
レコードを削除
このアクションモジュールは、オブジェクト内の既存のレコードを削除します。
レコードの ID を指定します。
このモジュールは、レコードの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
添付ファイル／ドキュメントをダウンロード
このアクションモジュールは、レコードからドキュメントまたは添付ファイルをダウンロードします。
レコードの ID および必要なダウンロードのタイプを指定します。
このモジュールは、添付ファイルまたはドキュメントの ID、および関連するフィールドを返すほか、接続がアクセスするカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
レコードの読み取り
このアクションモジュールは、Salesforce の単一オブジェクトからデータを読み取ります。
レコードの ID を指定します。
このモジュールは、レコードの ID および関連するフィールドと共に、接続を介してアクセスされるカスタムフィールドとその値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
レコードを更新
このアクションモジュールは、オブジェクト内のレコードを編集します。
モジュールを使用すると、モジュールで使用可能なオブジェクトのフィールドを選択できます。これにより、モジュールを設定する際にスクロールしなければならないフィールドの数が減ります。
このモジュールは、レコードの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
添付ファイル／ドキュメントをアップロード
このアクションモジュールは、ファイルをアップロードして指定したレコードに添付するか、ドキュメントをアップロードします。
このモジュールは、添付ファイルまたはドキュメントの ID、および関連するフィールドを返すほか、接続がアクセスするカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
ファイルをアップロード
このアクションモジュールは、1 つのファイルをSalesforceにアップロードします。
検索
検索
このアクションモジュールは、指定された条件を満たすすべてのレコードを取得します。
クエリによる検索
この検索モジュールは、指定された検索クエリに一致するレコードを Salesforce 内のオブジェクトで検索します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。