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 インスタンスで統合を実行します。

手順

  1. Control Room にログインします。
  2. 新しい Bot を作成します。詳しくは、「初めての Bot を作成する」を参照してください。
  3. [アクション] ペインから [Apigee] > [統合を実行] を選択し、Bot フローの [開始] の下に配置します。
  4. [構成する統合を検出] をクリックします。[ステップ 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 に格納します。
  5. [接続] をクリックします。
    資格情報が正しければ、GCloud に接続され、[ステップ 2/4: 統合のロード] 画面が表示されます。
  6. [ステップ 2/4: 統合のロード] 画面で以下を選択します。
    1. [プロジェクト ID] ドロップダウンをクリックし、統合をロードするプロジェクト ID を選択します。
    2. [場所] ドロップダウンをクリックし、統合をロードする場所を選択します。
      Apigee の統合のロード: ステップ 2/4
  7. [次へ] をクリックします。
    [ステップ 3/4: 統合の選択] 画面が表示され、利用可能なすべての統合が表示されます。
  8. リストから統合を選択します。
    Apigee の統合の選択: ステップ 3/4
  9. [次へ] をクリックします。
    [ステップ 4/4: 統合の構成] 画面が表示され、すべての構成オプションが表示されます。
  10. [ステップ 4/4: 統合の構成] 画面で、[API トリガー] ドロップダウンをクリックし、呼び出すトリガーを選択します。
    Apigee の統合の構成: ステップ 4/4
    入力パラメーターは、Apigee から取得したパラメーターです。
  11. [完了] をクリックします。
    選択したすべてのオプションが、[Apigee: 統合を実行] アクションのパラメーターとして表示されます。
  12. [新しい入力パラメーターを追加] をクリックし、入力パラメーターを手動で追加します。次の表で指定されているように、異なるパラメーター タイプに対してパラメーター値を指定することができます。
    パラメータータイプ パラメーター値
    文字列 変数として格納されている文字列値を指定します。 $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]
    - - (手動入力) 上記のフォーマットから任意の値を指定します。
  13. [マイ設定を検証] をクリックして、指定したすべてのパラメーターを検証することをお勧めします。値が正しくない場合、[統合検証] ウィンドウに詳細が表示されます。
    Apigee の統合の実行
  14. [デフォルト] をセッション名として入力します。
  15. 実行 ID を変数に格納し、Apigee で検証することができます。次に例を示します。ExecutionId
  16. Apigee 統合からの応答を確認するために、応答を変数に格納することができます。次に例を示します。Execution
    Apigee の統合の実行
    注: 出力は、ディクショナリ型のリストとして取得されます。 このリストの個々のレコード (行) を読み取るには、ループ アクションを使用してすべてのディクショナリ項目をループし、レコード (行) を個別に読み取るか抽出する必要があります。 たとえば、[複数のレコードを取得] の出力は、変数 list_of_records_any に保存されます。 変数に 5 つのレコードが含まれている場合、各レコードは Loop アクションに渡され、一度に 1 つずつ処理されます。複数のレコードを取得するループ アクション