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

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

Advanced Registration Flow の開始

この節では、以下の内容に関する情報を取り上げます。

 


概要

この節では、Oracle Business Process Management Process Engine で機能するようにコンフィグレーションされているバンドル済みの Oracle Business Process Management Web サービス エンドポイントを使用して Advanced Registration Flow 機能をすぐに利用する場合に役立ちます。ただし、この機能は拡張性が高く、環境に合わせて調整できます。

 


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

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

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

図 2-1 Advanced Registration Flow のコンポーネント

Advanced Registration Flow のコンポーネント

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

Event Manager のコンフィグレーションの詳細については、「Oracle Enterprise Repository Event Manager のコンフィグレーション」を参照してください。

使用例

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

Oracle Enterprise Repository をインストールしたら、次の手順で Event Manager をコンフィグレーションします。

  1. Event Manager から外部の Web サービス エンドポイントにイベントを送信できるようにするには、Event Manager を Oracle Enterprise Repository で有効にする必要があります。そのためには、以下のいずれかの処理を行います。
    • <OER ドメイン>\WEB-INF\classes ディレクトリにある eventing.properties ファイルの cmee.eventframework.enabled=true プロパティを有効にします。
    • または

    • Oracle Enterprise Repository の Web ベースのコンソールの [System Settings] を使用してこのプロパティを有効にすることもできます。詳細については、「Event Manager のシステム設定のコンフィグレーション」を参照してください。
  2. イベンティング プロパティ cmee.eventframework.delivery.sleepcmee.eventframework.store.sleep のデフォルト値を調整して、Oracle Enterprise Repository と Web サービス エンドポイントの全体的なパフォーマンスを制御することもできます。この 2 つのプロパティは、Event Manager で 1 秒あたりにトリガされるイベント数に直接影響します。たとえば、テスト目的で迅速な応答が必要な場合は、cmee.eventframework.store.sleep のデフォルト値 7200 秒を、テストに適した値に変更する必要があります。
  3. Event Manager では、Oracle Enterprise Repository と同じロギング フレームワークを使用します。デフォルトでは、ファイルに移動するようにロギングが設定されていますが、コンソールに移動するには、<OER ドメイン>\WEB-INF\classes ディレクトリにある log4fl.properties ファイルに以下のカテゴリを追加してデバッグ文を作成する必要があります。
  4. # eventing subsystem
    log4j.category.com.bea.infra.event.core= debug,eventingLog,stdout
    log4j.category.com.bea.infra.event.dm= debug,eventingLog,stdout
    log4j.category.com.bea.infra.event.facade= debug,eventingLog,stdout
    log4j.category.com.bea.infra.event.notifier= debug,eventingLog,stdout
    log4j.category.com.bea.infra.event.store= debug,eventingLog,stdout
    log4j.category.com.bea.infra.event.sub= debug,eventingLog,stdout
  5. Event Manager の Subscription Manager で Web サービスのサブスクリプションをコンフィグレーションします。
  6. 注意 : デフォルトでは、Oracle Business Process Management Process Engine が Oracle Enterprise Repository と同じマシンで実行されている場合に、その Process Engine で Subscription Manager をすぐに使用できるようにコンフィグレーションされています。デフォルト設定が実行されている場合は、この手順を省略できます。

    要件によっては、<OER ドメイン>\WEB-INF\classes ディレクトリにある EndPointEventSubscription.xml ファイルで、次の情報を変更する必要がある場合があります。

    • [Host] - Oracle Enterprise Repository 以外のホストで Web サービス エンドポイントが実行されている場合。同じホストの場合は、デフォルト値をそのまま使用します。
    • [Port] - Web サービス エンドポイントのポートを指定します。Oracle Business Process Management が Process Engine として使用される場合は、デフォルト値をそのまま使用します。
    • [URI] - Web サービスの URI を指定します。Oracle Business Process Management が Process Engine として使用される場合は、デフォルト値をそのまま使用します。
    • [Operation Name] - Oracle Business Process Management が Process Engine として使用される場合は、デフォルト値をそのまま使用します。使用可能な操作については、<OER Web アプリケーション パス>/WEB-INF/lib にある eventNotifier.jar 内の WSDL を参照してください。
    • [User Name/Password] - Oracle Business Process Management が Process Engine として使用される場合にのみ使用されます。デフォルトのユーザ名とパスワードは「admin」と「admin」です。
    • [Expression] - デフォルトでは空です。これは、すべてのイベントが配信されることを意味します。
  7. Oracle Enterprise Repository を再起動してコンフィグレーションの変更を有効にします。

アセット イベントのトリガ

Event Manager のコンフィグレーション後にイベントがトリガされるようにするには、次の手順に従います。

  1. Web ベースのコンソールから Oracle Enterprise Repository Asset Editor を起動します。
  2. Oracle Enterprise Repository Asset Editor を使用する方法については、『Oracle Enterprise Repository Registrar Guide』を参照してください。

  3. 次に示す画面で新しいアセットを作成します。
  4. 図 2-2 Oracle Enterprise Repository Asset Editor - 新しいアセットの作成


    Oracle Enterprise Repository Asset Editor - 新しいアセットの作成

    注意 : アセットの種類は [Service] にしてください。
  5. [OK] をクリックしてアセットを送信します。
  6. アセットが送信されたら、Oracle Enterprise Repository コンソールに切り替えて、次のロギング文がコンソールに出力されていることを確認します。
  7. 図 2-3 Event Monitoring コンソール


    Event Monitoring コンソール

  8. Event Monitoring ツールを使用すると、配信されるイベントのペイロードを表示できます。イベントのモニタの詳細については、「イベントのモニタ」を参照してください。

 


Oracle Business Process Management Process Engine のコンフィグレーションおよび実行手順

Oracle Enterprise Repository のインストール時には、Oracle Business Process Management のインストールとコンフィグレーションを求められます。この節では、Oracle Business Process Management が正常にインストールされていることを前提としています。

イベントを送信するように Event Manager を設定したら、Oracle Business Process Management Process Engine をコンフィグレーションしてイベントを処理できるようにする必要があります。Oracle Enterprise Repository をインストールすると、Process Engine をインストールしてコンフィグレーションするためのオプションを使用できます。この節では、以下で説明する手順を実行する前に Process Engine が正常にインストールされていることを前提としています。

Oracle Business Process Management Admin Center を起動するには、<OBPM Enterprise ホーム>\bin ディレクトリにある albpmadmcenter ファイルをダブルクリックします。

使用例

Oracle Enterprise Repository には、Process Engine にデプロイされる、バンドル済みの Advanced Registration Flow が用意されています。Oracle Enterprise Repository 内でトリガされたイベントは、Process Engine に配信され、Oracle Enterprise Repository プロセス (アセットの送信、受け入れ、登録、その他の管理プロセスなど) の自動化を試行する Advanced Registration Flow を実行します。

使用可能な Advanced Registration Flow の詳細については、「Advanced Registration Flow のコンフィグレーション」を参照してください。

送信イベントを処理するための Advanced Registration Flow のコンフィグレーション

Oracle Business Process Management Process Engine がインストールされたら、次の手順に従います。

  1. Generate Workflow Config ツール (config_gen.bat) を使用してワークフロー コンフィグレーション (workflow.xml) ファイルを生成します。このツールは、Oracle Enterprise Repository に接続し、カスタマイズ可能なブートストラップ ファイルを作成します。workflow.xml ファイルの生成の詳細については、「ワークフロー コンフィグレーション ファイルの生成」を参照してください。
  2. 新しく生成された workflow.xml ファイルを <OBPM Enterprise Edition>/enterprise/server/aler_engine ディレクトリにコピーします。
  3. 適切な XML エディタで workflow.xml ファイルを開きます。
  4. Oracle Enterprise Repository 接続情報 (URI やレジストラのユーザ名/パスワードなど) が次に示すように正しくコンフィグレーションされていることを確認します。
  5.    <alerconnection>
    <uri>http://server01.amer.bea.com:7005/aler/services/FlashlineRegistry </uri>
    <registrar>
    <user>admin</user>
    <password>admin</password>
    </registrar>
    </alerconnection>

    URI は次の形式にする必要があります。
    http://<ホスト>:<ポート>/<OER Web アプリケーション名>/services/FlashlineRegistry

  6. workflow.xml ファイル内で、次に示すように、アセットの種類が「Service」の assetType の設定を探します。
  7.    <assetType name=”Service” community=”_CHANGE_COMMUNITY_” id=”154”>
    <allTabs>
    <allTabs>
    <tab name=”Oveview”/>
    <tab name=”UDDI: Business Entity”/>
    <tab name=”Taxonomy”/>
    <tab name=”Architecture”/>
    </allTabs>
  8. 次に示すように、autoAccept 属性を追加し、値を true に設定します。
  9.    <assetType name=”Application” community=”_CHANGE_COMMUNITY_” id=”154”  autoAccept=”true”>
    <allTabs>
    <allTabs>
    <tab name=”Oveview”/>
    <tab name=”UDDI: Business Entity”/>
    <tab name=”Taxonomy”/>
    <tab name=”Architecture”/>
    </allTabs>

    これで、種類が「Service」のアセットを自動的に受け入れるように Oracle Business Process Management Process Engine がコンフィグレーションされました。

  10. Oracle Business Process Management Process Engine が実行されている場合は、その Process Engine を停止して再起動し、workflow.xml に対する最新の変更をロードします。
  11. Refresh Workflow Configuration ツールを使用すると、Oracle Business Process Management Process Engine を再起動せずに workflow.xml ファイルを更新できます。workflow.xml ファイルの更新の詳細については、「ワークフロー コンフィグレーション ファイルの更新」を参照してください。

アセット送信イベントのトリガ

Oracle Business Process Management Process Engine をコンフィグレーションして実行したら、次の手順に従ってアセット送信イベントを処理します。

  1. Web コンソールから Oracle Enterprise Repository Asset Editor を起動します。
  2. Oracle Enterprise Repository Asset Editor を使用する方法については、『Oracle Enterprise Repository Registrar Guide』を参照してください。

  3. [File|New] を選択し、次に示す画面で新しいアセットを作成します。
  4. 図 2-4 Oracle Enterprise Repository Asset Editor - 新しいアセットの作成


    Oracle Enterprise Repository Asset Editor - 新しいアセットの作成

    注意 : アセットの種類は [Service] にしてください。
  5. [OK] をクリックしてアセットを送信します。
  6. アセットが送信されたら、Oracle Business Process Management Log Viewer に切り替えて、イベントが処理されたことを確認します。Log Viewer を起動するには、<OBPM Enterprise ホーム>\bin ディレクトリにある albpmlogviewer ファイルをダブルクリックします。
  7. Process Administrator のプリファレンス設定を使用して、Process Engine の [Log] ページで [Debug] レベルを有効にします。デフォルトでは、[Warning] レベルに設定されています。
  8. 図 2-5 Oracle Business Process Management Process Administrator - ロギングのプリファレンス


    Oracle Business Process Management Process Administrator - ロギングのプリファレンス

  9. [Debug] レベルを有効にすると、Process Engine によって大量の情報 (Oracle Enterprise Repository Advanced Registration Flow の情報だけでなく、他の Process Engine の情報も) が出力されるという内容の通知が表示されます。Oracle Enterprise Repository のロギングをフィルタ処理するには、次の手順に従います。
    1. Log viewer の左端にあるリスト ボックスで、[Message] を選択します。
    2. その右横にあるリスト ボックスで、[Begins With] を選択します。
    3. テキスト ボックスに「ALER:」と入力します。
    4. [Apply Filter] ボタンをクリックします。
    5. 図 2-6 Oracle Business Process Management Log Viewer


      Oracle Business Process Management Log Viewer

  10. Log Viewer に「ALER: Done accepting the asset」というメッセージが表示されたら、Asset Editor に戻り、[View|Refresh Tree] コマンドを使用して [Administration] タブを更新します。
  11. 次に示すように、[Accepted] セクションが最新のデータに更新されていることを確認します。
  12. 図 2-7 Oracle Enterprise Repository Asset Editor - [Administration] タブ


    Oracle Enterprise Repository Asset Editor - [Administration] タブ

  13. 次に示すように、[Administration] タブの [Audit Log] が更新されていることを確認します。
  14. 図 2-8 Oracle Enterprise Repository Asset Editor - [Audit Log]


    Oracle Enterprise Repository Asset Editor - [Audit Log]


  ページの先頭       前  次