ビジネス・オブジェクト定義の要件

ビジネス・オブジェクト定義が XML データ・ハンドラーの要件に適合することを確認するには、このセクションのガイドラインを使用します。ガイドラインは次から構成されます。

ビジネス・オブジェクト定義を正しく作成することにより、データ・ハンドラーがビジネス・オブジェクトと XML 文書との相互の変換を正しく行うことができます。XML データ・ハンドラーのビジネス・オブジェクトの作成方法の詳細については、DTD からのビジネス・オブジェクト定義の作成を参照してください。

ビジネス・オブジェクトの構造

DTD またはスキーマ文書を表すには、少なくとも以下の 2 つのビジネス・オブジェクト 定義が必要です。

DTD またはスキーマ文書のビジネス・オブジェクト定義を使用して XML データ・ハンドラーにより処理されるビジネス・オブジェクトは、次の追加規則に準拠していることが必要です。

注:
ビジネス・オブジェクトには必要なデータが設定されて、XML データ・ハンドラーが有効な XML 文書を作成できるようにする必要があります。データなしでデータ・ハンドラー・ビジネス・オブジェクトを送信しないようにします。

本書では、DTD およびスキーマ文書のビジネス・オブジェクト定義の構造について次の情報を提供します。
データ・モデル 詳細
文書タイプ定義 (DTD) DTD のビジネス・オブジェクト構造
スキーマ文書 スキーマ文書のビジネス・オブジェクト構造

ビジネス・オブジェクトの属性プロパティー

ビジネス・オブジェクト定義により属性が定義されます。各属性には、その属性に関する情報を提供する各種のプロパティーがあります。このセクションでは、XML データ・ハンドラーがこれらのプロパティーの一部をどのように解釈するかについて説明するとともに、ビジネス・オブジェクト定義を変更するためにプロパティーを設定する方法について説明します。

Name 属性プロパティー

各ビジネス・オブジェクト属性には、固有の名前を付ける必要があります。XML エレメントまたは XML 属性の名前は、常に elem_name または attr_name タグ内で指定されます。この場合、属性のアプリケーション固有情報 の elem_name (または attr_name) タグに指定された XML エレメント (または属性) の名前に特殊文字が含まれます。ただし、(これらの特殊文字を使用できない) ビジネス・ オブジェクト属性の名前では、特殊文字は省略されます。

Type 属性プロパティー

各ビジネス・オブジェクト属性は、次のように、整数、ストリング、このオブジェクトに含まれる子ビジネス・オブジェクトのタイプなど、1 つのタイプを持っていることが必要です。

注:
単純属性はすべて、String タイプです。

Key 属性および Foreign Key 属性のプロパティー

各ビジネス・オブジェクトには、1 つ以上の基本キー属性が必要です。基本キー属性は、属性に対する Key プロパティーを true に設定することにより指定されます。Foreign Key プロパティーの設定はオプショナルで、XML 文書の構造に依存します。このセクションでは、次に示す Key 属性および Foreign Key 属性のプロパティーに関連する情報について説明します。

ビジネス・オブジェクト定義のキーの指定

以前のバージョンの XML ビジネス・オブジェクト定義生成ツール (XMLBorgen、Edifecs SpecBuilder、および XML ODA など) では、生成ツールが、ObjectEventId 属性を親 XML ビジネス・オブジェクトのキーとして指定していました。しかし、今回のリリースより、Business Object Designer Express では ObjectEventId 属性がキーとして指定されているビジネス・オブジェクト定義を保管できなくなりました。

この制限により、現行バージョンの XML ODA は次に示すアクションを行ないます。

XML ODA が生成する親ビジネス・オブジェクト定義にキーを指定するためには、ビジネス・オブジェクト定義を Business Object Designer Express に送り、そのビジネス・オブジェクト定義を分析して、キーとして指定する適切な属性を判別する必要があります。ビジネス・オブジェクト定義のキー属性の変更は、Business Object Designer Express でそのビジネス・オブジェクト定義を保管する に行なう必要があります。

注:
XML ODA は、以前の XML ビジネス・オブジ ェクト定義生成ツール (XMLBorgen や Edifecs SpecBuilder など) に代 わるものです。そのため、ObjectEventId が親ビジネス・オブジェクトのキー属性として指定されることを回避するためのこれらの特別なステップ は、XML ODA でのみ行なうことができます。以前の XML ビジネス・オブジェクト定義生成ツ ール (以前のバージョンの XML ODA も含む) で生成した、既存の XML ビジネス・オブジェクト定義がある場合、それらのビジネス・オブジェクト定義では引き続き、ObjectEventId をキーとして使用する可能性があります。これらのビジネス・オブジェクトを現行リリースにマイグレーションする場合は、そのビジネス・オブジェクト定義を調べてください。ビジネス・オブジェクト定義で適切なキー属性の設定をしないと、イベント・シーケンス機能のパフォーマンスに対して好ましくない影響を及ぼす可能性があります。

キーおよび「必須性」の処理

本書では次の情報を提供すると共に、キーと「必須性」の関係についても説明します。
データ・モデル 詳細
文書タイプ定義 (DTD) DTD のビジネス・オブジェクト属性プロパティー
スキーマ文書 スキーマ文書のビジネス・オブジェクト属性プロパティー

Required 属性プロパティー

このプロパティーが単一カーディナリティーの子ビジネス・オブジェクトを含む属性に対して指定されると、XML データ・ハンドラーは親ビジネス・オブジェクトにこの属性の子ビジネス・オブジェクトが含まれていることを要求します。Cardinality、Key、および Foreign Key 属性プロパティーは、属性の Required プロパティーの設定に影響を与えることがあります。

本書では、必須かどうかについて次の情報を提供します。
データ・モデル 詳細
文書タイプ定義 (DTD) DTD のビジネス・オブジェクト属性プロパティー
スキーマ文書 スキーマ文書のビジネス・オブジェクト属性プロパティー

Cardinality 属性プロパティー

Cardinality プロパティーは、ビジネス・オブジェクト定義をタイプとしている属性の場合に、許容される子ビジネス・オブジェクトの数を示します。このプロパティーの設定は、XML 文書およびそのエレメントの構造に依存します。また、この設定は、属性が必須であることを必要とするかどうか (Required プロパティーが true に設定されているかどうか) にも影響します。

本書では、カーディナリティーと「必須性」の関係について次の情報を提供します。
データ・モデル 詳細
文書タイプ定義 (DTD) DTD のビジネス・オブジェクト属性プロパティー
スキーマ文書

特殊属性値

ビジネス・オブジェクト属性には 1 つの値があり、この値のタイプは、その属性の Type プロパティーと一致しています。さらに、属性は、次の 2 つの特別な値のいずれか 1 つを持つことができます。

XML データ・ハンドラーは、空のタグを持つ XML 入力を受け取ると、対応するビジネス・オブジェクト属性に CxBlank の値を割り当てます。

アプリケーション固有情報

ビジネス・オブジェクト定義内のアプリケーション固有情報により、データ・ハンドラーにビジネス・オブジェクト定義を XML 文書に変換する指示が与えられます。アプリケーション固有情報により、データ・ハンドラーがビジネス・オブジェクトを正しく処理できるようになります。したがって、XML データ・ハンドラーに関して新しいビジネス・オブジェクトを作成するかまたは既存のビジネス・オブジェクトを変更する場合は、ビジネス・オブジェクト定義内のアプリケーション固有情報がデータ・ハンドラーが予期する構文規則に一致することを確認します。XML データ・ハンドラーは次の種類のアプリケーション固有情報を使用することができます。

注:
XML データ・ハンドラーはアプリケーション固有情報を使用して、XML 文書のコンポーネントとビジネス・オブジェクト内の属性を突き合わせます。アプリケーション固有情報の最大長は 255 文字です。 アプリケーション固有情報の値が 255 文字を超える場合には、DTD またはスキーマ文書を再構築し、ビジネス・オブジェクトを再生成することが必要です。

本書では、アプリケーション固有情報について次の情報を提供します。
データ・モデル 詳細
文書タイプ定義 (DTD) DTD の XML コンポーネントのアプリケーション固有情報
スキーマ文書 スキーマ文書内の XML コンポーネントのアプリケーション固有情報

ビジネス・オブジェクト動詞

ビジネス・オブジェクトを XML 文書に変換する場合、XML データ・ハンドラーは動詞に関する XML を生成せず、また XML 文書をビジネス・オブジェクトに変換する際に動詞の設定も行いません。しかし、動詞の情報は次のいずれかの方法で保持されます。

Copyright IBM Corp. 2004