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