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

学習の目的

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

• Salesforce から Asana にデータを自動的に同期するフローを設計する。
• フローをテストしてデータが正常に同期することを確認する。

この単元では、まず MuleSoft Composer を使用して Salesforce のカスタマーサービスケースを Asana のタスクと自動的に同期するフローを作成する方法を学習します。次に、フローをテストしてデータが正常に同期することを確認します。

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

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

次のデモ動画で、MuleSoft Composer を使用して Salesforce を Asana に接続する方法をご覧ください。

フローを設計する

Salesforce のカスタマーサービスケースを Asana のタスクと統合するインテグレーションフローを設計する準備が整いました。 

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

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

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

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

1. [Create New Flow (新規フローの作成)] をクリックします。
2. デフォルトのフロー名の横にある鉛筆アイコンをクリックします。
3. フローに Sync NTO Org Cases with Asana Tasks (NTO 組織のケースを Asana のタスクと同期) と名前を付け、[Save (保存)] をクリックします。

NTO 組織を使用してフローのトリガーを作成します。

1. [Salesforce] をクリックします。
2. [Add new Salesforce connection (新しい Salesforce 接続を追加)] をクリックします。
3. この接続に NTO sandbox org (NTO Sandbox 組織) と名前を付けます。
4. [This is a sandbox organization (これは Sandbox 組織です)] チェックボックスをオンにして、[Create (作成)] をクリックします。
5. NTO Sandbox 組織のユーザー名とパスワードを入力して、[Log In (ログイン)] をクリックします。
6. [Allow (許可)] をクリックして、MuleSoft Composer に「基本情報へのアクセス」「データへのアクセスと管理」「ユーザーに代わっていつでも要求を実行」権限を付与します。MuleSoft Composer で接続が自動的にテストされます。エラーメッセージが表示されていない場合は接続が確立され、フローの最初のステップ (トリガー) が表示されます。
7. デフォルトのステップ名の横にある鉛筆アイコンをクリックします。
8. ステップに Get case (ケースを取得する) と名前を付け、[Save (保存)] をクリックします。

NTO 組織でケースが作成または更新されるたびにフローを開始するトリガーを設定します。

1. [Choose an event that starts this flow (このフローを開始するイベントを選択)] 項目をクリックして、[New or updated record (レコードの新規作成または更新)] を選択します。
2. [Object Type (オブジェクト種別)] 項目に Case (ケース) と入力します。
3. [Sample Output (サンプル出力)] セクションを見ると、NTO 組織のケースの項目と関連付けられているサンプル値が表示されています。この情報から、正しい組織に接続されていることを確認でき、フローの今後のステップで使用できるデータの構造がわかります。
   
4. [Save (保存)] をクリックしてフローを保存します。

ケースの優先度が高いかどうかと、エンジニアリングの協力を要するかどうかを判断する 1 つ目の If ブランチを作成して設定します。

1. プラスアイコンをクリックしてステップを追加します。
2. [If/Else Block (If/Else ブロック)] をクリックします。
3. [Add Conditions (条件を追加)] をクリックします。デフォルトで [All conditions must be met (AND) (すべての条件を満たす必要がある (AND))] が選択されています。
4. 項目に [Priority (優先度)]、演算子に [Equals (次の文字列と一致する)] を選択し、値に High (高) と入力します。
5. [Add a condition (条件を追加)] をクリックします。
6. 項目に [Requires Engineering Assistance (エンジニアリングの協力要)]、演算子に [Is true (True)] を選択して、[Save (保存)] をクリックします。両方の条件を満たした場合は、1 つ目の If ブランチの後続のステップ (Asana でのタスクの作成) が実行されます。

優先度が高いケースのうち、エンジニアリングの協力を要するものを処理するフローの 2 つ目のステップを 1 つ目の If ブランチ内に作成します。

1. プラスアイコンをクリックして If ブランチ内にステップを追加します。
2. [Asana] をクリックします。
3. [Add new Asana connection (新しい Asana 接続を追加)] をクリックします。
4. 接続に NTO Asana と名前を付け、[Create (作成)] をクリックします。
5. [Allow (許可)] をクリックして、MuleSoft Composer に「名前とメールアドレスへのアクセス」「タスク、プロジェクト、ワークスペースへのアクセス」「ユーザーに代わってタスク、プロジェクト、コメントを作成および編集」権限を付与します。NTO Asana 接続が作成され、フローの 2 つ目のステップが表示されます。
6. ステップに Create Asana task (Asana のタスクを作成する) と名前を付け、[Save (保存)] をクリックします。

Asana にタスクを作成する 2 つ目のステップを 1 つ目の If ブランチ内に設定します。

1. [Action (アクション)] 項目をクリックして、[Create Task (タスクを作成)] を選択します。
2. [Workspace Id (ワークスペース ID)] 項目をクリックし、[NTO Customer Service (NTO カスタマーサービス)] を選択します。
3. [Project Id (プロジェクト ID)] 項目をクリックし、[Engineering Triage (エンジニアリングトリアージ)] を選択します。
4. 2 つ目のステップの以下の項目を、フローのステップ 1 の対応する項目にマップします。
   • Task Name (タスク名): ステップ 1 の [Subject (件名)]
   • Task Description (タスクの説明) = ステップ 1 の [Description (説明)]

ケースの優先度が高いかどうかを判断する 2 つ目の If ブランチを作成します。

1. [Add If (If を追加)] をクリックして 2 つ目の If ブランチを追加します。
2. [Add Conditions (条件を追加)] をクリックします。デフォルトで [All conditions must be met (AND) (すべての条件を満たす必要がある (AND))] が選択されています。
3. 項目に [Priority (優先度)]、演算子に [Equals (次の文字列と一致する)] を選択し、値に High (高) と入力して、[Save (保存)] をクリックします。この条件を満たした場合は、2 つ目の If ブランチの後続のステップ (Asana でのタスクの作成) が実行されます。

優先度が高いケースを処理するフローの 3 つ目のステップを 2 つ目の If ブランチ内に作成します。

1. プラスアイコンをクリックして 2 番目の If ブランチ内にステップを追加します。
2. [Asana] をクリックして、[NTO Asana] をクリックします。
3. ステップに Create Asana task (Asana のタスクを作成する) と名前を付け、[Save (保存)] をクリックします。

優先度が高いケースを処理するフローの 3 つ目のステップを 2 つ目の If ブランチ内に設定します。

1. [Action (アクション)] 項目をクリックして、[Create Task (タスクを作成)] を選択します。
2. [Workspace Id (ワークスペース ID)] 項目をクリックし、[NTO Customer Service (NTO カスタマーサービス)] を選択します。
3. [Project Id (プロジェクト ID)] 項目をクリックし、[Cross-Functional Support (部門間サポート)] を選択します。
4. 3 つ目のステップの以下の項目を、フローのステップ 1 の対応する項目にマップします。
   • Task Name (タスク名): ステップ 1 の [Subject (件名)]
   • Task Description (タスクの説明) = ステップ 1 の [Description (説明)]

残りのすべてのケースを処理する Else ブランチを作成します。

1. [Add Else (Else を追加)] をクリックします。

残りのすべてのケースを処理する 4 つ目のステップを Else ブランチ内に作成します。

1. プラスアイコンをクリックして Else ブランチ内にステップを追加します。
2. [Asana] をクリックして、[NTO Asana] をクリックします。
3. ステップに Create Asana task (Asana のタスクを作成する) と名前を付け、[Save (保存)] をクリックします。

残りのすべてのケースを処理する 4 つ目のステップを Else ブランチ内に設定します。

1. [Action (アクション)] 項目をクリックして、[Create Task (タスクを作成)] を選択します。
2. [Workspace Id (ワークスペース ID)] 項目をクリックし、[NTO Customer Service (NTO カスタマーサービス)] を選択します。
3. [Project Id (プロジェクト ID)] 項目をクリックし、[Customer Support (カスタマーサポート)] を選択します。
4. 4 つ目のステップの以下の項目を、フローのステップ 1 の対応する項目にマップします。
   • Task Name (タスク名): ステップ 1 の [Subject (件名)]
   • Task Description (タスクの説明) = ステップ 1 の [Description (説明)]
5. フローを保存します。フロー全体は次のようになります。

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

フローをテストする

フローを設計したら、エンドツーエンドでテストしてデータが問題なく同期することを確認する必要があります。テストは概して 10 分以内に終了します。テストが完了した時点、または 10 分を経過した時点でテストが停止します。テストに必要なアプリケーションとデータを揃えたうえでテストを開始することをお勧めします。  

このユースケースでは、NTO 組織でカスタマーサービスケースが作成または更新されると、フローがトリガーされます。そのため、NTO 組織の Service Cloud にテストケースを入力する準備をしておきます。 

優先度が高いケースでエンジニアリングの協力を要する場合は、Asana の NTO Customer Service ワークスペースの Engineering Triage プロジェクトにタスクが作成されます。そのため、タスクが適切に表示されることを確認する準備をしておきます。 

優先度が高いケースでエンジニアリングの協力を必要としない場合は、Asana の NTO Customer Service ワークスペースの Cross-Functional Support プロジェクトにタスクが作成されます。そのため、タスクが適切に表示されることを確認する準備をしておきます。 

その他のケースでは、Asana の NTO Customer Service ワークスペースの Customer Service プロジェクトにタスクが作成されます。そのため、タスクが適切に表示されることを確認する準備をしておきます。 

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

1. [Sync NTO Org Cases with Asana Tasks (NTO 組織のケースを Asana のタスクと同期)] フローで、[Test (テスト)] をクリックします。フローが参照のみモードになります。
   メモ: テストの実行中に何らかの理由で停止する場合は、[Stop Test (テストを停止)] をクリックします。 
2. NTO 組織の Service Cloud にログインして [ケース] タブに移動し、[新規] をクリックします。
3. 次の値を指定して新しいケースを設定し、[保存] をクリックします。
   • 原因: Equipment Design (機器設計)
   • 状況: 新規
   • 優先度: 高
   • ケース発生源: 電話
   • Requires Engineering Assistance (エンジニアリングの協力要): オン
   • 件名: Design issue with generator (発電機の設計に関する問題)
   • 説明: Complex design makes it difficult to assemble generator components correctly. (設計が複雑で発電機の部品を正しく組み立てることが難しい。)
4. フローに戻り、テストが完了するまで待機します。フローの 1 つ目の If ブランチにあるステップ 1 とステップ 2 に緑のチェックマークが表示された場合、このケースに関連するステップが正常に実行されたことを意味します。[Test Output (テスト出力)] セクションで、テスト用に入力したレコード値を確認します。
   
5. Asana で [Engineering Triage (エンジニアリングトリアージ)] プロジェクトをクリックします。[Design issue with generator (発電機の設計に関する問題)] というタスクが表示されるはずです
6. [Design issue with generator (発電機の設計に関する問題)] をクリックします。Asana のタスクの項目には NTO 組織の対応するケースの値が含まれているはずです。
   
7. フローの [Test (テスト)] を再度クリックします。
8. NTO 組織の Service Cloud にログインして前のケースに戻り、[Requires Engineering Assistance (エンジニアリングの協力を要する)] チェックボックスをオフにして [保存] をクリックします。
9. フローに戻り、テストが完了するまで待機します。フローの 2 つ目の If ブランチにあるステップ 1 とステップ 3 に緑のチェックマークが表示された場合、このケースに関連するステップが正常に実行されたことを意味します。[Test Output (テスト出力)] セクションで、テスト用に入力したレコード値を確認します。
   
10. Asana で [Cross-Functional Support (部門間サポート)] プロジェクトをクリックします。[Design issue with generator (発電機の設計に関する問題)] というタスクが表示されるはずです
11. [Design issue with generator (発電機の設計に関する問題)] をクリックします。Asana のタスクの項目には NTO 組織の対応するケースの値が含まれているはずです。
    
12. フローの [Test (テスト)] を再度クリックします。
13. NTO 組織の Service Cloud にログインして前のケースに戻り、[優先度] 項目で [中] を選択して [保存] をクリックします。
14. フローに戻り、テストが完了するまで待機します。フローの Else ブランチにあるステップ 1 とステップ 4 に緑のチェックマークが表示された場合、このケースに関連するステップが正常に実行されたことを意味します。[Test Output (テスト出力)] セクションで、テスト用に入力したレコード値を確認します。
15. 

    

    Asana で [Customer Support (カスタマーサポート)] プロジェクトをクリックします。[Design issue with generator (発電機の設計に関する問題)] というタスクが表示されるはずです

16. [Design issue with generator (発電機の設計に関する問題)] をクリックします。Asana のタスクの項目には NTO 組織の対応するケースの値が含まれているはずです。
    

17. NTO 組織の他の任意のケースでステップ 1 ～ 16 を繰り返してテストします。フローが問題なく動作するはずです。

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