C デプロイメント・ディスクリプタのプロパティ

この付録では、Oracle WebLogic Server、Oracle Enterprise Manager、またはその両方で実行時に使用されるBPELプロセス・サービス・コンポーネントのデプロイメント・ディスクリプタ構成およびパートナ・リンク・プロパティを定義する方法について説明します。

項目は次のとおりです。

• C.1項「デプロイメント・ディスクリプタのプロパティの概要」

• C.2項「非推奨の10.1.3プロパティ」

  
  

  注意: デプロイメント・ディスクリプタのプロパティを実行時に指定することはできません。

  
  

デプロイメント・ディスクリプタのプロパティの詳細は、『Oracle Fusion Middlewareパフォーマンスおよびチューニング・ガイド』の「Oracle BPEL Process Managerのパフォーマンス・チューニング」の章を参照してください。

C.1 デプロイメント・ディスクリプタのプロパティの概要

デプロイメント・ディスクリプタは、Oracle WebLogic ServerまたはOracle Enterprise Manager(あるいはその両方)で実行時に使用されるBPELプロセス・サービス・コンポーネントのプロパティです。プロパティには、次の2種類があります。

• 構成

• パートナ・リンク・バインディング

  表C-1は、構成のデプロイメント・ディスクリプタのプロパティを示しています。

  構成プロパティを定義する場合は、プロパティ名にbpel.configの接頭辞を追加する必要があります。たとえば、inMemoryOptimizationプロパティは、bpel.config.inMemoryOptimizationとして定義する必要があります。Oracle JDeveloperのプロパティ・インスペクタでプロパティを定義する方法については、項C.1.1「プロパティ・インスペクタでデプロイメント・ディスクリプタのプロパティを定義する方法」を参照してください。

  表C-1 configurationsデプロイメント・ディスクリプタのプロパティ

  プロパティ名	説明
  completionPersistPolicy	このプロパティは、インスタンス・データの保存方法を構成します。BPELサービス・コンポーネント・レベルでのみ設定できます。使用可能な値は、次のとおりです。 on(デフォルト): 終了したインスタンスは通常どおり保存されます。 deferred: 終了したインスタンスは保存されますが、異なるスレッドを使用して別のトランザクションで保存されます。 faulted: 失敗したインスタンスのみ保存されます。 注意: 未処理のフォルトが発生した場合は、これらのフラグに関係なく、インスタンスの監査情報がcube_instance表に保持されます。 off: このプロセスのインスタンスは保存されません。 詳細は、『Oracle Fusion Middlewareパフォーマンスおよびチューニング・ガイド』のcompletionPersistPolicyに関する項を参照してください。
  disableAsserts	このプロパティをtrueに設定すると、BPEL 1.1プロジェクトでアサーションが無効になります。
  globalTxMaxRetry	非同期BPELプロセスでアウトバウンド・アダプタを使用している場合は、リモート・フォルトに対する最大再試行回数を指定します。
  globalTxRetryInterval	非同期BPELプロセスでアウトバウンド・アダプタを使用している場合は、リモート・フォルトに対する再試行間隔(ミリ秒単位)を指定します。
  inMemoryOptimization	デフォルト値はfalseです。このプロパティをtrueに設定できるのは、デハイドレーション・ポイントがない場合のみです。wait、receive、onMessage、onAlarmなどのアクティビティでは、プロセス内にデハイドレーション・ポイントが作成されます。このプロパティをtrueに設定すると、to-spec問合せ時にこのプロセスのインスタンスに対するメモリー内最適化が試行されます。 詳細は、『Oracle Fusion Middlewareパフォーマンスおよびチューニング・ガイド』のinMemoryOptimizationに関する項を参照してください。
  keepGlobalVariables	インスタンスの完了後に、サーバーがグローバル変数値をインスタンス・ストアに保持できるかどうかを指定します。 false(デフォルト): インスタンスが完了すると、グローバル変数値は削除されます。 true: グローバル変数値は削除されません。
  oneWayDeliveryPolicy	このプロパティは、プロセスの永続ポリシーを配信レイヤーに設定します。可能な値は次のとおりです。 async.persist: システムへのメッセージが、エンジンで取得される前に配信ストアに保存されます。 async.cache: システムへのメッセージが、エンジンで取得される前にメモリーに保存されます。 sync: インスタンス起動メッセージが配信レイヤーに一時的に保存されません。エンジンは保存スレッドを使用してメッセージを起動します。 BPELプロセスを作成するときのこのプロパティの設定の詳細は、第4.1.1項「BPELプロセス・サービス・コンポーネントの追加方法」を参照してください。 詳細は、『Oracle Fusion Middlewareパフォーマンスおよびチューニング・ガイド』のOneWayDeliveryPolicyに関する項を参照してください。
  reenableAggregationOnComplete	このプロパティは、メッセージをルーティングするために作成して使用するインスタンス数を制御します。可能な値は次のとおりです。 true: 同じ相関のメッセージを処理する新規インスタンスが作成されます。 false: メッセージを処理するインスタンスが1つのみ作成されます。 詳細は、第9.2項「同じインスタンスへのメッセージのルーティング」を参照してください。
  sensorActionLocation	センサー・アクションXMLファイルの場所。センサー・アクションXMLファイルには、イベントに対するアクション・ルールが構成されています。
  sensorLocation	センサーXMLファイルの場所。センサーXMLファイルは、イベントが記録されるセンサーのリストを定義したものです。
  transaction	このプロパティは、コールを開始するBPELインスタンスのトランザクション動作を構成します。 requiresNew: 新規トランザクションが実行のために作成され、既存のトランザクションがある場合はそのトランザクションが一時停止されます。この動作は、リクエスト/レスポンス(開始)環境、およびbpel.config.oneWayDeliveryPolicyがsyncに設定されている一方向開始環境の両方に適用されます。 required: リクエスト/レスポンス(開始)環境では、この設定によって、トランザクションがある場合はコール元トランザクションが結合され、トランザクションがない場合は新規トランザクションが作成されます。bpel.config.oneWayDeliveryPolicyがsyncに設定されている一方向開始環境では、起動メッセージは、同じトランザクションの同一スレッドを使用して処理されます。 注意: このプロパティは、中間プロセスのreceiveアクティビティには適用されません。この場合は、別のトランザクションの別のスレッドを使用してメッセージが処理されます。これは、相関が必要であり、常に非同期で処理されるためです。 BPELプロセスを作成するときのこのプロパティの設定の詳細は、第4.1.1項「BPELプロセス・サービス・コンポーネントの追加方法」を参照してください。

  
  

  表C-2は、パートナ・リンク・バインディングのデプロイメント・ディスクリプタのプロパティを示しています。

  パートナ・リンク・バインディング・プロパティを定義する場合は、プロパティ名にbpel.partnerLink.partner_link_nameの接頭辞を追加する必要があります。たとえば、nonBlockingInvokeプロパティは、bpel.partnerLink.partner_link_name.nonBlockingInvokeとして定義する必要があります。Oracle JDeveloperのプロパティ・インスペクタでプロパティを定義する方法については、項C.1.1「プロパティ・インスペクタでデプロイメント・ディスクリプタのプロパティを定義する方法」を参照してください。

  表C-2 partnerLinkBindingデプロイメント・ディスクリプタのプロパティ

  プロパティ名	説明
  idempotent	idempotentアクティビティとは、再試行可能なアクティビティ(assignアクティビティやinvokeアクティビティなど)です。非idempotentアクティビティの後にインスタンスが保存されます。このプロパティは、永続プロセスと一時プロセスの両方に適用されます。 true (デフォルト): サーバーに障害が発生した場合、再起動後にアクティビティが再度実行されます。これは、アクティビティの呼出し直後にサーバーがデハイドレーションされず、アクティビティの実行が記録されていないためです。 false: アクティビティは実行直後にデハイドレーションされ、デハイドレーション・ストアに記録されます。idempotentをfalseに設定すると、フェイルオーバーによる保護は強化されますが、BPELプロセスがデハイドレーション・ストアに頻繁にアクセスする場合はパフォーマンスに影響が出ることがあります。 詳細は、『Oracle Fusion Middlewareパフォーマンスおよびチューニング・ガイド』のidempotentに関する項を参照してください。
  nonBlockingInvoke	デフォルト値はfalseです。trueに設定されている場合は、独立したスレッドを生成して起動を行うため、invokeアクティビティによってインスタンスがブロックされることはありません。 詳細は、第10.1.1項「シングル・スレッドでのフローのブランチのパラレル実行に関する注意事項」、および『Oracle Fusion Middlewareパフォーマンスおよびチューニング・ガイド』のnonBlockingInvokeに関する項を参照してください。
  validateXML	メッセージの境界の検証を有効化します。trueに設定すると、このパートナ・リンクに対するreceiveアクティビティおよびinvokeアクティビティ中に、XMLメッセージがXMLスキーマと照合して検証されます。XMLメッセージが無効な場合は、bpelx:invalidVariables実行時フォルトがスローされます。これによって、ドメイン・レベルのvalidateXMLプロパティが上書きされます。次の例では、StarLoanServiceパートナのみの検証が可能です。 <partnerLinkBinding name="StarLoanService"> <property name="wsdlLocation"> http://<hostname>:9700/orabpel/default/StarLoan/Sta rLoan?wsdl</property> <property name="validateXML">true</property> </partnerLinkBinding> 詳細は、『Oracle Fusion Middlewareパフォーマンスおよびチューニング・ガイド』のvalidateXMLに関する項を参照してください。

  
  

C.1.1 プロパティ・インスペクタでデプロイメント・ディスクリプタのプロパティを定義する方法

構成およびパートナ・リンク・バインディングのデプロイメント・ディスクリプタのプロパティと値は、Oracle JDeveloperのプロパティ・インスペクタで定義します。完了すると、composite.xmlファイルのBPELプロセス・サービス・コンポーネント・セクションにプロパティが表示されます。

1. SOAコンポジット・エディタで、図C-1に示すように、BPELプロセス・サービス・コンポーネントを選択します。

   図C-1 選択されたBPELプロセス・サービス・コンポーネント

   
   「図C-1 選択されたBPELプロセス・サービス・コンポーネント」の説明
   
   

2. Oracle JDeveloperの右下の隅にある「プロパティ・インスペクタ」に移動します。「プロパティ・インスペクタ」が表示されない場合は、「表示」メイン・メニューから「プロパティ・インスペクタ」を選択します。

3. 図C-2に示すように、「プロパティ」セクションで「追加」アイコンをクリックします。

   この例では、BPELプロセスの作成時に「BPELプロセスの作成」ダイアログで「配信」オプションが選択されていたため、oneWayDeliveryPolicyプロパティがすでに定義されています。BPELプロセスを作成するときのこのプロパティの設定の詳細は、第4.1.1項「BPELプロセス・サービス・コンポーネントの追加方法」を参照してください。

   図C-2 プロパティ・インスペクタ

   
   「図C-2 プロパティ・インスペクタ」の説明
   
   

   「プロパティの作成」ダイアログが表示されます。

4. 「名前」フィールドに、デプロイメント・ディスクリプタのプロパティを入力します。この例では、構成のデプロイメント・ディスクリプタのプロパティinMemoryOptimizationが定義されています。そのため、bpel.configの接頭辞が必要です。構成のデプロイメント・ディスクリプタのプロパティの詳細は、表C-1を参照してください。

   そのかわりにパートナ・リンク・バインディング・プロパティを追加する場合は、bpel.partnerLink.partner_link_nameの接頭辞が必要です(partner_link_nameはパートナ・リンクの名前です。例: LoanService)。パートナ・リンク・バインディングのデプロイメント・ディスクリプタのプロパティの詳細は、表C-2を参照してください。

5. 「値」フィールドに、このプロパティに適用可能な値(たとえばtrue)を入力します。

   図C-3は、完成した「プロパティの作成」ダイアログを示しています。

   図C-3 「プロパティの作成」ダイアログ

   
   「図C-3 「プロパティの作成」ダイアログ」の説明
   
   

6. 「OK」をクリックします。

   プロパティ・インスペクタに、追加されたデプロイメント・ディスクリプタのプロパティが表示されます。

   図C-4 プロパティ・インスペクタのデプロイメント・ディスクリプタのプロパティ

   
   「図C-4 プロパティ・インスペクタのデプロイメント・ディスクリプタのプロパティ」の説明
   
   

7. SOAコンポジット・エディタで「ソース」をクリックします。

   例C-1に示すように、composite.xmlファイル内にbpel.configの接頭辞が付いたinMemoryOptimization構成プロパティが表示されます。

例C-1 composite.xmlの構成プロパティ定義

<component name="LoanApproval" version="1.1">
    <implementation.bpel src="LoanApproval.bpel"/>
    <property name="bpel.config.oneWayDeliveryPolicy" type="xs:string"
              many="false">async.persist</property>
    <property name="bpel.config.inMemoryOptimization" type="xs:string"
              many="false" override="may">true</property>
  </component>

プロパティ・インスペクタで、かわりにパートナ・リンク・バインディングのデプロイメント・ディスクリプタのプロパティ(たとえば、nonBlockingInvokeパートナ・リンク・バインディング・プロパティ)を定義した場合は、例C-2に示すように、composite.xmlファイル内に表示されます。接頭辞が、このタイプのプロパティに必要なbpel.partnerLink.partner_link_nameであることに注目してください。

例C-2 composite.xmlのパートナ・リンク・バインディング・プロパティの定義

...
  <component name="myBPELServiceComponent">
 ....
  <property name="bpel.partnerLink.partner_link_name.
   nonBlockingInvoke">false</property>
</component>

C.1.2 BPELプロセス内でのプリファレンス値の取得方法

プロパティの値は、XPath拡張関数ora:getPreference(myPref)を使用してBPELプロセスで読み取ることができます。これによって、bpel.preference.myPrefの値を取得します。

この関数は、単純なassign文の一部として、または条件式の中で、あるいはより複雑なXPath式の一部として使用できます。

C.2 非推奨の10.1.3プロパティ

表C-3に、今後使用できなくなる非推奨プロパティを示します。

表C-3 非推奨プロパティ

プロパティ	デプロイメント・ディスクリプタ・タイプ	非推奨となったリリース
completionPersistLevel	configurations	11g リリース1
defaultInput	configurations	11g リリース1
initializeVariables	configurations	11g リリース1
loadSchema	configurations	11g リリース1
noAlterWSDL	configurations	11g リリース1
optimizeVariableCopy	configurations	11g リリース1
relaxTypeChecking	configurations	11g リリース1
relaxXPathQName	configurations	11g リリース1
transaction	configurations	10.1.3.4
SLACompletionTime	configurations	11g リリース1
xpathValidation	configurations	11g リリース1
user	configurations	11g リリース1
pw	configurations	11g リリース1
role	configurations	11g リリース1
correlation	partnerLinkBinding	11g リリース1
contentType	partnerLinkBinding	10.1.3
retryInterval	partnerLinkBinding	10.1.3.3のフォルト・ポリシー機能で非推奨
retryMaxCount	partnerLinkBinding	10.1.3.3のフォルト・ポリシー機能で非推奨
wsdlLocation	partnerLinkBinding	11g リリース1
wsdlRuntimeLocation	partnerLinkBinding	11g リリース1
wsseHeaders	partnerLinkBinding	11g リリース1
wsseUsername	partnerLinkBinding	11g リリース1
wssePassword	partnerLinkBinding	11g リリース1
preferredPort	partnerLinkBinding	11g リリース1
fullWSAddressing	partnerLinkBinding	11g リリース1