Request-Response データ・ハンドラーを使用するには、データ・ハンドラーに必要な構造を提供するようにビジネス・オブジェクト定義を作成または修正する必要があります。ただし、他のデータ・ハンドラーとは異なり、メタデータを持たせるようにビジネス・オブジェクト定義を変更する必要はありません。このセクションでは、Request-Response データ・ハンドラーと連動するビジネス・オブジェクト定義の作成に必要な情報を示します。特に、以下の情報を取り上げます。
Request-Response データ・ハンドラーは、要求または応答データ・ハンドラーとビジネス・オブジェクトを送受信するときにビジネス・オブジェクト定義を使用します。Request-Response データ・ハンドラーは、処理可能なビジネス・オブジェクトの構造に対して特定の要件を設定します。データ・ハンドラーに渡されるビジネス・オブジェクトは、1 つの要求子オブジェクトと 1 つ以上の応答子オブジェクトを持つ必要があります。これらの子オブジェクトは、自身を処理するデータ・ハンドラーの要件に適合する必要があります。
要求/応答ビジネス・オブジェクトを表すビジネス・オブジェクトの構造 を図 31 に示します。
図 31. 要求/応答ビジネス・オブジェクトのビジネス・オブジェクト構造
ビジネス・オブジェクト定義を Request-Response データ・ハンドラーの要件に適合したものにするためには、以下の各ビジネス・オブジェクトごとに提供されるガイドラインを使用してください。
Request-Response データ・ハンドラーは、トップレベル・ビジネス・オブジェクトが呼び出し側コンテキストとの間で送受信する情報を保持しているものとして動作します。表 30 では、Request-Response
データ・ハンドラーがビジネス・オブジェクトのプロパティーをどのように解釈するかを説明し、また、Request-Response
データ・ハンドラーで使用できるようにビジネス・オブジェクトを修正する場合のプロパティーの設定方法を説明しています。
表 30. トップレベル・ビジネス・オブジェクト定義のプロパティー
このトップレベル・ビジネス・オブジェクトには次の属性が必要です。
この要求ビジネス・オブジェクトは、要求データ・ハンドラーに必要なすべてのビジネス・オブジェクト要件に適合する必要があります。
この応答ビジネス・オブジェクトは、応答データ・ハンドラーに必要なすべてのビジネス・オブジェクト要件に適合する必要があります。
注:
例えば、ターゲット・アプリケーションが Customer XML 文書または OrderUpdate XML 文書のいずれかを戻す可能性がある場合は、トップレベル・ビジネス・オブジェクト定義には 2 つの属性が含まれている必要があります。1 つは Customer XML 文書を表すビジネス・オブジェクト定義を保持する属性、もう 1 つは OrderUpdate XML 文書を表すビジネス・オブジェクト定義を保持する属性です。データ・ハンドラーは応答ビジネス・オブジェクトを受け取ると、適切な属性にデータを取り込みます。
Request-Response データ・ハンドラーは、要求データ・ハンドラーの要求情報を保持するため、トップレベル・ビジネス・オブジェクトの最初の属性が要求ビジネス・オブジェクトであるものとして動作します。この属性は単一カーディナリティーである必要があります。表 31 では、Request-Response
データ・ハンドラーがこのビジネス・オブジェクト定義のプロパティーをどのように解釈するかを説明し、また、Request-Response
データ・ハンドラーで使用できるようにビジネス・オブジェクトを修正する場合のこれらのプロパティーの設定方法を説明しています。
プロパティー名 | 説明 |
---|---|
Name | 各ビジネス・オブジェクト定義には、固有の名前を付ける必要があります。この名前は、要求データ・ハンドラーが処理するビジネス・オブジェクト定義名と一致しなければなりません。 |
Version | ビジネス・オブジェクト定義の現行バージョンを表す定数。現在の値は 1.0.0 です。 |
アプリケーション固有情報 | 使用される要求データ・ハンドラーによって異なります。 |
例えば、RequestDataHandlerMimeType を text/xml として指定した場合、要求ビジネス・オブジェクトとして定義する子オブジェクトは、XML データ・ハンドラー との互換性を持つ必要があります。
Request-Response データ・ハンドラーは、応答データ・ハンドラーの応答情報を保持するため、トップレベル・ビジネス・オブジェクトの 2
番目以降の属性に応答ビジネス・オブジェクトがあるものとして動作します。この属性は単一カーディナリティーである必要があります。応答データ・ハンドラーが複数のタイプのビジネス・オブジェクトを戻す可能性がある場合、トップレベル・ビジネス・オブジェクトはそれぞれのタイプごとに
1 つの属性を持ちます。表 32 では、Request-Response
データ・ハンドラーがこのビジネス・オブジェクト定義のプロパティーをどのように解釈するかを説明し、また、Request-Response
データ・ハンドラーで使用できるようにビジネス・オブジェクトを修正する場合のこれらのプロパティーの設定方法を説明しています。
プロパティー名 | 説明 |
---|---|
Name | 各ビジネス・オブジェクト定義には、固有の名前を付ける必要があります。この名前は、応答データ・ハンドラーが処理するビジネス・オブジェクト定義名と一致しなければなりません。 |
Version | ビジネス・オブジェクト定義の現行バージョンを表す定数。現在の値は 1.0.0 です。 |
アプリケーション固有情報 | 使用される要求データ・ハンドラーによって異なります。 |
例えば、ResponseDataHandlerMimeType を text/abc として指定した場合、要求ビジネス・オブジェクトとして定義する子オブジェクトは、abc MIME タイプを処理できるカスタム・データ・ハンドラーとの互換性を持つ必要があります。
このセクションでは、Request-Response データ・ハンドラーの要件に適合する構造を表すビジネス・オブジェクト定義の作成方法について説明します。Business Object Designer Express を使用して、必要に応じてビジネス・オブジェクト定義から属性を追加または削除し、属性プロパティーを編集します。
要求/応答ビジネス・オブジェクト構造の理解 で説明したように、Request-Response データ・ハンドラーでは次のビジネス・オブジェクト定義を作成する必要があります。
Request-Response データ・ハンドラー用のトップレベル・ビジネス・オブジェクト定義を作成するには、Business Object Designer Express を使用して手動でビジネス・オブジェクト定義を作成する必要があります。
このトップレベル・ビジネス・オブジェクト定義の構造については 、トップレベル・ビジネス・オブジェクトを参照してください。
表 33. Request-Response データ・ハンドラー用のビジネス・オブジェクト
属性 | 注 | ビジネス・オブジェクト |
---|---|---|
要求ビジネス・オブジェクト | 要求に関する情報が含まれます。 | 要求ビジネス・オブジェクト |
応答ビジネス・オブジェクト | 要求の応答に関する情報が含まれます。 | 応答ビジネス・オブジェクト |
要求および応答ビジネス・オブジェクト定義を作成するには、次のいずれかの方法を使用できます。
XML ODA の詳細については、付録 A, XML ODA の使用を参照してください。その他の ODA の詳細については、対応するアダプター・ガイドを参照してください。
詳細については、トップレベル・ビジネス・オブジェクト定義の作成を参照してください。