このスクリプトでは、e-docs マニュアルの検索に必要な Google 検索の URL を出力します。
このスクリプトでは、e-docs マニュアルに必要なバナーを出力します。
このスクリプトでは、e-docs マニュアルの検索に必要な Google 検索のパラメータを出力します。
ビジネス プロセス構築ガイド
ビジネス プロセス アプリケーションの作成
Oracle WebLogic Integration では、Oracle Workshop for WebLogic のグラフィカルな設計環境が拡張され、統合エンタープライズ アプリケーションを構築できるようになります。WLI アプリケーションには、プロジェクトとファイルが含まれます。プロジェクトには、ビジネス プロセス、コントロール、Web サービス、XML ファイルなど、複数のコンポーネントを含めることができます。
この節では、WLI アプリケーションのコンポーネント、Oracle Workshop for WebLogic でアプリケーションを作成する手順および、アプリケーションにビジネス プロセスを組み込む方法について説明します。内容は以下のとおりです。
アプリケーションのコンポーネント
この節では、ビジネス プロセス アプリケーションを構築する際に作成する一部の高レベル コンポーネントと、これらのコンポーネントが、コンポーネント用に選択した名前に基づき、デプロイされたアプリケーションに表示される方法について概説します。
アプリケーション - 作成するアプリケーションのコンポーネントは、Oracle Workshop for WebLogic 環境の [パッケージ・エクスプローラー ] ペインのツリー構造に表示されます。Oracle Workshop for WebLogic に [パッケージ・エクスプローラー ] ペインが表示されない場合は、メニューから [ウィンドウ|ビューの表示|その他|Java|パッケージ・エクスプローラー ] を選択します。[パッケージ・エクスプローラー ] ペインの例を図 2-1 に示します。
WLI アプリケーションには、以下のプロジェクトがあります (たとえば、前述の図では、Tutorial_Process_Application という名のアプリケーションが示され、エンタープライズ アプリケーション プロジェクト、Web プロジェクト、およびユーティリティ プロジェクトが入っています)。
エンタープライズ アプリケーション (EAR) プロジェクト - JAR ファイル、デプロイメント記述子のビルド ファイル、および自動生成されたファイルが入っているプロジェクト。J2EE アプリケーションおよびそのコンポーネントは、Oracle WebLogic Server に EAR ファイルとしてデプロイされます。
ユーティリティ プロジェクト - XML スキーマおよびメッセージ ブローカ チャネル ファイルが入っているプロジェクト。ウィザードやテンプレートを使用してプロセス アプリケーションを作成すると、ビジネス プロセス アプリケーション フォルダの一部としてユーティリティ プロジェクト が作成されます。ユーティリティ プロジェクトには、schemas フォルダが含まれています。XML スキーマおよび MFL ファイルをビジネス プロセス プロジェクトの schemas フォルダに追加すると、XML Beans を生成するためにコンパイルされます。この方法で、Oracle Workshop for WebLogic により、XML スキーマの状況を示すインタフェースのセットが生成されます。XML Bean 型は、XML スキーマ自体の型に対応します。XML Beans により、組み込みのスキーマ型に対応する Java 型が与えられ、スキーマの任意の派生型について Java 型が生成されます。
詳細については、「スキーマのインポート 」を参照してください。
Web プロジェクト - Oracle WebLogic Server Web アプリケーションが入っているプロジェクト。言い換えると、プロジェクトを作成するということは、Web アプリケーションを作成することです。プロジェクト名は、「Tutorial_Process_Application_Web 」となり、RequestQuote.java という名のビジネス プロセスが入っています。クライアントでは、以下の URL を通じてユーザのビジネス プロセスにアクセスできます。
前述の URL では、host
および port
はホスト サーバ名およびリスニング ポートを示します。
プロジェクトが作成されるときに、さまざまな情報が組み合わせられ、プロジェクトのタイプの指定、標準のライブラリの追加、コンパイラ オプションの設定、パブリッシュ タスクの制御、ビルド パスの設定、およびアノテーション プロセッサの追加が行なわれます。この情報は、プロジェクトの作成時にファセットを選択して指定します。ファセットは、プロジェクトを最初に作成した後に、プロジェクトに追加したり削除したりすることもできます。プロジェクト ファセットを編集するには、[プロジェクト|プロパティー|プロジェクト・ファセット ] を選択します。ビジネス プロセス (Process.java) および Worklist アプリケーションについては、プロジェクト ファセットは既にコンフィグレーションされています。
注意 :
プロセスは、Oracle Weblogic Integration プロセス ファセット (process-enabled) が追加されている WEB プロジェクトでのみ作成できます。同様に、ワークリスト タスク プランは、WebLogic Integration Worklist アプリケーション モジュール ファセット (worklist-enabled) が追加されている EAR プロジェクトでのみ作成できます。
jar としてエクスポートされた Schemas フォルダは、EAR プロジェクトではなく、Web プロジェクトまたは Util プロジェクトに追加する必要があります。Eclipse と WTP の制約により、スキーマ、Channel Builder、およびコントロールは Web プロジェクトまたは Util プロジェクトにのみ関連付けられ、EAR プロジェクトには関連付けられません。EAR プロジェクトのモジュールの依存関係に、Schemas フォルダを jar としてエクスポートまたは追加した場合、チャネル ファイルは宣言されず、ビジネス プロセスのコントロールもデータ パレットには表示されません。
アプリケーションの設計
プロジェクト を アプリケーションに追加し、Oracle Workshop for WebLogic でアプリケーションを構築します。プロジェクトには、ビジネス プロセス、Web サービス、コントロール ファイルおよび XML ファイルなどのアプリケーションのコンポーネントが入っています。
ビジネス プロセス アプリケーションの作成
ビジネス プロセスの設計を素早く開始するために、基本的なビジネス プロセス ファイルを持つアプリケーションを作成できます。これはビジネス プロセス ロジックでカスタマイズできます。手順は、次のとおりです。
新しいアプリケーションを作成するには
Oracle Workshop for WebLogic メニューから、[ファイル|新規|その他 ] をクリックします。
[ウィザードを選択 ] ダイアログ ボックスが表示されます。
[WebLogic Integration] を展開して [プロセス アプリケーション ] を選択し、 [次へ ] をクリックします。
[プロセス アプリケーション ] ダイアログ ボックスで、以下の例に示すように詳細情報を入力します。
[EAR プロジェクト名 ] フィールドに Process_Application_EAR
と入力します。
[Web プロジェクト名 ] フィールドに Process_Application_Web
と入力します。
[ユーティリティ プロジェクト名 ] フィールドに Process_Application_Utility
と入力します。
[WebLogic Integration システムおよびコントロール スキーマをユーティリティ プロジェクトに追加 ] チェック ボックスを選択します。
この操作により、システム スキーマが Utility Project/schemas フォルダに追加されます。
[終了 ] をクリックします。
この操作により、基本的なビジネス プロセス プロジェクトを持つアプリケーションが作成されます。これには、Start および Finish ノードのみを含むビジネス プロセス ファイル含まれます (process.java
)。
注意 :
[プロセス アプリケーション ] ではなく [チュートリアル : プロセス アプリケーション ] を選択すると、Oracle Workshop for WebLogic により、ビジネス プロセス用のコンポーネントの入ったアプリケーションが作成されます。チュートリアルの実行については、『チュートリアル : 初めてのビジネス プロセス設計 』を参照してください。また、特別に作成されたテンプレートを使用し、ebXML または RosettaNet の参加者ビジネス プロセスを Oracle Workshop for WebLogic で構築することもできます。これらの参加者プロセスの作成方法の詳細については、「ebXML 参加者ビジネス プロセスの構築 」および「RosettaNet 参加者ビジネス プロセスの構築 」を参照してください。
表示された [関連付けられたパースペクティブを開きますか? ] ダイアログ ボックスで、[はい ] をクリックし、J2EE パースペクティブ からプロセス パースペクティブ に切り替えます。
注意 :
[関連付けられたパースペクティブを開きますか? ] ダイアログ ボックスは、ワークスペースにビジネス プロセスを初めて作成するときに表示されます。
プロセス アプリケーションが作成され、図 2-2 に示すように [パッケージ・エクスプローラー ] ペインに表示されます。
「チュートリアル : Workshop 入門 」では、Oracle Workshop for WebLogic のグラフィカルな設計環境でビジネス プロセスを設計するためのツールおよびコンポーネントについて概説します。
このガイドの以下のトピックでは、次のタスクなどの、特定のビジネス プロセス パターンを設計する方法を詳説します。
ビジネス プロセスのクライアント ノードにメソッドおよびコールバックを追加し、ビジネス プロセスとクライアント間のインタフェースを作成する。
コントロールを追加し、Web サービス、データベース、EJB などのリソースを伴うインタフェースを表示する。
XML スキーマを使用してビジネス プロセスで異なるデータ型をマッピングし、ビジネス プロセスにより特定のアクティビティを反復処理できる XML 要素の順序を構築する。
ソース ビュー で Process.java ファイルを表示および編集する。
これらのタスクなどの詳細については、「この節に含まれるトピック 」を参照してください。
ビジネス プロセス プロパティの設定
[JPD コンフィグレーション ] ペインには、ビジネス プロセス用に表示およびコンフィグレーションできる複数のプロパティがあります。
ビジネス プロセス プロパティを設定するには
プロパティをコンフィグレーションするビジネス プロセスの開始 ノードを選択します。
Oracle Workshop for WebLogic に [JPD コンフィグレーション ] ペインが表示されない場合は、メニューから [ウィンドウ|ビューの表示|その他|一般|JPD コンフィグレーション ] を選択します。
注意 :
デフォルトの [プロセス] ビューには [プロパティー] ペインしか表示されていません。[プロセス] パースペクティブで、[JPD コンフィグレーション] ビューと [プロパティー] ペインを同時に使用することはできません。
注意 :
[JPD コンフィグレーション] ペインの値を変更するには、[プロパティー] ペインを閉じてから、[JPD コンフィグレーション] ペインを開いて JPD を再ロードする必要があります。[プロパティー] ペインに戻るには、[JPD コンフィグレーション] ペインを閉じてから、[プロパティー] ペインを開いて JPD を再ロードします。
[JPD コンフィグレーション ] ペインに、[全般 ] プロパティと [プロセス ] プロパティが表示されます。
全般
名前 - これは、ビジネス プロセス名であり、Oracle WebLogic Integration Administration Console などの Oracle Workshop for WebLogic アプリケーション全体で表示されます。この名前は、このプロパティをクリックして新たな名前を入力することにより、好みの名前に変更できます。
メモ - [メモ ] をクリックし、次に をクリックして [Notes ] ダイアログ ボックスを開き、ビジネス プロセスに関連付けるノートを入力します。ノートを入力し、[OK ] をクリックします。エディタに入力したノートは、Oracle WebLogic Integration Administration Console にも表示されます。
プロセス
失敗時に停止 - ビジネス プロセスが失敗し、送出された例外を処理するようにコンフィグレーションされた例外ハンドラがない場合、ビジネス プロセスは中止状態に置かれて回復することができません。ただし、ビジネス プロセスが [失敗時に停止] にコンフィグレーションされている場合、ビジネス プロセスは失敗すると最後のコミット ポイントまでロールバックし、状態が永続化されます。プロセスはその後で Oracle WebLogic Integration Administration Console から再起動できます。ビジネス プロセスを [失敗時に停止] に対してコンフィグレーションするには、[失敗時に停止 ] ドロップダウン メニューから true を選択します。
ビジネス プロセスの例外ハンドラの詳細については、「例外の処理 」を参照してください。Oracle WebLogic Integration Administration Console でのビジネス プロセスの凍結解除方法の詳細については、『WebLogic Integration Administration Console の使用』の「プロセス インスタンスのモニタ 」を参照してください。
同期時の失敗 - このプロパティは、プロセスが同期サブプロセスとしてコンフィグレーションされている場合にのみ適用され、他のビジネス プロセスの場合は無視されます。同期サブプロセスが失敗すると、デフォルトの動作ではプロセスは rollback としてマークされます。これにより、サブプロセスと親プロセスの両方がロールバックされます。ただし、[ 同期時の失敗 ] プロパティが [ rethrow ] に設定されている場合は、サブプロセスのみがロールバックされます。同期サブプロセスおよび [ 同期時の失敗 ] プロパティの詳細については、「 サブプロセスの操作 」を参照してください 。
永続的 - このプロパティは、ステートフルのビジネス プロセスを永続化する方法を設定します。つまり、これにより、対話をメモリで維持するか、あるいは、データベース リポジトリに保存するかを決定します。通常、ステートフル プロセスは、データベースに対して永続化されています。ただし、以下の場合に、非永続的なステートフル プロセスを使用することができます。
再試行回数 - 初回の試行後、プロセス エンジンにより、ビジネス プロセスの実行を再試行する回数を指定します。
ビジネス プロセスに非同期の Client Request ノードが 1 つ入っている場合、または、複数の Client Request ノードが入っており、その 1 つが非同期の場合は、ビジネス プロセス用に [再試行回数 ] を設定できます。同期の Client Request ノードのみ (つまり Client Request with Return ノード) が入っているビジネス プロセスの場合は、[再試行回数 ] プロパティを設定できません。
再試行遅延 - 再試行までの経過時間 (秒) を指定します。
ビジネス プロセスに非同期の Client Request ノードが 1 つ入っている場合、または、複数の Client Request ノード入っており、その 1 つが非同期の場合は、ビジネス プロセス用に [再試行遅延 ] を設定できます。同期の Client Request ノードのみ (つまり Client Request with Return ノード) が入っているビジネス プロセスの場合は、[再試行遅延 ] プロパティを設定できません。
ステートレス - このプロパティは閲覧用のみであり、編集できません。ビジネス プロセスが、ステートレス (プロパティは true を表示) またはステートフル (プロパティは false を表示) のどちらであるかを表示します。ステートレスおよびステートフルのビジネス プロセスの詳細については、「ステートレス/ステートフル ビジネス プロセスの構築 」を参照してください。
ビジネス プロセスのアノテーションの設定
ビジネス プロセス開始ノードの [プロパティー ] ペインには、ビジネス プロセス用に表示およびコンフィグレーションできる複数のプロパティがあります。
ビジネス プロセス アノテーションを設定するには
アノテーションをコンフィグレーションするビジネス プロセスの開始 ノードを選択します。
Oracle Workshop for WebLogic に [プロパティー ] が表示されない場合は、メニューから [ウィンドウ|ビューの表示|プロパティー ] を選択します。
[プロパティー ] ペインに以下のアノテーションが表示されます。
BeanInfo
customizerclass - このアノテーションは、どの Bean プロパティがパブリックであるかと、それらにアクセスするためにどのゲッター メソッドおよびセッター メソッドを使用するかを定義します。このクラスは、同一のパッケージ内に格納し、それに追加した BeanInfo の付いたタグ (または Bean) と同様に命名される必要があります。
ClassReliable
messageTimeToLive - このアノテーションは、重複したメッセージを検出するためにメッセージをサーバに維持する時間の長さを指定します。
Ebxml
詳細については、ebXML アノテーション タイプ を参照してください。
FeatureInfo
FeatureInfo アノテーションの詳細については、http://commons.apache.org/modeler/commons-modeler-1.0/docs/api/org/apache/commons/modeler/FeatureInfo.html を参照してください。
Handler
callback - このアノテーションは、発信の SOAP コールバックで実行するハンドラを指定します。
file - このアノテーションは、ハンドラのチェーンがインラインで指定されていない場合に、使用するハンドラ コンフィグレーション ファイルを指定します。
operation - このアノテーションは、着信の SOAP メッセージで実行するハンドラを指定します。
ManifestAttribute
ManifestAttribute アノテーションの詳細については、http://beehive.apache.org/docs/1.0/apidocs/classref_controls/org/apache/beehive/controls/api/packaging/ManifestAttribute.html を参照してください。
ManifestAttributes
ManifestAttribute アノテーションの詳細については、http://beehive.apache.org/docs/1.0.2/controls/apidocs/javadoc/org/apache/beehive/controls/api/packaging/ManifestAttributes.html を参照してください。
Protocol
詳細については、Protocol アノテーション タイプ を参照してください。
Rosettanet
詳細については、RosettaNet アノテーション タイプ を参照してください。
Schemas
value - このアノテーションは、コンポーネント クラスで型を参照されるスキーマ ファイルを 1 つまたは複数指定します。このアノテーションをプロセスまたはサービス ブローカ コントロールに追加することができます。複数の名前の値のエントリが定義され、各エントリによりスキーマの定義を 1 つ参照します。
Stateful
maxAge - このアノテーションは、ステートフル プロセス開始からの Oracle WebLogic Server により対話が終了されるまでのアクティブな状態に維持する経過時間を指定します。
maxIdleTime - このアノテーションは、Oracle WebLogic Server によりステートフル プロセスが終了されるまでのアイドル状態の維持時間を指定します。
runAsStartUser - このアノテーションは、対話を開始したユーザとして継続および完了のメソッドを実行することを指定します。
singlePrincipal - このアノテーションは、対話を開始したプリンシパルのみが対話を継続および完了できることを指定します。
TargetNamespace
value - このアノテーションは、発信 XML メッセージおよび生成された WSDL ファイルで使用される XML ネームスペースを指定します。
Version
Strategy - これにより、親プロセスの異なるバージョンが存在する場合に、サブプロセスを呼び出す方法を指定します。[strategy] ドロップダウン メニューから以下を行います。
サブプロセスの呼び出し時にサブプロセスのバージョンを設定する場合は、 [loosely-coupled ] を選択する。
親プロセスの呼び出し時にサブプロセスのバージョンを設定する場合は、 [tightly-coupled ] を選択する。
WSSecurityCallback
file - このアノテーションは、WS-Security ファイルの場所を指定します。
WSSecurityService
file - このアノテーションは、Web サービスにより使用される WS-Security ポリシー ファイル (WSSE ファイル) へのパスを指定します。
Wsdl
value - このアノテーションは、Web サービスにより実装される WSDL ファイルを指定します。
XmlNamespaces
Value - このアノテーションは、ネームスペースの値およびプレフィックスの値を指定します。
Com.bea.wli.common.XQuery
Prolog - これにより、ネームスペースおよび関数宣言を指定します。
Version - これにより、 インライン XQueries 用にプロセス ファイルで使用する XQuery バージョンを指定します。
Com.bea.wli.jpd.Process
binding - このプロパティは、ビジネス プロセスで Web サービス、ebXML、または RosettaNet プロトコルを使用するかどうかを指定します。デフォルト値は webservice です。ビジネス プロセスが ebXML または RosettaNet プロセスの場合は、[ebxml ] または [rosettanet ] を選択します。
name - これは、プロセス名を示します。
process - これにより、読み込み専用のアノテーションを示し、プロセス アノテーションのコンテンツを表示します。
プロパティの詳細については、Javadoc を参照してください。
ebXML および RosettaNet ビジネス プロセスの詳細については、「ebXML 参加者ビジネス プロセスの構築 」および「RosettaNet 参加者ビジネス プロセスの構築 」を参照してください。
注意 :
ビジネス プロセス (JPD) では、WS-Security ポリシー (WSSE) ファイルはサポートされません。したがって、JPD ファイルでは、com.bea.wli.common.WSSecurityCallback
および com.bea.wli.common.WSSecurityService
アノテーションもサポートされません。
注意 :
WS-Security を使用したい場合は、JWS を JPD のフロントエンドにする必要があります。クライアントが WS-Security を使用して JWS を呼び出し、JWS がプロセス コントロールを介して JPD をローカルに呼び出します。
関連トピック
例外の処理
プロセス インスタンスのモニタ