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 モジュールで、「接続」ボックスの横にある「Add」をクリックします。
-
次のフィールドに入力します。
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 です。 -
「Continue」をクリックして接続を保存し、モジュールに戻ります。
Salesforce モジュールとそのフィールド
トリガー
Watch a field
このトリガーモジュールは、Salesforce でフィールドがアップデートされたときにシナリオを開始します。
Watch for Records
このトリガーモジュールは、オブジェクト内のレコードが作成または更新されたときにシナリオを実行します。このモジュールは、レコードに関連付けられたすべての標準フィールドと、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
Watch Outbound Messages
このトリガーモジュールは、誰かがメッセージを送信したときにシナリオを実行します。このモジュールは、レコードに関連付けられたすべての標準フィールドと、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールには、追加の設定が必要です。
-
Salesforce 設定ページに移動します。
設定ページにアクセスするには、Salesforce アカウントの右上隅にある「Setup」というラベルの付いたボタンを見つけてクリックします。 Salesforce 設定ページで、左側にある「Quick Find / Search」バーを見つけます。 「Workflow Rules」を検索します。
-
Workflow Rules をクリックします。
-
表示された Workflow Rules ページで「New Rule」をクリックし、ルールを適用するオブジェクトタイプ（商談レコードの更新を監視する場合は「Opportunity」など）を選択します。
-
Next をクリックします。
-
ルール名、評価条件およびルール条件を設定し、「Save」、「Next」の順にクリックします。
-
Done をクリックします。
-
新しく作成したワークフロールールから、「Edit…」をクリックします。
-
「Add Workflow Action」ドロップダウン・リストから「New Outbound Message」を選択します。
-
新しい送信メッセージに含める名前、説明、エンドポイント URL、フィールドを指定し、「Save」をクリックします。
Endpoint URL フィールドには、Workfront Fusion の Salesforce Outbound Message で提供される URL が含まれます。
-
Outbound Message イベントで始まるシナリオを設定します。
-
右下にある </> アイコンをクリックし、提供された URL をコピーします。
-
Workflow Rules ページに戻り、新しく作成したルールを見つけ、「Activate」をクリックします。
このモジュールを設定する際には、次のフィールドが表示されます。
アクション
Create a Record
このアクションモジュールは、オブジェクトに新しいレコードを作成します。
モジュールを使用すると、モジュールで使用可能なオブジェクトのフィールドを選択できます。これにより、モジュールを設定する際にスクロールしなければならないフィールドの数が減ります。
このモジュールは、レコードの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
Custom API Call
このアクションモジュールでは、Salesforce API への認証済みのカスタム呼び出しを実行できます。これにより、他の Salesforce モジュールでは不可能なデータフロー自動処理を実現できます。
このモジュールは、次の値を返します。
-
Status Code （数字）:HTTP リクエストの成功または失敗を示します。 これらはインターネット上で検索できる標準コードです。
-
Headers （オブジェクト）：出力本文に関連しない、応答/ステータスコードのより詳細なコンテキスト。 応答ヘッダーに表示されるすべてのヘッダーが応答ヘッダーではないので、不要なヘッダーも含まれている可能性があります。
応答ヘッダーは、モジュールの設定時に選択した HTTP リクエストによって異なります。
-
Body （オブジェクト）：モジュールの設定時に選択した HTTP リクエストによっては、一部のデータが返される場合があります。 そのデータ（GET リクエストからのデータなど）は、このオブジェクトに含まれます。
このモジュールを設定する際には、次のフィールドが表示されます。
API 呼び出しの設定に必要な HTTP リクエストメソッドを選択します。詳しくは、HTTP リクエストメソッドを参照してください。
<Instance URL>/services/data/v46.0/ への相対パスを入力します。
使用可能なエンドポイントの一覧について詳しくは、Salesforce REST API 開発者ガイドを参照してください。
{"Content-type":"application/json"}。Workfront Fusion は認証ヘッダーを追加します。{"name":"something-urgent"}標準の JSON オブジェクトの形式で、API 呼び出しの本文の内容を追加します。
メモ：
if などの条件文を JSON で使用する場合は、条件文を引用符で囲みます。
Delete a Record
このアクションモジュールは、オブジェクト内の既存のレコードを削除します。
レコードの ID を指定します。
このモジュールは、レコードの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
Download Attachment/Document
このアクションモジュールは、レコードからドキュメントまたは添付ファイルをダウンロードします。
レコードの ID および必要なダウンロードのタイプを指定します。
このモジュールは、添付ファイルまたはドキュメントの ID、および関連するフィールドを返すほか、接続がアクセスするカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
Read a Record
このアクションモジュールは、Salesforce の単一オブジェクトからデータを読み取ります。
レコードの ID を指定します。
このモジュールは、レコードの ID および関連するフィールドと共に、接続を介してアクセスされるカスタムフィールドとその値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
-
URL：
query -
メソッド：GET
-
クエリ文字列：
-
キー：
q -
値：
SELECT Id, Name, CreatedDate, LastModifiedDate FROM User LIMIT 10
Update a Record
このアクションモジュールは、オブジェクト内のレコードを編集します。
モジュールを使用すると、モジュールで使用可能なオブジェクトのフィールドを選択できます。これにより、モジュールを設定する際にスクロールしなければならないフィールドの数が減ります。
このモジュールは、レコードの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
Upload Attachment/Document
このアクションモジュールは、ファイルをアップロードして指定したレコードに添付するか、ドキュメントをアップロードします。
このモジュールは、添付ファイルまたはドキュメントの ID、および関連するフィールドを返すほか、接続がアクセスするカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
ファイルをアップロード
このアクションモジュールは、1 つのファイルをSalesforceにアップロードします。
検索
Search with Query
この検索モジュールは、指定された検索クエリに一致するレコードを Salesforce 内のオブジェクトで検索します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
Search
このアクションモジュールは、指定された条件を満たすすべてのレコードを取得します。