Apigee の統合の実行
- 最終更新日2023/04/05
Apigee の統合の実行
Apigee の [統合を実行] アクションを使用して、Apigee で統合を構成し、実行できます。
前提条件
- GCP アカウント (GCP Cloud) を作成し、GCloud プロジェクトを作成します。
- Google Cloud プロジェクトで GCloud アカウントにログインし、プロジェクトを作成します。すでにプロジェクトにアクセスできる場合は、ここに自分のプロジェクトが表示されます。
- OAuth 2.0 クライアント ID を作成します。クライアント ID は、Google の OAuth サーバーに対して 1 つのアプリケーションを識別するために使用されます。詳細については、「GCP Create access credentials」を参照してください。
[Apigee 実行] アクションを使用して、Automation 360 から Apigee インスタンスで統合を実行します。
手順
- Control Room にログインします。
- 新しい Bot を作成します。詳しくは、「初めての Bot を作成する」を参照してください。
- [アクション] ペインから [Apigee] > [統合を実行] を選択し、Bot フローの [開始] の下に配置します。
-
[構成する統合を検出] をクリックします。[ステップ 1/4: Apigee X への接続] が表示されます。[認証タイプ] のドロップダウンで、認証方法を選択します。詳細については、「Apigee の接続」を参照してください。
- ユーザー アカウント: この接続方法を使用するには、GCloud アカウントの資格情報を入力します。
- サービス アカウント: この接続方法を使用するには、GCloud サービス アカウント キーを指定します。下記の JSON 形式では、サービス アカウント キーを追加する必要があります。JSON スニペット全体を Credential Vault に保存し、接続時に、保存された資格情報を選択することを推奨します。
{ "type": "service_account", "project_id": "your_project_id", "private_key_id": "your_private_key_id", "private_key": "-----BEGIN PRIVATE KEY-----\your_private_key-----END PRIVATE KEY-----\n", "client_email": "your_client_email", "client_id": "your_client_id", "auth_uri": "https://accounts.google.com/o/oauth2/auth", "token_uri": "https://oauth2.googleapis.com/token", "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs", "client_x509_cert_url": "your_client_certificate_url" }
- Control Room OAuth 接続: この接続方法を使用するには、OAuth 接続を作成し、それを Control Room に格納します。
-
[接続] をクリックします。
資格情報が正しければ、GCloud に接続され、[ステップ 2/4: 統合のロード] 画面が表示されます。
-
[ステップ 2/4: 統合のロード] 画面で以下を選択します。
- [プロジェクト ID] ドロップダウンをクリックし、統合をロードするプロジェクト ID を選択します。
-
[場所] ドロップダウンをクリックし、統合をロードする場所を選択します。
-
[次へ] をクリックします。
[ステップ 3/4: 統合の選択] 画面が表示され、利用可能なすべての統合が表示されます。
-
リストから統合を選択します。
-
[次へ] をクリックします。
[ステップ 4/4: 統合の構成] 画面が表示され、すべての構成オプションが表示されます。
-
[ステップ 4/4: 統合の構成] 画面で、[API トリガー] ドロップダウンをクリックし、呼び出すトリガーを選択します。
入力パラメーターは、Apigee から取得したパラメーターです。 -
[完了] をクリックします。
選択したすべてのオプションが、[Apigee: 統合を実行] アクションのパラメーターとして表示されます。
-
[新しい入力パラメーターを追加] をクリックし、入力パラメーターを手動で追加します。次の表で指定されているように、異なるパラメーター タイプに対してパラメーター値を指定することができます。
パラメータータイプ パラメーター値 例 文字列 変数として格納されている文字列値を指定します。 $str_INString$ Integer 番号を指定します。 9 二重下線 10 進数で指定します。 20.5 JSON JSON 文字列を指定します。 $str_JSONString$ 文字列配列 配列内に文字列の値を指定します。 [a,b,c] 整数配列 配列内に整数を指定します。 [11,22,334] ダブル配列 配列内に整数や 10 進数を指定します。 [23.5,27,44.5] Boolean ブール値を True または False で指定します。 真 ブール配列 配列内にブール値を指定します。 [true,false] - - (手動入力) 上記のフォーマットから任意の値を指定します。 -
[マイ設定を検証] をクリックして、指定したすべてのパラメーターを検証することをお勧めします。値が正しくない場合、[統合検証] ウィンドウに詳細が表示されます。
- [デフォルト] をセッション名として入力します。
- 実行 ID を変数に格納し、Apigee で検証することができます。次に例を示します。ExecutionId。
-
Apigee 統合からの応答を確認するために、応答を変数に格納することができます。次に例を示します。Execution。
注: 出力は、ディクショナリ型のリストとして取得されます。 このリストの個々のレコード (行) を読み取るには、ループ アクションを使用してすべてのディクショナリ項目をループし、レコード (行) を個別に読み取るか抽出する必要があります。 たとえば、[複数のレコードを取得] の出力は、変数 list_of_records_any に保存されます。 変数に 5 つのレコードが含まれている場合、各レコードは Loop アクションに渡され、一度に 1 つずつ処理されます。