アップグレード ガイド

     前  次 新しいウィンドウで目次を開く     
ここから内容

WLI で使用するビジネス プロセスとコントロール ファイルをアップグレードする

以降の節では、ビジネス プロセスとコントロール ファイルを WebLogic Integration 10gRelease 3 (10.3) で使用するために必要な更新について説明します。この章では、8.1.x または 8.5.x から 10g Release 3 (10.3) にアプリケーションをアップグレードする際のソースの変更について詳細に説明します。

 

ビジネス プロセスをアップグレードする

Oracle WebLogic Integration 10g Release 3 (10.3) 環境では、すべての JPD ファイルに独自の .jpd 拡張子ではなく .java 拡張子が付けられます。すべての WebLogic Integration JPD 8.1 アノテーションは、JSR 175 ベースのアノテーションにアップグレードされます。JPD 8.1 または 8.5 のすべてのアノテーションは、共通アノテーション、コントロール アノテーション、および JPD アノテーションとして分類されます。

WebLogic Integration 8.1.x または 8.5.x では、JPD 内の jpdContext には @common:context アノテーションが指定されていました。ただし、WebLogic Integration 9.2 以降では、jpdContext が @com.bea.wli.jpd.Context() にアップグレードされています。

たとえば、次のような WebLogic Integration 8.1.x JPD ビジネス プロセス アノテーションがあるとします。 

/**
* @jpd:process process::
* <process name="EchoAsync">
*   <clientRequest name="Client Request" method="clientRequest"/>
*   <perform name="Perform" method="perform"/>
*   <controlSend name="start" method="myTimerStart"/>
*   <clientCallback name="Client Response" method="clientResponseCallbackHandler"/>
*   <transaction name="Commit"/>
* </process>::
*/

この JPD を Oracle WebLogic Integration 10g Release 3 (10.3) にアップグレードすると、アノテーションは次のようになります。 

@com.bea.wli.jpd.Process(
	process="<process name=\"EchoAsync\">" +
	"  <clientRequest name=\"Client Request\"
	method=\"clientRequest\"/>\n" +
	"  <perform name=\"Perform\" method=\"perform\"/>\n" +
	"  <controlSend name=\"start\" method=\"myTimerStart\"/>\n" +
	"  <clientCallback name=\"Client Response\" 
	method=\"clientResponseCallbackHandler\"/>\n" +
	"  <transaction name=\"Commit\"/>\n" +
"</process>"
)
注意 : WliTimerControl は、JPD のためのデフォルトの Oracle WebLogic Integration タイマー コントロールです。
注意 : JMS 転送は、WebLogic Integration 8.1 では jws.queue を使用してサポートされていました。これは、Oracle Workshop for WebLogic ベースの情報 (ビジネス プロセスや JWS など) で使用されるためです。Oracle WebLogic Integration 10g Release 3 (10.3) では、JWS は weblogic.wsee.DefaultQueue を JMS 転送のデフォルト キューとして使用しますが、ビジネス プロセスは依然として jws.queue を必要とします。また、Oracle WebLogic Integration 10g Release 3 (10.3) では、JMS 転送に対して任意の JMS キューを指定できますが、新しい JWS アプリケーションに対しては jws.queue を使用できないことに注意してください。Oracle WebLogic Integration 対応ドメインで競合が発生するためです。Oracle WebLogic Integration 10g Release 3 (10.3) の JWS アプリケーションでは、jws.queue の使用やキュー名のカスタマイズ (jws.properties を使用) を行わないでください。

表 3-1 に、WebLogic Integration JPD 8.1.x または 8.5.x から 10g Release 3 (10.3) JPD へのアノテーションのアップグレード情報を示します。

表 3-1 JPD アノテーション
8.x のアノテーション
属性
10g Release 3 (10.3) のアノテーション
属性
備考
jpd:ebxml
 
Ebxml
 
プロセスの ebXML パラメータを指定する。
ebxml-action-mode
 
ebxmlActionMode
 
ebxml-service-name
 
ebxmlServiceName
 
protocol-name
 
protocolName
 
jpd:ebxml-method
 
EbXMLMethod
 
メソッドの ebXML パラメータを指定する。
envelope
 
envelope
 
jpd:mb-static-subscription
 
MessageBroker.StaticSubscription
 
ビジネス プロセスのサブスクリプション パラメータを指定する。
channel-name
 
channelName
 
xquery
 
xquery
 
filter-value-match
 
filterValueMatch
 
message-metadata
 
messageMetaData
 
message-body
 
messageBody
 
suppressible
 
suppressible
 
jpd:process
 
Process
 
ビジネス プロセスの設定を指定する。
binding
 
binding
 
name
 
name
 
freezeOnFailure
 
freezeOnFailure
 
onSyncFailure
 
onSyncFailure
 
retryCount
 
retryCount
 
retryDelay
 
retryDelay
 
stateless
 
isStateless
 
process
 
process
 
jpd:rosettanet
 
RosettaNet
 
プロセスの Rosettnet プロパティを指定する。
protocol-name
 
protocolName
 
protocol-version
 
protocolVersion
 
pip-name
 
pipName
 
pip-version
 
pipVersion
 
pip-role
 
pipRole
 
jpd:selector
 
Selector
 
ビジネス プロセス ファイルで XQuery 定義の前に指定する。
xquery
 
xquery
 
jpd:transform
 
Transform
 
実行時に自動的にインスタンス化されるトランスフォーメーション コントロール インスタンスのアノテーション。
jpd:unexpected-message
 
UnexpectedMessage
 
メッセージが予期されるノードをプロセス フローが検出する前に、ビジネス プロセスが受信したメッセージを無視できる設定を指定する。
action
 
action
 
jpd:version
 
Version
 
さまざまなバージョンの親プロセスが存在するときにサブプロセスを呼び出す方法を指定する。
strategy
 
strategy
 
jpd:xml-list
 
XmlList
 
型なしの XML のビジネス プロセス変数 XmlObjectList のアノテーション。
jpd:xquery
 
Xquery
 
JPD ファイルでグローバル XQuery 定義の前に指定する。
version
 
version
XQuery 言語仕様のバージョンを表す。
prologue
 
prologue
 
jpd:input-message
 
InputMessage
 
実行時に型付き XBean パラメータを検証する。
validate
 
validate
 

 

JCX または WebLogic Integration コントロール ファイルをアップグレードする

Oracle WebLogic Integration 10g Release 3 (10.3) にアップグレードすると次のようになります。

たとえば、WebLogic Integration 8.1 JCX に次のアノテーションが含まれているとします。

/**

* @jc:task-create

* name = name}"

*/

Oracle WebLogic Integration 10g Release 3 (10.3) では、これが次のようにアップグレードされます。 

@TaskCreate(name = "{name}", 
taskTypeId.path = "/Worklist/Compatibility 8.1.x",
taskTypeId.version = 10.0f,
taskTypeId.worklistHostApplicationId = "worklist-ejbs-81x"
)

次のトピックも参照してください。

 

JCS コントロール ファイルをアップグレードする

WebLogic Integration 10g Release 3 (10.3) にアップグレードすると、JCS コントロール ファイルの拡張子が .java に変わります。WebLogic Integration コントロール アノテーションを含む JCS コントロール ファイルがアップグレードされます。

表 3-2 に、WebLogic Integration 8.1 から 10g Release 3 (10.3) JSC アノテーションのアップグレードに関する情報を示します。

表 3-2 JCS アノテーション
8.x のアノテーション
属性
10g Release 3 (10.3) のアノテーション
属性
備考
common:xmlns
 
XmlNamespaces.Entry
 
すべてのアノテーションは XMLNamespace の子ノードになる。
prefix
 
prefix
 
namespace
 
namespace
 
common:target-namespace
 
TargetNamespace
   
namespace
 
value
 
common:security
 
Security
 
すべてのアノテーションはスキーマの子ノードになる。
roles-allowed
 
rolesAllowed
 
roles-referenced
 
rolesReferenced
 
run-as
 
runAs
 
run-as-principal
 
runAsPrincipal
 
single-principal
 
singlePrincipal
 
callback-roles-allowed
 
callbackRolesAllowed
 
jcs:jc-jar
 
<なし>
 
主に Workshop for WebLogic 8.x で使用される。Oracle Workshop for WebLogic では使用されない。
common:schema
 
Schemas.Entry
 
すべてのアノテーションはスキーマの子ノードになる。
file
 
file
 
inline
 
inline
 
common:message-buffer
 
MessageBuffer
   
enable
 
enable
 
retry-count
 
retryCount
 
retry-delay
 
retryDelay
 
editor-info:code-gen
     
主に Workshop for WebLogic 8.x で使用される。Oracle Workshop for WebLogic では使用されない。
jcs:control-tags
 
<なし>
 
主に Workshop for WebLogic 8.x で使用される。Oracle Workshop for WebLogic では使用されない。
common:control
 
Control
 
標準の Beehive アノテーション。
common:operation
 
<なし>
 
Apache Beehive コントロール フレームワークで処理されるため不要。
jcs:ide
 
<なし>
 
このアノテーションは Workshop for WebLogic 8.x のため処理されない。
jc:conversation
 
Conversation
 
このアノテーションは jws:conversation アノテーションと同じである。
phase
 
value
 
jcs:suppress-common-tags
 
<なし>
 
主に Workshop for WebLogic 8.x で使用される。Oracle Workshop for WebLogic では使用されない。


  ページの先頭       前  次