トリガー接続としての「RESTアダプタ」の追加
「RESTアダプタ」を統合キャンバスにトリガー接続としてドラッグすると、アダプタ・エンドポイント構成ウィザードが起動されます。 ウィザードで選択した内容に基づいて、次のページを表示できます。
RESTアダプタ・トリガー基本情報ページ
RESTアダプタのユーザー名と説明を入力します。 複数のリソースまたは動詞の構成を選択することもできます。
| 要素 | 説明 |
|---|---|
|
エンドポイントにどのような名前を付けますか。 |
他のユーザーが接続について理解できるようにわかりやすい名前を指定します。 たとえば、ソースOracle REST接続を作成している場合は、
ExposeFlowAsRESTResourceという名前を付けることができます。 名前に使用できるのは、英字、数字、アンダースコアおよびハイフンです。 次のものは使用できません。
|
|
このエンドポイントでは何が行われますか。 |
エンドポイントの職責のオプションの説明( |
|
Select to configure multiple resources or verbs (maximum 11) |
必要に応じて、異なるリソースURIおよびHTTPアクション/動詞を使用して複数の操作エントリ・ポイントを構成する場合に選択します。 各操作は、1つの統合内で異なる選択アクション・ブランチを表します。 1つの統合で作成できる操作(ブランチ)の最大数は11個です。 この機能により、異なる操作を実行するために複数の統合(それぞれが個別のリソースURIおよび動詞を持つ)を作成する必要がなくなります。 |
RESTアダプタのトリガー・リソース構成ページ
RESTアダプタ操作名、相対リソースURIおよびエンドポイント・アクションを入力します。 問合せパラメータとテンプレート・パラメータの追加や、エンドポイントのリクエストまたはレスポンス(あるいは両方)の構成も選択できます。 Oracle NetSuiteと統合する場合は、JWTユーザー・アサーションを使用してアイデンティティ伝播を構成するように選択できます。
| 要素 | 説明 |
|---|---|
|
操作名を指定してください |
操作名を入力してください。 |
|
この操作では何が行われますか。 |
操作職責のオプションの説明を入力します。 |
|
What is the endpoint’s relative resource URI? |
リソースに関連付けられた相対パスを指定します。 このパスには、テンプレート・パラメータを中カッコで囲んで指定できます(たとえば、{order-id})。 対処できる特定の情報のソースをリソースとして指定できます。 リソース・パスの形式は、接頭辞付きURLの後に指定の相対パスを付加したものです。 デフォルトではURLの接頭辞は次のパスです。 たとえば、統合名が このURLは、次に示す先頭の固定部分を除いてオーバーライドできます。 |
|
エンドポイントでどのアクションを実行しますか。 |
エンドポイントで実行する1つのHTTPアクション(メソッド)を選択します。
|
|
構成するオプションを選択してください |
構成するオプションを選択します。
|
|
Configure Request Headers? |
構成するリクエスト・ヘッダーのタイプを選択します。
|
|
Configure Response Headers? |
構成するレスポンス・ヘッダーのタイプを選択します。
|
|
Configure CORS (Cross Origin Resource Sharing) (トリガー(インバウンド)方向のみで使用可能) |
トリガーのCORSパラメータを構成する場合に選択します。 CORSでは、Webページ上の制限されたリソース(たとえば、クロスサイトJavaスクリプティングに関するセキュリティの問題をもたらすカスタムHTTPヘッダー)のリクエストを、リソースの提供元のドメインとは別のドメインから行うことができます。 |
|
カスタムJWT要求の構成 (トリガー(インバウンド)方向のみで使用可能) |
カスタムJWT要求を使用してユーザー・アイデンティティをOracle NetSuiteに伝播する場合に選択します。 ノート: この選択は、Oracle NetSuiteを使用したアイデンティティ伝播にのみ適用されます。 |
RESTアダプタ・トリガーのカスタム要求の構成ページ
クライアントIDおよびクライアント・シークレットに使用するカスタムJWTクレームを追加します。 カスタムJWT要求により、ユーザー・アイデンティティをOracle NetSuiteに伝播できます。 このページは、「リソース構成」ページで「カスタムJWT要求の構成」を選択した場合にのみ表示されます。
| 要素 | 説明 |
|---|---|
| 追加 | 「追加」をクリックして、クライアントIDおよびクライアント・シークレットのカスタムJWTクレームを指定します。 追加する要求は、Oracle Cloud Infrastructure Identity and Access Managementでも定義する必要があります。
アダプタ・エンドポイント構成ウィザードを完了すると、入力した名前がマッパーの「ソース」セクション(「セキュリティ・プロパティ」、「カスタム請求」)に表示されます。 |
| 編集 | 行をダブルクリックしてエントリを編集します。 |
| 削除 | 行を選択し、「削除」をクリックします。 |
この機能にはユースケースが用意されています。 「カスタムJWT要求を使用したRESTアダプタからOracle NetSuiteへのユーザー・アイデンティティの伝播」を参照してください。
RESTアダプタ・トリガー・リクエスト・パラメータ・ページ
このエンドポイントについてRESTアダプタのリクエスト・パラメータを入力します。
| 要素 | 説明 |
|---|---|
|
Resource URI |
Basic Infoページに入力された、エンドポイントの相対URIが表示されます。 |
|
Specify Query Parameters |
RESTエンドポイントの問合せパラメータを指定します。 「Add」アイコンをクリックすると、パラメータ名を入力してデータ型を選択するための行が表示されます。 たとえば、 「Delete」アイコンをクリックすると、選択した行が削除されます。 |
|
Template Parameters |
相対リソースURIのテンプレート・パラメータが表示されます。 テンプレート・パラメータは、Basic Infoページに指定した詳細情報に基づいています。編集することはできません。 テンプレート・パラメータは、パスの一部として中カッコで囲んで定義する必要があります。 たとえば、URL ノート:
|
RESTアダプタ・トリガー・リクエスト・ページ
エンドポイントについてRESTアダプタのリクエスト・ペイロードの詳細を入力します。
| 要素 | 説明 |
|---|---|
|
マルチパート添付処理オプションの選択 |
リクエストがインバウンドとアウトバウンドのいずれであるかに基づいて、次のオプションを構成します。 インバウンド(トリガー)・リクエストについて、含めるマルチパート添付ファイル・タイプを選択します。 このオプションは、「Basic Info」ページでPOSTアクションを選択した場合にのみ使用できます。
|
|
リクエスト・ペイロード書式を選択 |
ノート:
使用するリクエスト・ペイロード形式を選択します。 リクエスト・ペイロードの主要部は、表現の構造をXSD要素を使用して定義する必要があります。
|
|
Schema Location |
次のいずれかの方法でスキーマ・ファイルを指定します。
|
|
要素 |
ペイロードの構造を定義する要素を選択します。 このフィールドは、リクエスト・ペイロード・ファイルをインポートした後で表示されます。 スキーマまたはJSONサンプル・ファイルを参照して選択したら、スキーマが自動的に表示されます。 ルート要素を選択するためのコンボ・ボックスもデフォルトで表示されます。 |
|
リクエスト本文のメディア・タイプは何ですか。 (コンテンツタイプ・ヘッダー) |
エンドポイントで受け取るマルチパート添付ファイル・タイプを選択します。 このフィールドは、「マルチパート添付処理オプションの選択」フィールドで「リクエストはペイロードでマルチパートです」オプションを選択した場合に表示されます。
|
RESTアダプタ・トリガー・リクエスト・ヘッダー・ページ
このエンドポイントについてRESTアダプタのリクエスト・ヘッダー・プロパティを入力します。
ノート:
標準ヘッダー名と同じカスタム・ヘッダー名を指定すると、エラーが発生します。 カスタム・ヘッダー名には必ず一意の名前を指定してください。使用する標準HTTPリクエスト・ヘッダーを指定します。
| 要素 | 説明 |
|---|---|
|
Add Standard Request Headers |
デフォルトのドロップダウン・リストから、使用する標準HTTPリクエスト・ヘッダーを選択します。
|
|
HTTP Header Name |
次のタスクを実行します。
|
使用するカスタムHTTPリクエスト・ヘッダーを指定します。
| 要素 | 説明 |
|---|---|
|
Add Custom Request Headers |
次のカスタム・リクエスト・ヘッダー・タスクを実行します。
|
|
Custom Header Name |
カスタム・ヘッダー名を入力します。 |
|
Custom Header Description |
オプションで説明を入力します。 |
RESTアダプタ・トリガーCORS構成ページ
このエンドポイントについてRESTアダプタのCORS構成プロパティを入力します。
| 要素 | 説明 |
|---|---|
|
Allowed Origins |
CORSリクエストの作成元として許容できるドメインを指定します。 これらのドメインからのリクエストが受け入れられます。 すべてのドメインでリクエストを作成する場合はアスタリスク( |
|
Allowed Methods |
表示される許容メソッドは、「Basic Info」ページの「What action does the endpoint perform?」リストでの選択に基づきます。 許容できるドメインからの許容できるアクション(メソッド)を実行するリクエストのみが受け入れられます。 CORS構成でリストされたメソッド名を構成することはできません。 |
RESTアダプタ・トリガー・レスポンス・ページ
エンドポイントについてRESTアダプタのレスポンス・ペイロードの詳細を入力します。
| 要素 | 説明 |
|---|---|
|
マルチパート添付処理オプションの選択 |
リクエストがインバウンドとアウトバウンドのいずれであるかに基づいて、次のオプションを構成します。 インバウンド(トリガー)・レスポンスについて、含めるマルチパート添付ファイル・タイプを選択します。
|
|
レスポンス・ペイロード書式を選択 |
ノート:
使用するレスポンス・ペイロード形式を選択します。 レスポンス・ペイロードの主要部は、表現の構造をXSD要素を使用して定義する必要があります。
|
|
Schema Location |
次のいずれかの方法でスキーマ・ファイルを指定します。
|
|
要素 |
ペイロードの構造を定義する要素を選択します。 このフィールドは、レスポンス・ペイロード・ファイルをインポートした後で表示されます。 スキーマ・ファイルを参照して選択すると、ルート要素を選択するためのコンボ・ボックスがデフォルトで表示されます。 |
|
レスポンス本文のメディア・タイプは何ですか(Acceptヘッダー) |
エンドポイントで応答するペイロードのタイプを選択します。
エンドポイントで受け取るマルチパート添付ファイル・タイプを選択します。 このフィールドは、「マルチパート添付処理オプションの選択」フィールドで「レスポンスはペイロードでマルチパートです」オプションを選択した場合に表示されます。
|
RESTアダプタ・トリガー・レスポンス・ヘッダー・ページ
このエンドポイントについてRESTアダプタのレスポンス・ヘッダー・プロパティを入力します。
ノート:
標準ヘッダー名と同じカスタム・ヘッダー名を指定すると、エラーが発生します。 カスタム・ヘッダー名には必ず一意の名前を指定してください。使用する標準HTTPレスポンス・ヘッダーを指定します。
| 要素 | 説明 |
|---|---|
|
Add Standard Response Headers |
デフォルトのドロップダウン・リストから、使用する標準HTTPレスポンス・ヘッダーを選択します。
|
|
HTTP Header Name |
次のタスクを実行します。
|
使用するカスタムHTTPレスポンス・ヘッダーを指定します。
| 要素 | 説明 |
|---|---|
|
Add Custom Response Headers |
次のカスタム・レスポンス・ヘッダー・タスクを実行します。
|
|
Custom Header Name |
カスタム・ヘッダー名を入力します。 |
|
Custom Header Description |
オプションで説明を入力します。 |
RESTアダプタのトリガー操作ページ
既存の操作を確認または編集するか、新しい操作を追加します。 各操作は、1つの統合内で異なる選択アクション・ブランチを表します。 1つの統合で作成できる操作(ブランチ)の最大数は6です。 必要に応じて、各エントリ・ポイントに異なるリソースURIとHTTPアクション/動詞を構成できます。 この機能により、異なる操作を実行するために複数の統合(それぞれが個別のリソースURIおよび動詞を持つ)を作成する必要がなくなります。 RESTアダプタをトリガー接続として使用するピック処理を使用して、複数のエントリ・ポイントを1つの統合に公開できます。
「Oracle Integration 3での統合の使用」の「単一のRESTアダプタ・トリガー接続での複数リソースのリクエストの受信」を参照してください。
| 要素 | 説明 |
|---|---|
| 操作 | 「リソース構成」ページに入力された操作名が表示されます。 |
| リソース | 「リソース構成」ページで選択されたエンドポイント相対リソースURLが表示されます。 |
| HTTPメソッド | 「リソース構成」ページで選択されたアクションが表示されます。 |
| Edit/Delete | 操作と、そのエンドポイントの相対リソースURLおよびアクションを編集または削除する場合に選択します。 |
| 他の操作を追加 | 別の操作名、エンドポイントの相対リソースURLおよびアクションを追加する場合に「リソース構成」ページに戻る場合に選択します。 |
RESTアダプタ・トリガー操作選択ページ
このエンドポイントについてRESTアダプタの呼出し操作選択パラメータを入力します。
| 要素 | 説明 |
|---|---|
|
Business Object |
この接続で使用するビジネス・オブジェクト(リソース)を選択します。 |
|
Operations |
この接続のビジネス・オブジェクトに対して実行する操作(メソッド)を選択します。 |
サマリー・ページ
指定したアダプタ構成値は、Summaryページで確認できます。
| 要素 | 説明 |
|---|---|
|
サマリー |
ウィザードのそれまでのページで定義した構成の値のサマリーが表示されます。 表示される情報は、アダプタによって異なる場合があります。 一部のアダプタでは、選択したビジネス・オブジェクトおよび操作名が表示されます。 生成されたXSDファイルが提供されるアダプタの場合は、XSDリンクをクリックしてそのファイルの読取り専用バージョンを表示します。 前のページに戻って値を更新するには、左パネルの適切なタブをクリックするか、「戻る」をクリックします。 構成の詳細を取り消すには、「取消」をクリックします。 「サンプルcURLの生成」をクリックして、RESTアダプタの接続構成時に選択した構成オプション(セキュリティ・ポリシー、ヘッダー、パラメータなど)のサンプル |