Application Integration でサポートされているコネクタをご覧ください。

統合例を試す

Google Cloud プロジェクトで Application Integration を初めて設定するときに、Application Integration により、デフォルトで ExampleIntegration-EcomOrderProcessing という名前の非公開のサンプル統合が作成されます。

サンプル統合を表示する

サンプル統合を表示するには、次の手順を行います。

1. Google Cloud コンソールで [Application Integration] ページに移動します。

   Application Integration に移動

2. ナビゲーション メニューで [統合] をクリックします。[統合リスト] ページが表示されます。
3. [ExampleIntegration-EcomOrderProcessing] という名前の統合をクリックします。

   サンプル統合が、次のレイアウトのような統合エディタで開きます。

   

e コマースのサンプル統合

このサンプル統合を使用して、Application Integration のさまざまなトリガー、タスク、コンセプトを実際に体験できます。

このサンプル統合は、次の注文処理オペレーションを実装する基本的な e コマース バックエンドのシナリオを示しています。

1. API エンドポイントから次の注文リクエスト ペイロードを受信します。

   {
     "order_no": "12345",
     "buyer_id": "raambo",
     "line_items": [
       {
         "line": 1,
         "sku": "tr100",
         "vendor": "Internal",
         "quantity": 1,
         "price_per_unit": 10
       },
       {
         "line": 2,
         "sku": "tbz",
         "vendor": "External",
         "quantity": 24.0,
         "price_per_unit": 1
       }
     ]
   }
   

2. 注文ペイロードを抽出し、注文の合計金額を計算します。
3. 合計注文金額が $100 以上かどうかを確認します。「はい」の場合は、追加の承認を得て続行します。
4. 注文アイテムに外部ベンダーがあるかどうかを確認します。「はい」の場合、REST API 呼び出しを使用してベンダーに詳細を送信します。
5. 合計注文額、フィルタリングされた外部ベンダーのアイテム、それぞれの HTTP レスポンス ステータスとともに、注文レスポンスを送信します。

次の表に、ExampleIntegration-EcomOrderProcessing で使用されるすべてのトリガー、タスク、エッジ条件を示します。

orders_request.line_items
.FOR_EACH(~obj1->~obj1
  .GET_PROPERTY("quantity")
  .TO_DOUBLE()
  .MULTIPLY(~obj1
    .GET_PROPERTY("price_per_unit")
    .TO_DOUBLE()))
.TO_DOUBLE_ARRAY()
.SUM()

orders_request
.GET_PROPERTY("line_items")
.FILTER(~obj1->~obj1
  .GET_PROPERTY("vendor")
  .TO_STRING()
  .EQUALS("External"))

サンプル統合を公開してテストする

統合を公開するには、統合デザイナー ツールバーの [公開] をクリックします。

統合が正常に公開されると、公開された統合の実行ログを表示、検査できます。ログを表示するには、[View execution logs for this integration] をクリックします。実行ログのページが表示されます。

統合エディタからテストする

サンプルの統合をテストするには、次の手順を行います。

1. 統合エディタ ツールバーの [テスト] をクリックし、[OrderProcessAPITrigger] を選択します。

   [テスト統合] ペインが表示されます。

2. orders_request 入力変数を編集するように求められます。このテストの目的のために、quantity 値を 240 に更新できます。更新した orders_request 入力変数は、次のようになります。

       {
         "order_no": "12345",
         "buyer_id": "raambo",
         "line_items": [
           {
             "line": 1,
             "sku": "tr100",
             "vendor": "Internal",
             "quantity": 1,
             "price_per_unit": 10
           },
           {
             "line": 2,
             "sku": "tbz",
             "vendor": "External",
             "quantity": 240,
             "price_per_unit": 1
           }
         ]
       }
       

3. [Test Integration] をクリックします。

更新された orders_request 数量は 200 より大きいため、サンプルのインテグレーションでは、承認タスクの受信者フィールドに指定されたメールアドレスへ承認リクエスト メールを送信します。承認が完了すると、統合注文オペレーションは正常に完了します。

テストの詳細については、インテグレーションをテストして公開するをご覧ください。

次の手順で実行ログを調べて、特定のインテグレーションのステータスとペイロードを表示します。

1. 統合エディタで、 [View execution logs for this integration] をクリックします。実行ログのページが表示されます。
2. [Execution Logs] ページでは、統合の実行の試行ごとに関する詳細を確認できます。各エントリには、以下のような実行の試行の詳細が含まれます。
   • 統合名
   • 実行 ID
   • ステータス
   • 開始時刻
   • 期間
   • 統合バージョン
   • トリガー ID
3. 実行された統合の横にある展開の矢印（>）をクリックすると、展開された統合のタスクと変数のリストと、タスクのステータスと変数のペイロードが表示されます。

REST API 呼び出しを使用してテストする

テストケース 1: デフォルトの入力を使用してリクエストを送信する

  curl -X POST -H "Content-Type: application/json" -d '{"trigger_id":"api_trigger/ecom-order-processing_API_1"}' 'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME:execute' -H "Authorization: Bearer $(gcloud auth print-access-token)"

テストケース 2: カスタム入力を使用してリクエストを送信する

  curl -X POST -H "Content-Type: application/json" -d '{ "triggerId": "api_trigger/ecom-order-processing_API_1", "inputParameters": { "orders_request": { "jsonValue": "{\n \"order_no\": \"12345\",\n \"buyer_id\": \"raambo\",\n \"line_items\": [{\n \"line\": 1.0,\n \"sku\": \"tr100\",\n \"vendor\": \"Internal\",\n \"quantity\": 1.0,\n \"price_per_unit\": 10.0\n }, {\n \"line\": 2.0,\n \"sku\": \"tbz\",\n \"vendor\": \"External\",\n \"quantity\": 24.0,\n \"price_per_unit\": 2.0\n }]\n}" } } }' 'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME:execute' -H "Authorization: Bearer $(gcloud auth print-access-token)"

次のように置き換えます。

• PROJECT_ID: Google Cloud プロジェクトの ID。
• LOCATION: インテグレーションのロケーション。Application Integration のロケーションをご覧ください。
• INTEGRATION_NAME: インテグレーションの名前。

テスト出力

API は、すべての統合出力変数値を含む統合実行レスポンスを返します。