Oracle Enterprise Repository Event Manager のコンフィグレーション

この節では、Advanced Registration Flow を使用する前に完了する必要のある Event Manager のコンフィグレーションについて説明します。この節では、以下の内容に関する情報を取り上げます。

Oracle Enterprise Repository Event Manager とは

Event Manager は、Oracle Enterprise Repository に組み込まれたコンポーネントであり、イベントサブスクリプション、イベントの永続性、イベントのフィルタ処理、およびイベントの配信を管理します。Web サービスエンドポイントでは、Event Manager の Subscription Manager をサブスクライブできます。Oracle Enterprise Repository 内で生成されるアセット登録イベントは、Web サービスエンドポイントに配信されます。

次の図は、関連するさまざまなコンポーネントを示しています。

Event Manager では、デフォルトで有効な組み込みバージョンの Apache ActiveMQ JMS サーバを使用します。組み込みの JMS サーバは、追加のコンフィグレーションを行わずにすぐに実行できるようにコンフィグレーションされています。ただし、WebLogic Server や IBM WebSphere などの外部の JMS サーバを使用するように Event Manager をコンフィグレーションすることもできます。

この節では、Advanced Registration Flow を使用する前に完了する必要のある Event Manager のコンフィグレーションについて説明します。Advanced Registration Flow のコンフィグレーションについては、「Advanced Registration Flow のコンフィグレーション」を参照してください。

Event Manager のシステム設定のコンフィグレーション

Oracle Enterprise Repository の [System Settings] セクションを使用すると、管理者は Oracle Enterprise Repository の基本操作をコンフィグレーションしたり、特定の機能の有効と無効を切り替えたりできます。Event Manager に関連する設定は、メインカテゴリ [External Integrations] の [Eventing] グループで行います。システム設定の詳細については、『Oracle Enterprise Repository 管理ガイド』を参照してください。

WebLogic Server や IBM WebSphere などの外部 JMS サーバのコンフィグレーションには追加の「イベンティング」プロパティを使用できます。「イベンティング」プロパティについては、「Oracle Enterprise Repository 用の JMS サーバのコンフィグレーション」を参照してください。

Event Manager の有効化

Event Manager から外部の Web サービスエンドポイントにイベントを送信できるようにするには、Event Manager を Oracle Enterprise Repository で有効にする必要があります。

Event Manager のオプションの設定のコンフィグレーション

Event Manager のパフォーマンスの調整に使用できるオプションの「イベンティング」プロパティがいくつか存在します。

Eventing Manager 通知機能スレッドスリープ (秒)

1 つまたは複数のイベントをエンドポイントに配信する必要がある場合に、そのエンドポイントを使用できないときは、エンドポイントが使用可能になるまで、Event Manager 通知機能がイベントの配信を再試行します。cmee.eventframework.notifier.sleep プロパティは、通知機能がイベントを再配信するまでに待機する時間を秒単位でコンフィグレーションします。

Eventing Manager ストアスレッドスリープ (秒)

イベントがトリガされるとすぐに、Event Manager は JMS サーバにプッシュする前にイベントをメモリに格納し、Oracle Enterprise Repository スレッドがブロックされないようにします。cmee.eventframework.store.sleep プロパティは、メモリに格納された次のイベントのポーリングの前に、Event Manager の Store Manager スレッドをスリープ状態にする時間を指定します。デフォルトのポーリング遅延時間は 60 秒です。

Eventing Manager ストア配信スリープ (秒)

デフォルトでは、Event Manager はイベントをバッチ配信します。cmee.eventframework.delivery.sleep プロパティは、次に使用可能なイベントのバッチを JMS サーバから選択する前に、Event Manager の Delivery Manager スレッドをスリープ状態にする時間を指定します。各バッチ間のデフォルトの遅延時間は 7200 秒 (2 時間) です。

Event Manager の配信バッチサイズ

Event Manager がイベントをバッチ配信する場合は、cmee.eventframework.delivery.batch.size プロパティを使用して、配信されるバッチサイズをコンフィグレーションできます。デフォルトのバッチサイズは 100 個のイベントです。配信するイベント数が少ない場合、Event Manager は使用可能なイベントを配信してから、cmee.eventframework.delivery.sleep プロパティでコンフィグレーションされた時間だけスリープ状態になります。

Subscription Manager のコンフィグレーション

Subscription Manager は、一致するイベントが配信される Web サービスエンドポイントによってイベントのサブスクリプションを管理します。

Subscription Manager のコンフィグレーションファイルは <OER Web アプリケーション名>\WEB-INF\classes\EndPointEventSubscription.xml にあります。

Web サービスエンドポイントのコンフィグレーション

Event Manager では、EndPointEventSubscription.xml ファイルを使用して、イベントを配信する必要のある Web サービスエンドポイントの情報をロードします。次のサンプルコードに示すように、あらかじめ定義されている ALPBM エンドポイントまたはユーザ定義の Web サービスエンドポイントのホスト、ポート、URI、ユーザ、およびパスワードをコンフィグレーションする必要があります。

<sub:EventSubscriptionData xmlns:sub="http://www.bea.com/infra/events/subscription" xmlns:xsi=???
<sub:eventSubscription>
    <sub:endPoint name="ALBPMEndpoint">
      <sub:host>maplanis01.amer.bea.com</sub:host>
      <sub:port>9000</sub:port>
      <sub:uri>fuegoServices/ws/StatusChangeEnpointServiceListener</sub:uri>
      <sub:targetNamespace>StatusChangeEndpoint</sub:targetNamespace>
      <sub:operationName>newEvent</sub:operationName>
      <sub:authenticationData>
        <sub:basicAuthentication>
          <sub:username>aler_workflow_user</sub:username>
          <sub:username>aler_workflow_user</sub:username>
        </sub:basicAuthentication>
      </sub:authenticationData>
    </sub:endPoint>
    <sub:notifierClass>com.bea.infra.event.notifier.help.AlbpmHTTPEventNotifier    </sub:notifierClass>
    <sub:expression>id > 500</sub:expression>
  </sub:eventSubscription>
</sub:EventSubscriptionData>

エンドポイントを必要な数だけ追加し、個別のホストまたはポートに配置して、イベントのロードバランシングを行うことができます。あらかじめ定義されている Advanced Registration Flow のエンドポイントは 1 つ (StatusChangeEndpoint) だけです。

イベントをフィルタ処理する式の設定

expression 要素に入力した値に基づいて、イベントをフィルタ処理できます。

すべてのイベントのエンドポイントへの配信

デフォルト設定では、「すべてのイベント」をエンドポイントに配信します。expression 要素が空の場合、Oracle Enterprise Repository 内でトリガされるすべてのイベントは OOTB エンドポイントに配信されます。

イベントの種類でフィルタ処理されたイベントのエンドポイントへの配信

次の XML コードは、AssetSubmission という種類のイベントをエンドポイントに配信する方法を示しています。

<sub:expression> eventdata_name =”urn:com:bea.aler:events:type:AssetSubmission”</sub:expression>

また、「OR」演算子を使用して複数のイベントの種類をフィルタ処理することもできます。

eventdata_name =”urn:com:bea.aler:events:type:AssetSubmission” OR
eventdata_name =”urn:com:bea.aler:events:type:AssetAccepted”

urn:com:bea:aler:events:type:AssetSubmission
urn:com:bea:aler:events:type:AssetAccepted
urn:com:bea:aler:events:type:AssetTabApproved
urn:com:bea:aler:events:type:AssetAllTabApproved
urn:com:bea:aler:events:type:AssetRegister
urn:com:bea:aler:events:type:PolicyAssertionChanged
urn:com:bea:aler:events:type:MetaDataChange:name
urn:com:bea:aler:events:type:AssetUnSubmission
urn:com:bea:aler:events:type:AssetUnAccept
urn:com:bea:aler:events:type:AssetUnregister
urn:com:bea:aler:events:type:AssetStatusChanged
urn:com:bea:aler:events:type:MetaDataChange:version
urn:com:bea:aler:events:type:MetaDataChange:description
urn:com:bea:aler:events:type:CategorizationChanged:assetLifecycleStage
urn:com:bea:aler:events:type:CategorizationChanged:classification
urn:com:bea:aler:events:type:MetaDataChange:supported
urn:com:bea:aler:events:type:MetaDataChange:organizational ownership
urn:com:bea:aler:events:type:MetaDataChange:usagefee

JMS メッセージセレクタを使用してフィルタ処理されたイベントのエンドポイントへの配信

セレクタとは、サブスクリプションにフィルタをアタッチしてコンテンツベースのルーティングを実行する手段です。セレクタは SQL 92 構文を使用して定義されます。イベントをフィルタ処理するためのフィルタ式の記述に使用できるすべてのフィールドのリストを次に示します。これらのフィールドは Event Manager によって JMS メッセージにプロパティとして追加され、フィールドにアクセスする JMS メッセージセレクタを記述してイベントをフィルタ処理できます。

submittedby_emailaddress = mrsmith@bea.com
asset_description = Test Asset
submittedby_name = aler_workflow_user
submittedby_id = 99
asset_community = Java
eventdata_description = new aler event
eventsource_componentname = Aqualogic ALER
asset_name = TestAsset
eventsource_componenttype = ALER3.0
asset_typeid = 154
eventdata_eventid = d0cdac55-c78f-4a29-8aec-6ea9ba8d31f1
eventdata_name = urn:com:bea:aler:events:type:MetaDataChange:name
asset_activestatus = ACTIVE
eventsource_location = ALERCore
asset_id = 50100
eventdata_version = ver1.0
asset_version = 1

JMS メッセージセレクタの詳細については、以下の Web サイトを参照してください。

JMS メッセージセレクタの例

asset_id BETWEEN 50000 AND 50100
eventdata_name = 'urn:com:bea:aler:events:type:AssetSubmission' AND asset_id BETWEEN 50000 AND 50100
asset_name LIKE 'Inventory'
asset_id > 500

Event Manager のイベントのロギングのコンフィグレーション

Event Manager では、Oracle Enterprise Repository と同じロギングフレームワークを使用します。デフォルトでは、ファイルに移動するようにロギングが設定されていますが、コンソールに移動するには、<OER ドメイン>\WEB-INF\classes ディレクトリにある log4fl.properties ファイルに以下のカテゴリを追加してデバッグ文を作成する必要があります。

Advanced Registration Flow のコンフィグレーションと管理