フローを設計してテストする

学習の目的

この単元を完了すると、次のことができるようになります。

• 2 つの Salesforce 組織間で新しい取引先を自動的に同期するフローを設計する。
• フローをテストして、2 つの Salesforce 組織間で新しい取引先が設定どおりに同期されることを確認する。

「MuleSoft Composer の基本」で説明したように、フローはシステムとデータを統合するために組み合わせて設定する一連のステップです。フローを設計する前に、フローチャートを使用してフローのステップを計画します。紙と鉛筆を使ってこれを行うことで、フローをどのようなものにするか考えをまとめることができます。

前の単元で説明した NTO ユースケースのインテグレーションフローのステップをすべて含むフローチャートの例を次に示します。 

この NTO ユースケースのフローを作成するタスクと関連するフローコンポーネントの詳細な説明は、次のとおりです。

MuleSoft Composer ではデフォルトで作業が検証され、手順の各ステップでアプリケーション内コンテキストヘルプが提供されます。たとえば、システムに接続を追加すると、MuleSoft Composer で接続がテストされるため、正常に機能することを確認したうえで次のステップに進むことができます。また、各ステップ内の必須項目を入力するように MuleSoft Composer から求められます。これでフローのビルドが簡単になります。

フローの構築のベストプラクティスは、数ステップごとにテストを繰り返しながらフローを完成させることです。 

次のデモ動画で、MuleSoft Composer を使用して 2 つの異なる Salesforce 組織を接続する方法を確認してください。

フローを設計する

これで、2 つの Salesforce 組織間で新しい取引先を自動的に同期するインテグレーションフローを設計する準備が整いました。 

次の手順に従ってフローを設計します。

NTO 組織から MuleSoft Composer を起動します。

1. ユーザー名とパスワードを使用して NTO 組織にログインします。
2. アプリケーションランチャーに Composer と入力して [MuleSoft Composer] を選択します。

新しいフローを作成します。

1. [Create New Flow (新規フローを作成)] をクリックします。
2. デフォルトのフロー名の横にある鉛筆アイコンをクリックします。
3. フローに Sync Accounts - GD Org to NTO Org (取引先の同期 - GD 組織から NTO 組織へ) と名前を付け、[Save (保存)] をクリックします。

GD Sandbox 組織接続を使用して、フローのトリガーを作成します。

1. [Salesforce] をクリックします。
2. [Add new Salesforce connection (新しい Salesforce 接続を追加)] をクリックして GD Sandbox 組織への接続を作成します。
   メモ: これが最初の Salesforce 接続である場合、このオプションは表示されません。次のステップに進んでください。
3. この接続に GD sandbox org (GD Sandbox 組織) と名前を付けます。
4. [This is a sandbox organization (これは Sandbox 組織です)] チェックボックスをオンにして、[Create (作成)] をクリックします。
   メモ: 開発者組織を使用する場合は、このチェックボックスの選択をスキップして [Create (作成)] をクリックします。
5. GD Sandbox 組織のユーザー名とパスワードを入力して、[Log In to Sandbox (Sandbox にログイン)] をクリックします。
6. [Allow (許可)] をクリックして、MuleSoft Composer に「ID URL サービスにアクセス」、「API を使用してユーザーデータを管理」、「いつでも要求を実行」権限を付与します。MuleSoft Composer で接続が自動的にテストされます。エラーメッセージが表示されていない場合は接続が確立し、フローの最初のステップ (トリガー) が表示されます。

GD 組織で取引先が作成されるたびにフローを開始するトリガーを設定します。

1. [Choose an event that starts this flow (このフローを開始するイベントを選択)] 項目をクリックして [New record (新規レコード)] を選択します。
2. [Object Type (オブジェクト種別)] 項目をクリックして [Account (取引先)] を選択します。
3. [項目を選択] をクリックします。
4. 検索項目を使用して、次の項目を見つけて選択し、[Add (追加)] をクリックします。これらの項目は、フローの後の方のステップでインテグレーションタスクを実行するために使用します。
   ヒント: 検索する項目のキーワードを入力し、表示された関連項目を選択します。キーワードを消去して次の項目でプロセスを繰り返します。すべての項目の選択が完了したら、[Add (追加)] をクリックします。
   • Account ID (取引先 ID)
   • Account Name (取引先名)
   • Billing City (市区郡(請求先))
   • Billing Country (国(請求先))
   • Billing State/Province (都道府県(請求先))
   • Billing Street (町名・番地(請求先))
   • Billing Zip/Postal Code (郵便番号(請求先))
   • NTO Account ID (NTO 取引先 ID)
5. [Sample Output (サンプル出力)] セクションを見ると、選択した項目とそれに関連付けられた GD 組織の取引先からのサンプル値が表示されています。これで、正しい組織に接続されていることを確認でき、フローの今後のステップで使用できるデータの構造がわかります。
   
6. [Save (保存)] をクリックしてフローを保存します。

NTO Sandbox 組織接続を使用して、フローの 2 番目のステップを作成します。

1. プラスアイコンをクリックしてステップを追加します。
2. [Salesforce] をクリックし、[Add new Salesforce connection (新しい Salesforce 接続を追加)] をクリックします。
3. 接続に NTO sandbox org (NTO Sandbox 組織) と名前を付けます。
   メモ: NTO 組織にログインしていても、インテグレーションタスクを実行するには NTO 組織への接続を作成する必要があります。
4. [This is a sandbox organization (これは Sandbox 組織です)] チェックボックスをオンにして、[Create (作成)] をクリックします。
5. NTO の Sandbox 組織のユーザー名とパスワードを入力して、[Log In to Sandbox (Sandbox にログイン)] をクリックします。
6. [Allow (許可)] をクリックして、MuleSoft Composer に「ID URL サービスにアクセス」、「API を使用してユーザーデータを管理」、「いつでも要求を実行」権限を付与します。MuleSoft Composer で接続が自動的にテストされます。エラーメッセージが表示されていない場合は接続が確立し、フローの 2 番目のステップが表示されます。

2 番目のステップで、関連付けられた GD 取引先 ID を含む関連情報を使用して NTO 組織に取引先を作成するように設定します。

1. [Action (アクション)] 項目をクリックし、[Create new record (新しいレコードを作成)] を選択します。
2. [Object Type (オブジェクト種別)] 項目をクリックして [Account (取引先)] を選択します。[Account Name (取引先名)] は必須項目であるため自動的に選択されます。
3. [Add Fields (項目を追加)] をクリックします。
4. 検索項目を使用して、次の項目を見つけて選択し、[Add (追加)] をクリックします。これらの項目は、フローのステップ 1 で取得した GD データを保存するために使用されます。
   • Billing City (市区郡(請求先))
   • Billing Country (国(請求先))
   • Billing State/Province (都道府県(請求先))
   • Billing Street (町名・番地(請求先))
   • Billing Zip/Postal Code (郵便番号(請求先))
   • GD 取引先名
5. 各項目をクリックして NTO 取引先項目を、ステップ 1 で取得した対応する GD 取引先項目にマップします。
   • Account Name (取引先名) = Account Name (取引先名)
   • Billing City (市区郡(請求先)) = Billing City (市区郡(請求先))
   • Billing Country (国(請求先)) = Billing Country (国(請求先))
   • Billing State/Province (都道府県(請求先)) = Billing State/Province (都道府県(請求先))
   • Billing Street (町名・番地(請求先)) = Billing Street (町名・番地(請求先))
   • Billing Zip/Postal Code (郵便番号(請求先)) = Billing Zip/Postal Code (郵便番号(請求先))
   • GD Account ID (GD 取引先 ID) = Account ID (取引先 ID)

既存の GD Sandbox 組織接続を使用して、フローの 3 番目のステップを作成します。

1. プラスアイコンをクリックしてステップを追加します。
2. [Salesforce] をクリックし、[GD sandbox org (GD Sandbox 組織)] を選択します。
   メモ: ここでは既存の GD Sandbox 組織接続を再利用します。

3 番目のステップで、トリガー元の GD 取引先を関連付けられた NTO 取引先 ID で更新するように設定します。 

1. [Action (アクション)] 項目で [Update record (レコードを更新)] を選択します。
2. [Object Type (オブジェクト種別)] で [Account (取引先)] を選択します。[Account ID (取引先 ID)] は必須項目であるため自動的に選択されます。
3. [Add Fields (項目を追加)] をクリックし、[NTO Account ID (NTO 取引先 ID)] を選択し、[Add (追加)] をクリックします。
4. GD 取引先項目を、フローの前のステップで取得した対応する取引先項目に次のようにマップします。
   • Account ID (取引先 ID) = ステップ 1 の [Account ID (取引先 ID)]
   • NTO Account ID (NTO 取引先 ID) = ステップ 2 の [Id]
5. フローを保存します。フロー全体は次のようになります。
   

次は、フローのテスト方法を学習します。 

フローをテストする

フローを設計したら、エンドツーエンドでテストしてデータが問題なく同期されるかを確認する必要があります。 

ベストプラクティスは、テストシステムとデータを使用してフローをテストすることです。テストが完了したら、本番のシステムとデータを使用してフローを実行します。Salesforce では、これは Sandbox 組織を使用してフローをテストし、本番組織でフローを実行することを意味します。

また、ベストプラクティスは、フローのあらゆるパスをテストすることです。たとえば、フロー内に If 分岐と Else 分岐を含む If/Else ブロックがある場合、必ず両方の分岐をテストします。

一般に、テストは 10 分以内に完了します。テストが完了した時点、または 10 分を経過した時点でテストは停止します。テストに必要なアプリケーションとデータのすべてを準備してからテストを開始するのがベストプラクティスです。  

このユースケースでは、GD 組織で取引先が作成されるとフローがトリガーされます。そのため、GD 組織でテスト取引先を作成する準備をします。 

次に、以下を確認する準備をします。

• NTO 組織で取引先が作成され、関連付けられた GD 取引先 ID などの関連情報が含まれている。
• 関連付けられた NTO 取引先 ID で GD 取引先が更新されている。

次の手順に従ってフローをテストします。

1. [Sync Accounts - GD Org to NTO Org (取引先の同期 - GD 組織から NTO 組織へ)] フローで [Test (テスト)] をクリックします。フローが参照のみモードになります。
   メモ: テストの実行中に何らかの理由で停止する場合は、[Stop Test (テストを停止)] をクリックします。 
2. GD Sandbox 組織の Sales Cloud にログインし、[取引先] タブページに移動します。
3. [新規] をクリックし、次の値を使用して取引先を作成し、[保存] をクリックします。
   • 取引先名: ACME
   • 町名・番地(請求先): 495 Park Avenue
   • 市区郡(請求先): New York
   • 都道府県(請求先): New York
   • 郵便番号(請求先): 10022
   • 国(請求先): United States
4. フローに戻り、テストが完了するまで待機します。フローの 3 つのステップすべてに緑のチェックマークが表示されたら、フローは正常に実行されたことを示しています。[Test Output (テスト出力)] セクションで、テスト用に入力したレコード値を確認します。
   
5. NTO 組織の Sales Cloud にログインし、[取引先] タブに移動し、すべての取引先を表示します。GD の [ACME] 取引先と一致する NTO の [ACME] 取引先が作成されたことを確認します。この取引先には [GD account ID (GD 取引先 ID)] を含むすべての詳細が含まれている必要があります。この例では、ID は 0016e00002zgVOLAA2 です。
   
6. GD 組織の Sales Cloud に戻り、GD の [ACME] 取引先で NTO 取引先 ID が更新されていることを確認します。この例では 0011U000026YA7FQAW です。
   
7. ステップ 1 ～ 6 を繰り返して、別の取引先をテストします。フローは問題なく動作するはずです。

ここまで順調ですね。次の単元では、本番環境でフローをアクティブ化して監視し、トラブルシューティングする方法を学習します。