高度なコンフィグレーションタスク

ドキュメントのダウンロード

サイトマップ

用語集

検索

e-docs > WebLogic Integration > B2B トピック > B2B Integration 管理ガイド > 高度なコンフィグレーションタスク

B2B Integration 管理ガイド

高度なコンフィグレーションタスク

この章では、WebLogic Integration の B2B Integration の高度な機能について説明します。また、これらの機能に関する詳細の参照先も示します。この章のトピックは以下のとおりです。

高度な機能の概要

ロジックプラグインは、WebLogic Integration の起動時に呼び出される Java クラスです。実行時に、ビジネスメッセージをインターセプト、処理、および出力します。ロジックプラグインに関する高度な機能には、以下のものがあります。

ビジネスメッセージのルーティングとフィルタ処理
組み込み XOCP ルータおよび XOCP フィルタロジックプラグインは、ユーザ定義の XPath ルータとフィルタ式をサポートします。定義された XPath ルータおよびフィルタ式を基に、トレーディングパートナ間でやり取りされる XOCP ビジネスメッセージのフローを次のように制御できます。
- XPath ルータロジックプラグインは、XOCP ビジネスメッセージの受信側のリストを変更できます。
- XPath フィルタロジックプラグインは、XOCP ビジネスメッセージをトレーディングパートナに送信するかどうかを決定できます。
注意: メッセージをトレーディングパートナにルーティングするために XPath ルータおよびフィルタ式を使用することは、XOCP ビジネスプロトコルの特別な機能です。
カスタムロジックプラグイン
デフォルトでは、ビジネスプロトコル固有の組み込みロジックプラグインのチェーンは、各ビジネスプロトコルのルーティングおよびフィルタ処理機能に関連付けられています。カスタムロジックプラグインは、ルーティングまたはフィルタ処理のいずれかに対して必要に応じて定義および挿入できます。このカスタムプラグインは、ルーティングとフィルタ処理に加えてさまざまなサービスを実行できます。

また、WebLogic Integration で提供されている B2B Integration 機能は、トレーディングパートナに対する拡張プロパティの仕様をサポートします。拡張プロパティは、以下で使用できます。

XPath ルーティングおよびフィルタ式
カスタムロジックプラグイン
外部アプリケーション

ルーティングおよびフィルタ処理の XPath 式

注意: XOCP プロトコルは、このリリースの Weblogic Integration から非推奨になっています。XOCP に代わる機能については、『WebLogic Integration リリースノート』を参照してください。

ビジネスメッセージのフローを制御するために XOCP ルータおよび XOCP フィルタロジックプラグインで使用する XPath 式は、以下の 3 種類に分類されます。

ビジネスメッセージがアセンブルされたときに追加される XPath 式
メッセージの XPath ルータ式は、直接メッセージに関連付けることができます。XOCP メッセージがアセンブルされた場合は、トレーディングパートナの受信側のフィールドを空白にすることも、名前または XPath 式を入れることもできます。たとえば、B2B Integration プラグインで提供された拡張機能で WebLogic Integration Studio を使用すると、ビジネスメッセージ送信アクションに対してルーティング式をコンフィグレーションするときに、トレーディングパートナ名または XPath 式のどちらかを指定できるようになります（詳細は、『B2B Integration ワークフローの作成』の「ビジネスメッセージの送受信」を参照）。
トレーディングパートナに関連付ける XPath 式
トレーディングパートナの XPath ルータ式とトレーディングパートナの XPath フィルタ式は、B2B Console を介してトレーディングパートナに関連付けることができます。
ビジネスプロトコル定義に関連付ける XPath 式
ビジネスプロトコルの XPath ルータ式とビジネスプロトコルの XPath フィルタ式は、B2B Console を介して XOCP ビジネスプロトコル定義に関連付けることができます。

注意: メッセージをトレーディングパートナにルーティングするために XPath 式を使用することは、XOCP ビジネスプロトコルの特別な機能です。アプリケーションが RosettaNet または cXML でメッセージを送信したときに、対象となる受信側は明示的にエンコードされます。

XOCP ハブおよびスポーク配信チャネルで説明されているように、XOCP 配信チャネルは、ハブ配信チャネルまたはスポーク配信チャネルとしてコンフィグレーションされます。ビジネスメッセージがハブ配信チャネルに転送されると、XOCP ルータロジックプラグインは、XML メッセージコンテキストドキュメントを生成します。メッセージコンテキストドキュメントは、会話定義とコラボレーションプロトコルアグリーメントで識別されたとおりに、トレーディングパートナの送信側と受信側に関連付けられたプロパティを捕捉します。定義された XPath ルータ式は、メッセージコンテキストドキュメントで捕捉されたトレーディングパートナのセットおよび関連するプロパティから、トレーディングパートナの一部を選択するために、XPath 構文を使用します。選択したトレーディングパートナは、XOCP ビジネスメッセージの意図した受信側です。

次の図では、XOCP ハブ配信チャネルのメッセージ処理およびルーティングの上位レベルの概要を示します。

図3-1 XOCP ハブ配信チャネルでのメッセージ処理

受信メッセージがハブ配信チャネルで受信されると、コンフィグレーションされている会話定義およびそれに関連付けられているコラボレーションアグリーメントは、メッセージコンテキストドキュメントに含まれる受信側トレーディングパートナを識別するのに使用されます。

たとえば、バイヤとサプライヤの 2 つのロールを定義した Query Price and Availability（QPA）会話定義があるとします。トレーディングパートナ（TP1）では、ハブ配信チャネル tp1-hub-dc が定義されています。他の 4 つのトレーディングパートナ（TP2、TP3、TP4、および TP5）では、スポーク配信チャネル tp2-spoke-dc、tp3-spoke-dc、tp4-spoke-dc、および tp5-spoke-dc が定義されています。以下のコラボレーションアグリーメントが TP1 で定義されています。

TP1（tp1-hub-dc）は、QPA のサプライヤロールに割り当てられる
TP2（tp2-spoke-dc）は、QPA のバイヤロールに割り当てられる
TP1（tp1-hub-dc）は、QPA のバイヤロールに割り当てられる
TP3（tp3-spoke-dc）は、QPA のサプライヤロールに割り当てられる
TP4（tp4-spoke-dc）は、QPA のサプライヤロールに割り当てられる
TP5（tp5-spoke-dc）は、QPA のサプライヤロールに割り当てられる

TP2 からのビジネスメッセージがサプライヤロールに送信され、tp1-hub-dc で受信されると、tp1-hub-dc にバイヤロールが割り当てられたコラボレーションアグリーメントが識別されます。このコラボレーションアグリーメントを使用して、ビジネスメッセージの受信側トレーディングパートナを識別します。

この場合、XOCP ルータロジックプラグインで生成された XML メッセージコンテキストドキュメントには、送信側（TP1）と受信側（TP3、TP4、TP5）の両方の識別情報とプロパティが含まれます。

定義された XPath ルータ式は、このリストからトレーディングパートナを選択するために XOCP ルータロジックプラグインによって使用されます。XPath 式で選択されたトレーディングパートナは、メッセージルーティングヘッダーに含まれます。各 Xpath 式は、置き換えられるか、前の式の結果に付加されるようにコンフィグレーションされます。XPath ルータ式の処理方法の詳細については、XPath ルータ式の処理を参照してください。

注意: 処理の過程で XPath ルータロジックプラグインによってメッセージコンテキストドキュメントの wlc 要素の context 属性が message-router から trading-partner-router に更新され、さらに hub-router に更新されますが、ドキュメントの他の要素は変更されません。つまり、すべての XPath ルータ式は、元々含まれていたトレーディングパートナのセットから選択するために使用されます。

XOCP ルータロジックプラグインが処理を完了し、指定したトレーディングパートナにメッセージがルーティングされると、XPath フィルタロジックプラグインは、送信ビジネスメッセージごとに XML メッセージコンテキストドキュメントを生成します。

XPath フィルタ式が定義されると、XOCP フィルタで生成されたメッセージコンテキストドキュメントに対して評価され、ビジネスメッセージをトレーディングパートナに送信するかどうかが決定されます。XPath フィルタ式は、Boolean 型の true または false で評価します。

どの式も false の場合、メッセージは送信されず、他の式は評価されません。
すべての式が true の場合、メッセージは通常どおりに処理されます。

これらの XPath フィルタ式が評価される順序については、XPath フィルタ式の処理で説明します。

高度な機能の概要で説明したとおり、XPath ルータおよびフィルタ式は、ユーザ定義の拡張プロパティを参照できます（トレーディングパートナの拡張プロパティについては、トレーディングパートナの拡張プロパティを参照）。

XPath ルータ式の処理

XPath ルータ式は、3 種類に分類されます。それぞれの式は、置き換えられるか、前の Xpath 式の結果に付加されるようにコンフィグレーションされます。式は、次の順序で処理されます。

メッセージ XPath ルータ式
メッセージ XPath ルータ式は、ビジネスメッセージに含まれており、そのビジネスメッセージのルーティングに常に適用されます。
トレーディングパートナ XPath ルータ式
トレーディングパートナ XPath ルータ式は、送信側のトレーディングパートナに関連付けられており、そのトレーディングパートナが送信したすべてのメッセージに適用されます。
ビジネスプロトコル XPath ルータ式
ビジネスプロトコル XPath ルータ式は、特定のプロトコルを使用するすべての受信ビジネスメッセージに適用されます。

複数のトレーディングパートナ XPath ルータ式またはビジネスプロトコル XPath ルータ式を定義した場合、ビジネスプロトコル XPath ルータ式の前に、すべてのトレーディングパートナ XPath ルータ式が評価されます。同じタイプの式は、B2B Console にリストされている順番に処理されます。

XPath フィルタ式の処理

WebLogic Integration は、トレーディングパートナとビジネスプロトコルの 2 つのエンティティの XPath フィルタ式をサポートします。式は、次の順序で処理されます。

トレーディングパートナ XPath フィルタ式
この式は、受信側トレーディングパートナに関連付けられており、そのトレーディングパートナに送信されたすべてのメッセージに適用されます。
ビジネスプロトコル XPath フィルタ式
この式は、指定したプロトコルを使用するすべての送信ビジネスメッセージに適用されます。

トレーディングパートナまたはビジネスプロトコルに対して複数の XPath フィルタ式を定義した場合、ビジネスプロトコル XPath フィルタ式の前に、すべてのトレーディングパートナ XPath フィルタ式が評価されます。処理は、式が false になるか、すべての式が処理されるまで続きます。同じタイプの式は、B2B Console にリストされている順番に処理されます。

XPath ルータ式およびフィルタ式のコンフィグレーション

B2B Console で、トレーディングパートナとビジネスプロトコルの両方に対して XPath ルータ式およびフィルタ式をコンフィグレーションできます。トレーディングパートナに対して XPath ルータ式およびフィルタ式をコンフィグレーションするには、以下の手順を実行します。

B2B Console で、[トレーディングパートナ] ページを開き、[詳細] タブを選択します。2 つの下位タブ [XOCP フィルタおよびルータ] と [拡張プロパティ] が表示されます。
[XOCP フィルタおよびルータ] タブを選択します。このタブページが次の図のように表示されます。

図3-2 [XOCP フィルタおよびルータ] タブ

[XOCP フィルタおよびルータ] タブで、必要な XPath 式をコンフィグレーションまたは順序変更できます。これらのタスクに必要な情報の詳細は、オンラインヘルプで説明します。「ヘルプの利用」を参照。

上のタブと同じ [フィルタおよびルータ] タブが、XOCP ビジネスプロトコル定義ページの [コンフィグレーション] タブを選択したときに使用できるようになります。2 つのページは、コンテキストのみが異なります。XOCP ビジネスプロトコル定義ページからアクセスするタブは、特定のトレーディングパートナではなく、すべてのメッセージに適用されるフィルタとルータを定義するのに使用します。

追加情報

ビジネスメッセージのルーティングとフィルタ処理、メッセージコンテキストドキュメントの構造、および XPath 式の作成については、『B2B Integration ロジックプラグインプログラミングガイド』の「ビジネスメッセージのルーティングとフィルタ処理」を参照してください。

カスタムロジックプラグイン

注意: ロジックプラグインは、主に、XOCP プロトコルに基づくハブアンドスポークコンフィグレーションで使用されましたが、このリリースの WebLogic Integration からは非推奨になっています。XOCP に代わる機能については、『WebLogic Integration リリースノート』を参照してください。

ロジックプラグインは、実行時にビジネスメッセージをインターセプトして処理する Java クラスです。各ビジネスプロトコルは、次の 3 つの標準ロジックプラグインに関連付けられています。

ルータロジックプラグイン
このロジックプラグインは、着信ビジネスメッセージを処理し、その処理で使用するメッセージコンテキストドキュメントを生成します。デフォルトでは、これがルータチェーンで最初のロジックプラグインとなります。ハブの配信チャネル用の XOCP ルータロジックプラグインは、ルーティングおよびフィルタ処理の XPath 式で説明されているように、XPath ルータ式に基づいて受信先トレーディングパートナのリストを変更できます。
ルータエンキューロジックプラグイン
このロジックプラグインは、ビジネスメッセージをルータメッセージキューに追加します。デフォルトでは、これがルータチェーンで最後のロジックプラグインとなります。
フィルタロジックプラグイン
このロジックプラグインは、送信ビジネスメッセージを処理し、その処理で使用するメッセージコンテキストドキュメントを生成します。デフォルトでは、これがフィルタチェーンで唯一のロジックプラグインとなります。ハブの配信チャネル用の XOCP フィルタロジックプラグインは、ルーティングおよびフィルタ処理の XPath 式で説明されているように、任意の XPath フィルタ式を使用して、メッセージが送信されたかどうかを調べます。

次の表では、組み込みロジックプラグインについて説明します。

表3-1 ビジネスプロトコルロジックプラグイン

プロトコル	処理チェーン	ロジックプラグイン
XOCP	ルータ	XOCP ルータ
	ルータ	XOCP ルータエンキュー
	フィルタ	XOCP フィルタ
RosettaNet	ルータ	RosettaNet ルータ
	ルータ	RosettaNet ルータエンキュー
	フィルタ	RosettaNet フィルタ
cXML	ルータ	cXML ルータ
	ルータ	cXML ルータエンキュー
	フィルタ	cXML フィルタ

カスタムロジックプラグインは、ビジネスプロトコルに対するルータ処理チェーンまたはフィルタ処理チェーンのいずれかに開発および追加できます。ただし、このような処理チェーンに含めることによって、ロジックプラグインの機能が制限されるとは限りません。カスタムロジックプラグインは、これら 2 つの種類の処理チェーンのいずれかに関連付けられてはいますが、サービスのルーティングやフィルタリングの実行に必要ではありません。したがって、たとえば、メッセージコンテキストを検証し、請求処理用の情報を捕捉するためにカスタムロジックプラグインを開発できます。

ロジックプラグインのコンフィグレーション

カスタムロジックプラグインを開発したら、ビジネスプロトコル定義ルータまたはフィルタチェーンにその定義を追加する必要があります。そのために、WebLogic Integration B2B Console を開いて、次の手順を実行します。

以下のプロパティを指定して、ロジックプラグインの定義を作成します。
ロジックプラグイン定義を作成するには、次の手順を実行します。
1. ナビゲーションツリーから [Logic Plug-Ins] を選択します。右ペインに [Logic Plug-Ins] ページが表示されます。
2. [新しいロジックプラグインの作成] を選択します。ロジックプラグインのページが表示されます。ページには、必要なプロパティを指定するためのフィールドがあります。
ロジックプラグイン定義をビジネスプロトコル定義に追加し、ルータまたはフィルタチェーン内でのロジックプラグインの位置を指定します。

次の節の説明に従って、ビジネスプロトコルページから手順 2 を実行します。

ビジネスプロトコルルータまたはフィルタチェーンへのカスタムロジックプラグインの追加

ビジネスプロトコルルータまたはフィルタ処理チェーンにカスタムロジックプラグインを追加するには、次の手順を実行します。

ナビゲーションツリーからビジネスプロトコルを選択します。右ペインに、上位レベルタブ（[コンフィグレーション] および [メモ]）が表示されます。
[コンフィグレーション] タブから、下位の [フィルタおよびルータ] タブを選択します。このタブページが次の図のように表示されます。
図3-3 ビジネスプロトコル用 [フィルタおよびルータ] タブ

[フィルタおよびルータ] タブで、使用可能なロジックプラグインを必要に応じて選択および順序変更できます。これらのタスクに必要な情報の詳細は、オンラインヘルプで説明します。「ヘルプの利用」を参照。

追加情報

ロジックプラグイン API の詳細、およびカスタムロジックプラグインの開発とデプロイメントのガイドラインについては、『B2B Integration ロジックプラグインプログラミングガイド』を参照してください。

トレーディングパートナの拡張プロパティ

トレーディングパートナの拡張プロパティを使用すると、トレーディングパートナに関連付けられるデフォルトプロパティを増やし、アプリケーション固有の要件をサポートすることができます。B2B Console で拡張プロパティを追加できます。追加された拡張プロパティには固有の名前が付けられ、ビジネスプロトコルルータおよびフィルタロジックプラグインによって生成されるメッセージコンテキストドキュメントに拡張プロパティセットとして含まれます。

拡張プロパティセットは、XML ドキュメント内のサブツリーとして取得できるようにリポジトリ内でモデル化されます。XML サブツリーは、組み込みルータおよびフィルタロジックプラグインによって生成されるメッセージコンテキスト XML ドキュメントに表示されます。XPath 式は、これらの拡張プロパティを参照できます。指定したトレーディングパートナに関連付けられた拡張プロパティセットのルート要素は、<trading-partner> 要素ノードの最後の子として挿入されます次の例では、拡張プロパティセットを持つリポジトリから生成された XML ドキュメントを示します。

<wlc context="message-router">
...
<trading-partner name="ABC International"
email="admin@abc.com" 
phone="+1 123 456 7890">
<address>123 ABC Street., Anytown, CA 95131</address>
<extended-property-set name="ABC Contact">
	<business-contact>Joe Smith</business-contact>
	<phone type="work">+1 123 456 7654</phone>
	<phone type="cell">+1 321 654 4567</phone>
	<city>Anytown</city>
	<state>California</state>
</extended-property-set>
</trading-partner>
...
</wlc>

トレーディングパートナの拡張プロパティのコンフィグレーション

トレーディングパートナに拡張プロパティを追加するには、次の手順を実行します。

ナビゲーションツリーからトレーディングパートナを選択します。右ペインに、4 つの上位レベルタブ（[コンフィグレーション]、[モニタ]、[メモ]、[詳細]）が表示されます。
[詳細] タブを選択します。[詳細] タブに 2 つの下位タブ（[XOCP フィルタおよびルータ] と [拡張プロパティ]）が表示されています。
[拡張プロパティ] タブを選択します。このタブページが次の図のように表示されます。
図3-4 トレーディングパートナの [拡張プロパティ] タブ

このタブを使用して、必要な拡張プロパティを設定できます。これらのタスクに必要な情報の詳細は、オンラインヘルプで説明します。「ヘルプの利用」を参照してください。

追加情報

メッセージコンテキストドキュメント構造、および拡張プロパティを参照するための XPath 式の作成については、『B2B Integration ロジックプラグインプログラミングガイド』を参照してください。