Fuse Online でのアプリケーションの統合

1. 統合する各アプリケーションへのコネクションを作成します。

2. 最初のコネクションを選択します。これは、別のアプリケーションと共有するデータが含まれるアプリケーションへのコネクションです。

   または、HTTP リクエストを受け入れるタイマーまたは Webhook でインテグレーションを開始できます。

3. 最後のコネクションを選択します。これは、最初のコネクションからデータを受け取ってインテグレーションを完了するアプリケーションへのコネクションです。
4. 最初のコネクションのデータフィールドを最後のコネクションのデータフィールドにマップします。
5. インテグレーションに名前を付けます。
6. Publish をクリックし、インテグレーションの実行を開始します。

手順の概要

1. Fuse Online の OAuth Application Management ページで、Fuse Online を登録するアプリケーションのエントリーを展開します。これにより、クライアント ID およびクライアントシークレットのフィールドが表示されます。
2. OAuth Application Management ページの上部付近に表示されている During registration, enter this callback URL: の URL をクリップボードにコピーします。
3. 別のブラウザータブで、登録するアプリケーションの Web サイトに移動し、クライアント ID とシークレットを取得するのに必要なステップを実行します。これらのステップの 1 つで、Fuse Online 環境のコールバック URL を入力する必要があります。クリップボードにコピーした URL を 2 つ目のステップで貼り付けます。
4. Fuse Online の Settings ページにクライアント ID とクライアントシークレットを貼り付け、設定を保存します。

1. 左側のパネルで Connections をクリックします。
2. 検証するコネクション、または新しいアクセストークンを取得するコネクションをクリックします。
3. コネクションの詳細ページで、Validate または Reconnect をクリックします。

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. ステップの実行に必要な情報のプロンプトに応答します。この情報はカスタムステップごとに異なります。

手順

1. Fuse Online の左ナビゲーションパネルで Integrations をクリックします。
2. 右上の Create Integration をクリックします。
3. Choose a connection ページで API Provider をクリックします。

4. Start integration with an API call ページで以下を行います。

   • REST API オペレーションを定義する OpenAPI 2.0 ドキュメントがある場合は、OpenAPI ドキュメントをアップロードします。
   • OpenAPI 2.0 ドキュメントを定義する必要がある場合は、Create を選択します。

5. Next をクリックします。

   • ドキュメントをアップロードした場合は、これを確認または編集します。

     1. Review/Edit をクリックして Apicurito エディターを開きます。
     2. 必要に応じて確認や編集を行います。
     3. 右上の Save または Cancel をクリックし、エディターを閉じます。
     4. Next をクリックします。

   • ドキュメントを作成する場合は、Fuse Online が開く Apicurito エディターで以下を行います。

     1. OpenAPI ドキュメントを定義します。
     2. 右上の Save をクリックし、エディターを閉じます。
     3. Next をクリックします。

   Apicurito エディターの使用に関する詳細は、「Design and develop an API definition with API Designer」を参照してください。

手順

1. Operations リストページで、編集するフローのオペレーションに対して Create flow をクリックします。

2. このフローに追加する各コネクションに対して以下を行います。

   1. フロービジュアライゼーションで、プラス記号をクリックしてその場所にコネクションを追加します。
   2. 使用するコネクションをクリックします。
   3. コネクションが実行するアクションを選択します。
   4. ラベルが付いたフィールドにデータを入力して、アクションを設定します。
   5. Next をクリックします。

   フローに必要なコネクションをすべて追加してから、続行します。

3. このオペレーションフローでコネクション間のデータを処理するには、以下を行います。

   1. フロービジュアライゼーションで、ステップを追加する場所にあるプラス記号をクリックします。
   2. 追加するステップをクリックします。
   3. ラベル付が付いたフィールドにデータを入力して、ステップを設定します。

   4. Next をクリックします。

      ヘルプは「コネクション間のステップの追加」を参照してください。

   コネクションの間のデータを処理する別のステップを追加する場合は、この手順のサブセットを繰り返します。

4. データを次のコネクションのフィールドにマップします。

   1. フロービジュアライゼーションで、コネクションが受信データを処理できないことを示す、データタイプ不一致の アイコンを確認します。ここでは、データマッパーステップを追加する必要があります。

   2. フロービジュアライゼーションの各データ不一致アイコンに対して以下を行います。

      1. そのステップの直前にあるプラスマークをクリックします。
      2. Data Mapper をクリックします。
      3. 必要なマッピングを定義します。詳細は「インテグレーションデータを次のコネクションのフィールドにマッピング」を参照してください。
      4. Done をクリックして、データマッパーステップをフローに追加します。

5. フロービジュアライゼーションの、Provided API Return Path ステップで Configure をクリックします。

   すべての API プロバイダーインテグレーションは、オペレーションフローの実行をトリガーした REST API の呼び出し元に応答を送信することで、各オペレーションフローを終了します。応答には、ここで設定される戻りコードが含まれます。

   本リリースでは、API 呼び出しによってこのフローの実行がトリガーされる場合は、戻りコードはこのステップで指定されるコードになります。エラー処理は、今後のリリースでサポートされる予定です。

   フローのデフォルトの戻りコードである 501 Not implemented を使用するか、以下のように別の戻りコードを指定します。

   1. Return Code 入力フィールドをクリックすると、可能な戻りコードのリストが表示されます。
   2. 該当の戻りコードまでスクロールし、クリックします。
   3. Next をクリックします。

6. このフローに、必要なコネクションとステップがすべてあり、データの不一致アイコンがない場合や、フローを編集しない場合は、以下の 1 つを行います。

   • Publish: インテグレーションの実行を開始するには、右上の Publish をクリックします。これにより、インテグレーションがビルドされ、REST API サービスが OpenShift にデプロイされます。さらにインテグレーションが実行できるようになります。オペレーションフローの作成を完了するときやオペレーションフローを編集するときに、インテグレーションをパブリッシュできます。
   • Save: オペレーションのリストを表示するには、右上の Save をクリックします。
   • Operation :  別のオペレーションフローを編集するには、ページ上部のパンくずリストで Operation ドロップダウンメニューを表示し、編集するフローのオペレーションをクリックします。Fuse Online は、編集しているフローの現在の状態を保存します。

手順

1. Task API クイックスタートインテグレーションをインポートします。

   1. https://github.com/syndesisio/syndesis-quickstarts/tree/1.6/api-provider にアクセスし、TaskAPI-export.zip をダウンロードします。
   2. Fuse Online の左側のナビゲーションパネルで Integrations をクリックします。
   3. 右上の Import をクリックします。
   4. ダウンロードした TaskAPI-export.zip ファイルをドラッグアンドドロップします。Fuse Online は、ファイルが正常にインポートされたことを示します。
   5. 左側のナビゲーションパネルで Integrations をクリックし、先ほどインポートした Task API インテグレーションのエントリーを表示します。このエントリーは、設定が必要であることを示します。

2. Task API インテグレーションを設定します。

   1. Task API エントリーをクリックして、インテグレーションの概要を表示します。
   2. 右上にある Edit Integration をクリックし、この API が提供するオペレーションのリストを表示します。

   3. Create Task オペレーションのフローで、1 つのステップを更新します。

      1. Task オペレーションの POST エントリーで、Create flow をクリックし、そのフローのビジュアライゼーションを表示します。

         コネクションとステップはすでにこのフローに追加されています。オペレーションフロービジュアライゼーションで、ステップの設定を表示するには、その Configure ボタンをクリックします。Cancel または Next をクリックしてフロービジュアライゼーションに戻ります。1 つのステップの設定を確認したら、別のステップの Configure をクリックし、その設定を確認します。データベースコネクションをクリックすると、実行する SQL ステートメントを確認できます。

      2. オペレーションフロービジュアライゼーションで、フローの最後のステップである Provided API Return Path ステップの Configure をクリックします。スクロールダウンして確認する必要がある場合があります。
      3. Return Code 入力フィールドをクリックし、スクロールして 201 Created を選択します。
      4. Next をクリックします。
      5. 右上の Save をクリックします。

   4. Delete Task for ID オペレーションのフローで、1 つのステップを更新します。

      1. Delete Task for ID オペレーションの Delete エントリーで、Create flow をクリックし、そのフローのビジュアライゼーションを表示します。

         このオペレーションフローには、データマッパーステップと Fuse Online によって提供されるサンプルデータベースへのコネクションがあります。オペレーションフロービジュアライゼーションで、データベースコネクションの Configure をクリックし、実行する SQL ステートメントを表示します。

      2. Next または Cancel をクリックします。
      3. オペレーションフロービジュアライゼーションで、フローの最後のステップである Provided API Return Path ステップの Configure をクリックします。
      4. Return Code 入力フィールドをクリックし、スクロールして 200 OK を選択します。
      5. Next をクリックします。
      6. 右上の Save をクリックします。

   5. Get Task by ID オペレーションのフローで、1 つのステップを更新します。

      1. Get Task by ID オペレーションの GET エントリーで、Create flow をクリックし、そのフローのビジュアライゼーションを表示します。

         このオペレーションフローには、2 つのデータマッパーステップ、Fuse Online によって提供されるサンプルデータベースへのコネクション 1 つ、および 1 つのログステップがあります。

      2. オペレーションフロービジュアライゼーションで、ステップの Configure ボタンをクリックし、その設定を表示します。ステップの設定を確認したら、Next または Cancel をクリックします。この作業を必要なステップすべてに行います。
      3. オペレーションフロービジュアライゼーションで、フローの最後のステップである Provided API Return Path ステップの Configure をクリックします。
      4. Return Code 入力フィールドをクリックし、スクロールして 200 OK を選択します。
      5. Next をクリックします。

3. 右上の Publishをクリックし、Save and publish をクリックします。

   Fuse Online は、このインテグレーションの概要ページを表示し、アセンブル、ビルド、デプロイ、およびインテグレーションの実行中にパブリッシュの進捗を表示します。

4. Task API インテグレーション概要ページに Running が表示されると、Fuse Online は Task API サービスの外部 URL を表示します。以下のような URL が表示されます。

   https://i-task-api-proj319352.6a63.fuse-ignite.openshiftapps.com/api/

   これは、Task API サービスを利用できる場所を示しています。REST API 呼び出しは、このベース URL で始まる URL を指定します。

   Fuse Online を OpenShift Container Platform で使用し、外部 URL がインテグレーションの概要ページにない場合、CONTROLLERS_EXPOSE_VIA3SCALE 環境変数が true に設定されています。この API プロバイダーインテグレーションをテストする場合は、3scale の管理者に協力を依頼してください。

手順

1. Fuse Online の左側のナビゲーションパネルで Integrations をクリックします。
2. Task API インテグレーションをクリックし、その概要を表示します。
3. インテグレーションの外部 URL をコピーします。

4. ターミナルで以下のようなコマンドを実行し、インテグレーションの外部 URL を externalURL 環境変数に割り当てます。必ず、このサンプルコマンドの URL を、コピーした URL に置き換え、末尾に /api を追加するようにしてください。

   export externalURL="https://i-task-api-proj319352.6a63.fuse-ignite.openshiftapps.com/api"`

5. Create Task オペレーションに対してフローの実行をトリガーする curl コマンドを実行します。

   curl -k --header "Content-Type: application/json" --request POST --data '{ "task":"my new task!"}' $externalURL/todo

   • -k を指定すると、サーバーコネクションがセキュアでなくても curl は続行および動作します。
   • --header は、コマンドが JSON 形式のデータを送信することを示します。
   • --request は、データを格納する HTTP POST コマンドを指定します。
   • --data は、保存する JSON 形式のコンテンツを指定します。この例では、クォータは { "task":"my new task!"} です。

   • $externalURL/todo は呼び出す URL です。

     このコマンドは、HTTP POST リクエストを、Create Task オペレーションのフローの実行をトリガーする Task API サービスに送信します。フロー実行により、新しいタスクがサンプルデータベースに追加され、以下のようなメッセージを返して実行された内容を示します。

   {"completed":false,"id":1,"task":"my new task!"}

6. Get Task by ID オペレーションに対してフローの実行をトリガーする curl コマンドを実行します。

   curl -k $externalURL/todo/1

   タスクを取得するには、curl コマンドに URL のみを指定する必要があります。HTTP GET コマンドはデフォルトのリクエストです。URL の最後の部分は、取得するタスクの ID を指定します。

7. Delete Task for ID オペレーションのフローの実行をトリガーする curl コマンドを実行します。

   curl -k -X DELETE $externalURL/todo/1

   このコマンドは、ID でタスクを取得したコマンドと同じ URL で HTTP DELETE コマンドを実行します。

1. GET または POST リクエストを Fuse Online に送信するかどうかを決定します。
2. このリクエストを処理するようインテグレーションを計画します。

3. インテグレーションを終了するコネクションを作成します。

   Fuse Online は、最初のコネクションとして使用する Webhook コネクションを提供します。

4. インテグレーションに追加する他のコネクションを作成します。

5. インテグレーションを作成します。

   1. Webhook コネクションを最初のコネクションとして追加します。

   2. 最後のコネクションを追加した後、インテグレーションで必要な他のコネクションを追加します。最後のコネクションと途中のコネクションは、インテグレーションの実行をトリガーする HTTP リクエストを処理します。目的を達成するために最も適切な HTTP リクエストを選択および指定するのはユーザー自身です。これには以下を考慮してください。

      • 取得または更新するデータが含まれるアプリケーションへのコネクションを追加します。
      • GET リクエストは、キー/値パラメーターの指定に限定されます。
      • POST リクエストは、XML や JSON インスタンスなどの任意のボディーを提供します。
      • Fuse Online は HTTP ステータスヘッダーのみを返し、データは返しません。そのため、GET リクエストによってトリガーされるインテグレーションや、データを取得せずにデータを更新するインテグレーションを定義できます。同様に、POST リクエストによってトリガーされるインテグレーションや、データを更新せずにデータを取得するインテグレーションを定義することもできます。

   3. Webhook コネクションの後にデータマッパーステップを追加します。

      GET リクエストでは、HTTP リクエストのパラメーターフィールドを次のコネクションのデータフィールドにマップします。

      POST リクエストの場合、JSON インスタンス、JSON スキーマ、XML インスタンス、または SML スキーマを渡して、リクエストに出力データシェイプを指定した可能性があります。指定しなかった場合は、Webhook コネクションをインテグレーションの最初のコネクションとして追加します。指定しないと、Webhook コネクションの出力データタイプのデフォルトは JSON 形式になります。

   4. インテグレーションに必要な他のステップを追加します。
6. インテグレーションをパブリッシュし、Running 状態になるまで待ちます。
7. インテグレーション概要ページに移動し、Fuse Online が提供する外部 URL をコピーします。
8. 外部 URL を編集して、GET または POST リクエストを作成します。
9. HTTP GET または POST リクエストを Fuse Online に送信するアプリケーションを実装します。

手順

1. Fuse Online パネルの左側にある Integrations をクリックします。
2. Create Integration をクリックします。
3. Choose a connection ページで Webhook コネクションをクリックします。

4. Choose an action ページで Incoming Webhook アクションを選択します。

   Webhook Configuration ページで、Fuse Online はこのインテグレーションのために生成した Webhook トークンを表示します。

   HTTP リクエストを作成するとき、このトークンは URL の最後の部分になります。このインテグレーションをパブリッシュし、稼働状態になった後、Fuse Online はこのトークンが末尾にある Fuse Online 外部 URL を表示します。

5. Next をクリックします。

6. Specify Output Data Type ページで以下を行います。

   1. Select Type フィールドをクリックし、JSON schema を選択します。
   2. Definition フィールドに、HTTP リクエストでパラメーターのデータタイプを定義する JSON スキーマを貼り付けます。「リクエストパラメーターを指定するための JSON スキーマ」を参照してください。
   3. Data Type Name フィールドに、このデータタイプの名前を指定します。これは任意のフィールドですが、名前を指定すると、データマッパーの Sources リストに表示されるため、フィールドを正しくマップしやすくなります。
   4. 必要に応じて、このデータタイプを区別するための情報を Data Type Description フィールドに入力します。
   5. Next をクリックします。
7. 最後のコネクションをインテグレーションに追加します。
8. 必要な他のコネクションを追加します。
9. 必要な他のステップを追加します。
10. 最初のコネクションの直後に、データマッパーステップを追加します。
11. Publish をクリックし、インテグレーションの名前を付け、必要に応じて説明を追加した後、 Save and publish をクリックします。

手順

1. フロービジュアライゼーションで、 アイコンを見つけます。
2. アイコンをクリックして Data Type Mismatch 通知を確認します。
3. メッセージで Add a data mapping step をクリックし、データマッパーを表示します。

手順

1. Sources パネルで、マップ元となるデータフィールドをクリックします。

   ステップを展開して、提供されるデータフィールドを表示する必要がある場合があります。

   ソースフィールドが多数ある場合は、 をクリックして対象のフィールドを検索し、検索フィールドにデータフィールドの名前を入力します。

2. Target パネルで、マップ先のデータフィールドをクリックします。

   データマッパーは、先ほど選択した 2 つのフィールドを接続する行を表示します。

3. 必要に応じて、データマッピングの結果をプレビューします。これは、マッピングに変換を追加する場合や、マッピングにタイプ変換が必要な場合に便利です。

   1. データマッパーの右上で をクリックし、Show Mapping Preview を選択して、ソースフィールドにテキスト入力フィールドを表示し、ターゲットフィールドに読み取り専用結果フィールドを表示します。
   2. ソースフィールドのデータ入力フィールドにテキストを入力します。
   3. このテキストボックスの外部をどこかクリックし、ターゲットフィールドの読み取り専用フィールドにマッピングの結果を表示します。
   4. 任意で、変換の結果を確認するには、Mapping Details パネルに変換を追加します。
   5. を再度クリックし、Show Mapping Preview を選択して、プレビューフィールドを非表示にします。

4. 任意で、マッピングが定義されていることを確認するには、右上の をクリックし、定義されたマッピングを表示します。

   このビューでデータマッピングの結果をプレビューすることもできます。プレビューフィールドが表示されない場合は、 をクリックし、Show Mapping Preview を選択します。前の手順で説明したデータを入力します。定義されたマッピングの表では、プレビューフィールドは選択したマッピングでのみ表示されます。別のマッピングのプレビューフィールドを表示するには、そのマッピングを表示します。

   を再度クリックし、データフィールドパネルを表示します。

5. 右上の Done をクリックし、データマッパーステップをインテグレーションに追加します。

1. Configure Mapper ページで、右上のプラスマークをクリックし、Mapping Details パネルを表示します。
2. Sources セクションに、ソースフィールドの名前を入力します。
3. Action セクションで、デフォルトの Map アクションを受け入れます。
4. Target セクションで、マップ先のフィールドの名前を入力し、Enter をクリックします。

手順

1. Target パネルで、複数のソースフィールドをマップするフィールドをクリックします。

2. Sources パネルに、ターゲットフィールドにマップするフィールドが含まれるフィールドがある場合は、そのコンテナーフィールドをクリックし、含まれるすべてのフィールドをターゲットフィールドにマップします。

   各ソースフィールドを個別に選択するには、ターゲットフィールドに組み合わせる最初のフィールドをクリックします。ターゲットフィールドに組み合わせる他の各フィールドにマウスオーバーし、CTRL-Mouse1 (MacOS では CMD-Mouse1) を押します。

   作業が完了したら、各ソースフィールドからターゲットフィールドへの線が表示されるはずです。

3. Mapping Details パネルの Separator フィールドで、データマッパーが異なるソースフィールドからのコンテンツの間に挿入する文字を許可または選択します。デフォルトは空白文字です。

4. Mapping Details パネルの Sourcesの下にあるソースフィールドの順番が、複合ターゲットフィールドの対応するコンテンツと同じになるようにしてください。

   必要な場合は、同じ順番になるようにソースフィールドをドラッグアンドドロップします。データマッパーは新しい順番を反映するためにインデックス番号を自動的に更新します。

5. ソースフィールドを複合ターゲットフィールドの各パーツにマップした場合は、次のステップを省略します。

   ターゲットフィールドがマップできないデータを想定する場合、Mapping Details パネルで各ソースフィールドのインデックスを編集し、複合ターゲットフィールドの対応するデータのインデックスと同じになるようにします。データマッパーは、不足しているデータを示すために、必要に応じてパディングフィールドを自動的に追加します。

   誤って余分なパディングフィールドを作成した場合は、余分なパディングフィールドのごみ箱アイコンをクリックして削除します。

6. 必要に応じて、データマッピングの結果をプレビューします。

   1. データマッパーの右上にある をクリックします。Show Mapping Preview を選択して、テキスト入力フィールドを現在選択しているマッピングの各ソースフィールドに表示し、読み取り専用結果フィールドを現在選択しているマッピングのターゲットフィールドに表示します。

   2. ソースデータ入力フィールドにテキストを入力します。テキストボックスの外部をクリックし、ターゲットフィールドの読み取り専用フィールドにマッピングの結果を表示します。

      ソースフィールドの順序を変更したり、マッピングに変換を追加すると、ターゲットフィールドの結果フィールドにこれが反映されます。データマッパーがエラーを検出すると、Mapping Details パネルの上部に情報メッセージが表示されます。

   3. を再度クリックし、Show Mapping Preview を選択して、プレビューフィールドを非表示にします。

      プレビューフィールドを再表示すると、入力したデータはデータマッパーが終了するまでそのまま存在します。

7. マッピングが適切に定義されていることを確認するには、右上の をクリックし、このステップで定義されたマッピングを表示します。複数のソースフィールドの値を 1 つのターゲットフィールドに組み合わせるマッピングは次のようになります。

   このビューでは、マッピングの結果をプレビューすることもできます。 をクリックし、 Show Mapping Preview を選択して、先ほどのステップの説明どおりにテキストを入力します。プレビューフィールドは選択したマッピングのみに表示されます。表の別のマッピングをクリックして、そのプレビューフィールドを表示します。

手順

1. Sources パネルで、分割するコンテンツのあるフィールドをクリックします。
2. Target パネルで、ソースフィールドデータを区切る最初のフィールドをクリックします。

3. Target パネルで、ソースフィールドのデータの一部を含める追加の各ターゲットフィールドにマウスオーバーし、CTRL-Mouse1 (MacOS では CMD-Mouse1) を押して選択します。

   ターゲットフィールドの選択を終了すると、ソースフィールドから各ターゲットフィールドへの線が表示されるはずです。

4. Mapping Details パネルの Separator フィールドで、ソースフィールドの値を区切る場所を示すソースフィールドの文字を許可または選択します。デフォルトは空白文字です。

5. Mapping Details パネルの Targets の下にあるターゲットフィールドの順番が、複合ソースフィールドの対応するコンテンツと同じになるようにしてください。

   必要な場合は、同じ順番になるようにターゲットフィールドをドラッグアンドドロップします。データマッパーは新しい順番を反映するためにインデックス番号を自動的に更新します。

6. 複合ソースフィールドの各パーツをターゲットフィールドにマップした場合は、次のステップを省略します。

   ソースフィールドに、不必要なデータが含まれる場合は、Mapping Details パネルで、各ターゲットフィールドのインデックスを編集して、複合ソースフィールドの対応するデータのインデックスと同じになるようにします。データマッパーは、不要なデータを示すため、必要に応じてパディングフィールドを自動的に追加します。

7. 必要に応じて、データマッピングの結果をプレビューします。

   1. データマッパーの右上で をクリックし、Show Mapping Preview を選択して、ソースフィールドにテキスト入力フィールドを表示し、各ターゲットフィールドに読み取り専用結果フィールドを表示します。

   2. ソースフィールドのデータ入力フィールドにテキストを入力します。フィールドのパーツの間には必ず区切り文字を入力してください。テキストボックスの外部をクリックし、ターゲットフィールドの読み取り専用フィールドにマッピングの結果を表示します。

      ターゲットフィールドの順序を変更したり、ターゲットフィールドに変換を追加すると、ターゲットフィールドの結果フィールドにこれが反映されます。データマッパーがエラーを検出すると、Mapping Details パネルの上部に情報メッセージが表示されます。

   3. を再度クリックし、Show Mapping Preview を選択して、プレビューフィールドを非表示にします。

      プレビューフィールドを再表示すると、入力したデータはデータマッパーが終了するまでそのまま存在します。

8. マッピングが適切に定義されていることを確認するには、 をクリックし、このステップで定義されたマッピングを表示します。ソースフィールドの値を複数のターゲットフィールドに分割するマッピングは次のようになります。

   このビューでは、マッピングの結果をプレビューすることもできます。 をクリックし、 Show Mapping Preview を選択して、先ほどのステップの説明どおりにテキストを入力します。プレビューフィールドは選択したマッピングのみに表示されます。表の別のマッピングをクリックして、そのプレビューフィールドを表示します。

手順

1. フィールドをマップします。これは、1 対 1 のマッピング、組み合わせのマッピング、または分割のマッピングになります。
2. Mapping Details パネルの Sources または Targets にある変換するフィールドのボックスで、ごみ箱を指す矢印をクリックします。データマッパーが実行する変換を選択するフィールドが表示されます。
3. このフィールドをクリックして変換のリストを表示します。
4. 実行する変換をクリックします。
5. 変換に入力パラメーターが必要な場合は、該当する入力フィールドに指定します。
6. 別の変換を追加するには、ごみ箱を指す矢印を再度クリックします。

手順

1. データタイプが表示されない場合は、 をクリックした後、Show Types をクリックして表示します。

   これは、条件を指定するための要件ではありませんが、データタイプを表示すると便利です。

2. 条件を適用するマッピングを作成するか、現在選択しているマッピングが条件を適用するマッピングであることを確認します。たとえば、以下のマッピングについて考えてみましょう。

   

3. 右上の をクリックして条件式入力フィールドを表示します。

   データマッパーは、式フィールドに現在のマッピングにあるソースフィールドの名前を自動的に表示します。以下に例を示します。

   

   式入力フィールドでは、ソースフィールドの順序は、マッピングの作成時に選択した順序になります。これは、データマッパーがこの順序でフィールド値を連結し、結果をターゲットフィールドに挿入するのがデフォルトのマッピング動作であるため、重要になります。この例では、このマッピングの作成では、最初に lastName が選択されてからfirstName が選択されます。

4. 式入力フィールドを編集して、データマッパーがマッピングに適用する条件式を指定します。サポートされる条件式の詳細は、次の手順に従います。

   式を指定する際に、以下を実行できます。

   • @ を入力してフィールドの名前の入力を開始します。データマッパーは入力内容に一致するフィールドのリストを表示します。式に指定するフィールドを選択します。

   • フィールドをマッピングキャンバスから式入力フィールドにドラッグします。

     フィールド名を式に追加するとき、データマッパーはそのフィールドをマッピングに追加します。たとえば、以下の条件式について考えてみましょう。

     

     実行中、データマッパーによって lastName が空であると判断されると、firstname フィールドのみを firstName フィールドのみをターゲット customerName フィールドにマップします。lastName フィールドに値が含まれ、空でない場合、データマッパーはソースの orderIdおよび phone フィールドの値を連結し、結果を customerName フィールドに挿入します。(以下の例は論理の仕組みを示していますが、lastName フィールドに値があるときは、データマッパーと使って単にマッピングを実行し、他の値をターゲットにマップしない可能性が高いため、実践的な例とは言えません。)

     この例では、式の入力後にデータマッピングは次のようになります。

     

   条件式で式が適用されるマッピングにあるフィールド名を削除すると、データマッパーはそのフィールドをマッピングから削除します。つまり、マッピングのすべてのフィールド名は条件式にある必要があります。

5. マッピングプレビューフィールドが表示されていない場合は、 をクリックした後に Show Mapping Preview をクリックして表示します。
6. ソースのプレビュー入力フィールドにサンプルデータを入力して、ターゲットフィールドが正しい値であることを確認します。

7. 必要に応じて、マッピングにある 1 つ以上のソースまたはターゲットフィールドに変換を適用します。

   1. Mapping Details パネルで、変換を適用するフィールドを見つけます。
   2. 下にある Add Transformation をクリックします。
   3. データマッパーが実行する変換をクリックします。
   4. 必要な場合は入力パラメーターを指定します。

   たとえば、この手順と同じマッピングで Mapping Details パネルにて Uppercase 変換を firstName フィールドに適用できます。これをテストするには、firstName フィールドのプレビュー入力フィールドにデータを入力します。

8. 必要に応じて条件式を編集して、目的の結果を取得します。

手順

1. 右上の をクリックします。
2. マッピングのリストを解除し、ソースおよびターゲットフィールドを再表示するには、 を再度クリックします。

手順

1. フロービジュアライゼーションにて、ログステップを追加する場所でプラス記号をクリックします。Fuse Online が最後のコネクションを選択するよう要求する場合は、このステップをスキップします。
2. Log をクリックします。

3. Configure Log Step ページで、ログするコンテンツを選択します。Custom Text を選択した場合、テキスト入力フィールドに以下のいずれかを入力します。

   • ログするテキスト
   • Camel Simple 言語式

   式を入力すると、Fuse Online は式を解決し、生成されたテキストをログに記録します。

4. ログステップ設定が完了したら、Next をクリックしてフローにステップを追加します。

手順

1. インテグレーションを別の環境にコピーする 方法を確認します。
2. 開発環境からインテグレーションをエクスポートします。「インテグレーションのエクスポート」を参照してください。
3. インテグレーションをテスト環境にインポートします。「インテグレーションのインポート」を参照してください。

1. 左側のパネルで Integrations をクリックします。
2. インテグレーションのリストで、実行が停止したインテグレーションのエントリーの右側にある View をクリックします。

3. インテグレーションの概要ページのフロービジュアライゼーションで、再接続するアプリケーションのアイコンをクリックします。

   これが API プロバイダーインテグレーションの場合、インテグレーションの概要ページでそのフローアイコンをクリックし、オペレーションのリストを表示します。次に、パスに障害のあるコネクションが含まれるオペレーションをクリックし、オペレーションのパスビジュアライゼーションで障害のあるコネクションをクリックします。

4. コネクションの詳細ページで、Reconnect をクリックします。

5. アプリケーションの OAuth ワークフローのプロンプトに応答します。

   Fuse Online は、そのアプリケーションへのアクセスが承認されたことを示すメッセージを表示します。アプリケーションによっては、これに数秒かかることがありますが、より長期間かかることもあります。

6. アプリケーションを再接続した後、インテグレーションを起動します。

1. Fuse Online をアプリケーションのクライアントとして再登録します。「承認取得のための一般的な手順」を参照してください。
2. 新しいコネクションを作成します。

3. 古いコネクションを使用していた各インテグレーションを編集します。

   1. 古いコネクションを削除します。
   2. 新しいコネクションに置き換えます。
4. 更新された各インテグレーションをパブリッシュします。

手順

1. Fuse Online パネルの左側にある Integrations をクリックします。
2. インテグレーションのリストで、更新するインテグレーションの View をクリックします。

3. インテグレーションの概要ページで、右上隅の Edit Integration をクリックします。

   これがシンプルなインテグレーションである場合、Fuse Online はインテグレーションのフローを表示します。これが API プロバイダーインテグレーションである場合、Fuse Online はオペレーションリストを表示します。特定のオペレーションのフローを更新するには、オペレーションの右にある Create flow または Edit flow をクリックして、そのフローを表示します。

4. 必要に応じてフローを更新します。

   • ステップを追加するには、フロービジュアライゼーションで、ステップを追加する場所のプラス記号をクリックします。その後、追加するステップを表すカードをクリックします。
   • ステップを削除するには、フロービジュアライゼーションで削除するステップの をクリックします。
   • ステップの設定を変更する場合は、フロービジュアライゼーションで更新するステップの Configure をクリックします。設定ページで、必要に応じてパラメーター設定を更新します。

手順

1. Fuse Online パネルの左側にある Integrations をクリックします。
2. インテグレーションのリストで、開始するインテグレーションのエントリーの右にある をクリックし、Delete を選択します。
3. ポップアップの OK をクリックし、インテグレーションの削除を確認します。