フローの設計とテスト

学習の目的

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

Salesforce から Asana にデータを自動的に同期するフローを設計する。
フローをテストしてデータが期待どおり同期されることを確認する。

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

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

ベストプラクティスとして、フローの作成時には、フローが完成するまで数個のステップを追加しながらテストを繰り返します。

大規模なインテグレーションタスクがある場合は、タスクを管理可能なサイズに小分けにして、それぞれにフローを作成することをお勧めします。これにより、フローをより簡単かつ迅速に作成、テスト、実行して、タスクを完了できるようになります。

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

フローを設計する

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

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

NTO 組織から Mulesoft コンポーザーを起動します。

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

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

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

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

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

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

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

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

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

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

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

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

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

Task Name (タスク名): ステップ 1 の [Subject (件名)]
Task Description (タスクの説明) = ステップ 1 の [Description (説明)]

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

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

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

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

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

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

Task Name (タスク名): ステップ 1 の [Subject (件名)]
Task Description (タスクの説明) = ステップ 1 の [Description (説明)]

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

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

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

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

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

[Action (アクション)] 項目をクリックして、[Create Task (タスクを作成)] を選択します。
[Workspace Id (ワークスペース ID)] 項目をクリックし、[NTO Customer Service (NTO カスタマーサービス)] を選択します。
[Project Id (プロジェクト ID)] 項目をクリックし、[Customer Support (カスタマーサポート)] を選択します。
4 つ目のステップの以下の項目を、フローのステップ 1 の対応する項目にマップします。

Task Name (タスク名): ステップ 1 の [Subject (件名)]
Task Description (タスクの説明) = ステップ 1 の [Description (説明)]

フローを保存します。フロー全体は次のようになります。

NTO ケースの新規作成または更新がトリガーとして表示されているフローのステップ 1。

ケースの優先度が高いかどうかと、エンジニアリングの協力を要するかどうかを判断する条件が表示されているフローの 1 つ目の If ブランチ。

Asana で作成された [Task Name (タスク名)] 項目と [Task Description (タスクの説明)] 項目を使用するタスクが表示されている、1 つ目の If ブランチ内にあるフローのステップ 2。

Asana で作成された [Assignee Id (割り当て先 ID)] や [Assignee Status (割り当て先の状況)] などの項目が表示されている、1 つ目の If ブランチ内にあるフローのステップ 2 の残りの部分。

ケースの優先度が高いかどうかを判断する条件が表示されているフローの 2 つ目の If ブランチ。

Asana で作成された [Task Name (タスク名)] 項目と [Task Description (タスクの説明)] 項目を使用するタスクが表示されている、2 つ目の If ブランチ内にあるフローのステップ 3。

Asana で作成された [Assignee Id (割り当て先 ID)] や [Assignee Status (割り当て先の状況)] などの項目が表示されている、2 つ目の If ブランチ内にあるフローのステップ 3 の残りの部分。

Asana で作成された [Task Name (タスク名)] 項目を使用するタスクが表示されている、Else ブランチ内にあるフローのステップ 4。

Asana で作成された [Assignee Id (割り当て先 ID)] や [Assignee Status (割り当て先の状況)] などの項目が表示されている、Else ブランチ内にあるフローのステップ 4 の残りの部分。

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

フローのテスト

フローを設計したら、エンドツーエンドでテストしてデータが想定どおりに同期されることを確認する必要があります。一般に、テストは 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 プロジェクトにタスクが作成されます。そのため、タスクが適切に表示されることを確認する準備をしておきます。

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

[Sync NTO Org Cases with Asana Tasks (NTO 組織のケースを Asana のタスクと同期)] フローで、[Test (テスト)] をクリックします。フローが参照のみモードになります。
メモ: テストの実行中に何らかの理由で停止する場合は、[Stop Test (テストを停止)] をクリックします。
NTO 組織の Service Cloud で、[ケース] タブに移動し、[新規] をクリックします。
次の値を指定して新しいケースを設定し、[保存] をクリックします。

原因: Equipment Design (機器設計)
Status (状況): New (新規)
優先度: High (高)
Case Origin (ケース発生源): Phone (電話)
Requires Engineering Assistance (エンジニアリングの協力要): オン
Subject (件名): Design issue with generator (発電機の設計に関する問題)
Description (説明): Complex design makes it difficult to assemble generator components correctly. (設計が複雑で発電機の部品を正しく組み立てることが難しい。)

フローに戻り、テストが完了するまで待機します。フローの 1 つ目の If ブランチにあるステップ 1 とステップ 2 に緑のチェックマークが表示された場合、このケースに関連するステップが正常に実行されたことを意味します。[Test Output (テスト出力)] セクションを見ると、テスト用に入力したレコード値が表示されています。
Asana で [Engineering Triage (エンジニアリングトリアージ)] プロジェクトをクリックします。[Design issue with generator (発電機の設計に関する問題)] というタスクが表示されるはずです。
[Design issue with generator (発電機の設計に関する問題)] をクリックします。Asana のタスクの項目には NTO 組織の対応するケースの値が含まれているはずです。
フローの [Test (テスト)] を再度クリックします。
NTO 組織の Service Cloud にログインして前のケースに戻り、[Requires Engineering Assistance (エンジニアリングの協力を要する)] チェックボックスをオフにして [保存] をクリックします。
フローに戻り、テストが完了するまで待機します。フローの 2 つ目の If ブランチにあるステップ 1 とステップ 3 に緑のチェックマークが表示された場合、このケースに関連するステップが正常に実行されたことを意味します。[Test Output (テスト出力)] セクションを見ると、テスト用に入力したレコード値が表示されています。
Asana で [Cross-Functional Support (部門間サポート)] プロジェクトをクリックします。[Design issue with generator (発電機の設計に関する問題)] というタスクが表示されるはずです。
[Design issue with generator (発電機の設計に関する問題)] をクリックします。Asana のタスクの項目には NTO 組織の対応するケースの値が含まれているはずです。
フローの [Test (テスト)] を再度クリックします。
NTO 組織の Service Cloud にログインして前のケースに戻り、[優先度] 項目で [中] を選択して [保存] をクリックします。
フローに戻り、テストが完了するまで待機します。フローの Else ブランチにあるステップ 1 とステップ 4 に緑のチェックマークが表示された場合、このケースに関連するステップが正常に実行されたことを意味します。[Test Output (テスト出力)] セクションを見ると、テスト用に入力したレコード値が表示されています。
Asana で [Customer Support (カスタマーサポート)] プロジェクトをクリックします。[Design issue with generator (発電機の設計に関する問題)] というタスクが表示されるはずです。
[Design issue with generator (発電機の設計に関する問題)] をクリックします。Asana のタスクの項目には NTO 組織の対応するケースの値が含まれているはずです。
NTO 組織の他の任意のケースでステップ 1 ～ 16 を繰り返してテストします。フローは期待どおり機能するはずです。