SOAPアダプタのカスタムSOAPヘッダーの構成

Oracle Integrationでは、接続ページで提供されるWSDL定義で定義されていないカスタムSOAPヘッダーの追加がサポートされています。カスタム・ヘッダーを追加するには、「リクエスト・ヘッダー」ページの「カスタムSOAPヘッダー」タブまたはアダプタ・エンドポイント構成ウィザードの「レスポンス・ヘッダー」ページ(あるいはその両方)でスキーマをアップロードします。

カスタムSOAPヘッダーの追加

カスタムSOAPヘッダーを構成し、アダプタ・エンドポイント構成ウィザードで要素をカスタムSOAPヘッダーとして選択できる有効なスキーマを指定します:

ヘッダー・ページで、「このエンドポイントのヘッダーを構成しますか?」としてYesを選択します。
構成するヘッダーのタイプの場合、リクエスト・ヘッダーの列とレスポンス・ヘッダーの列でカスタムSOAPヘッダーを適宜選択します。

「図custom_header.pngの説明」
リクエスト・ページまたはレスポンス・ページ(あるいはその両方)で、要素をカスタムSOAPヘッダーとして選択できる有効なスキーマをアップロードします。アップロードするスキーマについて、次の制限に注意してください。
- アップロードするスキーマにはtargetNamespaceが必要です。
- ネームスペースのないカスタムSOAPヘッダーを想定するエンドポイントはサポートされません。
- スキーマがqualifiedとしてelementFormDefaultで定義されていることを確認します(ネームスペースが指定された子要素の場合)、またはunqualified (ネームスペース・プレフィクスがない子要素の場合)。
- 依存関係(imports/includes/cross参照を持つスキーマはサポートされていません。「サンプル・スキーマ」を参照してください。
- アップロードされたスキーマからヘッダーとして選択できるのは、1つの要素のみです。複数の要素を選択する手順は、次のとおりです:
  - targetNamespace同じ場合は、各要素のスキーマを再度アップロードする必要があります。
  - targetNamespaceが異なる場合は、targetNamespaceが必要な別のスキーマを使用できます。
アップロードされたスキーマから表示される要素のリストから、必要な要素を選択します。
「ヘッダーの追加」をクリックして、構成済ヘッダー表に要素を追加します。

カスタムのSOAPヘッダーを削除

リクエストまたはレスポンス・ページで、構成済ヘッダー表の必須ヘッダー要素の横にあるチェック・ボックスを選択します。
「ヘッダーの削除」をクリックすると、構成済のヘッダー表から要素が削除されます。

サンプル・スキーマ

次のスキーマにはtargetNamespaceが含まれます。子のプレフィクスが必要です。

スキーマ XML

スキーマ	XML
`<xsd:schema elementFormDefault="qualified" targetNamespace="http://xmlns.oracle.com/ sample" xmlns:xsd="http://www.w3.org/2001/XMLSchema"> <xsd:element name="headerRoot"> <xsd:complexType> <xsd:sequence> <xsd:element name="headerChild" type="xsd:string"/> </xsd:sequence> </xsd:complexType> </xsd:element> </xsd:schema>`	`<hdr:headerRoot xmlns:hdr=http://xmlns.oracle.com/sample> <hdr:headerChild>headerValue</hdr:headerChild> </hdr:headerRoot >`

<xsd:schema elementFormDefault="qualified"
targetNamespace="http://xmlns.oracle.com/ 
sample" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <xsd:element name="headerRoot">
    <xsd:complexType>
      <xsd:sequence>
        <xsd:element name="headerChild" type="xsd:string"/>
      </xsd:sequence>
    </xsd:complexType>
  </xsd:element>
</xsd:schema>

<hdr:headerRoot xmlns:hdr=http://xmlns.oracle.com/sample>
<hdr:headerChild>headerValue</hdr:headerChild>
</hdr:headerRoot >

次のスキーマにはtargetNamespaceが含まれます。子のプレフィクスは必須ではありません。

スキーマ XML

スキーマ	XML
`<xsd:schema elementFormDefault="unqualifi ed" targetNamespace="http://xmlns.oracle. com/sample" xmlns:xsd="http://www.w3.org/2001/XMLSchema"> <xsd:element name="headerRoot"> <xsd:complexType> <xsd:sequence> <xsd:element name="headerChild" type="xsd:string"/> </xsd:sequence> </xsd:complexType> </xsd:element> </xsd:schema>`	`<hdr:headerRoot xmlns:hdr=http://xmlns.oracle.com/sample> <headerChild>headerValue</headerChild> </hdr:headerRoot >`

<xsd:schema elementFormDefault="unqualifi
ed" targetNamespace="http://xmlns.oracle.
com/sample" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <xsd:element name="headerRoot">
    <xsd:complexType>
      <xsd:sequence>
        <xsd:element name="headerChild" type="xsd:string"/>
      </xsd:sequence>
    </xsd:complexType>
  </xsd:element>
</xsd:schema>

<hdr:headerRoot xmlns:hdr=http://xmlns.oracle.com/sample>
<headerChild>headerValue</headerChild>
</hdr:headerRoot >