4 ドキュメント定義の作成
この章では、ドキュメント定義を作成および削除するプロセスについて説明します。また、ドキュメント・プロトコルの概念についても説明します。
ドキュメント定義の作成は、Oracle B2Bプロセス・フローの2番目のステップです。ドキュメント定義では、メッセージの検証に使用されるドキュメント・プロトコル(ドキュメント・プロトコル・バージョンおよびドキュメント・タイプ)が指定されます。使用するドキュメント定義ガイドラインは、メッセージのタイプによって異なります(たとえば、XMLメッセージの場合はXSD/DTDです)。
ノート:
XMLでのカスタム・ドキュメント・プロトコルの場合、識別式(XPath)がドキュメントのタイプ/リビジョン/ドキュメント定義間で一意であることを確認します。
トランザクションのホスト取引パートナとリモート取引パートナの両方で、同じドキュメント定義を使用します。ドキュメント定義は、ドキュメント・プロトコル、プロトコル・バージョンおよびドキュメント・タイプの標準に準拠する必要があります。これは、ドキュメント・ガイドライン・ファイルを作成(ステップ1)してから、Oracle B2Bインタフェースでドキュメント定義の作成時にこれらのファイルをインポート(ステップ2)すれば難しいことではありません。
この章の内容は次のとおりです。
ドキュメント・プロトコルの詳細は、ドキュメント・プロトコルの使用 を参照してください。
ドキュメント・プロトコルの概要
カスタム・プロトコルおよびガイドライン・ドキュメントを使用して、ほとんどのプロトコルを定義できます。新規ドキュメント・プロトコルを追加する場合は、常にカスタム・ドキュメントです。
Oracle B2Bでは、次のドキュメント・プロトコルをサポートしています。
-
カスタム
-
OAG
-
RosettaNet
-
UCCNet
-
UserDefined
ドキュメント定義の一部として、ドキュメント・ガイドライン・ファイルを指定できます。検証が有効な場合、実行時のペイロードは、使用するドキュメント定義ファイルのタイプに準拠している必要があります。
ドキュメント階層
図4-1に示すように、ドキュメント・プロトコルは階層とみなすことができます。
ドキュメント・プロトコルは、複数のドキュメント・プロトコル・バージョンで構成できます。ドキュメント・プロトコル・バージョンは、複数のドキュメント・タイプで構成できます。ドキュメント・タイプは、複数のドキュメント定義で構成できます。通常、1つのドキュメント定義で作業を開始し、そのドキュメント定義を様々な取引パートナ向けにカスタマイズします。
図4-2に、カスタムに適用されるドキュメント・プロトコル階層を示します。
Oracle B2Bインタフェースでは、ドキュメント定義を作成する際、そのドキュメント定義の名前にドキュメント・プロトコル階層が反映されます。
DocumentProtocol-Version-DocumentType-DocumentDefinitionName
例4-1に、カスタム・ドキュメントに対する定義に反映される階層を示します。
ドキュメント・プロトコル: CUSTOM
ドキュメント・プロトコル・バージョン: 4010
ドキュメント・タイプ: PurchaseOrder
ドキュメント定義: PurchaseOrder_def
結果のドキュメント定義:
CUSTOM-4010-PurchaseOrder-PurchaseOrder_def
ドキュメント定義の作成
必要なガイドライン・ファイルを作成した後、Oracle B2Bインタフェースを使用してドキュメント定義を作成し、ガイドライン・ファイルをインポートします。
ノート:
ドキュメント・バージョン、ドキュメント・タイプおよびドキュメント定義は、作成後には編集できなくなります。特定のドキュメント要素(バージョン、タイプまたは定義)を削除して、新しく作成する必要があります。作成後にドキュメント要素を更新すると、メタデータの不整合、メタデータ検証の問題、ランタイム・エラーが発生する原因となる場合があります。