第5章 インテグレーションの作成

1. 接続するアプリケーションが OAuth プロトコルを使用するかどうかを判別します。OAuth を使用する各アプリケーションでは、Fuse Online をそのアプリケーションへのアクセスが許可されるクライアントとして登録します。OAuth プロトコルを使用するアプリケーションには以下が含まれます。

   • Dropbox
   • Google アプリケーション (Gmail、カレンダー、およびスプレッドシート)
   • Salesforce
   • SAP Concur
   • Twitter
2. 接続するアプリケーションが HTTP Basic 認証を使用するかどうかを判別します。HTTP Basic 認証を使用する各アプリケーションにアクセスするためのユーザー名およびパスワードを特定します。コネクションを作成する際に、この情報を提供する必要があります。
3. 統合するアプリケーションごとにコネクションを作成します。

手順

1. Fuse Online の左パネルで Integrationsをクリックします。
2. 右上の Create Integration をクリックします。

3. 最初のコネクションを追加および設定します。

   1. Choose a connection ページで、インテグレーションを開始するために使用するコネクションをクリックします。このインテグレーションの稼働時に、Fuse Online はこのアプリケーションに接続し、インテグレーションが操作するデータを取得します。
   2. Choose an action ページで、このコネクションが実行するアクションを選択します。使用できるアクションはコネクションごとに異なります。
   3. アクションを設定するページで、フィールドに値を入力します。
   4. 任意で、コネクションにデータタイプの指定が必要な場合は、Next をクリックしてアクションの出入力タイプを指定するよう要求されます。
   5. Next をクリックして、最初のコネクションを追加します。

   アプリケーションに接続する代わりに、指定した間隔でインテグレーションの実行をトリガーするタイマーや、HTTP リクエストを許可する Webhook を最初のコネクションとすることが可能です。

   最初のコネクションの選択および設定後、Fuse Online は最後のコネクションを選択するよう要求します。

4. 最後のコネクションを選択および設定します。

   1. Choose a connection ページで、インテグレーションを完了するために使用するコネクションをクリックします。このインテグレーションの稼働中に、Fuse Online はインテグレーションが操作するデータでこのアプリケーションに接続します。
   2. Choose an action ページで、このコネクションが実行するアクションを選択します。使用できるアクションはコネクションごとに異なります。
   3. アクションを設定するページで、フィールドに値を入力します。
   4. 任意で、コネクションにデータタイプの指定が必要な場合は、Next をクリックしてアクションの出入力タイプを指定するよう要求されます。
   5. Next をクリックして、最後のコネクションを追加します。

   アプリケーションに接続する代わりに、最後のコネクションはインテグレーションが処理したメッセージに関する情報をインテグレーションのログに送信できます。これには、Fuse Online が最後のコネクションの選択を要求したときに Log を選択します。

5. 必要に応じて、最初のコネクションと最後のコネクションとの間に 1 つ以上のコネクションを追加します。コネクションごとにアクションを選択し、必要な設定詳細を入力します。
6. 必要に応じて、コネクション間のインテグレーションデータで操作する 1 つ以上のステップを追加します。「コネクション間のステップの追加」を参照してください。
7. インテグレーションビジュアライゼーションで、 アイコンを見つけます。この警告は、このコネクションの前にデータマッパーステップが必要なことを示しています。必要なデータマッパーステップを追加します。
8. インテグレーションに必要なステップがすべて含まれている場合は、インテグレーションの実行を開始するかどうかに応じて Save または Publish をクリックします。
9. Name フィールドに、このインテグレーションを別のインテグレーションと区別する名前を入力します。
10. 必要に応じて、: Description フィールドに説明を入力します。たとえば、このインテグレーションが実行することを説明できます。

11. インテグレーションの実行を開始する準備ができたら、Save and publish をクリックします。

    Fuse Online にはインテグレーションの概要が表示されます。Fuse Online がパブリッシュの処理中であることが分かります。インテグレーションの状態が Runningになるまでに多少時間がかかる可能性があります。

    インテグレーションをパブリッシュしない場合は、Save クリックします。Fuse Online はインテグレーションを保存し、フロービジュアライゼーションを表示します。編集を続行できます。または、ページの上部のパンくずリストで Integrations をクリックし、インテグレーションの一覧を表示します。保存してもインテグレーションがパブリッシュされない場合は、Stopped がインテグレーションのエントリーに表示されます。

手順

1. Fuse Online で左側にある Integrations をクリックします。
2. 右上の Create Integration をクリックします。

3. Choose a connection ページで Timer をクリックします。

   Fuse Online は Timer コネクションを提供するため、タイマーコネクションを作成する必要はありません。

4. Choose an action ページで Cron または Simple を選択します。

   • cron タイマーには、インテグレーションの実行をトリガーするスケジュールを指定する cron 式が必要です。
   • 期間とその時間単位の指定を要求されます (例:5 seconds、1 hour)。使用可能な単位はミリ秒 (milliseconds)、秒 (seconds)、分 (minutes)、時間 (hours)、および日 (days) です。
5. 追加するタイマーのタイプに応じて、cron 式または選択した時間単位の期間を入力します。
6. Next をクリックして Timer コネクションをインテグレーションの最初のコネクションとして追加します。

手順

1. インテグレーションビジュアライゼーションの、Conditional Flows ステップを追加する場所で をクリックします。
2. Conditional Flows をクリックします。

3. Configure Conditional Flows ページで、以下の条件を 1 つまたは複数定義します。

   1. 最初の When フィールドに Camel Simple Expression を入力します。たとえば以下の式は、メッセージの本文に 160 を超える pto フィールドが含まれている場合に true に評価します。

      ${body.pto} > 160

      この式が true に評価されると、インテグレーションはこの条件で作成および関連付けする条件付きフローを実行します。

      注記

      条件付きフローステップが以下のようなフローの 1 つにある場合は、式に追加のプロパティーを指定する必要があります。

      • API プロバイダーインテグレーションのオペレーションフロー。
      • Webhook コネクションで始まるシンプルなインテグレーション。
      • カスタム REST API コネクションで始まるシンプルなインテグレーション。

      これらのフローでは、Fuse Online は body プロパティー内で実際のメッセージコンテンツをラッピングします。これは、Conditional Flows ステップへの入力に body プロパティーが含まれ、このプロパティーに実際のメッセージコンテンツが含まれる別の body プロパティーが含まれることを意味します。そのため、このようなフローの 1 つにある条件付きフローステップの式に、body のインスタンスを 2 つを指定する必要があります。たとえば、入力メッセージの pto フィールドにあるコンテンツを評価するとします。この場合、以下のように式を指定します。

      ${body.body.pto} > 160

   2. 必要に応じて、Add another condition をクリックし、前のステップを繰り返します。定義する追加条件ごとに、この作業を行います。
   3. 必要に応じて、条件フィールドの右にある上矢印または下矢印をクリックして、定義された条件をインテグレーションで評価する順序を変更します。

   4. 必要に応じて、デフォルトの条件付きフローとする場合は Use a default flow をクリックします。

      実行中に Use a default flow を選択した場合、指定した条件に true となるものがなければ、インテグレーションはデフォルトの条件付きフローを実行します。実行中に Use a default flow を選択しなかった場合、指定した条件に true となるものがなければ、この Conditional Flows ステップに続くステップで、インテグレーションの実行が継続されます。

   5. Apply をクリックし、定義した条件の一覧を表示します。
   6. Done をクリックして、新しい Flows ナビゲーション制御があるプライマリーフローを上部に表示します。

4. 条件ごとにフローを定義します。

   1. インテグレーションビジュアライゼーションで、フローを定義する条件に対して Open Flow をクリックします。

      Fuse Online は、ページ上部付近にその条件を表示します。条件付きフロービジュアライゼーションは、すべての条件付きフローにある Flow Start ステップおよび Flow End ステップを表示します。

   2. フロービジュアライゼーションの、この条件付きフローにステップを追加する箇所で をクリックします。

   3. 追加するステップをクリックします。プライマリーフローに追加できるコネクションまたはステップを追加できます。

      Flow Start ステップからの出力は、この Conditional Flows ステップの前にあるプライマリーフローステップからの出力と常に同じです。たとえば、フィルターステップまたはデータマッパーステップをこの条件付きフローに追加する場合、利用可能なフィールドはプライマリーフローで利用可能なフィールドと同じになります。

   4. 必要に応じて手順を設定します。
   5. この条件付きフローに追加するステップごとに、前述の 3 つの手順を繰り返します。
   6. ページ上部の Flow フィールドで、下矢印をクリックし、Back to primary flow をクリックします。これにより、条件付きフローが保存され、プライマリーフローが表示されます。
   7. ステップ 4 の最初に戻り、作成する条件付きフローごとにステップ 4 の手順を繰り返します。

手順

1. フロービジュアライゼーションの、データマッパーステップを追加する箇所で をクリックします。
2. Data Mapper をクリックして、データマッパーキャンバスにソースおよびターゲットフィールドを表示します。

手順

1. フロービジュアライゼーションの、フィルターステップを追加する箇所で をクリックします。
2. Basic Filter をクリックします。

3. Configure Basic Filter Step ページの Continue only if incoming data match フィールドで以下を行います。

   • 定義されたすべてのルールを満たす必要があるデフォルトを使用します。
   • あるいは、ANY of the following を選択して、1 つのルールのみを満たす必要があることを示します。

4. フィルタールールを定義します。

   1. The data you want to evaluate: フィルターが評価する内容が含まれるフィールドの名前を入力します。たとえば、ステップに送信されるデータがご自分の Twitter ハンドルをメンションするツイートで構成されるとします。また、ツイートに特定の内容が含まれる場合のみ実行を継続するとします。ツイートは text という名前のフィールドにあるため text を最初のフィールドの値として入力または選択します。

      フィールドの値は以下の方法で定義できます。

      • 入力を開始します。data name フィールドには、ポップアップボックスに補完の候補が表示される自動補完機能があります。ボックスから適切な候補を選択します。
      • フィールドをクリックします。ドロップダウンボックスが表示され、利用可能なフィールドのリストが表示されます。リストから対象のフィールドを選択します。
   2. Must meet this condition: ドロップダウンボックスから条件を選択します。デフォルト設定は Contains です。実行を継続するには、このフィールドで選択する条件が、3 つ目のフィールドに入力する値に対して true である必要があります。
   3. For this value: フィルターする値を入力します。たとえば、Twitter フィードからの特定製品のメンションを操作する場合は、ここに製品名を入力します。

5. 必要に応じて、+ Add another rule クリックして、別のルールを定義します。

   エントリーの横にあるごみ箱アイコンをクリックすると、ルールを削除できます。

6. フィルターステップが完了したら、Done をクリックしてフローに追加します。

手順

1. フロービジュアライゼーションの上級なフィルターステップを追加する場所で をクリックします。
2. Advanced Filter をクリックします。

3. 編集ボックスで Camel Simple Expression 言語を使用してフィルター式を指定します。たとえば、メッセージヘッダーの type フィールドが widget に設定されている場合、以下の式は true に評価されます。

   ${in.header.type} == 'widget'

   以下の例では、メッセージのボディーに title フィールドが含まれる場合に式が true に評価されます。

   ${in.body.title}

4. Next をクリックして、高度なフィルターステップをフローに追加します。

手順

1. フロービジュアライゼーションのテンプレートステップを追加する場所で をクリックします。
2. Template をクリックします。Upload Template ページが開きます。
3. Freemarker、Mustache、または Velocity をテンプレートタイプとして指定します。

4. テンプレートを定義するには、以下のいずれかを行います。

   • テンプレートファイルまたはテンプレートを作成するために編集するテキストが含まれるファイルを、テンプレートエディターにドラグアンドドロップします。
   • browse to upload をクリックしてファイルを選択し、アップロードします。
   • テンプレートエディターで、テンプレートを定義します。
5. テンプレートエディターでは、テンプレートが Fuse Online で使用できるようにしてください。有効なテンプレートの例は、この手順の後に記載されています。Fuse Online では、構文エラーが含まれる行の左側に が表示されます。構文エラーインジケーターにマウスオーバーすると、エラーを解決するためのヒントが表示されます。

6. Done をクリックして、フローにテンプレートステップを追加します。

   Done ボタンが有効でない場合は、修正する必要のある構文エラーが 1 つ以上存在します。

   テンプレートステップへの入力は、JSON オブジェクトの形式である必要があります。そのため、データマッピングステップをテンプレートステップの前に追加する必要があります。

7. テンプレートステップの前にデータマッパーステップを追加するには、以下を行います。

   1. フロービジュアライゼーションで、先ほど追加したテンプレートステップの直前にある をクリックします。
   2. Data Mapper をクリックします。

   3. データマッパーで、ソースフィールドを各テンプレートプレースホルダーフィールドにマップします。

      たとえば、この手順の後に記載されているテンプレート例を使用して、ソースフィールドを以下のテンプレートフィールドにマップします。

      • time
      • name
      • text
   4. 右上の Done をクリックし、データマッパーステップをフローに追加します。

   テンプレートステップからの出力は常に JSON オブジェクトになります。そのため、テンプレートステップの後にデータマッパーステップを追加する必要があります。

8. テンプレートステップの後にデータマッパーステップを追加するには、以下を行います。

   1. フロービジュアライゼーションで、先ほど追加したテンプレートステップの直後にある をクリックします。
   2. Data Mapper をクリックします。
   3. データマッパーで、テンプレートの message フィールドをターゲットフィールドにマップします。message フィールドには常にソースフィールドをテンプレートに挿入した結果が含まれます。たとえば、フローの次のコネクションが Gmail コネクションで、テンプレートステップの結果を Gmail メッセージの内容として送信するとします。これには、message ソースフィールドを text ターゲットフィールドにマップします。
   4. 右上の Done をクリックします。

手順

1. フロービジュアライゼーションのカスタムステップを追加する場所で をクリックします。

2. 追加するカスタムステップをクリックします。

   使用できるステップには、Fuse Online 環境にアップロードされたエクステンションで定義されたカスタムステップが含まれます。

3. ステップの実行に必要な情報のプロンプトに応答します。この情報はカスタムステップごとに異なります。