ゼロからイベント駆動フローを作成する

イベント駆動型フローでは、1つまたは複数のターゲットアプリケーションでアクションを完了するフローをトリガーするソースアプリケーションのイベントを特定します。

このタスクについて

イベントドリブン・フローを作成するには、まず、フローのトリガーとなるイベントを指定する。 そのイベントは、アプリケーションで発生するものかもしれないし、スケジュールでフローを開始することにするかもしれない。 次に、1つまたは複数のターゲットアプリケーションで完了するアクションを追加します。 また、フロー内のアプリケーションからの入力または出力データを処理するツールボックスユーティリティを追加することもできます。 イベント・ドリブン・フローには、以下の制限と動作が適用される。

• 1つのフローに追加できるアクションは最大10個です。
• アクションはフローに示された順序で完了する。
• アクションの1つが失敗した場合、フロー内の次のアクションは完了しないが、以前のアクションは逆転しない。

ヒント： 統合エージェントにフローを作成してもらうこともできます。 エージェントを開くには、統合エージェントアイコン をクリックし、シナリオを記述します。 エージェントは必要な情報を尋ね、アプリケーションへの接続とデータのマッピングを促します。 エージェントは、ツールボックスから If、 For each、 Log ノードを追加することもできますが、 If ノードのフィルタは自動的に入力されません。 エディターでフローを開いていて、さらにアクションをリクエストすると、そのアクションは開いているフローに追加されます。 エージェントを使用して別のフローを作成する場合は、まず既存のフローを閉じてください。

イベントドリブン・フローを作成するには、以下の手順を実行する。

1. App Connect Designer ホームページで、 イベントドリブン フローの作成をクリックします。
   または、 [デザイン] ページから 、 [作成 ] > [イベント駆動フロー] をクリックします。
   フローエディターが開きます。
2. フローの目的を示す名前を入力してください。
   

   フローを進めると App Connect が自動的に変更を保存します。 フローから離れると、フローは下書きとして保存され、別の機会に完成させることができます。

3. フローをトリガーするイベントを追加する。
   ソース・アプリケーションからストリーム・イベントを受信するか、アプリケーションにイベントをポーリングするか、アプリケーションからイベントのスケジュールを構成するかを選択できます。
   • ソース・アプリケーションからイベントをストリームするには、[ アプリケーションとAPI ]タブでアプリケーションをクリックし、イベントをストリームしたいオブジェクトとイベント・タイプをクリックします。 たとえば、参加者が Eventbrite でイベントにサインアップするたびにイベント通知を App Connect に送信するには、 Eventbrite をクリックし、次に [参加者] と [新しい参加者] をクリックします。
     アカウントリストで正しいアカウントが選択されていることを確認してください。

     
     イベントノードがフローに追加される。

     

     アプリケーションの中には、イベント通知をフローに送信するために、WebhookコールバックURLを使用するものがあります。 Eventbriteのように、コールバック URL がアプリケーションに自動的に登録されるアプリケーションもあれば、 URL を手動で登録しなければならないアプリケーションもある。 詳細については、 WebhookコールバックURLを参照してください。

   • 新規または更新されたオブジェクトについてソース・アプリケーションをポーリングするには、 [Applications and APIs ]タブでアプリケーションをクリックし、[ Configure more events ]をクリックします。 設定するイベントの選択 パネルで、監視するオブジェクトをクリックし、イベントのタイプをクリックします。 たとえば、 Salesforce で新しいアカウントが作成されるたびにフローをトリガーするには、 Salesforce > Configure more events をクリックし、 Accounts and New accounts をクリックします。
     
     イベントノードがフローに追加される。 アカウントリストで正しいアカウントが選択されていることを確認し、ポーリング間隔を設定する。 詳細については、 フローをトリガーするポーリング・イベントの設定を参照のこと。

     
   • 一定間隔または特定の日時にフローを実行するように設定するには、 「ツールボックス」 タブを開き、「 スケジューラ 」をクリックします。
     

     Schedulerノードがフローに追加される。 フローが実行されるスケジュールを定義する。 詳細については、 スケジュールされた時間にフローが実行されるように設定するを参照してください。

     この例では、フローが最初に開始されたときにトリガーされるようにスケジュールが定義され、その後、1時間単位で毎日トリガーされる。

     
4. 最初のアクションをフローに追加するには、 Add node (+)をクリックし、アプリケーションと適切なアクションを選択します。
   ターゲット・アプリケーションに正しいアカウントが選択されていることを確認する。 アカウントが接続されていない場合は、アカウントを追加することができます。 詳細については、 アカウントへの接続を参照してください。
5. アクションのフィールドに、ターゲットアプリケーションに渡したい値を入力する。 プレーンテキストで静的データを指定することも、フロー内の前のノードからのマッピングを追加して動的データを指定することもできる。 また、関数 （JSONata式 ）を適用してデータを変換したり、他の組み込みメカニズムを使用してカスタム値を定義することもできます。
   • テキスト、マッピング、JSONata式をフィールドに手動で入力したり、独自のカスタム値を定義するには、 アクションの設定を参照してください。
   • アクションのフィールドに、提案されたスマートマッピングを自動的に入力するには、マッピングアシストを使用します。 詳しくは、 AIによる提案でデータマッピングとデータ変換を簡素化するをご覧ください。

   サンプルデータを使って、マッピングを追加しながらテストすることができます。 詳細については、 サンプルデータを使ったマッピングのテストを参照してください。

   次の例では、 Salesforce リード取得アクションを使用して、フローが最後にトリガーされてから Salesforce で作成された新規リードの詳細を取得しています。 この動作を定義するには、 「Add condition 」をクリックし、最初の2つのフィールドから「 Created date 」と「 is greater than 」を選択する。 次に3番目のフィールドをクリックし、「 Insert a mapping 」をクリックして「 Available mappings 」リストを開く。 リストから、 Previous event time を選択します。これは、前回のスケジュールがトリガーされた時刻を表します。 また、取得するアイテムの最大数やエラー条件を設定することもできます。

   

   ヒントアクションのフィールドを完成させた後、自動生成またはカスタムサンプルデータを使用して、アクションをテストし、その効果を確認することができます。 アクションは、あなたが接続しているターゲット・アプリケーション上で完了するので、アクションをテストするために本番環境でないアカウントを使用していることを確認してください。 詳細については、 サンプルデータを使ったアクションのテストを参照してください。
6. オプション： 対象アプリケーションとアクションを追加する。
7. オプション： 1つ以上のツールボックスユーティリティを使用して、特殊な処理を行う。
   例えば、 If ノードを追加して条件処理を提供したり、 For each ノードを追加して検索された項目を処理したりする。 詳細については、 フローに特殊処理を追加する（Toolboxユーティリティ ）を参照してください。

   この例では、 For each ノードを使用して、検索された Salesforce レコードをループし、Insightly で対応するリードレコードを作成しています。 (+)をクリックし、 ツールボックスタブに移動し、 For eachをクリックして、処理するアイテムのコレクションと処理オプションを選択する。

   

   次に、[ For each node]で[ Add node] （+）をクリックし、[ Applications] タブで[ Insightly ]>[ Leads ]>[ Create leads ]をクリックします。 Insert a mapping をクリックすると、 Salesforce ノードから処理された出力を表すマッピングが個々のフィールドに入力されます。

   

   提案されたマッピングのプレビューをマッチするフィールドに挿入します。 プレビュー・マッピングを調べて要件に適していることを確認し、「 Apply 15 suggestions 」をクリックしてフィールドに入力する。

   
8. オプション： イベントドリブンフローのエラーを処理するために、エラーキャッチフローを追加することができます。
   詳細については、 イベント駆動型フローまたはAPIフローでエラーを処理するためのcatchフローの設定を参照してください。
9. フローをテストまたはデプロイする前に、フローの検証エラーを修正してください。
   詳細は、 フローの検証を参照。