開始者ビジネスプロセスで ebXML コントロールを使用することで、参加者と ebXML ビジネスメッセージを交換できます。ebXML コントロールは、ビジネスメッセージを送受信するためのメソッドを提供します。詳細については、EBXMLControl インタフェースを参照してください。参加者から受信した ebXML メッセージ、確認応答、およびエラーは、コールバックによって処理されます。

ebXML プロトコル (Electronic Business using eXtensible Markup Language) は、あらゆる場所であらゆる規模の企業がインターネット経由で業務を行うことを可能にする仕様のモジュラスイートです。ebXML は UN/CEFACT および OASIS でサポートされています。ebXML の詳細については、http://www.ebXML.org を参照してください。

ebXML コントロールを使用すると、WebLogic Workshop ビジネスプロセスでは、ebXML 経由でトレーディングパートナとビジネスメッセージおよびデータを交換できます。ebXML コントロールは、ebXML 1.0 と ebXML 2.0 の両方のメッセージングサービスをサポートしています。開始者ビジネスプロセスで ebXML コントロールを使用することで、参加者との ebXML ビジネスメッセージの交換を管理できます。ebXML ソリューションの概要については、『Trading Partner Integration の紹介』(以下の URL) を参照してください。

この節に含まれるトピック

関連トピック

ebXML コントロールを作成する

ここでは、新しい ebXML コントロールを作成する方法について説明します。各 ebXML コントロールインスタンスは、1 つの ebXML 会話を表します。ビジネスプロセス内の異なる ebXML 会話ごとに、異なる ebXML コントロールインスタンスを追加する必要があります。ebXML コントロールについては、「ebXML コントロール」を参照してください。

新しい ebXML コントロールを作成するには

[パッケージ・エクスプローラー] ペインで、ebXML コントロールを追加するビジネスプロセスをダブルクリックします。ビジネスプロセスがデザインビューに表示されます。
データパレットのをクリックし、ドロップダウンリストから Integration コントロールを選択して、アプリケーションの統合に使用するコントロールのリストを表示します。

注意 :

[データパレット] ビューが BEA Workshop for WebLogic Platform に表示されない場合は、メニューバーから [ウィンドウ

ビューの表示

データパレット] をクリックします。

[Ebxml] を選択します。

[Insert control: Ebxml] ダイアログボックスが表示されます (図 5-1)。

図 5-1 Insert control: Ebxml

[Insert control: プロセス] ダイアログボックスで、以下の情報を入力します。

[フィールド名] に、ビジネスプロセスから新しいプロセスコントロールインスタンスにアクセスするときに使用する変数の名前を入力します。有効な Java 識別子を入力する必要があります。
[挿入位置] で、フィールド名をプロセスファイルに挿入するポイントをドロップダウンリストから選択します。
これをコントロールファクトリにするかどうかを決定し、[これを実行時に複数のインスタンスを作成できるコントロールファクトリにする] チェックボックスをチェックするか、チェックをはずします。コントロールファクトリの詳細については、「コントロールファクトリ : コントロールをまとめて管理する」を参照してください。
[次へ] をクリックします。

[コントロールの作成] ウィザードが表示されます。

[コントロールの作成] ウィザードで、以下の情報を入力します。

[名前] フィールドに新しいコントロール拡張ファイルの名前を入力します。
現在のプロジェクトのプロパティに設定されているようにコメントを追加するかどうかを決定し、[コメントの生成] チェックボックスをチェックするか、チェックをはずします。
[次へ] をクリックします。

[Insert control: Ebxml] ダイアログボックスが表示されます。

[Insert control: Ebxml] ダイアログボックスで、表 5-1 に従って以下の情報を指定します。

フィールド

説明

from

省略可能。この会話の開始者のビジネス ID。次のいずれかの値になる。

空の場合 - デフォルトのトレーディングパートナを使用する。
静的な値の場合 - 開始者トレーディングパートナのビジネス ID。指定されるビジネス ID は、TPM リポジトリでコンフィグレーションされていなければならない。

開始者ビジネス ID を動的に指定するには、セレクタを使用するか、またはコントロール送信ノードで setProperties メソッドを使用する (「ビジネス ID を動的に指定する」を参照)。

この値は、プロセス変数に XQuery セレクタを使用して、または受信メッセージでメソッドパラメータを使用して取得することもできる。

注意 :

[to] 属性、[to-selector] 属性や setProperties を使用して「from」トレーディングパートナの値を指定しなければ、システムが TPM コンソールで「default」としてマークされているローカルトレーディングパートナの ID を使用します。

to

省略可能。この会話の参加者のビジネス ID。次のいずれかの値になる。

空の場合 - デフォルトのトレーディングパートナを使用する。
静的な値の場合 - 参加者トレーディングパートナのビジネス ID。指定されるビジネス ID は、TPM リポジトリでコンフィグレーションされていなければならない。

参加者ビジネス ID を動的に指定するには、セレクタを使用するか、またはコントロール送信ノードで setProperties メソッドを使用する (「ビジネス ID を動的に指定する」を参照)。

この値は、プロセス変数に XQuery セレクタを使用して、または受信メッセージでメソッドパラメータを使用して取得することもできる。

serviceName

必須。ebXML サービスの名前。同一の会話に参加する開始者と参加者のビジネスプロセスでは、ebxml-service-name の設定が同じでなければならない。このサービス名は、ebXML メッセージエンベロープの eb:Service エントリに対応する。

method-arg-type

必須。添付ファイルの型。次のいずれかの値になる。

XmlObject - デフォルト。型なしの XML フォーマットのデータを表す。XML データは、設計時には指定されない。
XmlObject[] - 1 つまたは複数の XmlObject 要素を含む配列。

注意 : XmlObject[] オプションは、コントロールウィザードウィンドウのドロップダウンメニューから使用できません。ソースビューで指定する必要があります。「XmlObject および RawData 配列のペイロードを指定する」を参照してください。

RawData - 任意の非 XML 構造化データまたは非構造化データを表す。このデータの MFL ファイルは存在しない (そのため、既知のスキーマはない)。
RawData[] - 1 つまたは複数の RawData 要素を含む配列。

注意 : RawData[] オプションは、コントロールウィザードウィンドウのドロップダウンメニューから使用できません。ソースビューで指定する必要があります。「XmlObject および RawData 配列のペイロードを指定する」を参照してください。

MessageAttachment[] - ebXML のビジネスメッセージの 1 つまたは複数のパートを含む配列。メッセージパートには型なしの XML データ (XmlObject データ型) と非 XML データ (RawData データ型) がある。異なる種類のペイロード (XML と非 XML) を同じメッセージで送信するときに使用される。メッセージ部分の実際の数は、処理されるまで不明なことがある。

MessageAttachment オブジェクトの操作については、「メッセージ添付ファイルを使用する」を参照。

データ型の詳細については、「データ型の操作」を参照。

ebxmlActionMode

この ebXML コントロールのアクションモード。ebXML メッセージのメッセージヘッダにある eb:Action 要素で指定される値を決定する。この値は、同じ会話の中で複数のメッセージ交換が行われるときに重要になる。次のいずれかの値になる。

default - eb:Action 要素を SendMessage (デフォルト名) に設定する。
non-default - eb:Action 要素を、開始者ビジネスプロセス内でメッセージを送信する (ebXML コントロール上の) メソッドの名前に設定する。開始者から参加者にメッセージを送信するためには、この名前が、対応する参加者ビジネスプロセスにあるクライアント要求ノードのメソッド名と一致していなければならない。参加者から開始者にメッセージを送信するためには、参加者ビジネスプロセス内のクライアントコールバックノードのコールバックインタフェースにあるメソッド名が、開始者ビジネスプロセス内のコントロールコールバックインタフェースにある (ebXML コントロール上の) メソッド名と一致しなければならない。確実に回復できるようにし、かつ、高可用性を実現するためには、non-default の使用を推奨する。

特に指定しなければ、ebxml-action-mode は non-default に設定される。

xQueryVersion

使用する XQuery のバージョンを指定する。

[終了] をクリックします。

ebXML コントロールインスタンスが [コントロール] タブに表示されます。

コントロールファイルを作成すると、BEA Workshop for WebLogic Platform の [サービス] タブでそのコントロールファイルの名前がサービスとして使用できるようになります。

XmlObject および RawData 配列のペイロードを指定する

XmlObject[] および RawData[] ペイロードオプションはソースビューでのみ使用できます。ebXML コントロールを作成した後で、これらのオプションを使用するようにコンフィグレーションできます。

ソースビューでペイロードを指定するには

コントロール定義ファイルを開きます。それには、[パッケージ・エクスプローラー] ペインでファイルをダブルクリックします。
[ソースビュー] タブをクリックします。
request および response メソッドで、指定されているペイロードを、使用するペイロードの型に変更します。

ペイロードの指定には、以下の制約が適用されます。

任意の型の配列を使用する場合、引数リスト内で配列の後にその型の引数を指定することはできない。つまり、配列はその型の引数の中で最後に指定する必要があります。
MessageAttachment[] 型が引数の 1 つである場合、引数リストに他の配列 (MessageAttachment[] を含む) を指定することはできない。

変更を適用したら、コントロール定義ファイルを保存して閉じます。

関連トピック

ebXML コントロールを使用する

すべての WebLogic Workshop コントロールは一貫したモデルに従います。ebXML コントロールもその他の WebLogic Workshop コントロールを使用する場合とほぼ同じです。

開始者ビジネスプロセスに ebXML コントロールを追加したら、コントロールでメソッドを使用して参加トレーディングパートナと ebXML メッセージを交換できます。デザインビューのデータパレットで ebXML コントロールのノードを展開し、そのメソッドを表示します。次に、目的のメソッドをビジネスプロセスにドラッグアンドドロップします。一般的な作業は以下のとおりです。

参加者にメッセージを送信する

参加者に ebXML メッセージを送信するには、コントロール送信ノードでメッセージ送信メソッドを使用します。デフォルトでは、コントロールファイルインスタンスには、生成された送信メソッド request が含まれています。ビジネスプロセスにコントロール送信ノードを追加するには、このメソッドをデータパレットからビジネスプロセスにドラッグします。複数のやり取りを伴うビジネスプロセスの場合には、参加者への ebXML メッセージ送信を含む処理ごとに個別のコントロール送信ノードを作成する必要があります。

コントロール送信ノードを作成したら、ペイロードパートとその Java データ型を指定する必要があります (表 5-2 を参照)

表 5-2 データ型
型	説明
`XmlObject`	型なし XML フォーマットのデータ。
`XmlObject[]`	1 つまたは複数の `XmlObject` 要素を含む配列。
`RawData`	非 XML 構造化データまたは非構造化データ。このデータの MFL ファイルは存在しない (そのため、既知のスキーマはない)。
`RawData[]`	1 つまたは複数の `RawData` 要素を含む配列。
`MessageAttachment[]`	ebXML のビジネスメッセージの 1 つまたは複数の部分を含む配列。メッセージパートには型なしの XML データ (`XmlObject` データ型) と非 XML データ (`RawData` データ型) がある。異なる種類のペイロード (XML と非 XML) を同じメッセージで送信するときに使用される。メッセージ部分の実際の数は、処理されるまで不明なことがある。`MessageAttachment[]` オブジェクトの操作については、「メッセージ添付ファイルを使用する」を参照。

型付き XML データや型付き MFL データを添付ファイルにすることもできますが、その場合は対応する XML Bean クラス名や MFL クラス名をパラメータ内で指定する必要があります。

参加者からの応答を処理する

参加者からの応答を処理するには、開始者ビジネスプロセスで以下のコールバックメソッドを使用します (表 5-3 を参照)。

表 5-3 コールバックメソッド
メソッド名	説明
`onAck`	参加者からのメッセージ受信通知を処理する。
`onError`	参加者から送られたエラーを処理する。
`response`	参加者から送られた応答メッセージを処理する。

参加者から ebXML メッセージを受信するには、適切なメソッドを使用します。ビジネスプロセスにメソッドを追加するには、データパレットからビジネスプロセスまで、そのメソッドをドラッグします。これにより、コントロール受信ノードが作成されます。複数のやり取りを伴うビジネスプロセスの場合には、参加者からの ebXML メッセージ受信を含む処理ごとに個別のコントロール受信ノードを作成する必要があります。

response メソッドで、ebxml-action-node に non-default が指定されている場合には、コントロール受信ノードの名前を getInvoice などわかりやすい名前に変更できます。ただし、ebxml-action-node に default が指定されている場合には、デフォルト名 (onMessage) を使用する必要があり、ビジネスプロセスは 1 つの onMessage コントロール受信ノードしかもつことができません。

response メソッドでは、コントロール受信ノードの作成後、受信メッセージのペイロードパートとその Java データ型を指定する必要があります。有効なデータ型については、「参加者にメッセージを送信する」を参照してください。

onError メソッドと onAck メソッドは、システムレベルのメソッドです。どちらも、メッセージの受信時に ebXML エンベロープを格納する EnvelopeDocument 引数を使用します。システムレベルのメソッドなので、これらの引数はデフォルトのコントロールでは表示されませんが、データパレットからビジネスプロセスにドラッグできます。envelope.xsd ファイルをもつスキーマプロジェクトがアプリケーションに含まれており、スキーマがすでに構築されている場合は、WebLogic Workshop のマッパー機能でクエリを (XQuery 言語で) 作成して、必要な値を抽出できます。マッパー機能を使用してクエリを作成する方法については「XQuery を使用したデータの変換」を参照してください。

@jc:ebxml-method タグで message-envelope アノテーションを使用して、受信 ebXML メッセージのメッセージエンベロープを取得できます。envelope アノテーションの詳細については、EBXMLControl.EbxmlMethod アノテーションを参照してください。

ビジネス ID を動的に指定する

ebXML コントロールでは、コントロールの開始者 (from プロパティ) および参加者 (to プロパティ) のビジネス ID を動的にバインドする機能を追加できます。プロパティの動的バインディングは以下の方法で行うことができます。

優先順位

最も優先順位の高い方法から挙げると、プロパティ設定の階層は次のようになります。

セレクタ (EBXMLControl.EbxmlMethod アノテーション) と DynamicProperties.xml ファイルを使用して動的にバインドされるプロパティ
setProperties() メソッドを使用して設定されるプロパティ
JPD でアノテーション EBXMLControl.EbXM を使用してコントロールインスタンスレベルで設定されるプロパティ
JPD でアノテーション EBXMLControl.EbXM を使用してコントロールクラスレベルで設定されるプロパティ

動的なセレクタの方が静的なセレクタよりも優先順位が高くなります。

セレクタを使用する

動的なセレクタを使用することで、ebXML コントロールでは実行時に、複数のトレーディングパートナからビジネスメッセージの送信先になる 1 つを決定できます。動的なセレクタを指定するときには、必要なビジネス ID を取得する XQuery を構築してテストします。

動的なセレクタを使用するには

デザインビューに、動的なセレクタを指定する ebXML コントロールを含むビジネスプロセスを表示します。
デザインビューのデータパレットで、ebXML コントロールノードを選択します。
プロパティエディタで from-selector プロパティまたは to-selector プロパティを見つけ、関連付けられた xquery パラメータを選択します。[xquery] フィールドの横の、3 つのドット (...) で示されるボタンをクリックします。動的なセレクタクエリビルダが表示されます。
[開始メソッドのスキーマ] 領域で、コントロールの開始メソッドに関連付ける要素を選択します。生成されたクエリが [XQuery] 領域に表示されます。
[OK] をクリックします。

setProperties を使用する

setProperties メソッドは ebXMLPropertiesDocument パラメータを取ります。ebXMLPropertiesDocument 型は、DynamicProperties.xsd で定義された対応するスキーマ要素から生成される XML Beans クラスです。DynamicProperties.xsd ファイルは、新しいプロセスアプリケーションのシステムフォルダ内、またはスキーマプロジェクトのシステムフォルダ内にあります。

DynamicProperties.xsd ファイルをもつスキーマプロジェクトがアプリケーションに含まれており、スキーマがすでに構築されている場合は、WebLogic Workshop のマッパー機能でクエリを (XQuery 言語で) 作成して、必要な値を抽出できます。マッパー機能を使用してクエリを作成する方法については「XQuery を使用したデータの変換」を参照してください。

setProperties メソッドを使用してビジネス ID を動的に設定するには

DynamicProperties.xsd ファイルをもつスキーマプロジェクトがアプリケーションに含まれており、スキーマがすでに構築されていることを確認します。
ビジネスプロセスにコントロール送信ノードを作成します。
データパレットから setProperties メソッドをドラッグし、コントロール送信ノードにドロップします。
[データの送信] タブで [トランスフォーメーション] を選択し、to および from 値を格納している変数を指定します。次にそれらを ebXMLPropertiesDocument 内の対応する要素にマップするトランスフォーメーションを作成します。

現在のプロパティ設定を表示するには、getProperties() メソッドを使用します。

Integration コントロールを使用する

ebXML コントロール

この節に含まれるトピック

概要 : ebXML コントロール

ebXML コントロールを作成する

ebXML コントロールを使用する

サンプル : ebXML コントロール

関連トピック

概要 : ebXML コントロール

関連トピック

ebXML コントロールを作成する

新しい ebXML コントロールを作成するには

XmlObject および RawData 配列のペイロードを指定する

ソース ビューでペイロードを指定するには

関連トピック

ebXML コントロールを使用する

参加者にメッセージを送信する

参加者からの応答を処理する

ビジネス ID を動的に指定する

優先順位

セレクタを使用する

動的なセレクタを使用するには

setProperties を使用する

setProperties メソッドを使用してビジネス ID を動的に設定するには

関連トピック

サンプル : ebXML コントロール

ソースビューでペイロードを指定するには