ebXML を伴うワークフローの使用法

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

サイトマップ

用語集

検索

e-docs > WebLogic Integration > B2B トピック > B2B Integration ebXML の実装 > ebXML を伴うワークフローの使用法

B2B Integration ebXML の実装

ebXML を伴うワークフローの使用法

この章では、ワークフローを使用して ebXML ビジネスプロセスを設計、管理する方法を説明し、トレーディングパートナ間で ebXML ビジネスメッセージを交換するために必要な手順を示します。この章の内容は以下のとおりです。

ebXML ビジネスメッセージ

ビジネスメッセージは、トレーディングパートナ間の通信の基本単位です。ビジネスメッセージは、会話の一部として交換されます。会話内のロールは、ワークフローによって実装され、ワークフローはビジネスメッセージの交換を管理します。

ebXML ビジネスメッセージは、1 つの XML ビジネスドキュメントとゼロ個以上の添付ファイルで構成されます。ebXML メッセージは、通信プロトコルと独立した MIME/マルチパートメッセージエンベロープで、これはメッセージパッケージと呼ばれています。すべてのメッセージパッケージは、添付ファイル付き SOAP メッセージの仕様に準拠した構造になっています。

次の図は、ebXML プロトコルに基づく会話で交換されるビジネスメッセージの構造を表しています。

図3-1 ebXML ビジネスメッセージ

上図に示されているメッセージパッケージは、以下の論理的 MIME 要素で構成されています。

ヘッダコンテナ－ 1 つの SOAP 1.1 準拠メッセージが格納されている論理コンテナ。この SOAP メッセージは XML ドキュメントで、そのルート要素は SOAP エンベロープです。このエンベロープには、次の要素が入っています。
- SOAP ヘッダ－ ebXML 固有のヘッダ要素。SOAP ヘッダは、SOAP メッセージにさまざまな機能を追加する場合の一般的なメカニズムです。
- SOAP 本体－メッセージサービスハンドラの制御データおよびメッセージのペイロード要素に関連する情報を格納するコンテナ。
ペイロードコンテナ－アプリケーションレベルのペイロードを含む、ゼロ個以上の MIME 要素。ペイロードは、ファイルタイプを限定しておらず、XML データまたはバイナリデータを含んでいてもかまいません。

ebXML 会話への参加

会話とは、会話定義で定義されているトレーディングパートナ間の一連のビジネスメッセージ交換のことです。会話を定義する上での基本的な手順は、その会話のロールを実行するワークフローの作成です。ebXML ビジネスプロトコルを参照する会話定義には、開始者および参加者という 2 つのロールが必ず含まれます。ebXML 会話に関連付けられた各ワークフローテンプレートは、この 2 つのロールのうち 1 つだけを実行します。

ebXML プラグインは、ebXML 会話にロールを実装するワークフローの設計および実行ができるように WebLogic Integration Studio および処理エンジンの機能を拡張します。ワークフローはビジネスプロセスです。ebXML ベースのビジネスプロセスは、パブリックプロセスまたはプライベートプロセスとして設計できます。

注意: この節の内容は、読者が WebLogic Integration Studio をよく知っているものとして記述されています。Studio の使用方法の詳細については、ここでは説明されません。Studio の起動および使用に関しては、『WebLogic Integration Studio ユーザーズガイド』および『WebLogic Integration BPM ユーザーズガイド』を参照してください。

次の図は、開始者および参加者という 2 つのロール、および各ロールの高レベルの仮想ワークフローを含む簡単な ebXML 会話、「価格と在庫の照会（QPA）」を示しています。各トレーディングパートナは、会話におけるそれぞれのロールに対するワークフローを 1 つずつ実装しています。各ロールには、適時に正しい ebXML メッセージを送受信するために必要なそれぞれのタスクセットが設定されています。

図3-2 ebXML 会話のサンプル

上図では、ある会話におけるトレーディングパートナ間の ebXML メッセージ交換を示しています。

左側に示されたトレーディングパートナのワークフローは、最初のメッセージを送ることにより、ebXML 会話を開始します。
右側に示されたトレーディングパートナのワークフローは、受信したメッセージに応答する ebXML メッセージを送信することにより、会話に参加します。

以下の節では、会話の主要コンポーネントについて説明します。

ebXML 会話の開始

ebXML 会話における各トレーディングパートナは、開始者または参加者という 2 つのいずれかのロールに割り当てられます。ebXML 会話は、ワークフローが新規の会話に ebXML メッセージを送信した時点で開始されます（詳細については、新規会話におけるメッセージの送信を参照）。

会話に最初のメッセージを送信するワークフローは、次の 4 つのいずれかの方法により開始されます。

[時限] －ワークフローは指定日の指定時刻に開始されます。
[手動] －ワークフローは WebLogic Integration Worklist から開始されます。言い換えれば、Worklist ユーザが開始することになります。
[呼び出し] －ワークフローは別のワークフローに呼び出されることにより開始されます。
イベント－ワークフローは XML ドキュメントが JMS キューに到着すると開始されます（このイベントは、ebXML ビジネスメッセージの受信の結果として発生するイベントであってはならない）。

ebXML メッセージの送信

ワークフロータスクでは、Send ebXML Message という ebXML アクションを呼び出すことによって、ebXML メッセージを送信できます。このアクションをタスクノードに追加する手順は次のとおりです。

Studio で、テンプレート定義のリストから定義の 1 つを右クリックし、[開く] を選択します。

指定されたワークフローテンプレートが Studio に表示されます。
タスクノードを右クリックし、次にショートカットメニューから [プロパティ] を選択します。

[タスクのプロパティ] ダイアログボックスが表示されます。
[追加] をクリックして、[アクションを追加] ダイアログボックスを表示します。
[ebXML アクション｜ebXML メッセージの送信] と選択します。
[OK] をクリックして、次の図に示す [ebXML メッセージの送信] ダイアログボックスを表示します。
図3-3 [ebXML メッセージの送信] ダイアログボックス

WebLogic Integration では、ebXML メッセージの送信に 2 つのモードがあります。どちらのモードが使用されるかは、メッセージが送信される状況によって決まります。特定の会話における最初のメッセージは、新規会話モードで送信されます。後の（応答）メッセージは関連会話モードで送信されます。

たとえば、図3-2 に示されているサンプルの ebXML 会話では 2 つのメッセージが送信されています。最初のメッセージ（PriceAndAvailabilityQuote）は、開始者ワークフローから参加者ワークフローに送られ、2 つめのメッセージ（PriceAndAvailabilityResponse）は参加者ワークフローから開始者ワークフローに送られています。

[ebXML メッセージの送信] ダイアログボックスに必要なデータの種類は、選択したメッセージタイプによって異なります。

新規会話におけるメッセージの送信

サンプル会話における最初の ebXML メッセージ、PriceAndAvailabilityQuote の場合、図3-3 に示されているように [ebXML メッセージの送信] ダイアログボックスで [新規の会話] を選択し、続いて以下のデータを指定します。

[会話名] － ebXML ベースの会話をドロップダウンリストから選択してメッセージが送信される会話を指定します。会話定義は WebLogic Integration リポジトリに格納されています（会話定義のコンフィグレーションについては、ebXML ビジネスメッセージを参照）。
[送信側ビジネス ID] －メッセージの送信側のビジネス ID を指定します。この ID は、ebXML メッセージを送信するトレーディングパートナを識別する一意の値です。この値は、静的値、または Expression Builder によって動的に評価される値のいずれかになります。

注意: ビジネス ID は静的値にしないことをお勧めします。変数を使用するか、実行時にビジネス ID を評価する XPath 式を使用してください。このようにすることにより、複数のトレーディングパートナで同じワークフローを使用できます。
[受信側ビジネス ID] －メッセージの受信側のビジネス ID を指定します。この ID は、ebXML メッセージを受信するトレーディングパートナを識別する一意の値です。この値は、静的値、または Expression Builder によって動的に評価される値のいずれかになります（前項の注意を参照）。
[エンベロープ変数] －構成済みの ebXML メッセージ送信後に ebXML メッセージヘッダ（SOAP エンベロープ）が格納される変数を指定します。メッセージのステータスをトレースする場合に、メッセージ ID や会話 ID などの情報をこの変数から取り出すことができます。
[メッセージペイロード] －ゼロ個以上のペイロードを指定します。各ペイロードに対しては、タイプ（XML または ebXML バイナリ）および関連変数を指定します。

関連会話におけるメッセージの送信

参加者ワークフローから開始者ワークフローに、PriceAndAvailabilityQuote ebXML メッセージの応答として送られる、PriceAndAvailabilityResponse (サンプル ebXML メッセージ) の場合、図3-3 に示されている [ebXML メッセージの送信] ダイアログボックスで [関連する会話] を選択します。

[ebXML メッセージの送信] ダイアログボックスで [関連する会話] を選択すると、[会話名]、[送信側ビジネス ID]、および [受信側ビジネス ID] の各フィールドは書き込み不可になります。これらの属性は、1 つの会話につき設定できるのは 1 度だけ、すなわち、最初の ebXML メッセージが新規会話で送信される時に限られます（詳細については、前節の新規会話におけるメッセージの送信を参照）。関連会話のメッセージを送信する場合は、システムによってその前の ebXML メッセージ交換から値が取り込まれるため、[会話名]、[送信側ビジネス ID]、および [受信側ビジネス ID] の値を指定する必要はありません（詳細については、ebXML メッセージの受信を参照）。

ただし、[メッセージペイロード] フィールドについては、ゼロ個以上のペイロードに対してペイロードタイプ（XML または ebXML バイナリ）および関連変数を指定する必要があります。

ebXML メッセージの受信

WebLogic Integration がサポートする ebXML メッセージの受信方法には、開始ノードによるものと、イベントノードによるものの、2 通りがあります。どちらのノードが使用されるかは、メッセージが受信される状況によって決まります。

ebXML ベースの会話におけるトレーディングパートナのワークフローは、会話を開始する ebXML ワークフローからメッセージを受信することにより起動するように設定できます。この開始 ebXML メッセージは参加者ワークフローの開始ノードを起動し、それが ebXML メッセージの開始として定義されます。図3-2 に示されているサンプル会話の参加者ワークフローは、このようにして起動されるワークフローの一例です。
どちらの ebXML ワークフロー（開始者ロールまたは参加者ロールのいずれかのワークフロー）でも、要求に対する応答など、一定の ebXML メッセージをイベントノードで待機できます。図3-2 に示されているサンプル会話では、開始者ワークフローの [Wait for Response] ノードがそのようなイベントノードの一例となっています。

開始ノード

ebXML ベースの会話におけるトレーディングパートナのワークフローは、別のトレーディングパートナから ebXML メッセージを受信したときに開始するように設定できます。Studio には、このようなワークフローを設計するため、開始ノードに ebXML 固有のオプションがあります。

ワークフローの開始ノード（図3-2 に示されている参加者ワークフローの開始ノードが一例）に ebXML イベントを指定する手順は次のとおりです。

[開始] ノードを右クリックし、次にショートカットメニューから [プロパティ] を選択します。

[開始のプロパティ] ダイアログボックスが表示されます。

図3-4 [開始のプロパティ] ダイアログボックス
[イベント] オプションを選択して、ドロップダウンリストから [EBXML メッセージ] を選択します。
[メッセージエンベロープ] フィールドで、該当するドロップダウンリストから、次のものを選択します。
- 着信メッセージが適用される会話
- メッセージエンベロープを格納する変数
[メッセージペイロード] フィールドで、ゼロ個以上のメッセージの添付ファイルに対してタイプ（XML または ebXML バイナリ）、および各添付ファイルのデータを格納する関連変数を選択します。

注意: [メッセージペイロード] フィールドの各行は、関連 ebXML メッセージの添付ファイルを表しています。1 つの ebXML メッセージに複数の添付ファイルがある場合、このフィールドの行の順序がメッセージ中の添付ファイルの順序となります。[メッセージペイロード] フィールドの行を空のままにすると、メッセージ受信時に ebXML メッセージに対応する添付ファイルがあっても無視されます。
[OK] をクリックして設定を保存し、ダイアログボックスを閉じます。

イベントノード

ワークフローには、特定インスタンスのワークフローで ebXML メッセージが受信されたときに起動するように設計されたイベントを組み込むことができます。ebXML メッセージの受信を待機するイベントは、そのタイプを [ebXML イベント] として定義する必要があります。このイベントは、実行時において適切な ebXML メッセージが会話で受信されたときに起動されます。

ebXML メッセージの受信を待機するイベントを定義する手順は次のとおりです。

イベントノードを右クリックし、次にショートカットメニューから [プロパティ] を選択します。

[イベントのプロパティ] ダイアログボックスが表示されます。

図3-5 [イベントのプロパティ] ダイアログボックス
[タイプ] ドロップダウンリストから [ebXML イベント] を選択します。
[エンベロープ変数] フィールドのドロップダウンリストから、メッセージエンベロープを格納する変数を選択します。
[メッセージペイロード] フィールドで、ゼロ個以上のメッセージの添付ファイルに対してタイプ（XML または ebXML バイナリ）、および各添付ファイルのデータを格納する関連変数を選択します。

注意: [メッセージペイロード] フィールドの各行は、関連 ebXML メッセージの添付ファイルを表しています。1 つの ebXML メッセージに複数の添付ファイルがある場合、このフィールドの行の順序がメッセージ中の添付ファイルの順序となります。[メッセージペイロード] フィールドの行を空のままにすると、メッセージ受信時に ebXML メッセージに対応する添付ファイルがあっても無視されます。

[OK] をクリックして設定を保存し、ダイアログボックスを閉じます。

ebXML 会話の終了

ebXML ベースの会話は、両方のトレーディングパートナについて ebXML メッセージの交換が完了した時点で終了します。

この動作は、XOCP ビジネスプロトコルと対照的です。WebLogic Integration では、XOCP 会話管理サービスをサポートしており、その場合、会話を開始するワークフローが同時に会話の終了も行ない、会話の各ワークフローに会話終了メッセージを送信します（詳細については、『B2B Integration ワークフローの作成』の「協調的ワークフローの終了」を参照）。

XOCP 会話の場合、会話終了プロパティを定義するには、会話を開始したワークフローの完了ノードで [カスタム] オプションを選択します。このオプションは ebXML ベースの会話には選択しないでください。逆に、ebXML 会話のワークフローでは、完了ノードに [カスタム] オプションが選択されていないことを確認する必要があります。

ebXML のサンプルアプリケーション

ebXML のサンプルアプリケーションは、インストールした WebLogic Integration の ¥SAMPLES_HOME¥integration¥samples¥ebxml ディレクトリにあります（SAMPLES_HOME は WebLogic Platform のサンプルがインストールされるディレクトリを表します）。このサンプルでは、「価格と在庫の照会（QPA）」会話における開始者ロールとして設計されたワークフローと参加者ロールとして設計されたワークフローの 2 つのワークフローが紹介されています。どちらのワークフローも WebLogic Integration をデプロイする 2 つのトレーディングパートナ間の ebXML ベースのビジネスプロセスを管理するように設計されています。実行方法も含め、このサンプルに関する説明は、『B2B Integration サンプルの使い方』の「ebXML サンプル」を参照してください。

ebXML サンプルはさらに追加されており、次の URL の BEA dev2dev オンラインサイトに掲載される予定です。

http://dev2dev.bea.com