エンドポイントの動的な起動

実行時に、追加の起動接続やRESTのアウトバウンド詳細を構成せずに、RESTのエンドポイント/URLを動的に起動できます。 Oracle ERP Cloud REST APIsがHATEOSリンクを含むレスポンスを返すかぎり、この機能を使用するには、HATEOSリンクを起動接続にマップします。この機能は、RESTエンドポイントを動的に起動する必要がある場合や、設計時にエンドポイントが不明な場合に便利です。この機能は、複数のRESTサービスを起動する必要がある場合にも役立ち、そのすべてが同じ入力ペイロードを受け入れ、アウトバウンド・エンドポイントに対して構成されているのと同じレスポンス・ペイロードを返します。このような場合、この機能によって、RESTエンドポイントを起動するために複数の接続を作成する必要がなくなります。

ノート:

次の制約に注意してください

リクエスト・スキーマとレスポンス・スキーマは、エンドポイントの構成中に指定したスキーマと同じである必要があります。
テンプレート・パラメータはこれらのプロパティのマッピング中はサポートされていません。
エンドポイントURLのHTTP動詞は変更できません。たとえば、エンドポイントがPOSTを使用するように構成されている場合、送信リクエストは、エンドポイントURIが実行時に変更されてもPOSTを使用します。
エンドポイントURLは実行時に決定されるため、接続構成中に指定されたセキュリティ資格証明が新しいエンドポイントURLでも動作するかどうかをテストする機能はありません。実行時にエンドポイントURLが異なる認可ヘッダーを必要としていると考えると、元のURLは、認可標準ヘッダーのマッピングを指定する必要がある場合があります。

このユースケースでは、動的エンドポイントを使用する統合を設計する1つの方法について、高レベルな概要を説明します。子オブジェクトを取得するには、REST APIを使用します(たとえば、第1アドレスはアカウント親オブジェクトの子オブジェクトです)。統合は次のように設計されます。

初期起動は、REST APIを使用してアカウント・オブジェクトを取得するように構成されます。このREST APIのレスポンスでは、子オブジェクトは提供されません。かわりに、子オブジェクト(つまり、第1アドレス・オブジェクト)へのHATEOSリンクがあります。
2番目の起動では、前述のレスポンスからHATEOSリンクを使用して、RESTエンドポイントへの別の起動接続を作成し、動的RESTエンドポイントのサポートを使用して子Primary Addressオブジェクトをフェッチします。

実行時にエンドポイントの構成を変更するには、ConnectivityPropertiesターゲット要素で1つ以上の様々なプロパティをマップします。

オーケストレーションされた統合を作成します。
アダプタを統合キャンバスにトリガー接続としてドラッグします(任意のアダプタの場合もあります)。
アダプタ・エンドポイント構成ウィザードでアダプタを構成してください。
初期「Oracle ERP Cloudアダプタ」を統合キャンバスに起動接続としてドラッグします。
crmRestAppサービス・アプリケーション、アカウントオブジェクト(ビジネス・リソース)、およびget操作を使用するように構成します。

最初の起動接続のレスポンスには、HATEOSリンクのコレクションが含まれており、それぞれが「第1アドレス」などの子オブジェクトを指しています。
トリガー・アダプタ接続と「Oracle ERP Cloudアダプタ」接続の起動の間のマッパーで、ソース要素をターゲット要素にマッピングします。この例では、PartyNumberソース要素がidターゲット要素に渡されます。

「図mapper1.pngの説明」
for-eachアクションを追加して、HATEOSリンク間で反復します。「繰返し要素」フィールドの値はレスポンス・オブジェクトから取得されます。

「図for_each.pngの説明」
スイッチ・アクションを追加して、「第1アドレス」オブジェクトに対応するHATEOSリンクを取得します。

「図switch.pngの説明」
「Oracle ERP Cloudアダプタ」をスイッチ・アクションに2番目の起動接続としてドラッグします。
crmRestAppサービス・アプリケーション、「第1アドレス」オブジェクト(ビジネス・リソース)およびgetAll操作を使用するように構成します。このオブジェクトは動的RESTエンドポイントのサポートを使用します。「第1アドレス」はリンクのコレクションです。すべてのHATEOSリンクを取得するために、getAll操作が選択されています。
2番目の「Oracle ERP Cloudアダプタ」起動接続の直前のマッパーで、ターゲット・セクションのConnectivityPropertiesの下のRestApiを展開します。
ソース・セクションから、hrefをConnectivityPropertiesの下のAbsoluteEndpointURIにマップします。 ConnectivityPropertiesスキーマ要素は、動的RESTエンドポイントをサポートします。 href要素は、「第1アドレス」オブジェクト・リンクを指します。 href要素は「Oracle ERP Cloudアダプタ」によって起動されます。

「図dynamic_mapping.pngの説明」

必要に応じて、ConnectivityPropertiesの下にある他のノードをマッピングします。これらのマッピングにより提供されるランタイム値によって、リクエストが動的に構成されます。

これらのプロパティにカーソルを合わせると、簡単な説明が表示されます。

要素	説明
AbsoluteEndpointURI	RESTアダプタが起動する絶対エンドポイントURLを表します。空の値は無視されます。実行時に決定されたエンドポイントURLにリクエストをルーティングするには、この要素のマッピングを指定します。 AbsoluteEndpointURIは、ConnectivityPropertiesでURLに関連する他のプロパティより優先されます。
BaseUri	接続構成中に指定したベースURLと同等です。ベースURIのみを置き換えてURLのrestを保持するには、この要素にマッピングを指定します。 AbsoluteEndpointURIに空ではないランタイム値がある場合、このマッピングは無視されます。
RelativeUri	BaseUriと?の間のエンドポイントURIの一部を形成します。 BaseUriに空のランタイム値がある場合、またはAbsoluteEndpointURIが空でないランタイム値を持つ場合、マッピングは無効です。ランタイム値は、/で始まる必要があります。
Uri	エンドポイントURLの特定の部分の実行時値を置換するには、このノードの下にある様々な要素を使用します。
スキーム	エンドポイントURLのスキームのみを変更するマッピングを指定してください。サポートされる値は、HTTPとHTTPSです。
ホスト	エンドポイントURLの「ホスト」部分のみを変更するマッピングを指定
ポート	エンドポイントURLのポートのみを変更するマッピングを指定してください。
問合せ	エンドポイントURLの問合せ部分のみを変更するマッピングを指定してください。問合せ部分は?の後にあります。
パス	エンドポイントURLのパス部分のみを変更するマッピングを指定してください。「パス」は、ホスト名と?の間のURIの一部です。
プラグイン	このノードの様々なプロパティは、RESTアダプタがエンドポイントURLを起動する方法に影響を与えます。
PostQueryString	ランタイム値がtrueで、HTTP動詞がPOSTの場合、問合せ文字列のパラメータはフォーム・パラメータとしてPOSTを使用して送信されます。デフォルトは、falseです。
UseFormUrlEncoding	ランタイム値がfalseの場合、RESTアダプタはRFC 3986-compliantエンコーディングを使用して問合せパラメータをエンコードします。デフォルトはtrueです。これは、カスタム・ヘッダーx-ics-use-x-www-form-urlencodedをfalseに設定するのと同等です。 x-ics-use-x-www-form-urlencodedの詳細は、エンコード問合せパラメータのRFC 3986サポートを参照してください。x-ics-use-x-www-form-urlencodedは、両方を設定するときに優先されます。

FTPアダプタを、FTPサーバーのファイルに「第1アドレス」オブジェクトのレスポンスを書き込むためのスイッチ・アクションにドラッグします。
「Oracle ERP Cloudアダプタ」とFTPアダプタの間のマッパーで、「第1アドレス」オブジェクトの詳細をマッピングします。

「図mapper3.pngの説明」
完了すると、統合設計は次のようになります:

図dynamic_integration.pngの説明
統合をアクティブ化して起動します。ランタイムで決定されたエンドポイントURIは、「Oracle ERP Cloudアダプタ」によって起動されます。