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

RESTアダプタ・トリガー・レスポンス・ページ

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

要素 説明

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

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

インバウンド(トリガー)・レスポンスについて、含めるマルチパート添付ファイル・タイプを選択します。

  • レスポンスはペイロードでマルチパートです: ペイロードからレスポンスを受信する場合に選択します。

  • マルチパート・レスポンスのタイプは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」をクリックします。

要素

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

レスポンス本文のメディア・タイプは何ですか(Acceptヘッダー)
エンドポイントで応答するペイロードのタイプを選択します。

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

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

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

  • 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として定義されます。