cXML サポートの概要

WebSphere Business Integration Connect Document Manager は、XML 文書のルート・エレメント名「cXML」および cXML DOCTYPE (DTD) によって識別されるバージョンにより、cXML 文書を識別します。例えば、以下の DOCTYPE は、cXML バージョン 1.2.009 用です。

<!DOCTYPE cXML SYSTEM "http://xml.cXML.org/schemas/cXML/1.2.009/cXML.dtd">

Document Manager が cXML 文書に対する DTD 検証を実行しますが、Business Integration Connect は cXML DTD を提供していません。これは、www.cxml.org からダウンロードし、Community Console の検証マップ・モジュールを使用して Business Integration Connect にアップロードすることができます。 DTD をアップロードした後に、cXML 文書フローと関連付けます。DTD の cXML 文書フローへの関連付けについて詳しくは、ハブの構成を参照してください。

Document Manager は、文書管理のために cXML ルート・エレメントの 2 つの属性 payloadID と timestamp を使用します。cXML payloadID と timestamp は、文書 ID 番号および文書タイム・スタンプとして使用されます。いずれも文書管理用に Community Console で表示可能です。

cXML ヘッダー内の From エレメントと To エレメントには、文書のルーティングおよび認証に使用される Credential エレメントが含まれます。以下の例は、cXML 文書のソースおよび宛先としての From エレメントと To エレメントを示しています。

<Header>
 <From>
  
             <Credential domain="AcmeUserId">
                 <Identity>admin@acme.com</Identity>
             </Credential>
             <Credential domain="DUNS">
                 <Identity>130313038</Identity>
             </Credential>
 </From
 <To>
             <Credential domain="DUNS">
                 <Identity>987654321</Identity>
             </Credential>
             <Credential domain="IBMUserId">
                 <Identity>test@ibm.com</Identity>
             </Credential>
 </To>
 

複数の Credential エレメントが使用されている場合、Document Manager は、ルーティングおよび認証のビジネス ID として DUNS 番号を使用します。指定されている DUNS 番号がない場合は、最初の信任状が使用されます。

Business Integration Connect は、Sender エレメントの情報を使用しません。

同期トランザクションでは、cXML 応答文書に From および To ヘッダーは使用されません。応答文書は、要求文書によって確立されたのと同じ HTTP 接続を使用して送信されます。

cXML 文書タイプ

cXML 文書は、要求、応答、またはメッセージという 3 つタイプのいずれかになります。

要求

cXML 要求には、多くのタイプがあります。cXML 文書内の要求エレメントは、Business Integration Connect の文書フロー定義に対応しています。標準的な要求エレメントは、以下のとおりです。

以下のテーブルは、cXML 要求文書のエレメントと Business Integration Connect 内の文書フロー定義の間の関係を示しています。

cXML エレメント
文書フロー定義

cXML DOCTYPE
プロトコル

DTD バージョン
プロトコル・バージョン

要求 (タイプ)

例: OrderRequest

文書フロー

応答

ターゲット参加者は、cXML 応答を送信して、ソース参加者に cXML 要求の結果を通知します。一部の要求の結果にはデータがないため、応答エレメントにはオプションで状況エレメントのみを含めることができます。また、応答エレメントには、アプリケーション・レベルのデータが含まれることがあります。例えば、PunchOut 時には、PunchOutSetupResponse エレメントにアプリケーション・レベルのデータが含まれます。標準的な応答エレメントは、以下のとおりです。

以下のテーブルは、cXML 要求文書のエレメントと Business Integration Connect 内の文書フロー定義の間の関係を示しています。

cXML エレメント
文書フロー定義

cXML DOCTYPE
プロトコル

DTD バージョン
プロトコル・バージョン

応答 (タイプ)

例: ProfileResponse

文書フロー

メッセージ

cXML メッセージでは、cXML メッセージ・エレメントに Business Integration Connect 文書フロー情報が含まれます。このエレメントには、応答エレメントと同じオプションの状況エレメントを含めることができます。この状況エレメントは、要求メッセージへの応答となるメッセージで使用されます。

メッセージの内容は、ユーザーのビジネス・ニーズによってカスタム定義されます。 <Message> エレメントのすぐ下のエレメントは、Business Integration Connect で作成された文書フロー定義に対応しています。以下の例では、SubscriptionChangeMessage が文書フローになります。

<Message>
 <SubscriptionChangeMessage type="new">
            <Subscription>
                 <InternalID>1234</InternalID>
                 <Name xml:lang="en-US">Q2 Prices</Name>
                 <Changetime>1999-03-12T18:39:09-08:00</Changetime>
                 <SupplierID domain="DUNS">942888711</SupplierID>
                 <Format version="2.1">CIF</Format>
             </Subscription>
 </SubscriptionChangeMessage>
 </Message>
 

以下のテーブルは、cXML メッセージのエレメントと Business Integration Connect 内の文書フロー定義の間の関係を示しています。

cXML エレメント
文書フロー定義

cXML DOCTYPE
プロトコル

DTD バージョン
プロトコル・バージョン

メッセージ
文書フロー

片方向メッセージと要求/応答文書の違いは、簡単に言うと、要求エレメントや応答エレメントではなく、メッセージ・エレメントがあることです。

メッセージは、以下の属性を持つことができます。

Content-Type ヘッダーと添付文書

すべての cXML 文書には、Content-Type ヘッダーが含まれている必要があります。添付ファイルのない cXML 文書の場合は、以下の Content-Type ヘッダーが使用されます。

cXML プロトコルは、MIME を介して、外部ファイルの添付をサポートしています。例えば、バイヤーは、通常、対応するメモ、図面、FAX などによって仕入れ注文を明確にしなければならない場合があります。添付ファイルを含む cXML 文書では、以下にリストした Content-Type ヘッダーのいずれかを使用する必要があります。

boundary エレメントは、MIME メッセージの本文とペイロード部分を区切るために使用される固有のテキストです。詳しくは、www.cxml.org にある「cXML User Guide」を参照してください。

有効な cXML 対話

Business Integration Connect では、以下の cXML 文書フロー定義の対話がサポートされています。
ソース ターゲット ソース・パッケージ ターゲット・パッケージ ソース・プロトコル ターゲット・プロトコル パススルー 検証 変換

参加者

マネージャー

なし

なし

cXML

cXML

x

x


マネージャー

参加者

なし

なし

cXML

cXML

x

x


マネージャー

参加者


なし

XML

cXML

x

x

x

Copyright IBM Corp. 1997, 2004