Salesforce の商談から BigQuery への注文を自動化する

---

このチュートリアルでは、Application Integration を使用して顧客管理（CRM）アプリケーションとエンタープライズ リソース プランニング（ERP）アプリケーションとの間の注文管理フローを自動化する方法のユースケースについて説明します。

概要

企業では、さまざまな CRM や ERP アプリケーションを使用して、販売注文の作成、処理、管理、維持を行っています。これらのアプリケーションはそれぞれ異なるチームや組織によって処理されるため、タイムリーな顧客アップデートを提供しながら注文を常に追跡することは困難です。

このチュートリアルでは、Salesforce トリガーを使用して Salesforce の新しい商談イベントに登録する統合を作成します。新しい商談が作成されると、統合によりアカウント ID や名前などの追加の商談の詳細が取得されます。これらの詳細は BigQuery のテーブルでチェックされ、追跡注文番号を使用して商談の作成と更新が行われます。検証中、アカウント情報が BigQuery に存在しなければ、統合は Integration Connectors を使用して BigQuery テーブルと接続された ServiceNow インスタンスの両方に新しいエントリを自動的に作成します。

目標

このチュートリアルでは、統合で以下のタスクを行う方法について説明します。

• 統合を呼び出すように Salesforce トリガーを設定する。
• Salesforce、BigQuery、ServiceNow 接続用のコネクタタスクを追加して構成する。
• 商談の詳細を抽出してマッピングするためのデータ マッピング タスクを追加して構成する。

費用

このチュートリアルでは、Google Cloud の次の課金対象のコンポーネントを使用します。

• アプリケーションの統合
• インテグレーション コネクタ
• BigQuery
• Secret Manager

このチュートリアルの手順は、リソース使用量が Google Cloud の Always Free 階層の制限内に収まるように設計されています。

このドキュメントに記載されているタスクの完了後、作成したリソースを削除すると、それ以上の請求は発生しません。詳細については、クリーンアップをご覧ください。

準備

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. Google Cloud Console の [プロジェクト セレクタ] ページで、Google Cloud プロジェクトを選択または作成します。

   注: この手順で作成するリソースをそのまま保持する予定でない場合、既存のプロジェクトを選択するのではなく、新しいプロジェクトを作成してください。チュートリアルの終了後にそのプロジェクトを削除すれば、プロジェクトに関連するすべてのリソースを削除できます。

   プロジェクト セレクタに移動

3. Google Cloud プロジェクトで課金が有効になっていることを確認します。

4. BigQuery API を有効にします。

   API を有効にする

5. サービス アカウントを作成します。

   1. Google Cloud コンソールで [サービス アカウントの作成] ページに移動します。

      [サービス アカウントの作成] に移動
   2. プロジェクトを選択します。

   3. [サービス アカウント名] フィールドに名前を入力します。Google Cloud コンソールでは、この名前に基づいて [サービス アカウント ID] フィールドに値が設定されます。

      [サービス アカウントの説明] フィールドに説明を入力します。例: Service account for quickstart

   4. [作成して続行] をクリックします。

   5. サービス アカウントに次のロールを付与します: BigQuery Data Editor (roles/bigquery.dataEditor), BigQuery Read Session User (roles/bigquery.readSessionUser), Secret Manager Viewer (roles/secretmanager.viewer), Secret Manager Secret Accessor (roles/secretmanager).

      ロールを付与するには、[ロールを選択] リストを見つけてロールを選択します。

      追加のロールを付与するには、 [別のロールを追加] をクリックして各ロールを追加します。

      注: [ロール] フィールドは、サービス アカウントがプロジェクト内のどのリソースにアクセスできるかに影響します。これらのロールは後で取り消すことも、追加のロールを付与することもできます。本番環境では、オーナー、編集者、閲覧者のロールを付与しないでください。代わりに、ニーズに合わせて事前定義ロールまたはカスタムロールを付与します。
   6. [続行] をクリックします。

   7. [完了] をクリックして、サービス アカウントの作成を完了します。

6. Google Cloud Console の [プロジェクト セレクタ] ページで、Google Cloud プロジェクトを選択または作成します。

   注: この手順で作成するリソースをそのまま保持する予定でない場合、既存のプロジェクトを選択するのではなく、新しいプロジェクトを作成してください。チュートリアルの終了後にそのプロジェクトを削除すれば、プロジェクトに関連するすべてのリソースを削除できます。

   プロジェクト セレクタに移動

7. Google Cloud プロジェクトで課金が有効になっていることを確認します。

8. BigQuery API を有効にします。

   API を有効にする

9. サービス アカウントを作成します。

   1. Google Cloud コンソールで [サービス アカウントの作成] ページに移動します。

      [サービス アカウントの作成] に移動
   2. プロジェクトを選択します。

   3. [サービス アカウント名] フィールドに名前を入力します。Google Cloud コンソールでは、この名前に基づいて [サービス アカウント ID] フィールドに値が設定されます。

      [サービス アカウントの説明] フィールドに説明を入力します。例: Service account for quickstart

   4. [作成して続行] をクリックします。

   5. サービス アカウントに次のロールを付与します: BigQuery Data Editor (roles/bigquery.dataEditor), BigQuery Read Session User (roles/bigquery.readSessionUser), Secret Manager Viewer (roles/secretmanager.viewer), Secret Manager Secret Accessor (roles/secretmanager).

      ロールを付与するには、[ロールを選択] リストを見つけてロールを選択します。

      追加のロールを付与するには、 [別のロールを追加] をクリックして各ロールを追加します。

      注: [ロール] フィールドは、サービス アカウントがプロジェクト内のどのリソースにアクセスできるかに影響します。これらのロールは後で取り消すことも、追加のロールを付与することもできます。本番環境では、オーナー、編集者、閲覧者のロールを付与しないでください。代わりに、ニーズに合わせて事前定義ロールまたはカスタムロールを付与します。
   6. [続行] をクリックします。

   7. [完了] をクリックして、サービス アカウントの作成を完了します。

注: Application Integration API、Secret Manager API、Connectors API などの必要な Google Cloud API はすべて、Application Integration の設定中に有効になります。詳細については、Application Integration を設定するをご覧ください。

環境を準備する

Salesforce ユーザーの設定を確認する

このチュートリアルでは、必要なユーザー設定と一連の権限を持つ既存の Salesforce デベロッパー アカウントがあることを前提としています。アカウントで変更データ キャプチャ（CDC）が有効になっていることを確認します。新しいアカウントの作成については、統合ユーザーを設定するをご覧ください。

BigQuery データセットとテーブルを設定する

このチュートリアルでは、BigQuery データセットを設定して、Salesforce の商談の詳細と ServiceNow のアカウント情報を格納する 2 つのテーブルを作成する必要があります。

BigQuery データセットを設定する

BigQuery データセットを設定するには、次の操作を行います。

1. Google Cloud コンソールの [BigQuery] ページに移動します。

   BigQuery に移動

2. [エクスプローラ] パネルをクリックして、このチュートリアルで使用しているプロジェクトを選択します。
3. （アクション）を展開して [データセットを作成] を選択します。
4. [データセットを作成] ページで次の詳細を構成します。
   1. データセット ID: 「Demo_order_dataset」と入力します。
   2. ロケーション タイプ > リージョン: us-central1 (lowa) リージョンを選択します。
5. [データセットを作成] をクリックします。

新しい Demo_order_dataset データセットがプロジェクトの [エクスプローラ] パネルに表示されます。

BigQuery テーブルを設定する

BigQuery テーブルを作成するには、次の操作を行います。

1. [エクスプローラ] パネルで、作成した Demo_order_dataset データセットをクリックして開きます。
2. 次の手順で、Salesforce の商談の詳細を格納する空の注文テーブルを作成します。
   1. [ テーブルを作成] をクリックします。
   2. [送信先] セクションで、テーブル名として「Orders」と入力します。
   3. [スキーマ] セクションで [テキストとして編集] をクリックし、次の JSON スキーマ定義を貼り付けます。

      [
        {
          "name": "order_number",
          "type": "STRING",
          "mode": "NULLABLE",
          "description": "Salesforce order number"
        },
        {
          "name": "order_status",
          "type": "STRING",
          "mode": "NULLABLE",
          "description": "Sale order status"
        },
        {
          "name": "tracking_number",
          "type": "INTEGER",
          "mode": "NULLABLE",
          "description": "Salesforce tracking number"
        }
      ]
      

   4. [テーブルを作成] をクリックします。
3. 次の手順で、空のアカウント テーブルを作成し、Salesforce アカウントの詳細を保存します。
   1. [ テーブルを作成] をクリックします。
   2. [送信先] セクションで、テーブル名として「Accounts」と入力します。
   3. [スキーマ] セクションで [テキストとして編集] をクリックし、次の JSON スキーマ定義を貼り付けます。

      [
        {
          "name": "account_id",
          "type": "STRING",
          "mode": "NULLABLE",
          "description": "Account ID for the opportunity"
        },
        {
          "name": "name",
          "type": "STRING",
          "mode": "NULLABLE",
          "description": "Account name for the opportunity"
        }
      ]
      

   4. [テーブルを作成] をクリックします。

   新しい Orders テーブルと Accounts テーブルが [エクスプローラ] パネルの Demo_order_dataset データセットに表示されます。

ServiceNow インスタンスを確認する

このチュートリアルでは、ServiceNow の無料の Personal Developer Instance（PDI）を使用します。既存の ServiceNow インスタンスを使用することも、新しいインスタンスを作成することも可能です。インスタンスがアクティブであることを確認し、そのインスタンスの URL をメモします。PDI の詳細については、ServiceNow PDI のドキュメントをご覧ください。

接続を設定

このチュートリアルでは、Integration Connectors で次の接続を構成する必要があります。

ヒント: us-central1(lowa) リージョンでは以下の接続を作成することをおすすめします。

Salesforce 接続

Integration Connectors で Salesforce 接続を構成します。Salesforce コネクタの構成については、Salesforce コネクタをご覧ください。

BigQuery 接続

Demo_order_dataset データセットの注文とアカウント詳細の取得、更新、検証を行うように、Integration Connectors の BigQuery 接続を構成します。BigQuery コネクタの構成については、BigQuery コネクタをご覧ください。

ServiceNow の接続

インスタンス URL を使用して Integration Connectors の ServiceNow 接続を構成し、ServiceNow でアカウントの詳細を作成して取得します。ServiceNow コネクタの構成については、ServiceNow コネクタをご覧ください。

統合を作成する

新しい統合を作成するには、次の手順を行います。

1. Google Cloud コンソールで [Application Integration] ページに移動します。

   Application Integration に移動

2. ナビゲーション メニューで [統合] をクリックします。[Integrations List] ページが表示されます。
3. [ 統合を作成] をクリックし、[統合を作成] ページで次の情報を入力します。
   1. 連携名: 「opportunity-to-order-integration」と入力します。
   2. 説明: 「Demo integration created for tutorial」と入力します。
   3. リージョン: サポートされているリージョンのリストから us-central1 を選択します。
   4. [作成] をクリックして統合エディタを開きます。

統合トリガーを設定する

統合が正常に作成されたら、特定されたイベントの統合を呼び出す統合トリガーを追加して構成できます。

このチュートリアルでは、Salesforce トリガーを使用して、Salesforce インスタンスで新しい商談が作成されるたびに統合を呼び出します。opportunity-to-order-integration 統合に Salesforce トリガーを追加して構成するには、次の操作を行います。

1. 統合エディタで [トリガー] をクリックし、使用可能なトリガーのリストを表示します。
2. 統合エディタで、[Salesforce トリガー] 要素をクリックして配置します。
3. デザイナー キャンバスで [Salesforce trigger] 要素を選択して、Salesforce トリガーの構成ペインを開きます。
4. [トリガー入力] で、次の項目を構成します。
   1. Event type: プルダウン リストから [Change Data Capture (CDC)] を選択します。
   2. Salesforce インスタンス構成: プルダウン リストから [+ 新しい Salesforce インスタンス構成の追加] オプションをクリックします。

      [Add Salesforce instance configuration] ダイアログで、次の操作を行います。

      • Salesforce instance connection name: Salesforce インスタンスの接続名を入力します。例: test
      • Salesforce ドメイン: Salesforce のドメイン名を入力します。この情報は、[Salesforce アカウント] > [プロファイルを表示] ページで確認できます。
      • 認証プロファイル: 認証プロファイルを選択します。認証プロファイルが存在しない場合は、新しいプロファイルを作成します。詳細については、新しい認証プロファイルを作成するをご覧ください。
      • [Add] をクリックします。
   3. Salesforce チャネル構成: プルダウン リストから [+ 新しい Salesforce チャネル構成の追加] をクリックします。

      [Add Salesforce channel] ダイアログで、次の操作を行います。

      • Salesforce object name: 「Opportunity」と入力します。
      • [Add] をクリックします。
   4. オペレーション: プルダウン リストから [作成] を選択します。

   プロパティへの変更は自動的に保存されます。

トリガー ペイロードを Salesforce コネクタにマッピングする

Salesforce トリガーを使用して統合が呼び出されると、商談 ID を抽出して Salesforce コネクタにマッピングし、その商談の詳細をさらに取得します。

Salesforce アカウントに接続する

次の手順で、Connectors タスクを追加して構成し、Salesforce 接続を使用して商談の詳細を取得します。

1. 統合エディタで、[タスク] をクリックして、使用可能なタスクのリストを表示します。
2. 統合エディタで [Connectors] 要素をクリックして配置します。
3. デザイナーで [Connectors] タスク要素を選択して、[Connectors] タスク構成ペインを表示します。
4. [] をクリックし、Connectors ラベルの名前を Fetch Salesforce Data に変更します。
5. [コネクタを設定する] をクリックします。
6. [Connectors Task Editor] ページで、次の操作を行います。
   1. [Select connection] で、us-central1 リージョンを選択します。
   2. 使用可能な接続のリストから、Salesforce 接続を選択します。
   3. [Next] をクリックします。
   4. [タイプ] で [エンティティ] を選択します。
   5. [Set entities/actions] で使用可能なエンティティのリストから [商談] を選択し、[オペレーション] として [入手] を選択します。
   6. [完了] をクリックして接続の構成を完了し、ペインを閉じます。

商談 ID を抽出してマッピングする

Data Mapping タスクは、その Salesforce トリガーと Salesforce コネクタの間の商談の詳細をマッピングして抽出するために使用されます。

統合でデータ マッピングを追加して構成するには、次の操作を行います。

1. 統合エディタで、[タスク] をクリックして、使用可能なタスクのリストを表示します。
2. 統合エディタで [Data Mapping] 要素をクリックして配置します。
3. デザイナーで [Data Mapping] 要素を選択して、タスク構成ペインを表示します。
4. [] をクリックし、Data Mapping タスクの名前を Map to opportunity ID に変更します。
5. [Open Data Mapping Editor] をクリックします。

   データ マッピング エディタを使用すると、使用可能な変換関数を使用して、入力変数を目的の出力変数にマッピングできます。 出力は、他の統合タスクまたはトリガーの変数として使用できます。マッピング変数の詳細については、マッピングを追加するをご覧ください。

6. トリガーの（SalesforceTriggerCdcRecordID）出力変数を自動生成されたコネクタの（entityId(Fetch Salesforce Data)）入力変数にマッピングします。

   マッピングが完了したら、ペインを閉じます。変更は自動的に保存されます。

7. Salesforce トリガーから Map to opportunity ID タスクにエッジ接続を追加します。
8. Map to opportunity ID タスクから Fetch Salesforce Data コネクタにエッジ接続を追加します。

BigQuery テーブルで Salesforce アカウントを検証する

Salesforce コネクタからすべての商談の詳細を取得したら、その商談に関連付けられているアカウント ID を抽出してマッピングし、BigQuery テーブルでその商談の存在を確認します。

BigQuery テーブルに接続する

次の手順で、BigQuery 接続を使用して BigQuery のアカウント テーブルを読み取る Connectors タスクを構成します。

1. 統合エディタで、[タスク] をクリックして、使用可能なタスクのリストを表示します。
2. 統合エディタで [Connectors] 要素をクリックして配置します。
3. デザイナーで [Connectors] タスク要素をクリックして、コネクタタスクの構成ペインを表示します。
4. [] をクリックして Connectors の名前を Check account in BigQuery に変更します。
5. [コネクタを設定する] をクリックします。
6. [Connectors Task Editor] ページで、次の操作を行います。
   1. [Select connection] で、us-central1 リージョンを選択します。
   2. 使用可能な接続のリストから、BigQuery 接続を選択します。
   3. [Next] をクリックします。
   4. [タイプ] で [エンティティ] を選択します。
   5. [Set entities/actions] で、使用可能なエンティティのリストから [アカウント] を選択し、[オペレーション] として [リスト] を選択します。
   6. [完了] をクリックして接続の構成を完了し、ペインを閉じます。
7. Fetch Salesforce Data コネクタから Check account in BigQuery コネクタにエッジ接続を追加します。

Salesforce アカウント ID を抽出して検証する

商談のアカウント ID を抽出、マッピング、検証する手順は次のとおりです。

1. 統合エディタで、[タスク] をクリックして、使用可能なタスクのリストを表示します。
2. 統合エディタで [Data Mapping] 要素をクリックして配置します。
3. デザイナーの [Data Mapping] 要素をクリックして、タスク構成ペインを表示します。
4. [] をクリックし、Data Mapping タスクの名前を Check account に変更します。
5. [Open Data Mapping Editor] をクリックします。
6. [+ 新しい変数を追加] をクリックして、次の出力変数を作成します。

   出力変数名	データ型
   sf_account_id	STRING
   sf_account_name	STRING
   account_exists	BOOLEAN

7. Salesforce コネクタのペイロード変数とローカル変数の間で次のマッピングを作成します。

   入力	出力
   connectorOutputPayload ( Fetch Salesforce Data) .GET_PROPERTY("AccountId")	sf_account_id
   connectorOutputPayload ( Fetch Salesforce Data) .GET_PROPERTY("Name")	sf_account_name
   connectorOutputPayload (Check account in BigQuery) .FILTER(~obj1 -> ~obj1 .GET_PROPERTY("account_id") .TO_STRING() .EQUALS(sf_account_id) ) .SIZE() .EQUALS("1")	account_exists

   マッピングが完了したら、ペインを閉じます。変更は自動的に保存されます。

8. Check account in BigQuery コネクタから Check account タスクにエッジ接続を追加します。

新しい BigQuery アカウントを作成する

BigQuery で Salesforce アカウントを確認した際にアカウントが存在しない場合は、次の手順で BigQuery に新しいアカウントを作成します。同じ情報を使用して ServiceNow でもアカウントを作成します。

BigQuery にアカウントを追加する

次の手順で、BigQuery の Accounts テーブルに新しいエンティティを作成する Connectors タスクを構成します。

1. 統合エディタで、[タスク] をクリックして、使用可能なタスクのリストを表示します。
2. 統合エディタで [Connectors] 要素をクリックして配置します。
3. デザイナーで [Connectors] タスク要素をクリックして、コネクタタスクの構成ペインを表示します。
4. [] をクリックして Connectors の名前を Create account in BigQuery に変更します。
5. [コネクタを設定する] をクリックします。
6. [Connectors Task Editor] ページで、次の操作を行います。
   1. [Select connection] で、us-central1 リージョンを選択します。
   2. 使用可能な接続のリストから、BigQuery 接続を選択します。
   3. [Next] をクリックします。
   4. [タイプ] で [エンティティ] を選択します。
   5. [Set entities/actions] で、使用可能なエンティティのリストから [アカウント] を選択し、[オペレーション] として [作成] を選択します。
   6. [完了] をクリックして接続の構成を完了し、ペインを閉じます。

新しい ServiceNow アカウントを作成する

次の手順で、新しいアカウントを ServiceNow インスタンスに追加する Connectors タスクを構成します。

1. 統合エディタで、[タスク] をクリックして、使用可能なタスクのリストを表示します。
2. 統合エディタで [Connectors] 要素をクリックして配置します。
3. デザイナーで [Connectors] タスク要素をクリックして、コネクタタスクの構成ペインを表示します。
4. [] をクリックして Connectors の名前を Create account in ServiceNow に変更します。
5. [コネクタを設定する] をクリックします。
6. [Connectors Task Editor] ページで、次の操作を行います。
   1. [Select connection] で、us-central1 リージョンを選択します。
   2. 使用可能な接続のリストから、BigQuery 接続を選択します。
   3. [Next] をクリックします。
   4. [タイプ] で [エンティティ] を選択します。
   5. [Set entities/actions] で使用可能なエンティティのリストから [system_user] を選択し、[オペレーション] として [作成] を選択します。
   6. [完了] をクリックして接続の構成を完了し、ペインを閉じます。

アカウントの詳細を変換してマッピングする

アカウントの詳細を変換して BigQuery コネクタと ServiceNow コネクタにマッピングするには、次の操作を行います。

1. 統合エディタで、[タスク] をクリックして、使用可能なタスクのリストを表示します。
2. 統合エディタで [Data Mapping] 要素をクリックして配置します。
3. デザイナーの [Data Mapping] 要素をクリックして、タスク構成ペインを表示します。
4. [] をクリックし、Data Mapping タスクの名前を Mapping for Account Creation に変更します。
5. [Open Data Mapping Editor] をクリックします。
6. [+ 新しい変数を追加] をクリックして、次の入力変数を作成します。

   入力変数名	データ型
   new_BQaccount	JSON
   new_SNaccount	JSON

7. 次のマッピングを作成して、Salesforce のアカウント ID と名前を BigQuery テーブルにマッピングします。

   入力	出力
   new_BQaccount .SET_PROPERTY( sf_account_id, "account_id" ) .SET_PROPERTY( sf_account_name, "name" )	connectorInputPayload (Create account in BigQuery)
   new_SNaccount .SET_PROPERTY( sf_account_id, "sys_id" ) .SET_PROPERTY( sf_account_name, "first_name" )	connectorInputPayload (Create account in ServiceNow)

   マッピングが完了したら、ペインを閉じます。変更は自動的に保存されます。

8. Mapping for Account Creatio タスクから Create account in BigQuery コネクタにエッジ接続を追加します。
9. Mapping for Account Creation タスクから Create account in ServiceNow コネクタにエッジ接続を追加します。

BigQuery で新しい注文を作成する

注文番号を生成して BigQuery に追加する手順は次のとおりです。

BigQuery に注文を追加する

次の手順で、BigQuery の注文テーブルに新しいエンティティを作成する Connectors タスクを構成します。

1. 統合エディタで、[タスク] をクリックして、使用可能なタスクのリストを表示します。
2. 統合エディタで [Connectors] 要素をクリックして配置します。
3. デザイナーで [Connectors] タスク要素をクリックして、コネクタタスクの構成ペインを表示します。
4. [] をクリックして Connectors の名前を Create order in BigQuery に変更します。
5. [コネクタを設定する] をクリックします。
6. [Connectors Task Editor] ページで、次の操作を行います。
   1. [Select connection] で、us-central1 リージョンを選択します。
   2. 使用可能な接続のリストから、BigQuery 接続を選択します。
   3. [Next] をクリックします。
   4. [タイプ] で [エンティティ] を選択します。
   5. [Set entities/actions] で、使用可能なエンティティのリストから [注文] を選択し、[オペレーション] として [作成] を選択します。
   6. [完了] をクリックして接続の構成を完了し、ペインを閉じます。

注文を生成して BigQuery にマッピングする

1. 統合エディタで、[タスク] をクリックして、使用可能なタスクのリストを表示します。
2. 統合エディタで [Data Mapping] 要素をクリックして配置します。
3. デザイナーの [Data Mapping] 要素をクリックして、タスク構成ペインを表示します。
4. [] をクリックし、Data Mapping タスクの名前を Mapping for Order Creation に変更します。
5. [Open Data Mapping Editor] をクリックします。
6. [+ 新しい変数を追加] をクリックして、次の変数を作成します。

   変数名	データ型
   order_number	STRING

7. 次のマッピングを作成して新しい注文番号を生成し、BigQuery コネクタに注文の詳細をマッピングします。

   入力	出力
   GENERATE_UUID() .SPLIT("-") .GET("0")	new_order_number
   "{}" .TO_JSON() .SET_PROPERTY( connectorOutputPayload ( Fetch Salesforce Data) .GET_PROPERTY("DeliveryInstallationStatus__c") , "order_status" ) .SET_PROPERTY( connectorOutputPayload ( Fetch Salesforce Data) .GET_PROPERTY("TrackingNumber__c") , "tracking_number" ) .SET_PROPERTY( new_order_number , "order_number" )	connectorInputPayload (Create Order in BigQuery)

   マッピングが完了したら、ペインを閉じます。変更は自動的に保存されます。

8. Create account in BigQuery コネクタから Mapping for Order Creation タスクにエッジ接続を追加します。
9. Create account in ServiceNow コネクタから Mapping for Order Creation タスクにエッジ接続を追加します。
10. Mapping for Order Creation タスクから Create Order in BigQuery コネクタにエッジ接続を追加します。

Salesforce の商談を更新する

新しい注文番号を生成したら、ソースの Salesforce の商談を更新します。

Salesforce コネクタを構成する

次の手順で、既存の Salesforce の商談を更新する Connectors タスクを構成します。

1. 統合エディタで、[タスク] をクリックして、使用可能なタスクのリストを表示します。
2. 統合エディタで [Connectors] 要素をクリックして配置します。
3. デザイナーで [Connectors] タスク要素をクリックして、[Connectors] タスク構成ペイン] を表示します。
4. [] をクリックして Connectors の名前を Update Salesforce に変更します。
5. [コネクタを設定する] をクリックします。
6. [Connectors Task Editor] ページで、次の操作を行います。
   1. [Select connection] で、us-central1 リージョンを選択します。
   2. 使用可能な接続のリストから、Salesforce 接続を選択します。
   3. [Next] をクリックします。
   4. [タイプ] で [エンティティ] を選択します。
   5. [Set entities/actions] で使用可能なエンティティのリストから [商談] を選択し、[オペレーション] として [更新] を選択します。
   6. [完了] をクリックして接続の構成を完了し、ペインを閉じます。

注文番号を Salesforce にマッピングする

1. 統合エディタで、[タスク] をクリックして、使用可能なタスクのリストを表示します。
2. 統合エディタで [Data Mapping] 要素をクリックして配置します。
3. デザイナーの [Data Mapping] 要素をクリックして、タスク構成ペインを表示します。
4. [] をクリックし、Data Mapping タスクの名前を Mapping to update opportunity に変更します。
5. [Open Data Mapping Editor] をクリックします。
6. 次のマッピングを作成して Salesforce の商談を更新します。

   入力	出力
   "{}" .TO_JSON() .SET_PROPERTY( new_order_number , "OrderNumber__c" )	connectorInputPayload (Update Salesforce)
   entityId ( Fetch Salesforce Data)	entityId (Update Salesforce )
   "'" .CONCAT(entityId ( Fetch Salesforce Data)) .CONCAT("'")	filterClause (Update Salesforce )

   マッピングが完了したら、ペインを閉じます。変更は自動的に保存されます。

7. Create Order in BigQuery コネクタから Mapping to update opportunity タスクに エッジ接続を追加します。
8. Mapping to update opportunity タスクから Update Salesforce コネクタにエッジ接続を追加します。

エッジ条件を追加する

エッジ条件を使用すると、統合を制御するために満たされる必要がある条件を指定して、エッジで接続されたタスクに渡すことができます。必要なタスクを追加して構成したので、エッジ条件を追加して統合のフローを定義できます。

次のエッジ条件により、アカウント情報の検証に基づいて統合のフローが制御されます。

1. 次のエッジ条件で、Check account タスクから Mapping for Account Creation タスクにエッジ接続を追加します。

     $account_exists$ = False

2. 次のエッジ条件で、Check account タスクから Mapping for Order Creation タスクに別のエッジ接続を追加します。

     $account_exists$ = True

統合フローのサンプル

次の図は、このチュートリアルを使用して作成した統合のサンプル レイアウトを示しています。

統合を公開してテストする

統合を公開するには、統合デザイナー ツールバーの [公開] をクリックします。

統合が正常に公開されると、公開された統合の実行ログを表示、検査できます。ログを表示するには、[この統合の実行ログを表示] をクリックします。実行ログのページが表示されます。

テストケース 1: 新しいアカウント ID の注文番号が作成されたかどうかを確認する

Salesforce インスタンスにログインして新しい商談を作成し、統合をテストします。この商談は、新しいアカウント、または BigQuery テーブルに存在しないアカウントで作成する必要があります。

統合が成功したことを確認するには:

1. BigQuery ページに移動します。

   BigQuery に移動

   • [アカウント] テーブルを開いて、新しい商談のアカウント ID が挿入されていることを確認します。
   • [注文] テーブルを開いて、新しい注文の詳細が挿入されていることを確認します。
2. ServiceNow インスタンスに移動します。
   • 同じ Salesforce 商談アカウント ID を含む新しいアカウントがインスタンスに追加されたかどうかを確認します。
3. Salesforce を開きます。
   • 商談が新しい注文番号で更新されたかどうかを確認します。

テストケース 2: BigQuery で既存のアカウント ID の注文番号が作成されたかどうかを確認する

Salesforce インスタンスにログインして新しい商談を作成し、統合をテストします。この商談は、BigQuery テーブルにも存在する既存のアカウントで作成する必要があります。

統合が成功したことを確認するには:

1. BigQuery ページに移動します。

   BigQuery に移動

   • [アカウント] テーブルを開いて、新しいアカウント ID が挿入されていないことを確認します。
   • [注文] テーブルを開いて、新しい注文の詳細が挿入されていることを確認します。
2. Salesforce を開きます。
   • 商談が新しい注文番号で更新されたかどうかを確認します。

クリーンアップ

このチュートリアルで使用したリソースについて、Google Cloud アカウントに課金されないようにするには、統合の公開を停止して、Integration Connectors で作成した接続を削除します。

• この統合の公開を停止するには、統合エディタ ツールバーの [公開を停止] をクリックします。詳細については、統合を削除するをご覧ください。
• 接続を削除する方法については、コネクタを管理するをご覧ください。