Coupa「取得」アクティビティーの使用

Coupa インスタンスでオブジェクトを取得するには、Coupa「取得」アクティビティーを使用します。

Coupa インスタンスで ID に基づいてすべてのオブジェクトを取得するには、このタスクを使用します。このアクティビティーの呼び出しは、同期呼び出しです。同期呼び出しでは、入力データが処理のためにアクティビティーに送信され、オーケストレーションに応答が返信されます。

  1. アクティブなオーケストレーションで、「アクティビティー」タブを開いて Coupa フォルダーのコンテンツを展開します。
  2. 取得」アクティビティー・アイコンをオーケストレーション上にドラッグします。Coupa オブジェクトの取得「チェックリスト」が表示されます。
  3. チェックリスト」で、「要約」をクリックします。
  4. アクティビティー名」フィールドの内容を確認して、必要な変更を行います。
  5. チェックリスト」で、「エンドポイントの選出」をクリックします。
  6. 参照」をクリックし、「プロジェクト・エクスプローラー」ダイアログ・ボックスを使用して、関連する Coupa エンドポイントを選択します。
  7. オプション: 「新規作成」をクリックして必要な接続の詳細を指定することで、エンドポイントを作成することができます。この構成のエンドポイントを保存して使用するには、「OK」をクリックします。
  8. 選択したエンドポイントの構成に対して必要な変更を行うには、「編集」をクリックして、別のウィンドウでオプションにアクセスします。 変更を行うと、アクティブなオーケストレーションにおけるエンドポイントのすべての使用に、グローバルに影響します。
  9. チェックリスト」で、「構成」をクリックします。
  10. 参照」をクリックして、オブジェクト・タイプを選択します。 「Coupa の参照 (Browse Coupa)」ウィンドウが表示されます。
  11. 「Coupa の参照 (Browse Coupa)」で、「オブジェクト・タイプの検索」フィールドでオブジェクト・タイプを指定してオブジェクト・タイプをフィルタリングするか、オブジェクト・タイプ・リストからオブジェクト・タイプを選択します。「OK」をクリックします。オブジェクト・フィールドの設定が表示されます。
  12. オブジェクト・フィールド設定」で、マップするフィールドのフィールド名のチェック・ボックスを選択します。
  13. チェックリスト」で、「再試行」をクリックします。 デフォルト設定を確認して、必要な変更を行います。
  14. チェックリスト」から「入力のマップ」を選択します。 「オブジェクトの取得」アクティビティーの選択したオブジェクトから生成された XML スキーマが、「アクティビティーへ」パネルの request 入力パラメーターの下にノードとして表示されます。
  15. オーケストレーション変数とアクティビティーの入力パラメーターとの間のマップを作成します。
注: 入力構造の必須エレメントの値は、実行時に指定されている必要があります。 この値は、エレメントのデフォルト値を指定するか、エレメントを入力ノードにリンクすることによって指定できます。 実行時に必須エレメントの値が指定されていないと、アクティビティーは Web 管理コンソールから報告された例外をスローします。 実行時にオプションの入力パラメーターの値が指定されていなくても、実行時に例外はスローされません。
  1. チェックリスト」から「出力のマップ」を選択します。 アクティビティーの応答保持のために生成された XML スキーマが、「アクティビティーから」パネルの response 出力パラメーターの下にノードとして表示されます。
  2. 出力パラメーターとオーケストレーション変数との間のマップを作成します。

表: 入力のマップ・パラメーター

フィールド名 説明
retrieveAll ユーザーが特定のオブジェクト・タイプのすべてのレコードをフェッチする場合は、 このパラメーターを true に設定する必要があります。デフォルト値は false です。id の値が指定されている場合、パラメーターは無視されます。
limit retrieveAlltrue の場合にみ適用されます。パラメーターは結果のページ編集に使用されます。これは、取得するレコード数を、指定された値に制限します。limit 値に 50 を超える値が指定された場合でも、一度に返される結果の最大数は 50 です。
offset retrieveAlltrue の場合にみ適用されます。パラメーターは結果のページ編集に使用されます。レコードは、指定されたオフセットから取得が開始されます。
id 取得対象データのオブジェクト ID。このパラメーターは retrieveAll よりも優先されます。id が指定された場合、retrieveAll の値は無視されます。
supplier-id 関連するサプライヤー ID。RemitToAddress オブジェクトに対してのみ適用できます。

Coupa「オブジェクトの取得」アクティビティーを構成しました。

注: このアクティビティーへの入力として、複数のオブジェクトを追加することができます。 入力として複数のオブジェクトを追加するには、「入力のマップ」「アクティビティーへ」ペインで、オブジェクトの ID フィールドを右クリックし、「オカレンスの展開」を選択します。