ビジネス・オブジェクト定義の作成

XML 文書は、その構造を定義するため、DTD またはスキーマ文書を持つことができます。XML 文書内のエレメントを表すビジネス・オブジェクト定義には、文書の構造に関する情報が設定されていることが必要です。XML データ・ハンドラーにより処理されるビジネス・オブジェクトを作成するため、XML データ・ハンドラーは、XML 文書を処理するための構造情報が設定されたビジネス・オブジェクト定義を見つける能力を備えていることが必要です。XML 文書用のビジネス・オブジェクト定義は、次のいずれかの方法で作成できます。

どちらの方法でも、Business Object Designer Express ツールを使用することが必要です。このセクションでは、XML 文書用ビジネス・オブジェクト定義を生成するために Business Object Designer Express を使用する方法の概要について説明します。Business Object Designer Express の詳細な説明については、「ビジネス・オブジェクト開発ガイド」を参照してください。

注:
XML データ・ハンドラーを使用する一部のコネクターには、コンテンツ・ビジネス・オブジェクトを子として組み込むトップレベルのラッパー・ビジネス・オブジェクトが必要です。したがって、使用するコネクターが必要とするビジネス・オブジェクトの構造によっては、子として生成されたビジネス・オブジェクトを別のビジネス・オブジェクトに追加する必要がある場合があります。コネクターのビジネス・オブジェクトの構造についての詳細は、各コネクターの資料を参照してください。

ビジネス・オブジェクト定義を作成するための XML ODA の使用

XML Object Discovery Agent (ODA) は、XML 文書のためのビジネス・オブジェクト定義を、その DTD またはスキーマ文書に基づいて作成します。ODA は DTD またはスキーマ文書を検査して、XML 文書構造についての情報を取得します。次に、ODA は、ビジネス・インテグレーション・システムにロードできるファイルに、ビジネス・オブジェクト定義を書き込みます。

注:
DTD もスキーマ文書も持たない XML 文書の場合には、この文書に対応するビジネス・オブジェクト定義を手動で作成することができます。詳細については、ビジネス・オブジェクト定義の手動での作成を参照してください。

XML ODA ユーティリティーは XML データ・ハンドラーの要件に適合するビジネス・オブジェクト定義を作成します。ODA は必要な ObjectEventId 属性をすべてのビジネス・オブジェクト定義に追加します。

また、リポジトリーのバージョン番号を指定すると、これをビジネス・オブジェクト定義の先頭に追加します。これはビジネス・オブジェクト定義を WebSphere Business Integration Express にインポートするのに必要です。これらのビジネス・オブジェクト定義を、さらに編集する必要はありません。何らかの理由で編集が必要な場合には、ビジネス・オブジェクト定義の情報の変更を参照してください。

XML ODA の使用方法については、付録 A, XML ODA の使用を参照してください。この付録では、XML ODA のインストールと構成方法について説明します。また、ビジネス・オブジェクト定義を作成するために、Business Object Designer Express 上で XML ODA を使用する方法についても説明します。 Business Object Designer Express の起動については、「ビジネス・オブジェクト開発ガイド」を参照してください。

ビジネス・オブジェクト定義の手動での作成

このセクションでは、手動でビジネス・オブジェクト定義を作成して XML 文書を表す方法を説明します。ビジネス・オブジェクト定義は、その属性およびアプリケーション固有情報を含めて、正しく定義する必要があります。

注:
DTD もスキーマ文書も持たない XML 文書の場合には、この文書に対応するビジネス・オブジェクト定義を手動で作成することが必要です。DTD またはスキーマ文書が存在する場合には、ビジネス・オブジェクト定義の作成に XML ODA を使用することを IBM はお勧めします。

DTD またはスキーマ文書用の XML 文書フォーマットの記述により、XML ODA が作成する ビジネス・オブジェクト定義が規定されます。表 9 に、本書の中で、XML 文書のフォーマットを説明しているセクションを示します。各セクションには、該当するスキーマを記述するための対応するデータ・モデルが記載されています。これらのセクションで説明されているように、ビジネス・オブジェクト定義は、XML データ・ハンドラーの要件に適合しています。したがって、ビジネス・オブジェクト定義を手動で作成する必要がある場合には、該当するセクションの記載に従ってください。

次の手順では、ElementTypeName はビジネス・オブジェクト構造 (属性またはビジネス・オブジェクト) で表される XML エレメントのタイプです。XML 文書に基づいて、ビジネス・オブジェクトを定義するには、次の手順で行います。

  1. トップレベル・ビジネス・オブジェクト定義を作成します。 このビジネス・オブジェクト定義の名前は、XML 文書の最高位のエレメント (例えば、DTD またはスキーマ文書の名前) であり、BOPrefix_TopLevelName のフォーマットでなければなりません。
    注:
    一部のコネクターでは、コンテンツ・ビジネス・オブジェクトを子として組み込むラッパー・ビジネス・オブジェクトが必要です。詳しくは、DTD に基づくラッパー・ビジネス・オブジェクト定義を参照してください。
  2. トップレベル・ビジネス・オブジェクト定義に、XML エレメントに対応する属性を作成します。

    DTD またはスキーマ文書に基づくトップレベル・ビジネス・オブジェクト定義には、次の属性が必要です。

    これらの必須属性の一般情報は、ビジネス・オブジェクトの構造を 参照してください。さらに、本書では、DTD およびスキーマ文書に基づくトップレベル・ビジネス・オブジェクト定義の構造について、次の情報を提供します。
    データ・モデル 詳細
    文書タイプ定義 (DTD) DTD のビジネス・オブジェクト構造
    スキーマ文書 スキーマ文書に必要なビジネス・オブジェクト定義

  3. トップレベル・ビジネス・オブジェクト定義の子オブジェクトである、root エレメント・ ビジネス・オブジェクト定義を作成します。 これには root XML エレメントの属性が含まれます。 このビジネス・オブジェクト定義の名前は、XML 文書の root エレメントであり、BOPrefix_TopLevelName_RootElementName の フォーマットであることが必要です。
  4. root エレメント・ビジネス・オブジェクト定義の中に、各下位エレメントに対応するビジネス・オブジェクト属性を作成します。次のことに留意してください。

    注:
    スキーマ定義を持つ XML 文書の場合、root エレメント・ビジネス・オブジェクト定義にスキーマ・ロケーションのための属性も必要である場合があります。詳細については、スキーマ文書に必要なビジネス・オブジェクト定義を参照してください。
  5. すべての下位エレメントに関する子ビジネス・オブジェクト定義を作成します。上記の規則に従います。

Copyright IBM Corp. 2004