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

学習の目的

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

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

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

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

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

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

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

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

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

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

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

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

MuleSoft Composer から [Sync Salesforce Contacts to Square Customers (Salesforce の取引先責任者を Square の顧客に同期)] フローでエラーが発生したことを通知するメールを受信したとします。

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

1. メール通知を開きます。次のように表示されます。
   
2. フロー名のリンクをクリックします。MuleSoft Composer が起動して、フローの詳細ページが開き、その実行履歴が表示されます。
   
3. 失敗したインスタンスが 1 つ以上表示されている場合は、[Any Status (任意の状況)] 選択リストから [Status Failed (状況: 失敗)] を選択して、実行履歴を失敗したインスタンスに絞り込みます。フローの失敗したインスタンスの例を次に示します。
   
4. 失敗したインスタンスで [ANY (任意)] をクリックします。ランタイムエラーメッセージの詳細が表示されます。この例では、HTTP POST メソッドが Square API を使用して顧客を作成できなかったためにインスタンスが失敗しています。具体的には、Salesforce で取引先責任者の国として「United States」が入力されていましたが、Square API でこれが許容されませんでした。Square API では国は ISO 3166 の 2 文字形式である必要があります。この問題を解決するには、「United States」の代わりに「US」と入力します。
   

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

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

まとめ

このモジュールでは、最初に Salesforce で新規作成または更新された取引先責任者を Square の顧客と常に同期させるという課題を検討しました。次に、Salesforce で新規作成または更新された取引先責任者を Square の顧客と同期させる MuleSoft Composer ソリューションについて学習しました。最後に、MuleSoft Composer を使用してフロー作成タスク (フローの作成準備、フローの設計とテスト、フローのアクティブ化、フローの監視とトラブルシューティングなど) を実行する方法を学びました。

さらに発展させる

NTO の従業員が Slack を使用してコミュニケーションやコラボレーションを行う場合は、このモジュールで説明したフローを拡張します。具体的には、最初の If/Else ブロックのステップ 4 の後と、2 番目の If/Else ブロックのステップ 6 の後に 2 つのアクションステップを作成して設定します。これらのステップでは、Slack に接続し、取引先責任者とそれに対応する顧客が Salesforce と Square でそれぞれ作成または更新されたことを適切なチャンネルに通知します。フローで Slack を使用する方法については、「MuleSoft Composer を使用した Slack オートメーション」を参照してください。

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

リソース

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