機械翻訳について
  1. Oracle Integration Generation 2でのRESTアダプタの使用
  2. RESTアダプタ接続を統合に追加
  3. RESTアダプタをトリガー接続として追加
  4. RESTアダプタ・トリガー・リクエスト・ページ

RESTアダプタ・トリガー・リクエスト・ページ

エンドポイントについてRESTアダプタのリクエスト・ペイロードの詳細を入力します。

要素 説明

マルチパート添付処理オプションの選択

リクエストがインバウンドとアウトバウンドのいずれであるかに基づいて、次のオプションを構成します。

インバウンド(トリガー)・リクエストについて、含めるマルチパート添付ファイル・タイプを選択します。 このオプションは、「Basic Info」ページでPOSTアクションを選択した場合にのみ使用できます。

  • リクエストはペイロードでマルチパートです: ペイロード・リクエストとしてJSONまたはXMLコンテンツとともにリクエストの一部としてマルチパート添付を送信する場合に選択します。

  • マルチパート・リクエストのタイプはmultipart/form-dataで、HTMLフォーム・ペイロードがあります: RESTエンドポイントでHTMLフォームの構成を受け入れる場合に選択します。 このオプションを選択する前に、まず「リクエストはペイロードでマルチパートです」オプションを選択する必要があります。 この選択はメディア・タイプがmultipart/form-dataであることを前提とします。

リクエスト・ペイロード書式を選択
ノート:

  • サンプルJSONまたはアップロードされたXMLスキーマが、エンドポイントと交換された実際のランタイム・メッセージを表すことを確認してください。 ランタイム・メッセージの構造またはタイプが一致しないと、エラーが発生する可能性があります。

  • ターゲット名前空間なしでスキーマ・ファイルをアップロードすると、すべてのメッセージが使用するスキーマ・ファイルにサロゲート名前空間が追加されます:
    http://xmlns.oracle.com/cloud/adapter/nxsd/surrogate

使用するリクエスト・ペイロード形式を選択します。 リクエスト・ペイロードの主要部は、表現の構造をXSD要素を使用して定義する必要があります。

  • XMLスキーマ

  • JSONサンプル: SwaggerファイルとRAMLファイルを使用するには、このオプションを選択します。 最大100KBのサイズのJSONサンプル・ファイルがサポートされています。

    JSONサンプル・ファイルでは、空の配列はサポートされていません。 詳細は、サンプルのJSONファイルにおける空の配列の非サポートを参照してください。 Adapter Endpoint Configuration Wizardを使用する前に、大きなJSONサンプル・ファイルを特殊文字で処理する必要があります。 「特殊文字を使用した大規模なサンプルJSONファイルの処理」を参照してください。

  • XMLサンプル(単一のネームスペースまたはネームスペースなし): XMLドキュメントを使用してスキーマを生成するには、このオプションを選択します。

  • バイナリ: 構造化されていないインラインのペイロードで使用する - たとえば、application/octet-streamです。 ファイルの内容は保持されますが、レシーバはファイル名の拡張子などからファイルのタイプを判断する必要があります。 任意のバイト・ストリームのインターネット・メディア・タイプはapplication/octet-streamです。

Schema Location
次のいずれかの方法でスキーマ・ファイルを指定します。

  • 「Browse」をクリックして、使用するリクエスト・スキーマ・ファイルを選択します。

  • 「inline」をクリックして、JSONペイロードまたはURLをコピーしてテキスト・フィールドに貼り付けます。 完了したら「OK」をクリックします。

要素

ペイロードの構造を定義する要素を選択します。 このフィールドは、リクエスト・ペイロード・ファイルをインポートした後で表示されます。 スキーマまたはJSONサンプル・ファイルを参照して選択したら、スキーマが自動的に表示されます。 ルート要素を選択するためのコンボ・ボックスもデフォルトで表示されます。

リクエスト本文のメディア・タイプは何ですか。 (コンテンツタイプ・ヘッダー)

  • XML: ペイロードがXML形式で表示されます。

  • XML (text): ペイロードがXMLテキスト形式で表示されます。

  • JSON: ペイロードがJavaScript Object Notation (JSON)形式で表示されます。

  • URL-encoded: ペイロードがURLエンコード形式で表示されます。

  • Other Media Type: ペイロードを別の形式で表示する場合に選択します(たとえば、application/oracle.cloud+json)。 指定できるのは末尾が+jsonまたは+xmlのメディア・タイプのみです。 次のメディア・タイプは暗黙にサポートされますが、構成できません。 実行時に、リクエスト・メディア・タイプはhttp Content-Typeヘッダーの形式になります。 予期されるレスポンス・メディア・タイプはAcceptヘッダーを使用して指定されます。 すべてのサービスには、次のメディア・タイプのいずれかを使用してアクセスできます。

    • Application/XML

    • Application/JSON

エンドポイントで受け取るマルチパート添付ファイル・タイプを選択します。 このフィールドは、「マルチパート添付処理オプションの選択」フィールドで「リクエストはペイロードでマルチパートです」オプションを選択した場合に表示されます。

  • multipart/mixed: 添付ファイルとともにXMLまたはJSONペイロード・タイプを送信します。 たとえば、レビュー用のPDFドキュメントを電子メール内のリンクとして送信します。

  • multipart/form-data: 添付ファイルとともにXMLまたはJSONペイロード・タイプを送信します。 たとえば、HTMLフォームを作成して、画像のアップロードや送信を行います。 HTMLフォームでは、methodはpostとして定義され、enctype (エンコーディング・タイプ)はmultipart/form-dataとして定義されます。 この添付ファイル・タイプを使用する場合は、ペイロードなしで添付ファイルのみを送信することもできます。