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

RosettaNet は主要企業が参加するコンソーシアムであり、産業界全体に渡るオープン e ビジネスプロセス規格を作成および実装するために活動しています。これらの規格により、共通の e ビジネス言語の構築し、グローバル規模でのサプライチェーンパートナ間のプロセスの連係を図ります。RosettaNet は、Uniform Code Council, Inc. (UCC) の子会社です。Roset、taNet については、http://www.rosettanet.org を参照してください。BEA Workshop for WebLogic Platform ビジネスプロセスでは、RosettaNet コントロールを使用することで、RosettaNet を経由してトレーディングパートナとビジネスメッセージおよびデータの交換ができます。RosettaNet コントロールは、開始者ビジネスプロセスにおいて参加者との RosettaNet ビジネスメッセージの交換を管理する場合のみ使用します。RosettaNet ソリューションの概要については、『Trading Partner Integration の紹介』(以下の URL) を参照してください。

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

概要 : RosettaNet コントロール

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

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

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

関連トピック

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

ここでは、新しい RosettaNet コントロールを作成する方法について説明します。パブリックな開始者ビジネスプロセスごとに RosettaNet コントロールを 1 つ追加します。パブリックプロセスとプライベートプロセスの詳細については、『Trading Partner Integration の紹介』(http://edocs.beasys.co.jp/e-docs/wli/docs81/tpintro/index.html) の「トレーディングパートナビジネスプロセスの概念」にある「ビジネスプロセスのタイプ」を参照してください。RosettaNet コントロールについては、「RosettaNet コントロール」を参照してください。

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

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

[Rosettanet] を選択します。
[Insert control: RosettaNet] ダイアログボックスが表示されます。[Insert control: RosettaNet] ダイアログボックスで、以下の情報を入力します。

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

[コントロールの作成] ダイアログボックスが表示されます。

[コントロールの作成] ダイアログボックスで、以下の情報を入力します。

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

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

[Insert control: Rosettanet] ダイアログボックスで、以下の情報を指定します (表 12-1 を参照)。

注意 :

該当する場合、ここで入力した値は TPM リポジトリ内の対応する設定に一致する必要があります。

表 12-1 Rosettanet のフィールド
フィールド	説明
`from`	送信者の DUNS 番号。TPM リポジトリで定義する必要がある。
`to`	受信者の DUNS 番号。TPM リポジトリで定義する必要がある。
`rnif-version`	RNIF (RosettaNet Implementation Framework) のバージョン。次のいずれかの値になる。 1.1 2.0
`pip`	`3B2` などの RosettaNet PIP コード。`http://www.rosettanet.org` で定義されている有効な PIP コードでなければならない。
`pip-version`	RosettaNet PIP のバージョン。PIP に関連付けられた有効なバージョン番号でなければならない。
`from-role`	PIP 仕様で定義されている、送信側の RosettaNet ロール名。Buyer、Initiator、Shipper など。正しくない値が指定されている場合は、PIP 要求が拒否される可能性がある。
`to-role`	PIP 仕様で定義されている、受信側の RosettaNet ロール名。Seller、Participant、Receiver など。正しくない値が指定されている場合は、PIP 要求が拒否される可能性がある。
`method-arg-type`	必須。添付ファイルの型。標準の RNIF XML 部分を含む。次のいずれかの値になる。 `XmlObject` - デフォルト。型なしの XML フォーマットのデータを表す。XML データは、設計時には指定されない。 `RawData` - 非 XML 構造化データまたは非構造化データを表す。このデータの MFL ファイルは存在しない (そのため、既知のスキーマはない)。ペイロードに標準の RNIF XML 部分が含まれるので、推奨されない。 `MessageAttachment[]` - ビジネスメッセージの 1 つまたは複数の部分を含む配列。メッセージパートには型なしの XML データ (`XmlObject` データ型) と非 XML データ (`RawData` データ型) がある。異なる種類のペイロード (XML と非 XML) を同じメッセージで送信するときに使用される。メッセージ部分の実際の数は、処理されるまで不明なことがある。`MessageAttachment` オブジェクトの操作については、「メッセージ添付ファイルを使用する」を参照。データ型の詳細については、「データ型の操作」を参照。

[終了] をクリックします。
要求されたら、コントロールファイルを保存するサブフォルダを選択します。

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

関連トピック

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

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

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

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

RosettaNet コントロールには、開始者の要求メッセージを参加者に送信するためのメソッドや、参加者の返信に応答するためのメソッドが備わっています。ビジネスプロセスにメソッドを追加するには、データパレットからビジネスプロセスまで、そのメソッドをドラッグします。これにより、コントロール送信ノードが作成されます。

要求メッセージを送信する

sendMessage メソッドを使用して、RosettaNet 要求メッセージを参加者に送信します。ビジネスプロセスにコントロール送信ノードを作成したら、ペイロード部分とその Java データ型を指定する必要があります。有効なデータ型は以下のとおりです。

表 12-2 データ型
型	説明
`XmlObject`	型なし XML フォーマットのデータ。
`RawData`	非 XML 構造化データまたは非構造化データ。このデータの MFL ファイルは存在しない (そのため、既知のスキーマはない)。
`MessageAttachment`	型なしの XML フォーマットと非 XML フォーマット両方のデータ。`MessageAttachment` オブジェクトの操作については、「メッセージ添付ファイルを使用する」を参照。

参加者の返信に応答する

RosettaNet メッセージを送信した後、開始者ビジネスプロセスは参加者からの応答を待機します。要求に対する参加者の応答を受信した後、ビジネスプロセスは、確認応答して応答を受け付けるか、応答を拒否するか、またはエラーが発生したことを参加者に通知することができます。RosettaNet コントロールには、参加者の返信に応答するための以下のメソッドが備わっています。

表 12-3 メソッド型
メソッド名	説明
`sendAck`	参加者に受信の RosettaNet 確認応答を送信する。
`sendError`	参加者に RosettaNet エラーを送信する。
`sendReject`	参加者に RosettaNet 拒否を送信する。

参加者からのメッセージを処理する

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

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

参加者から RosettaNet メッセージを受信するには、適切なメソッドを使用します。ビジネスプロセスにメソッドを追加するには、データパレットからビジネスプロセスまで、そのメソッドをドラッグします。これにより、コントロール受信ノードが作成されます。

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

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

メッセージ要素を取得する

RosettaNetContext XMLBean を使用して、RosettaNet メッセージから特定のメッセージ要素を取得できます。以下のメッセージ要素が取得可能であり、java.lang.string として返されます。

表 12-5 メッセージの要素
要素名	説明
`from`	送信者の DUNS 番号。
`to`	受信者の DUNS 番号。
`pip`	メッセージ用に指定された RosettaNet PIP コード。
`pip-version`	メッセージ用に指定された PIP バージョン。
`from-role`	PIP 仕様で定義されている送信側の RosettaNet ロール名。Buyer、Initiator、Shipper など。
`to-role`	PIP 仕様で定義されている受信側の RosettaNet ロール名。Seller、Participant、Receiver など。
`failure-report-administrator`	障害を管理するように指定されているトレーディングパートナのトレーディングパートナ ID。WebLogic Integration では、送信側トレーディングパートナのバインディングで指定する。
`global-usage-code`	メッセージがテストモードとプロダクションモードのどちらで送信されたのかを示す。
`debug-mode`	メッセージがデバッグモードで送信された場合は `true` を返す。
`message-tracking-id`	このメッセージが応答となるアクションのインスタンス ID。
`protocol-name`	使用されるプロトコルの名前。
`protocol-version`	使用されるプロトコルのバージョン。
`conversation-id`	会話の ID。
`process-instance-id`	受信プロセスのインスタンス ID。
`process-uri`	受信プロセスの URI。
business-action	メッセージのビジネスアクション。Purchase Order Request、Purchase Order Confirmation など。
document-datetimestamp	文書が作成された日付と時刻。
proprietary-identifier	文書を識別するユニークな番号。

RosettaNetContext XMLBean を使用するときには、必ず以下のクラスをインポートしてください。

以下のコード例は、RosettaNetContext の使用方法を示しています。

メッセージを受信する開始者ビジネスプロセス

public void rn_onMessage(RosettaNetContextDocument doc, 
                         XmlObject msg)
   {
     System.out.println(">>>>> ContextInitiator.rn_onMessage()");
     RosettaNetContextDocument.RosettaNetContext context =
        doc.getRosettaNetContext();
     System.out.println("    from=" + context.getFrom());
     System.out.println("    to=" + context.getTo());
     System.out.println("    pip=" + context.getPip());
     System.out.println("    failure-report-admin=" +
        context.getFailureReportAdministrator());
   }

メッセージを送信する開始者ビジネスプロセス

public void rnSendMessage() throws Exception
   {
     String rnInfo = "Service Content";
     XmlObject xObj = XmlObject.Factory.parse(rnInfo);
     RosettaNetContextDocument doc = rn.sendMessage(xObj);
     System.out.println(doc.toString());
   }

Service Content は、RosettaNet メッセージのサービスコンテンツです。

メッセージを受信する参加者ビジネスプロセス

public void onMessage(RosettaNetContextDocument doc, XmlObject msg)
   {
     System.out.println(">>>>> ContextParticipant.onMessage()");
     RosettaNetContext context = doc.getRosettaNetContext();
     System.out.println("    from=" + context.getFrom());
     System.out.println("    to=" + context.getTo());
     System.out.println("    pip=" + context.getPip());
     System.out.println("    failure-report-admin=" +
        context.getFailureReportAdministrator());
   }

コールバック用の参加者ビジネスプロセスインタフェース

@CallbackInterface()

public interface Callback extends ServiceBrokerControl
{

/**

* @common:message-buffer enable="false"

*/

@com.bea.wli.common.MessageBuffer(enable = false)

public RosettaNetContextDocument sendReply(XmlObject msg);

/**

* @common:message-buffer enable="false"

*/

@com.bea.wli.common.MessageBuffer(enable = false)

public void sendReceiptAcknowledgement();

/**

* @common:message-buffer enable="false"

*/

@com.bea.wli.common.MessageBuffer(enable = false)

public void sendError(String msg);

@com.bea.wli.jpd.Callback()

public Callback callback;

応答を送信する参加者ビジネスプロセス

public void reply()
   {
     XmlObject xObj = null;
     try {
       xObj = XmlObject.Factory.parse("Service Content");
     } catch (Exception e) {
       e.printStackTrace();
     }

     RosettaNetContextDocument doc= callback.sendReply(xObj);
     System.out.println(doc.toString());
   }

Service Content は、RosettaNet メッセージのサービスコンテンツです。

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

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

優先順位

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

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

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

セレクタを使用する

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

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

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

setProperties を使用する

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

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

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

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

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

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

RosettaNet コントロール

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

概要 : RosettaNet コントロール

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

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

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

関連トピック

概要 : RosettaNet コントロール

関連トピック

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

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

関連トピック

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

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

要求メッセージを送信する

参加者の返信に応答する

参加者からのメッセージを処理する

メッセージ要素を取得する

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

優先順位

セレクタを使用する

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

setProperties を使用する

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

関連トピック

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

関連トピック