フローをアクティブ化して監視し、トラブルシューティングを実施する

学習の目的

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

• 本番環境でフローをアクティブ化してデータを自動的に同期する。
• 実行中のフローを監視し、トラブルシューティングする。

フローをアクティブ化する

フローをテストして納得がいったら、本番データを使用してフローをアクティブ化できます。まず、既存の各テスト接続を新しく作成した本番接続に切り替えて、フローをアクティブ化します。フローをアクティブ化すると、2 つの Salesforce 組織と Slack の間でインテグレーションタスクを実行できるようになります。

フローでは、GD 本番組織で専用のコンポーザーユーザーを必ず使用してください。フローの実行中は、通常のユーザーを使用して GD 本番組織のデータを操作します。 

次の手順に従ってフローをアクティブ化します。

1. [Sync Accounts - GD Org to NTO Org to Slack (取引先の同期 - GD 組織、NTO 組織、Slack の順)] フローで [Edit (編集)] をクリックします。
2. フローのステップ 1 で、省略記号アイコンをクリックし、[Change Connection (接続を変更)] をクリックします。
3. [Connection (接続)] 選択リストをクリックし、[Add New Salesforce Connection (新しい Salesforce 接続を追加)] をクリックします。
4. 接続に GD production org (GD 本番組織) と名前を付け、[This is a sandbox organization (これは Sandbox 組織です)] チェックボックスはオフのままにして、[Create (作成)] をクリックします。
5. GD 本番組織のユーザー名とパスワードを入力して、[Log In (ログイン)] をクリックします。
6. [Allow (許可)] をクリックし、MuleSoft Composer に権限を付与します。MuleSoft Composer で接続が自動的にテストされます。エラーメッセージが表示されなければ、正常に接続されています。
7. フローのステップ 2 で、この手順のステップ 2 ～ 6 を繰り返して、NTO 本番組織接続を作成します。
8. フローのステップ 3 で、省略記号アイコンをクリックし、[Change Connection (接続を変更)] をクリックします。
9. [Connection (接続)] 選択リストをクリックして、[NTO production org (NTO 本番組織)] を選択し、[Change (変更)] をクリックして [Confirm (確認)] をクリックします。
10. フローのステップ 4 で、この手順のステップ 8 と 9 を繰り返しますが、今回は GD 本番組織接続を選択します。
11. フローのステップ 5 で、省略記号アイコンをクリックし、[Change Connection (接続を変更)] をクリックします。
12. [Connection (接続)] 選択リストをクリックし、[Add New Slack Connection (新規 Slack 接続を追加)] をクリックします。
13. 接続に NTO Slack production (NTO Slack 本番) と名前を付け、[Create (作成)] をクリックします。
14. Slack ワークスペース選択リストから自分の [NTO production (NTO 本番)] ワークスペースを選択します。
15. [Allow (許可)] をクリックし、MuleSoft Composer に権限を付与します。MuleSoft Composer で接続が自動的にテストされます。エラーメッセージが表示されなければ、正常に接続されています。
16. フローのステップ 6 で、この手順のステップ 8 と 9 を繰り返して NTO 本番組織接続に切り替えます。
17. フローのステップ 7 で、この手順のステップ 8 と 9 を繰り返して GD 本番組織接続に切り替えます。
18. フローのステップ 8 で、この手順のステップ 8 と 9 を繰り返して NTO Slack 本番組織接続に切り替えます。
19. フローを保存します。
20. [Activate (アクティブ化)] をクリックします。フローが実行され、新規作成または更新された取引先が 2 つの Salesforce 組織と Slack の間で自動的に同期されます。

フローがアクティブになったところで、次はフローを監視し、問題が発生したらトラブルシューティングする方法を見ていきます。

フローを監視してトラブルシューティングする

フローがアクティブになると、バックグラウンドで継続的に実行されます。MuleSoft Composer は、フローのデプロイ先、その管理方法、パフォーマンスを最適化するために拡張が必要な状況を自動的に判断して処理します。 

フローのランタイムインスタンスにエラーが発生すると、(MuleSoft Composer で Salesforce 組織のメール通知が設定されている場合は) MuleSoft Composer からメール通知が送信されます。そのため、MuleSoft Composer から通知が来ていないか、メールをチェックする必要があります。メール通知設定の詳細は、「MuleSoft Composer のインストールと設定」を参照してください。

通常はメール通知に、エラーが発生しているフロー、合計実行回数のうち失敗した実行回数、レポートの開始時刻と終了時刻が表示されます。こうした情報に応じて、エラーのトラブルシューティングの手順を実行する必要があります。

MuleSoft Composer から [Sync Service Cases with Slack Notifications (サービスケースを Slack 通知と同期)] というフローの 1 つでエラーが発生したことを通知するメールを受信したとします。 

次の手順に従ってフローをトラブルシューティングします。

1. メール通知を開きます。次のように表示されます。
   
2. フロー名のリンクをクリックします。MuleSoft Composer が起動してフローの詳細ページが開き、その実行履歴が表示されます。
   
3. 失敗したインスタンスが 1 つ以上表示されている場合は、[Any Status (任意の状況)] 選択リストから [Status Failed (状況: 失敗)] を選択して、実行履歴を失敗したインスタンスに絞り込みます。以下は [Sync Service Cases with Slack Notifications (サービスケースを Slack 通知と同期)] フローの失敗したインスタンスの例です。
   
4. 失敗したインスタンスの [CLIENT_ERROR] をクリックします。ランタイムエラーメッセージの詳細が表示されます。この例では、Slack チャンネルに無効な値が渡されたため、インスタンスが失敗しています。この問題を解決するには、Slack チャンネルに有効な値を入力します。
   

ライセンスの期限が切れていると MuleSoft Composer にアクセスできません。MuleSoft Composer ライセンスの期限が切れる前に更新してください。

これで終了です! ここでは、2 つの Salesforce 組織と Slack の間で新規作成または更新された取引先を自動的に同期するインテグレーションフローを MuleSoft Composer を使って作成して実行しました。その結果、手作業をなくし、ニアリアルタイムのインテグレーションを実現できました。

まとめ

このモジュールではまず、2 つの Salesforce 組織と Slack の間で新規作成または更新された取引先の同期を維持する場合の課題について学習しました。次に、2 つの Salesforce 組織と Slack の間で新規作成または更新された取引先を同期する MuleSoft Composer ソリューションについて学習しました。最後に、MuleSoft Composer を使用してフロー作成タスク (フローの作成準備、フローの設計とテスト、フローのアクティブ化、フローの監視とトラブルシューティングなど) を実行する方法を学びました。

MuleSoft Composer の使用に関する他の一般的なインテグレーションの問題を解決する手順を確認するには、「MuleSoft Composer」Trailmix の他のモジュールを受講してください。

リソース

• Salesforce ヘルプ: MuleSoft Composer for Salesforce (Salesforce 向け MuleSoft Composer)
• Salesforce ヘルプ: Composer のコネクタリファレンス
• Salesforce Trailblazer Community: MuleSoft Composer for Salesforce