RosettaNet 参加者ビジネスプロセスの構築

このトピックでは、Oracle Workshop for WebLogic で RosettaNet 参加者ビジネスプロセスファイルを使用して、RosettaNet 会話のパブリック参加者ビジネスプロセスを構築する方法について説明します。

RosettaNet は主要企業が参加するコンソーシアムであり、産業界全体に渡るオープン e ビジネスプロセス規格を作成および実装するために活動しています。これらの規格により、共通の e ビジネス言語の構築し、グローバル規模でのサプライチェーンパートナ間のプロセスの連係を図ります。RosettaNet は、Uniform Code Council, Inc. (UCC) の子会社です。RosettaNet については、次の URL にアクセスしてください。

このトピックでは、RosettaNet PIP3A4 に基づき、「パブリック」、「参加者」のダブルアクションビジネスプロセスを重点的に説明します。「開始者」ビジネスプロセスには、RosettaNet コントロールを使用します。これは、会話で RosettaNet メッセージの送受信を行うメソッドを提供します。

RosettaNet 参加者ビジネスプロセスについて

RosettaNet 参加者ビジネスプロセスは、RosettaNet 会話のパブリック参加者ビジネスプロセスを構築するための土台になります。このファイルは、RosettaNet 参加者ビジネスプロセスの構築に必須ではありませんが、RosettaNet 開始者ビジネスプロセスと簡単に統合するために必要となるノードおよびビジネスプロセスアノテーションを含んでいます。

RosettaNet 参加者ビジネスプロセスは、RosettaNet メッセージ交換を構築できるプロセスタイプの例として使用する目的で用意されています。ファイルは次のノードで構成されています。

サンプルノード名	サンプルノードタイプ	説明
Start	開始	これにより、ビジネスプロセスの開始部分が示される。開始ノードの [アノテーション] ペインに、次のプロパティを定義できる。 pipName pipRole pipVersion protocolName protocolVersion これらのアノテーションについては、「ビジネスプロセスアノテーションのコンフィグレーション (必須)」を参照。開始ノードの詳細については、「ビジネスプロセスの開始」を参照。
On Error Message (グローバルエラー処理)	メッセージパス	メッセージパスを使用して、クライアントまたはコントロールからのメッセージの配信時に、プロセスの実行を中断する。これにより、プロセスは現在の実行の流れを中断して、指定した代わりのアクションを行う。メッセージパスについての詳細は、「メッセージパスの追加」を参照。
On Error (グローバルメッセージパス)	クライアント要求	このノード、またはその場所の他のノードを使用して、エラーメッセージを受信したときに行うエラー処理を実行する。Client Request ノードについては、「クライアントからメッセージを受信する」を参照。
Alert local administrator (グローバルメッセージパス)	実行	このノード、またはその場所の他のノードを使用して、エラーメッセージを管理者に送信する。実行ノードについては、「Perform ノードでのカスタム Java コードの記述」を参照。
Receive Message	クライアント要求	開始者から RosettaNet メッセージを受信した後、RosettaNet 参加者ビジネスプロセスを開始する。Client Request ノードについては、「クライアントからメッセージを受信する」を参照。
Send receipt acknowledgment.	クライアント応答	要求メッセージの受信確認を開始者に送信する。クライアント応答ノードについては、「コントロールを使用してリソースと対話する」を参照。
Send private message (プライベートプロセスグループを呼び出す)	実行	このノード、またはその場所の他のノードを使用して、要求をプライベートプロセスに送信する。実行ノードについては、「Perform ノードでのカスタム Java コードの記述」を参照。
Receive private message (プライベートプロセスグループを呼び出す)	実行	このノード、またはその場所の他のノードを使用して、プライベートプロセスから応答を受信する。実行ノードについては、「Perform ノードでのカスタム Java コードの記述」を参照。
Send reply (再試行ブロック)	クライアント応答	このノード、またはその場所の他のノードを使用して、応答を開始者に返送する。Client Response ノードについては、「メッセージのクライアントへの送信」を参照。
Receive receipt acknowledgment (再試行ブロック)	クライアント要求	このノード、またはその場所の他のノードを使用して、開始者プロセスからの確認をリスンする。Client Request ノードの詳細については、「クライアントからメッセージを受信する」を参照。
OnTimeout (再試行ブロック上のタイムアウトパス)	タイムアウトパス	タイムアウトパスを使用して、特定の時間が経過した後に再試行ブロックグループでノードの反復実行を中断する。ノードのグループ化については、「ビジネスプロセス内のノードのグループ化」を参照。タイムアウトパスについての詳細は、「タイムアウトパスの追加」を参照。
Check retries (再試行ブロック上のタイムアウトパス)	条件	このノード、またはその場所の他のノードを使用して、1 つまたは複数の条件の評価に基づいて実行パスを選択する。この場合は、再試行ブロックグループの反復回数である。分岐ノードの詳細は、「分岐条件の定義」を参照。
Notification of Failure (再試行ブロック上のタイムアウトパス)	実行	このノード、またはその場所の他のノードを分岐ノード内に配置して、再試行ブロックグループの反復がタイムアウトになった場合は、開始者への障害通知を処理する。このノードは通常、PIP0A1 障害通知を呼び出す場所。実行ノードについては、「Perform ノードでのカスタム Java コードの記述」を参照。このノードをカスタマイズする方法については、「障害通知の設定 (必須)」を参照。
Finish	完了	RosettaNet 参加者ビジネスプロセスを終了する。完了ノードについては、「ビジネスプロセスでのエンドポイントの指定」を参照。

このビジネスプロセスは、ダブルアクションアクティビティ (非同期) コレオグラフィにモデル化されており、『RosettaNet Implementation Framework Core Specification』(version V02.00.01) で指定されています。このコレオグラフィについては、次の URL を参照してください。

RosettaNet 参加者ビジネスプロセスの作成

RosettaNet 参加者ビジネスプロセスファイルを使用すると、パブリック参加者ビジネスプロセスを作成できます。RosettaNet 参加者テンプレートは PIP3A4 に基づいていますが、その他の PIP にも使用できます (PIP スキーマやアノテーションの PIP 識別情報などに多少に違いがあります)。

RosettaNet 参加者ビジネスプロセスを作成するには

まだ作成していない場合は、新しいアプリケーションまたは既存のアプリケーション内の新しいプロジェクトを作成します。
Oracle Workshop for WebLogic メニューから、[ファイル｜新規｜その他] を選択します。[ウィザードを選択] ダイアログボックスが表示されます。
WebLogic Integration を展開して、[RosettaNet 参加者プロセス] を選択し、[次へ] をクリックします。
[プロセス] ダイアログボックスで、[名前] フィールドに Java ファイルの有効な java クラス名を入力します。

注意 : この名前は、com.bea.wli.jpd.RosettaNet アノテーションの pip-name 属性のデフォルト値として使用されます。プロダクションモードで RosettaNet 参加者ビジネスプロセスを実行する前に、pip-name 属性を有効な PIP コードに変更する必要があります。詳細については、「RosettaNet 参加者ビジネスプロセスのカスタマイズ」を参照してください。

[ソース・フォルダー] に表示されたディレクトリ以外の場所に Java ファイルを作成するには、[参照] ボタンをクリックしてターゲットディレクトリを選択し、[OK] をクリックします。
[終了] をクリックします。

Oracle Workshop for WebLogic は新しい RosettaNet 参加者プロセス Java ファイルを作成し、[デザインビュー] ペインに表示します。

作業内容を保存するには、[ファイル｜保管] を選択します。

RosettaNet 参加者ビジネスプロセスのカスタマイズ

RosettaNet 参加者ビジネスプロセスを作成したら、関連する RosettaNet 会話用にカスタマイズする必要があります。一般的なカスタマイズの作業は以下のとおりです。

実装要件に応じて、参加者ビジネスプロセスに追加のカスタマイズが必要になる場合があります。

ビジネスプロセスアノテーションのコンフィグレーション (必須)

RosettaNet 参加者ビジネスプロセスファイルでは、次のデフォルトアノテーションを指定します。

これらのプロパティは、ビジネスプロセスの開始ノードを選択したときに表示されるプロパティ ビューで設定します。次のプロパティを見直して (必要に応じて) 編集します。

プロパティ	デフォルト	説明
pipName	`processName`	RosettaNet PIP コードを `3B2` などに変更する。次のサイトで定義するように、有効な PIP コードでなければならない。 `http://www.rosettanet.org`
pipRole	販売者	PIP 仕様での定義に従って参加者のロールの RosettaNet 名に変更する (例: PIP3B2 の受信者)。
pipVersion	1.0	RosettaNet PIP バージョンに変更する (例: PIP3B2 用 v01.01)。PIP に関連付けられた有効なバージョン番号でなければならない。
protocolName	rosettanet	変更しない。
protocolVersion	2.0	RNIF (RosettaNet Implementation Framework) version 1.1 を使用している場合は、1.1 に変更する。

引数タイプのカスタマイズ (省略可能)

デフォルトでは、RosettaNet 参加者ビジネスプロセスには、Client Request ノードが Receive Message という名前で含まれており、開始者からの着信 RosettaNet 要求メッセージを処理します。response および callback.sendReply メソッドでは、添付ファイルとその Java データ型の指定が必要な場合があります。データ型は、着信メッセージの内容と一致する必要があり、次の値のいずれかになります。

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

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

データトランスフォーメーションのコンフィグレーション (必須)

パブリックおよびプライベートのビジネスプロセスはさまざまなドキュメント形式をよく使用します。パブリックビジネスプロセスは関連付けられた PIP スキーマを使用します。プライベートプロセスは、独自の ERP フォーマットなど、内部プロセス (XML またはバイナリ) が要求するフォーマットを使用します。プライベートビジネスプロセスが PIP フォーマットを使用しない場合は、パブリックビジネスプロセスは PIP フォーマットから、プライベートビジネスプロセスで使用されているフォーマットにデータを変換する必要があります。

データトランスフォーメーションのコンフィグレーションには、以下を行う必要があります。

プライベート参加者プロセスの統合 (必須)

RosettaNet パブリック参加者ビジネスプロセスを作成したら、それを、開始者の要求をプライベートに処理する「プライベート」参加者プロセスにリンクする必要があります。Oracle Workshop for WebLogic には、他のビジネスプロセスと通信する以下のようなさまざまな方法を提供しています。

障害通知の設定 (必須)

この参加者ビジネスプロセスでは、開始者から応答ドキュメントに対して応答を待っている間にタイムアウトが発生した場合は、参加者は障害通知 (PIP0A1) を開始者に送信する必要があります。PIP0A1 の詳細については、次の URL にアクセスしてください。

開始者に障害を通知するには、PIP0A1 を実装する独立した開始者ビジネスプロセスを作成し、開始者ビジネスプロセスを開始する必要があります。

ビジネス プロセス構築ガイド

RosettaNet 参加者ビジネス プロセスの構築

RosettaNet 参加者ビジネス プロセスについて

RosettaNet 参加者ビジネス プロセスの作成

RosettaNet 参加者ビジネス プロセスを作成するには

RosettaNet 参加者ビジネス プロセスのカスタマイズ

ビジネス プロセス アノテーションのコンフィグレーション (必須)