1. Fuse Online の左側のナビゲーションパネルで Integrations をクリックします。
2. Create Integration をクリックします。
3. Choose a connection ページで API Provider カードをクリックします。
4. ダウンロードした task-api.json ファイルの raw バージョンを Upload an OpenAPI file セクションにドラッグします。Fuse Online は、ファイルが正常にインポートされたメッセージを表示します。

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

   注記

   警告メッセージは無視しても問題ありません。

6. Review/Edit をクリックします。

   API Designer で API が開きます。

7. API の構造を確認します。これには、以下のコンポーネントが含まれます。

   • 以下の操作を使用した / パス：

     • GET: 全タスクの一覧を取得します。
     • POST - 新規タスクの作成

   • 以下の 操作を使用した /{id} パス：

     • GET - ID 別にタスクを取得します。
     • PUT: ID でタスクを更新します。
     • DELETE: ID でタスクを削除する

   • 3 つのプロパティーを持つ Task データタイプ。

     • completed （整数,オプション）
     • id （整数。必須）
     • task （文字列,required）

8. この OpenAPI 仕様からインテグレーションを構築するのではなく、時間を節約するには、API Designer を終了して Fuse Online に戻り、「API Provider クイックスタートファイルのダウンロード」 でダウンロードした他のクイックスタートファイル(TaskAPI-export.zip)で提供される事前にビルドされたインテグレーション全体をインポートできるようにします。

   API Designer を終了するには、Cancel を 3 回クリックし、Fuse Online コンソールに戻るまでキャンセルを 確認 します。

手順

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

   1. Fuse Online の左側のナビゲーションパネルで Integrations をクリックします。
   2. 右上の Import をクリックします。
   3. ダウンロードした TaskAPI-export.zip ファイルを Import ページにドラッグします。Fuse Online は、ファイルが正常にインポートされたことを示します。
   4. 左側のナビゲーションパネルで Integrations をクリックし、先ほどインポートした Task API インテグレーションのエントリーを表示します。設定が必要であるとエントリーに表示されますが、このインテグレーションをパブリッシュする準備は整っています。

2. Edit Integration をクリックして、この API が提供するオペレーションのリストを表示します。

   各オペレーションにはフローが定義されます。Fuse Online では、フロー はインテグレーションの各 REST オペレーションに対して実行するコネクションおよびその他のステップを定義します。インポートされたクイックスタートは、各オペレーションの事前定義済みのフローを提供します。

3. 各オペレーションのフローを確認するには、以下を行います。

   1. Edit flow ボタンをクリックし、そのフローのビジュアライゼーションを表示します。

      各フローにはすでに 1 つのデータベースコネクション、1 つ以上のデータマッパーステップ、およびフローを終了する 1 つの Provided API Return Path ステップが存在します。

   2. Invoke SQL ステップでは Configure をクリックし、コネクションが実行する SQL ステートメントを表示します。その後、Cancel をクリックし、オペレーションのビジュアライゼーションフローに戻ります。
   3. データマッパーステップでは、Configure をクリックし、マッピングを表示します。その後、Cancel をクリックしてビジュアライゼーションに戻ります。
   4. 各オペレーションのフローの最終ステップである Provided API Return Path ステップでは、Configure をクリックし、オペレーションによって呼び出し元に送信された可能性がある HTTP リターンコードを表示します。Cancel をクリックしてビジュアライゼーションに戻ります。
   5. オペレーションのフローの確認後、ドロップダウンメニューで Integrations> Task API> Operation の順にクリックし、別のオペレーションを選択します。
   6. この手順を繰り返し、各フローを確認します。
4. 必要に応じて、Save をクリックし、インテグレーションの名前を編集します。

5. 3scale に公開する前に API をテストすることができるように、最初に 3scale の検出を無効にします。

   1. Cancel をクリックし、インテグレーションの編集から終了していることを確認します。
   2. View をクリックして Integration の概要ページを開きます。

   3. Disable Discovery ボタンがある場合は、これをクリックして 3scale の検出を無効にします。ボタンラベルが Enable discovery の場合は、次の手順に進みます。

      注記： 概要ページで Enable Discovery ボタンまたは Disable Discovery ボタンが表示されない場合は、OpenShift 管理者がサービス検出を設定していないことを意味します。

   4. Publish をクリックし、インテグレーションを開始することを確認します。

      インテグレーションの概要ページには、インテグレーションのアセンブル、ビルド、デプロイ、および開始時のパブリッシュの進捗が表示されます。

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

   https://i-task-api-fuseonline.apps.openshift.com/

   この URL は、Task API サービスを Fuse Online で利用可能にします。REST API 呼び出しは、このベース URL で始まる URL を指定します。

手順

1. インテグレーションの外部 URL をコピーします。

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

   export externalURL="https://i-task-api-fuseonline.apps.openshift.com"

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

   curl -k --header "Content-Type: application/json" --request POST --data '{"id":1, "task":"Create an account for new customer"}' $externalURL

   • -k を指定すると、サーバーコネクションがセキュアでなくても curl は続行および動作します。
   • --header は、コマンドが JSON 形式のデータを送信することを示します。
   • --request は、データを格納する HTTP POST コマンドを指定します。
   • --data は、保存する JSON 形式のコンテンツを指定します。この例では、コンテンツは {"id":1、"task":"Create an account for new customer"} です。completed フィールドは必須ではないことに注意してください。
   • $externalURL は呼び出す URL です。

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

   +

   {"completed":null,"id":1,"task":"Create an account for new customer"}

4. 以下の curl コマンドを実行して、2 つのタスクを作成します。

   curl -k --header "Content-Type: application/json" --request POST --data '{"id":2, "task":"Place order for customer"}' $externalURL
   
   curl -k --header "Content-Type: application/json" --request POST --data '{"id":3, "task":"Send confirmation email to customer' $externalURL

5. ID オペレーションによる Fetch task のフローの実行をトリガーする curl コマンドを実行します。

   curl -k $externalURL/1

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

6. Fetch all tasks オペレーションのフローをトリガーする以下の curl コマンドを実行します。

   curl -k $externalURL

7. 必要に応じて、ID オペレーションに対して Delete task のフローの実行をトリガーする curl コマンドを実行します。

   curl -k -X DELETE $externalURL/3

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

8. オプションで、PostgresDB サンプルデータベーステーブルの内容を表示できます。

   1. Fuse Online Pod の一覧を表示して、サンプルデータベース podname を取得します。

      oc get pods

   2. 以下のコマンドを入力します。syndsis-db-1-xxxxx を、サンプルデータベース podname に置き換えます。

      oc rsh syndesis-db-1-xxxxx

   3. サンプルデータベースにアクセスし、todo テーブルを表示します。

      sh-4.2$ psql -Usampledb
      
      sampledb=> select * from todo;

      以下のような結果が表示されるはずです。

      id |           task                      | completed
      ----+------------------------------------+-----------
       3 | Send confirmation email to customer |           |
       2 | Place order for customer            |     1
       1 | Create an account for new customer  |
      (3 rows)

手順

1. Fuse Online API インテグレーションの検出を有効にします。

   1. Fuse Online で Integrations を選択し、Task API インテグレーションの View をクリックします。
   2. インテグレーションの概要ページで Enable Discovery をクリックします。

   3. Publish をクリックし、インテグレーションを開始することを確認します。

      インテグレーションの概要ページには、インテグレーションのアセンブル、ビルド、デプロイ、および開始時のパブリッシュの進捗が表示されます。

   4. Task API インテグレーションの概要ページに Running が表示されるまで待ちます。

2. 3scale で API を検出するには、以下の手順を実施します。

   1. 3scale 管理ポータルにログインします。
   2. 管理ポータルの Dashboard の APIs セクションで、New Product をクリックします。
   3. Import from OpenShift を選択します。
   4. Namespace フィールドで、API が含まれる OpenShift プロジェクト（例： fuseonline ）。
   5. Name フィールドで、その namespace 内の API サービスの名前を選択します（例： i-task-api ）。

   6. 製品の作成 をクリックします。3scale では、プロダクト は顧客がアクセスする API で、内部 バックエンド API も含まれています。

      fuseonline 製品のページが開きます。

手順

1. アプリケーションプランを作成します。

   1. Create application plan をクリックし、Name フィールドで Basic Task Plan を入力します。このクイックスタートの例では、他のフィールドを空白のままにすることができます。
   2. Create application plan をクリックします。
   3. Publish をクリックします。

2. アプリケーションを作成して、アプリケーションプランに関連付けます。

   1. トップメニューから Audience を選択します。
   2. John Doe default ユーザーの Developer をクリックします。
   3. Applications をクリックした後、Create Application をクリックします。
   4. Application Plan フィールドをクリックしてアプリケーションプランのドロップダウン選択一覧を開き、i-task-api の Basic Task Plan をクリックします。
   5. Name フィールドに、Task App などの名前を入力します。

   6. Description フィールドに、Fuse Online Task quickstart application などのテキストを入力します。

      Task App の概要ページが表示されます。これには、後の手順で テスト curl コマンドを実行する際に使用する ユーザーキー 値が含まれます。

3. API サービスのマッピングルールを設定します。

   1. トップメニューから i-task-api を選択します。

   2. Integration で Mapping Rules を選択します。

      注記： 3scale では、インテグレーション は Fuse Online とは異なる意味を持ちます。3scale では、インテグレーション とは、API が 3scale と統合する方法（たとえば、API へのクライアントアクセスを管理および保護）を指します。

   3. マッピングルールを追加します。

      • Add mapping rule をクリックします。
      • Verb （動詞）を選択します（ GET など）。
      • パターン を入力します（例： / または / {id}/）。
      • Create Mapping Rule をクリックします。

   4. ここに示すマッピングルールを定義するまで、サブステップ c を繰り返します。

      

4. i-task-api 製品のステージング環境を更新するには、以下を実行します。

   1. Integration > Configuration の順に選択します。
   2. Promote v.x to Staging APIcast をクリックします。

5. ステージング環境を使用して curl 呼び出しを実行し、API 操作をテストします。この形式の Staging APIcast セクションでは、例が提供されています。

   curl -k "https://fuseonline-i-task-api-3scale-apicast-staging.apps.test.lab.upshift.rdu2.redhat.com:443/{id}/?user_key=4466490a15df83a6b36d2838fb19a030"

   注記： {id} は有効な値に置き換えてください。Fuse Online で API をテストする場合、サンプルデータベースに保存されている 3 つのタスクを作成します。そのため、{id} を 1、2、または 3 に置き換えることができます（3 番目のタスクを削除しなかった場合）。

   以下は、確認できる curl コマンドの例です。

   • コマンドの読み取りを容易にするため、URL と ユーザーキー を保持する変数を作成できます。

     URL とユーザーキーの値は、3scale ステージング環境に固有の値に置き換える必要があることに 注意 してください。

     export threescaleURL=”https://fuseonline-i-task-api-3scale-apicast-staging.apps.test.lab.upshift.rdu2.redhat.com:443”
     
     export KEY=”4466490a15df83a6b36d2838fb19a030"

   • ID 1 でタスクを取得します。

     curl -k GET $threescaleURL/1/?user_key=$KEY

   • ID 1 でタスクを更新します。

     curl -k --header "Content-Type: application/json" --request PUT --data '{"id":1, "task":"Update to task 1 - to do by Friday"}' $threescaleURL/1/?user_key=$KEY

   • 新しいタスクを作成します。

     curl -k --header "Content-Type: application/json" --request POST --data '{"id":4, "task":"Check the staus of the customer order"}' $threescaleURL/?user_key=$KEY

   • すべてのタスクを取得します。

     curl -k $threescaleURL/?user_key=$KEY

   • タスクを削除します。

     curl -k -X DELETE $threescaleURL/4/?user_key=$KEY

6. 3scale が API の対話を追跡する方法を確認するには、Analytics> Traffic をクリックし、手順 3 で定義したマッピングルールに基づいて 3scale が収集したメトリクスを表示します。