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 Workflow パッケージと任意の Adobe Workfront Automation および Integration パッケージ Workfront Ultimate Workfront Fusion を追加購入した Workfront Prime および Select パッケージ。 |
| Adobe Workfront ライセンス |
標準 Work またはそれ以上 |
| Adobe Workfront Fusion ライセンス |
オペレーションベース：Workfront Fusion ライセンス要件なし コネクターベース（レガシー）：Workfront Fusion for Work Automation および Integration |
| 製品 | 組織が Workfront Automation および Integration を含まない Select またはPrime Workfront パッケージを持っている場合は、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 Client シークレットを入力します。 Sandbox サンドボックス環境の場合は、このオプションを有効にします。 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 内のオブジェクトのレコードを検索します。 この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。