WebLogic Integration Administration Console の使用

     前  次    目次     
ここから内容

イベント ジェネレータ

イベント ジェネレータ モジュールでは、以下の作業を行うことができます。

注意 : イベント ジェネレータを作成、変更、または削除するには、Administrators グループ、IntegrationAdministrators グループ、または IntegrationOperators グループのメンバーとしてログインする必要があります。Worklist Console オンライン ヘルプの「ユーザ管理」にある WebLogic Integration のユーザ、グループ、ロール、およびセキュリティ ポリシーに関する説明を参照してください。

以下のトピックがあります。

イベント ジェネレータについて

イベント ジェネレータは、システム イベント (ディレクトリへのファイルの到着、電子メール アカウントまたは JMS キューへのメッセージの到着など) に応答して、メッセージ ブローカ チャネルにメッセージをパブリッシュします。WebLogic Integration Administration Console からは、以下のイベント ジェネレータを作成できます。

それぞれのイベント ジェネレータについて、一連のチャネル ルールをコンフィグレーションします。JMS イベント ジェネレータの場合、これらのルールは、ユーザが指定した順番で、受信した JMS メッセージに対して適用されます。たとえば、以下のルールは JMS イベント ジェネレータ用にコンフィグレーションされたものです。

表 5-1 JMS イベント ジェネレータ - ルール
チャネル
プロパティ
myapp/orders/AllOrders
VendorId
 
myapp/orders/ACMEOrders
VendorId
ACME Trading Corp

この場合、JMS ヘッダー プロパティ「VendorId」が「ACME Trading Corp」に設定されているメッセージは、myapp/orders/AllOrders チャネルにポストされてしまいます。「VendorId」プロパティによって 1 番目のルールがトリガされるためです。所期の結果をもたらすには、ルールの順序を逆にする必要があります。

表 5-2 ルール - 逆順
チャネル
プロパティ
myapp/orders/ACMEOrders
VendorId
ACME Trading Corp
myapp/orders/AllOrders
VendorId
 

これで、JMS ヘッダ プロパティ「VendorId」が「ACME Trading Corp」に設定されているメッセージが myapp/orders/ACMEOrders チャネルに正しくポストされるようになりました。

チャネル ルールの順序が重要になるのは、JMS イベント ジェネレータのみです。電子メールまたはファイルのイベント ジェネレータの場合、ルールの順序は重要ではありません。

WebLogic Integration ソリューションのデプロイメント』の以下の節にも、イベント ジェネレータの構成に関する情報が記載されています。

イベント ジェネレータ モジュールの概要

イベント ジェネレータ モジュールからアクセスできるページを次の表に示します。この表では、ページごとに関連タスクとヘルプ トピックも示しています。

表 5-3 イベント ジェネレータ
ページ
関連タスク
ヘルプ トピック
ファイル
すべてのファイル イベント ジェネレータを表示
ファイル イベント ジェネレータのリストを表示する。ジェネレータ名、チャネル数、読まれたファイル、最後にリセットした時間、エラー数、エラー リセット時間、およびステータス (実行中またはサスペンド) が表示される。
ジェネレータ名でリストをフィルタ処理する。使用 ? は任意の 1 文字、* は 0 個以上の文字を指定するときに使用する。
イベント ジェネレータをサスペンドまたは再開する。サーバを再起動する場合、イベント ジェネレータのステータスは保持される。たとえば、サーバを再起動する際にイベント ジェネレータがサスペンド状態であれば、イベント ジェネレータはサスペンド状態のままになる。
読まれたファイル数またはエラーの数をリセットする。
1 つまたは複数のイベント ジェネレータを削除する。
新しいファイル イベント ジェネレータの作成
ファイル イベント ジェネレータを作成およびデプロイする。作成されたばかりのイベント ジェネレータにはチャネル ルールがない。
ファイル イベント ジェネレータ定義
[ファイル ジェネレータ チャネル ルール定義] ページにアクセスして、新しく作成したイベント ジェネレータ、または既存のイベント ジェネレータにチャネル ルールを追加する。
既存のイベント ジェネレータのチャネル ルールを表示する。詳細を表示または更新するチャネル ルールを選択する。
1 つまたは複数のチャネル ルールを削除する。
ファイル イベント ジェネレータ チャネル ルール定義
新しいチャネル ルールを作成、および既存のチャネル ルールを表示する。
電子メール
すべての電子メール イベント ジェネレータを表示
電子メール イベント ジェネレータのリストを表示する。ジェネレータ名、チャネル数、読まれた電子メール、最後にリセットした時間、エラー数、エラー リセット時間、およびステータス (実行中またはサスペンド) が表示される。
ジェネレータ名でリストをフィルタ処理する。使用 ? は任意の 1 文字、* は 0 個以上の文字を指定するときに使用する。
イベント ジェネレータをサスペンドまたは再開する。サーバを再起動する場合、イベント ジェネレータのステータスは保持される。たとえば、サーバを再起動する際にイベント ジェネレータがサスペンド状態であれば、イベント ジェネレータはサスペンド状態のままになる。
読まれた電子メール数またはエラーの数をリセットする。
1 つまたは複数のイベント ジェネレータを削除する。
新しい電子メール イベント ジェネレータの作成
電子メール イベント ジェネレータを作成およびデプロイする。作成されたばかりのイベント ジェネレータにはチャネル ルールがない。
電子メール イベント ジェネレータ定義
[電子メール イベント ジェネレータ チャネル ルール定義] ページにアクセスして、新しく作成したイベント ジェネレータ、または既存のイベント ジェネレータにチャネル ルールを追加する。
既存のイベント ジェネレータのチャネル ルールを表示する。詳細を表示または更新するチャネル ルールを選択する。
1 つまたは複数のチャネル ルールを削除する。
電子メール イベント ジェネレータ チャネル ルール定義
新しいチャネル ルールを作成、および既存のチャネル ルールを表示する。
JMS
すべての JMS イベント ジェネレータを表示
JMS イベント ジェネレータのリストを表示する。
ジェネレータ名でリストをフィルタ処理する。使用 ? は任意の 1 文字、* は 0 個以上の文字を指定するときに使用する。
イベント ジェネレータをサスペンドまたは再開する。サーバを再起動する場合、イベント ジェネレータのステータスは保持される。たとえば、サーバを再起動する際にイベント ジェネレータがサスペンド状態であれば、イベント ジェネレータはサスペンド状態のままになる。
読まれたメッセージ数またはエラーの数をリセットする。
1 つまたは複数のイベント ジェネレータを削除する。
新しい JMS イベント ジェネレータの作成
JMS イベント ジェネレータを作成およびデプロイする。ジェネレータを作成するときは、送り先のトピックまたはキュー、メッセージ セレクタ、デフォルト チャネル ルールを指定する。
JMS イベント ジェネレータの詳細
イベント ジェネレータのデフォルトのチャネル ルールを更新する。
JMS イベント ジェネレータ定義
[JMS イベント ジェネレータ チャネル ルール定義] ページにアクセスして、新しく作成したイベント ジェネレータ、または既存のイベント ジェネレータにチャネル ルールを追加する。
既存のイベント ジェネレータのチャネル ルールを表示する。詳細を表示または更新するチャネル ルールを選択する。
1 つまたは複数のチャネル ルールを削除する。
JMS イベント ジェネレータ チャネル ルール定義
新しいチャネル ルールを作成、および既存のチャネル ルールを表示する。
タイマー
すべてのタイマー イベント ジェネレータを表示
タイマー イベント ジェネレータのリストを表示する。ジェネレータ名、チャネル数、読まれたメッセージ、最後にリセットした時間、エラー数、エラー リセット時間、およびステータス (実行中またはサスペンド) が表示される。
ジェネレータ名でリストをフィルタ処理する。使用 ? は任意の 1 文字、* は 0 個以上の文字を指定するときに使用する。
イベント ジェネレータをサスペンドまたは再開する。サーバを再起動する場合、イベント ジェネレータのステータスは保持される。たとえば、サーバを再起動する際にイベント ジェネレータがサスペンド状態であれば、イベント ジェネレータはサスペンド状態のままになる。
読まれたメッセージ数またはエラーの数をリセットする。
1 つまたは複数のイベント ジェネレータを削除する。
新しいタイマー イベント ジェネレータの作成
タイマー イベント ジェネレータを作成およびデプロイする。作成されたばかりのイベント ジェネレータにはチャネル ルールがない。
タイマー イベント ジェネレータ定義
[タイマー ジェネレータ チャネル ルール定義] ページにアクセスして、新しく作成したイベント ジェネレータ、または既存のイベント ジェネレータにチャネル ルールを追加する。
既存のイベント ジェネレータのチャネル ルールを表示する。詳細を表示または更新するチャネル ルールを選択する。
1 つまたは複数のチャネル ルールを削除する。
タイマー イベント ジェネレータ チャネル ルール定義
新しいチャネル ルールを作成、および既存のチャネル ルールを表示する。
MQ
すべての MQSeries イベント ジェネレータを表示
MQSeries イベント ジェネレータのリストを表示する。ジェネレータ名、チャネル数、読まれたメッセージ、最後にリセットした時間、エラー数、エラー リセット時間、およびステータス (実行中またはサスペンド) が表示される。
ジェネレータ名でリストをフィルタ処理する。使用 ? は任意の 1 文字、* は 0 個以上の文字を指定するときに使用する。
イベント ジェネレータをサスペンドまたは再開する。サーバを再起動する場合、イベント ジェネレータのステータスは保持される。たとえば、サーバを再起動する際にイベント ジェネレータがサスペンド状態であれば、イベント ジェネレータはサスペンド状態のままになる。
読まれたメッセージ数またはエラーの数をリセットする。
1 つまたは複数のイベント ジェネレータを削除する。
新しい MQSeries イベント ジェネレータの作成
MQSeries イベント ジェネレータを作成およびデプロイする。作成されたばかりのイベント ジェネレータにはチャネル ルールがない。
MQSeries イベント ジェネレータ定義
[MQSeries ジェネレータ チャネル ルール定義] ページにアクセスして、新しく作成したイベント ジェネレータ、または既存のイベント ジェネレータにチャネル ルールを追加する。
既存のイベント ジェネレータのチャネル ルールを表示する。詳細を表示または更新するチャネル ルールを選択する。
1 つまたは複数のチャネル ルールを削除する。
MQSeries ジェネレータ チャネル ルール定義
新しいチャネル ルールを作成、および既存のチャネル ルールを表示する。
HTTP
   
すべての HTTP イベント ジェネレータを表示
HTTP イベント ジェネレータのリストを表示する。ジェネレータ名、チャネル数、読まれた HTTP 要求、最後にリセットした時間、エラー数、エラー リセット時間、およびステータス (実行中またはサスペンド) が表示される。
ジェネレータ名でリストをフィルタ処理する。使用 ? は任意の 1 文字、* は 0 個以上の文字を指定するときに使用する。
イベント ジェネレータをサスペンドまたは再開する。サーバを再起動する場合、イベント ジェネレータのステータスは保持される。たとえば、サーバを再起動する際にイベント ジェネレータがサスペンド状態であれば、イベント ジェネレータはサスペンド状態のままになる。
読まれたメッセージ数またはエラーの数をリセットする。
1 つまたは複数のイベント ジェネレータを削除する。
新しい HTTP イベント ジェネレータの作成
HTTP イベント ジェネレータを作成およびデプロイする。作成されたばかりのイベント ジェネレータにはチャネル ルールがない。
HTTP イベント ジェネレータ定義
[HTTP ジェネレータ チャネル ルール定義] ページにアクセスして、新しく作成したイベント ジェネレータ、または既存のイベント ジェネレータにチャネル ルールを追加する。
既存のイベント ジェネレータのチャネル ルールを表示する。詳細を表示または更新するチャネル ルールを選択する。
1 つまたは複数のチャネル ルールを削除する。
HTTP ジェネレータ チャネル ルール定義
新しいチャネル ルールを作成、および既存のチャネル ルールを表示する。
RDBMS
   
すべての RDBMS イベント ジェネレータを表示
RDBMS イベント ジェネレータのリストを表示する。ジェネレータ名、チャネル数、読まれたメッセージ、最後にリセットした時間、エラー数、およびエラー リセット時間が表示される。
ジェネレータ名でリストをフィルタ処理する。使用 ? は任意の 1 文字、* は 0 個以上の文字を指定するときに使用する。
イベント ジェネレータをサスペンドまたは再開する。サーバを再起動する場合、イベント ジェネレータのステータスは保持される。たとえば、サーバを再起動する際にイベント ジェネレータがサスペンド状態であれば、イベント ジェネレータはサスペンド状態のままになる。
読まれたメッセージ数またはエラーの数をリセットする。
1 つまたは複数のイベント ジェネレータを削除する。
新しい RDBMS イベント ジェネレータの作成
RDBMS イベント ジェネレータを作成およびデプロイする。作成されたばかりのイベント ジェネレータにはチャネル ルールがない。
RDBMS イベント ジェネレータ定義
[RDBMS イベント ジェネレータ チャネル ルール定義] ページにアクセスして、新しく作成したイベント ジェネレータ、または既存のイベント ジェネレータにチャネル ルールを追加する。
既存のイベント ジェネレータのチャネル ルールを表示する。詳細を表示または更新するチャネル ルールを選択する。
1 つまたは複数のチャネル ルールを削除する。
RDBMS イベント ジェネレータ チャネル ルール定義
新しいチャネル ルールを作成、および既存のチャネル ルールを表示する。
TibcoRV
   
新しい TibcoRV イベント ジェネレータの作成
TibcoRV イベント ジェネレータを作成およびデプロイする。
TibcoRV イベント ジェネレータおよび他の WLI 製品の詳細については、http://edocs.beasys.co.jp/e-docs/wli/docs92/index.html を参照。
すべての TibcoRV イベント ジェネレータを表示
TibcoRV イベント ジェネレータのリストを表示する。ジェネレータ名、チャネル数、読まれたメッセージ、最後にリセットした時間、エラー数、エラー リセット時間、およびエラー ステータスが表示される。
ジェネレータ名でリストをフィルタ処理する。使用 ? は任意の 1 文字、* は 0 個以上の文字を指定するときに使用する。
イベント ジェネレータをサスペンドまたは再開する。サーバを再起動する場合、イベント ジェネレータのステータスは保持される。たとえば、サーバを再起動する際にイベント ジェネレータがサスペンド状態であれば、イベント ジェネレータはサスペンド状態のままになる。
読まれたメッセージ数またはエラーの数をリセットする。
1 つまたは複数のイベント ジェネレータを削除する。

イベント ジェネレータの作成およびデプロイメント

イベント ジェネレータ モジュールでは、WebLogic Integration の一部として含まれるイベント ジェネレータを作成およびデプロイできます。この節の説明に従って作成した新しいイベント ジェネレータは、パッケージ化され、EJB (JMS イベント ジェネレータ、ファイル イベント ジェネレータ、電子メール イベント ジェネレータ、タイマー イベント ジェネレータ、MQ イベント ジェネレータ、および RDBMS イベント ジェネレータ) または Web アプリケーション モジュール (HTTP イベント ジェネレータ) として単一の管理対象サーバ上にデプロイされます。作成されデプロイされたイベント ジェネレータは、必要に応じてサスペンド、再開、またはチャネル ルールの追加を行うことができます。

注意 : JMS イベント ジェネレータ、HTTP イベント ジェネレータ、MQ イベント ジェネレータ、および RDBMS イベント ジェネレータは、クラスタ内の任意の数の管理対象サーバを対象にすることができます。JMC と MQ のイベント ジェネレータは、通常、物理的な JMS 送り先を使用する場合は 1 台の管理対象サーバ、分散送り先を使用する場合はクラスタにデプロイされます。1 台の管理対象サーバにデプロイする場合は、この節の手順を参照してください。

この節の内容は以下のとおりです。

  1. ホーム ページで、[イベント ジェネレータ] モジュールを選択します。
  2. 左側のパネルから、[JMS] を選択します。
  3. [新規作成] を選択します。
  4. [新しい JMS イベント ジェネレータの作成] ページが表示されます。[ジェネレータ名] フィールドに、イベント ジェネレータのユニークな名前を入力します。
  5. 注意 : 名前は大文字と小文字を区別しません。先頭または末尾のスペースは削除されます。
  6. [送り先タイプ] ドロップダウン リストから、[javax.jms.queue]、[javax.jms.topic]、または [foreign_jms_destination] を選択します。
  7. 以下のいずれかを実行します。
    • [javax.jms.queue] または [javax.jms.topic] を選択した場合は、[送り先 JNDI 名] ドロップダウン リストから、トピックまたはキューの JNDI 名を選択する。
    • [foreign_jms_destination] を選択した場合は、[送り先 JNDI 名] ドロップダウン リストからリモート JNDI 名を選択し、すぐ下にあるドロップダウン リストから外部の送り先タイプ ([javax.jms.Queue] または [javax.jms.Topic]) を選択する。
    • 図 5-1 新しい JMS イベント ジェネレータの作成


      新しい JMS イベント ジェネレータの作成

  8. [JMS 接続ファクトリ JNDI 名] ドロップダウン リストから JNDI 名を選択します。
  9. [メッセージ セレクタ] フィールドに、JMS メッセージ セレクタを指定します。http://java.sun.com/dtd/ejb-jar_2_0.dtd を参照してください。
  10. [デフォルト ルール チャネル] ドロップダウン リストから、デフォルトのチャネルを選択します。このチャネルには、他のチャネル ルールに一致しないメッセージがパブリッシュされます。
  11. [送信] をクリックして、イベント ジェネレータを作成およびデプロイします。
  12. イベント ジェネレータ定義のページが表示されます。

    注意 : イベント ジェネレータはチャネル ルールなしで作成されデブロイされます。そのため、まずジェネレータのチャネル ルールを定義する必要があります。
  13. [新しいチャネル ルールを定義] を選択します。
  14. 必要なプロパティを設定します。「JMS イベント ジェネレータのチャネル ルールの定義」を参照してください。
  15. [送信] をクリックして、イベント ジェネレータにチャネル ルールを追加します。
  16. 必要に応じて手順 10 ~ 12 を繰り返し、チャネルをさらに追加します。
  17. 複数のルールを定義する場合は、必要に応じて順序を並べ替えることができます。上向き矢印または下向き矢印 新しい JMS イベント ジェネレータの作成 ボタンをクリックして、リスト内のエントリを上または下に移動します。変更はすぐに有効になります。
  18. ホーム ページで、[イベント ジェネレータ] モジュールを選択します。
  19. 左側のパネルから、イベント ジェネレータのタイプ ([ファイル]、[電子メール]、[タイマー]、[MQ Series]、[HTTP]、または [RDBMS]) を選択します。
  20. Console のメイン メニューからイベント ジェネレータのタイプを選択し、[新規作成] をクリックします。
  21. 選択したタイプに応じた [新規作成] 用ページが表示されます。

    図 5-2 新しいファイル イベント ジェネレータの作成


    新しいファイル イベント ジェネレータの作成

  22. [ジェネレータ名] フィールドに、イベント ジェネレータのユニークな名前を入力します。手順 2 で [HTTP] を選択した場合は、[Web アプリケーション コンテキスト ルート] を入力し、[JMS 接続ファクトリ JNDI 名] ドロップダウン リストから JNDI 名を選択する必要があります。
  23. 図 5-3 新しい HTTP EG の作成


    新しい HTTP EG の作成

  24. [送信] をクリックして、イベント ジェネレータを作成およびデプロイします。
  25. イベント ジェネレータ定義のページが表示されます。

    注意 : イベント ジェネレータはチャネル ルールなしで作成されデブロイされます。そのため、まずジェネレータのチャネル ルールを定義する必要があります。
  26. [新しいチャネル ルールを定義] を選択します。
  27. 必要なプロパティを設定します。利用できるプロパティの詳細については、作成中のイベント ジェネレータに適したトピックを参照してください。
  28. [送信] をクリックして、イベント ジェネレータにチャネル ルールを追加します。
  29. 必要に応じて手順 6 ~ 8 を繰り返し、チャネルをさらに追加します。
  30. 複数のルールを定義する場合は、順序を並べ替えることができます。上向き矢印または下向き矢印 新しい HTTP EG の作成 ボタンをクリックして、リスト内のエントリを上または下に移動します。変更はすぐに有効になります。
  31. 注意 : この機能は、便宜を図るためだけに提供されています。電子メールまたはファイルのイベント ジェネレータについては、チャネル ルールの順序は機能的に重要ではありません。

関連トピック

ファイル イベント ジェネレータのチャネル ルールの定義

[ファイル ジェネレータ チャネル ルール定義] ページでは、チャネル ルールのプロパティを定義できます。

図 5-4 チャネル定義 - ファイル

チャネル定義 - ファイル

利用できる設定の概要を次の表に示します。

表 5-4 [ファイル ジェネレータ チャネル ルール定義] ページの要素
設定
説明
必須/
省略可能
[ファイル タイプ] ドロップダウン リストから、[ディスク ファイル] または [FTP] を選択する。
ファイル イベントの種類。
必須
[チャネル名] ドロップダウン リストから、メッセージ ブローカ チャネルを選択する。
コンフィグレーションされた条件に一致するメッセージがパブリッシュされるメッセージ ブローカ チャネルの名前。
必須
[メッセージ エンコーディング] フィールドで、デフォルト値を選択しない場合は、文字セット名を入力する。

注意 : このプロパティを設定できるのは、メッセージ ブローカ チャネルのタイプが string の場合のみ。

文字セット (デフォルト以外の場合)。このプロパティを適用できるのは [チャネル名] が string の場合のみ。有効な値については http://www.iana.org/assignments/character-sets を参照。
省略可能
[FTP ホストの場所] フィールドに、FTP サーバの場所を入力する。
[ファイル タイプ] を [FTP] に設定した場合の FTP サーバの場所 (IP アドレスまたはホスト名)。
[ファイル タイプ] を [FTP] に設定した場合は必須
[FTP ユーザ名] フィールドに名前を入力する。
FTP アカウントのアクセスに必要な名前。
[ファイル タイプ] を [FTP] に設定した場合は必須
以下のいずれかの操作を行って、[FTP ユーザ パスワード] を指定する。
  • [エリアスを使用] オプション ボタンを選択し、ドロップダウン リストからパスワード エリアスを選択する。
  • [値を使用] オプション ボタンを選択し、フィールドにパスワードを入力する。
[値を使用] フィールドにパスワードを入力した場合、このパスワードはイベント ジェネレータのコンフィグレーション ファイルにクリア テキストで保存される。パスワードのセキュリティを保護するには、パスワードをパスワード ストアに追加する。「パスワード エリアスおよびパスワード ストア」を参照。エリアスをパスワード ストアに追加したら、[エリアスを使用] ドロップダウン リストから選択できる。
[ファイル タイプ] を [FTP] に設定した場合は必須
[FTP ローカル ディレクトリ] フィールドにパスを入力する。
FTP サーバからファイルをコピーする先のディレクトリへのパスを指定する。
[ファイル タイプ] を [FTP] に設定した場合は必須
[ディレクトリ] フィールドに有効なパスを入力する。
[ファイル タイプ] を [ディスク] に設定した場合は、ファイルをポーリングするディレクトリへのパスを指定する。
[ファイル タイプ] を [FTP] に設定した場合は、ファイルをポーリングする FTP サーバ上のパスを指定する。
[ファイル タイプ] に [ディスク] または [FTP] のいずれを設定したとしても、書き込み可能な場所を指定することを強く推奨する。
[ファイル タイプ] が [ディスク] の場合は、ポーリングの前にディレクトリが書き込み可能であることが確認される。書き込み可能になっていない場合、エラー数がインクリメントし、読み込みおよびパブリッシュ プロセスが省略される。
[ファイル タイプ] が [FTP] の場合は、ポーリング間隔ごとにディレクトリ内のファイルの読み込みとパブリッシュが行われる。ファイルを削除するとエラーが発生してログに記録され、エラー数がインクリメントする。ファイルを削除できないと、ポーリング間隔ごとに同じファイルがパブリッシュされることになる。
必須
[ファイル名で渡す] ドロップダウン リストから、[はい] または [いいえ] を選択する。
[はい] に設定すると、ファイルはアーカイブ ディレクトリにステージングされ FileControlPropertiesDocument 内で参照としてパスされるが、この時ファイルはメッセージのペイロードとして送信される。[はい] に設定する場合は、アーカイブ ディレクトリを指定する必要がある。
デフォルトは [いいえ]。
必須
[サブディレクトリをスキャン] ドロップダウン リストから、[はい] または [いいえ] を選択する。
サブディレクトリをスキャンするかどうかを指定する。
省略可能
[ファイル パターン] フィールドにパターンを入力する。
フィルタ処理するためのパターン (省略可能)。使用 ? は任意の 1 文字、* は 0 個以上の文字を指定するときに使用する。
省略可能
[到着順にソートしますか?] ドロップダウン リストから、[はい] または [いいえ] を選択する。
[はい] を設定した場合は、ファイルは到着順にソートされる。この順序は保持される (ファイルは到着順に処理される)。
デフォルトは [いいえ]。
必須
[ポーリング間隔] を日、時間、分、または秒で指定する。
指定したディレクトリをポーリングする頻度。[日] フィールドに日数を入力し (間隔が 1 日より長い場合)、必要な時間数、分数、または秒数をドロップダウン リストから選択する。
必須
[読み込み制限] フィールドに、各ポーリングで読み込むファイルの最大数を入力する。
各ポーリングで読み込むファイルの最大数。有効な値は 0 以上。0 に設定するとすべてのファイルが読み込まれる。
必須
[読み込み後のアクション] ドロップダウン リストから、[削除] または [アーカイブ] を選択する。
読み終わったファイルの処理方法を指定。
デフォルトは [削除]。
必須
[アーカイブ ディレクトリ] フィールドに有効なパスを入力する。
ファイルのアーカイブ先ディレクトリへのパスを指定する。
[読み込み後のアクション] を [アーカイブ] に設定した場合、または [ファイル名で渡す] を [はい] に設定した場合は必須
[エラー ディレクトリ] フィールドに有効なパスを入力する。
ファイル システムのディレクトリ パスを指定して、読み込みまたはメッセージ ブローカ チャネルへのコンテンツのパブリッシュで問題が発生した場合に、対象のファイルを書き込む。
必須
[説明] フィールドに、チャネル ルールの説明を入力する。
チャネル ルールのわかりやすい説明。
省略可能
[代替ユーザでパブリッシュ] ドロップダウン リストから、有効なユーザ名を選択する。
[代替ユーザでパブリッシュ] プロパティを使用すると、ファイル イベント ジェネレータは特定のユーザとしてメッセージをパブリッシュできるようになる。このプロパティに値を設定すると、メッセージはセキュリティ保護されたメッセージ ブローカ チャネルに配信される。
[代替ユーザでパブリッシュ] の指定を省略した場合、メッセージは Anonymous としてパブリッシュされる。
省略可能

関連トピック

電子メール イベント ジェネレータのチャネル ルールの定義

[電子メール イベント ジェネレータ チャネル ルール定義] ページでは、チャネル ルールのプロパティを定義できます。

図 5-5 チャネル定義 - 電子メール EG

チャネル定義 - 電子メール EG

利用できる設定の概要を次の表に示します。

表 5-5 イベント ジェネレータ チャネル ルール定義の要素
設定
説明
必須/
省略可能
[サーバ プロトコル] ドロップダウン リストから、[IMAP] または [POP3] を選択する。
電子メール アカウントのサーバの種類。デフォルトは [POP3]。
必須
[チャネル名] ドロップダウン リストから、メッセージ ブローカ チャネルを選択する。
コンフィグレーションされた条件に一致するメッセージがパブリッシュされるメッセージ ブローカ チャネルの名前。
必須
[ホスト名] フィールドに、サーバ名を入力する。
ポーリングするメール サーバ。
必須
[ポート番号] フィールドに、電子メール サーバのポート番号を入力する。
メール サーバ ポート。
デフォルトは -1。これは、メール サーバ (IMAP の場合は 143、POP3 の場合は 110) のデフォルトのポート番号が使用されることを示す。
必須
[ユーザ名] フィールドにアカウントのユーザ名を入力する。
電子メール アカウントのユーザ名。このアカウントについて、イベント ジェネレータがポーリングを行う。
必須
以下のいずれかの操作を行って、[パスワード] を指定する。
  • [エリアスを使用] オプション ボタンを選択し、ドロップダウン リストからパスワード エリアスを選択する。
  • [値を使用] オプション ボタンを選択し、フィールドにパスワードを入力する。
[値を使用] フィールドにパスワードを入力した場合、このパスワードはイベント ジェネレータのコンフィグレーション ファイルにクリア テキストで保存される。パスワードのセキュリティを保護するには、パスワードをパスワード ストアに追加する。「パスワード エリアスおよびパスワード ストア」を参照。エリアスをパスワード ストアに追加したら、[エリアスを使用] ドロップダウン リストから選択できる。
省略可能
[添付ファイル] フィールドから、[アーカイブ] または [無視] を選択する。
添付ファイルの処理方法を指定する。[アーカイブ] を選択した場合、添付ファイルは [アーカイブ ディレクトリ] に保存される。
必須
[ポーリング間隔] を日、時間、分、または秒で指定する。
アカウントをポーリングする頻度。[日] フィールドに日数を入力し (間隔が 1 日より長い場合)、必要な時間数、分数、または秒数をドロップダウン リストから選択する。
必須
[読み込み制限] フィールドに、各ポーリングで読み込むメッセージの最大数を入力する。
各ポーリングで読み込むメッセージの最大数。有効な値は 0 以上。
必須
[読み込み後のアクション] ドロップダウン リストから、[削除]、[アーカイブ]、または [移動] を選択する。
読み込まれたメッセージに対するイベント ジェネレータのアクションを指定します。[移動] は、IMAP プロトコルでのみ利用できる。
デフォルトは [削除]。
省略可能
[IMAP 移動フォルダ] フィールドに、有効な IMAP フォルダを入力する。
[読み込み後のアクション] を [移動] に設定した場合、[IMAP 移動フォルダ] でメッセージの移動先フォルダを指定する。
[読み込み後のアクション] を [移動] に設定した場合は必須
[アーカイブ ディレクトリ] フィールドに有効なパスを入力する。
[読み込み後のアクション] を [アーカイブ] に設定した場合、[アーカイブ ディレクトリ] フィールドでアーカイブ場所のパスを指定する。
[読み込み後のアクション] を [アーカイブ] に設定した場合は必須
[エラー ディレクトリ] フィールドに有効なパスを入力する。
問題が発生した場合にメッセージと添付ファイルを書き込む、ファイル システムのディレクトリ パスを指定する。
必須
[説明] フィールドに、チャネル ルールの説明を入力する。
チャネル ルールのわかりやすい説明。
省略可能
[代替ユーザでパブリッシュ] ドロップダウン リストから、有効なユーザ名を選択する。
[代替ユーザでパブリッシュ] プロパティを使用すると、電子メール イベント ジェネレータは特定のユーザとしてメッセージをパブリッシュできるようになる。このプロパティに値を設定すると、メッセージはセキュリティ保護されたメッセージ ブローカ チャネルに配信される。
[代替ユーザでパブリッシュ] の指定を省略した場合、メッセージは Anonymous としてパブリッシュされる。
省略可能

関連トピック

JMS イベント ジェネレータのチャネル ルールの定義

[JMS イベント ジェネレータ チャネル ルール定義] ページでは、チャネル ルールのプロパティを定義できます。

図 5-6 JMS EG - チャネル ルール定義

JMS EG - チャネル ルール定義

利用できる設定の概要を次の表に示します。

表 5-6 [JMS イベント ジェネレータ チャネル ルール定義] ページの要素
設定
説明
必須/
省略可能
[チャネル名] ドロップダウン リストから、メッセージ ブローカ チャネルを選択する。
コンフィグレーションされた条件に一致するメッセージのパブリッシュ先となるチャネルの名前。
必須
[プロパティ名] フィールドに、JMS プロパティに必要な名前を入力する。
[プロパティ名] および [プロパティ値] (下) の両方を指定した場合、このプロパティの値が [プロパティ値] の値と一致しないと、一致とはみなされない。
[プロパティ名] だけを指定した場合は、そのプロパティ自体が一致とみなされる。
[プロパティ名] および [プロパティ値] の両方を空白にした場合、JMS キューのすべてのメッセージが一致とみなされる。
省略可能
[プロパティ値] フィールドに、必要なプロパティ値を入力する。
[プロパティ名] を指定した場合に、[プロパティ値] を使用して、一致とみなされるために必要な値を指定できる。
省略可能
[説明] フィールドに、チャネル ルールの説明を入力する。
チャネル ルールのわかりやすい説明。
省略可能
[代替ユーザでパブリッシュ] ドロップダウン リストから、有効なユーザ名を選択する。
[代替ユーザでパブリッシュ] プロパティを使用すると、JMS イベント ジェネレータは特定のユーザとしてメッセージをパブリッシュできるようになる。このプロパティに値を設定すると、メッセージはセキュリティ保護されたメッセージ ブローカ チャネルに配信される。
[代替ユーザでパブリッシュ] の指定を省略した場合、メッセージは Anonymous としてパブリッシュされる。
省略可能

関連トピック

タイマー イベント ジェネレータのチャネル ルールの定義

[タイマー ジェネレータ チャネル ルール定義] ページでは、チャネル ルールのプロパティを定義できます。

図 5-7 タイマー ジェネレータ チャネル ルール定義

タイマー ジェネレータ チャネル ルール定義

利用できる設定の概要を次の表に示します。

表 5-7 タイマー ジェネレータ チャネル ルール定義の要素
設定
説明
必須/
省略可能
[チャネル名] ドロップダウン リストから、メッセージ ブローカ チャネルを選択する。
コンフィグレーションされた条件に一致するメッセージがパブリッシュされるメッセージ ブローカ チャネルの名前。
必須
[有効時間] ドロップダウン リストから、最初のイベントを開始する月、日、年、および時間を選択する。
最初のイベントが生成される日付と時刻。すでに有効時間が過ぎている場合、イベントは、次回の [実行間隔] の間隔までパブリッシュされない (次の設定を参照)。[1 回実行] オプションを選択した場合は、有効な未来の [有効時間] を入力する必要がある。入力しないとイベントは生成されない。
カレンダーで年間を通して毎日同じ時刻に発生するイベントを作成する場合は、標準時間から夏時間に移ったときに時間が変わることを考慮する必要がある。夏時間を考慮した場合、2 つのタイマー イベントを定義する必要がある。1 つは標準時間が適用されている期間 (たとえば 2004 年 4 月 6 日 2:30 PM から 2004 年 10 月 31 日 2:30 PM まで) に動作するイベント、もう 1 つは、夏時間期間中 (たとえば 2004 年 11 月 1 日 2:30 PM から 2005 年 4 月 2 日 2:30 PM まで) に動作するイベント。間隔は 1 日に設定する。必要に応じて、それ以降の年についてもタイマーを定義する必要がある。
必須
以下のいずれかを実行します。
  • [1 回実行] オプション ボタンを選択する。
  • [実行間隔] オプション ボタンを選択し、日、時間、分、および秒で間隔を指定する。
[有効時間] からの、各イベントが生成される間隔。[1 回実行] オプションを選択した場合、[有効時間] が最初で最後のイベント生成になる。

注意 : ビジネス カレンダーの時間間隔の最小単位は分。したがって、[ビジネス カレンダー] (下記の設定を参照) を指定する場合は、[実行間隔] の間隔に秒を指定しない。

必須
以下のいずれかを実行します。
  • [無期限] オプション ボタンを選択する。
  • [終了日] オプション ボタンを選択し、ドロップダウン リストから月、日、年、および時間を選択する。
コンフィグレーションされたスケジュールの期限が切れる日付と時間。[無期限] オプションを選択した場合、コンフィグレーションされたスケジュールは無期限で有効状態が維持される。
必須
[メッセージ] フィールドに、配信する XML メッセージを入力する。
指定したメッセージ ブローカ チャネルに配信するメッセージ コンテンツ。メッセージ コンテンツは任意の型の単一要素。たとえば、メッセージ コンテンツが string タイプの場合には、string タイプのチャネルを選択する。XML メッセージの場合は、XML タイプのチャネルを選択する。
省略可能
[ビジネス カレンダー] ドロップダウン リストから、ビジネス カレンダーを選択する。
ビジネス カレンダーを選択する場合、[実行間隔] の間隔は、指定したカレンダーに対して計算されるビジネス時間を表す。http://edocs.beasys.co.jp/e-docs/wli/docs92/worklistadminhelp/businesscalendar.html に記載されているワークリスト オンライン ヘルプの「ビジネス カレンダーとビジネス時間の計算について」を参照。
カレンダーを選択しない場合、[実行間隔] の間隔は絶対的な期間 (24 時間、毎日など) を表す。
イベント ジェネレータのチャネル ルールおよびチャネル ルールに関連付けられたビジネス カレンダーを変更する場合は、変更を行う前に、対応するタイマー イベント ジェネレータをサスペンドする必要がある。タイマー イベント ジェネレータのサスペンドの詳細については、「イベント ジェネレータのサスペンドおよび再開」を参照。
省略可能
[説明] フィールドに、チャネル ルールの説明を入力する。
チャネル ルールのわかりやすい説明。
省略可能
[代替ユーザでパブリッシュ] ドロップダウン リストから、有効なユーザ名を選択する。
[代替ユーザでパブリッシュ] プロパティを使用すると、タイマー イベント ジェネレータは特定のユーザとしてメッセージをパブリッシュできるようになる。このプロパティに値を設定すると、メッセージはセキュリティ保護されたメッセージ ブローカ チャネルに配信される。
[代替ユーザでパブリッシュ] の指定を省略した場合、メッセージは Anonymous としてパブリッシュされる。
省略可能
[回復可能] チェックボックス
サーバのシャットダウンによって失われるタイマー イベントを回復するには、タイマー イベント ジェネレータのチャネル ルールを定義する際に [回復可能] チェックボックスを選択する。
省略可能

関連トピック

MQ イベント ジェネレータのチャネル ルールの定義

[MQSeries ジェネレータ チャネル ルール定義] ページでは、チャネル ルールのプロパティを定義できます。

図 5-8 MQSeries ジェネレータ チャネル ルール定義

MQSeries ジェネレータ チャネル ルール定義

利用できる設定の概要を次の表に示します。

表 5-8 [MQSeries ジェネレータ チャネル ルール定義] ページの要素
設定
説明
必須/
省略可能
[チャネル名] ドロップダウン リストから、メッセージ ブローカ チャネルを選択する。
コンフィグレーションされた条件に一致するメッセージがパブリッシュされるメッセージ ブローカ チャネルの名前。
必須
[説明] フィールドに、チャネル ルールの説明を入力する。
チャネル ルールのわかりやすい説明。
省略可能
[ポーリング間隔] を日、時間、分、または秒で指定する。
指定したメッセージ キューをポーリングする頻度。[日] フィールドに日数を入力し (間隔が 1 日より長い場合)、必要な時間数、分数、または秒数をドロップダウン リストから選択する。
必須
[接続タイプ] ドロップダウン リストから、[TCP-IP] または [バインディング] を選択する。
WebSphere MQ キュー マネージャに接続する際に使用する接続モード。[TCP-IP] または [バインディング] を選択する。
[バインディング] は、ローカル システム上のキュー マネージャに接続するときだけ使用できる共有メモリ プロトコルである。
[TCP-IP] を選択した場合は、[MQSeries サーバ ホスト アドレス]、[MQSeries キュー マネージャ チャネル名]、および [MQSeries キュー マネージャ ポート番号] も指定する必要がある。
必須
[MQSeries キュー マネージャ] フィールドに、キュー マネージャの名前を入力する。
接続先となる WebSphere MQ キュー マネージャの名前。
必須
[MQSeries サーバ ホスト アドレス] フィールドに、IP アドレスまたはホスト名を入力する。
WebSphere MQ サーバの IP アドレスまたはホスト名。
[接続タイプ] を [TCP-IP] に設定した場合は必須
[MQSeries キュー マネージャ チャネル名] に、接続用の MQ チャネル名を入力する。
WebSphere MQ キュー マネージャに接続する際に使用するサーバ接続チャネルの名前を指定する。
[接続タイプ] を [TCP-IP] に設定した場合は必須
[MQSeries キュー マネージャ ポート番号] フィールドに、キュー マネージャのポート番号を入力する。
WebSphere MQ キュー マネージャに接続する際に使用する TCP/IP ポート番号。
[接続タイプ] を [TCP-IP] に設定した場合は必須
[MQSeries キュー マネージャ CCSID] フィールドに、アプリケーションによって予期されるロケールの CCSID を入力する。
WebSphere MQ によってサポートされる CCSID (Coded Character Set Identifier) を指定する。たとえば、en_US.iso88591 ロケールの場合、CCSID は 819ja_JP.SJIS ロケールの場合は 932
サポートされている CCSID、およびコード化された文字セット間でのメッセージ データの変換の詳細については、各プラットフォーム用の WebSphere MQ のマニュアルを参照。
省略可能
[MQSeries キュー名] フィールドに、キューの名前を入力する。
メッセージについてモニタする WebSphere MQ キューの名前。
必須
[MQSeries エラー キュー名] フィールドに、キューの名前を入力する。
エラー状態が原因で処理できないメッセージのキューの名前を指定する。
たとえば、キューから取得したメッセージのタイプが、メッセージ ブローカ チャネルについて設定したメッセージ タイプと一致しない場合は、処理中に例外が生成される。
エラー キューの名前を指定した場合、エラー メッセージは指定したキューに移動される。
エラー キューの名前を指定しなかった場合、エラー メッセージは元のキューに残される。また、イベント ジェネレータは同じメッセージを送信しようとし続けるため、結果的に無限ループになる。
省略可能
コンテンツのフィルタ処理を有効にするには、[コンテンツ フィルタ クラス] フィールドにコンテンツ フィルタ クラスの完全修飾名を入力する。
イベント コンテンツのフィルタ処理ロジックを実装するクラスの完全修飾名。「コンテンツのフィルタ処理」で説明しているとおり、このクラスは com.bea.wli.mbconnector.mqseries.AbstractContentFilter クラスの拡張である。
省略可能
[MQ データ変換が必要] チェック ボックスをチェックするか、チェックをはずす。
チェックした場合、[MQGMO_CONVERT] オプションが有効になり、キューから取得したメッセージのコンテンツがキュー マネージャによって変換される。メインフレームを含んだクロス プラットフォーム環境でメッセージを取得する場合 (メインフレームのアプリケーションがキューに送信したメッセージを PC 上のイベント ジェネレータで取得する場合など) は、このオプションをチェックする必要がある。一般に、このオプションは、CCSID によって指定されるネイティブ文字セットにメッセージを変換するために有効にする。
省略可能
[ポーリング スレッド数] フィールドに、処理スレッドの数を入力する。
イベント ジェネレータの処理スレッドの数。
必須
[ポーリングごとのメッセージ数] フィールドで、ポーリング サイクルごとに各スレッドによって取得されるメッセージの数を指定する。
ポーリング サイクルごとに各イベント ジェネレータ スレッドによって取得されるメッセージの数。[-1] を指定すると、各ポーリング サイクルでキューにあるすべてのメッセージが取得される。
省略可能
WebSphere MQ 認可が有効になっている場合は、[MQSeries ユーザ名] フィールドでユーザ名を指定する。
WebSphere MQ キュー マネージャに接続する際に使用する WebSphere MQ ユーザ名。
省略可能
WebSphere MQ 認可が有効になっている場合は、[MQSeries ユーザ パスワード] フィールドでパスワードを指定する。
WebSphere MQ キュー マネージャに接続する際に使用する WebSphere MQ ユーザ パスワード。
省略可能
[代替ユーザでパブリッシュ] ドロップダウン リストから、有効なユーザ名を選択する。
[代替ユーザでパブリッシュ] プロパティを使用すると、イベント ジェネレータは特定のユーザとしてメッセージをパブリッシュできるようになる。このプロパティに値を設定すると、メッセージはセキュリティ保護されたメッセージ ブローカ チャネルに配信される。
[代替ユーザでパブリッシュ] の指定を省略した場合、メッセージは Anonymous としてパブリッシュされる。
省略可能

コンテンツのフィルタ処理

キュー内のメッセージをメッセージ コンテンツに基づいてフィルタ処理するには、com.bea.wli.mbconnector.mqseries.AbstractContentFilter クラスを拡張したカスタム コンテンツ フィルタ クラスが必要です。

コード リスト 5-1 コンテンツ フィルタ
package com.bea.wli.mqseries.eventgen.contentfilter;

import com.bea.wli.mbconnector.mqseries.AbstractContentFilter;

public class ContentFilter extends AbstractContentFilter

{

public ContentFilter()
{
}

public boolean matchContent(byte abyte[])
{
/*この関数は常に true を返します。これは、すべてのメッセージで
イベントを生成できるようにするためです。ただし、ユーザは
メッセージのコンテンツに応じて、コンテンツ フィルタ ロジックを
ここに記述する必要があります。この関数に渡される
abyte[] バイト配列パラメータは、メッセージをバイト配列で
表したものです。メッセージがイベントを生成する必要が
ある場合には true を、そうでない場合は false を
返します。*/
return true;
}

この関数のパラメータは、イベント ジェネレータによってキューから取得されるメッセージを表すバイト配列です。このバイト配列によって表されるメッセージのコンテンツに対して必要なチェックを行うことによって、コンテンツ フィルタ処理のロジックを作成できます。メッセージがイベントを生成する場合は、ブール値の True を返します。イベントを生成しない場合は、ブール値の False を返します。

コンテンツ フィルタ処理のロジックを定義したら、それを実装するクラスを jar ファイルにバンドルし、WebLogic の CLASSPATH にインクルードする必要があります。

  1. mqegEjbUtil.jar ファイルを WL_HOME\integration\egs\mqEG.ear ファイルから抽出し、カスタム コンテンツ フィルタ クラスを作成する環境の CLASSPATH に含めます。
  2. com.bea.wli.mbconnector.mqseries.AbstractContentFilter を拡張してクラスを作成します。
  3. 注意 : このクラスは、手順 1 で抽出した mqegEjbUtil.jar ファイルにあります。
  4. コンテンツ フィルタ クラスのコードを作成します。コード リスト 5-1 に例を示します。
  5. カスタム コンテンツ フィルタ クラスをコンパイルします。
  6. mqegEjbUtil.jar から AbstractContentFilter クラスを抽出し、パッケージ構造を維持した状態でファイル システムのディレクトリに格納します。
  7. com.bea.wli.mbconnector.mqseries.AbstractContentFilter クラスと手順 4 でコンパイルしたカスタム コンテンツ フィルタ クラスを含んだ JAR (たとえば、mycontentfilter.jar) を作成します。
  8. この JAR ファイルを WebLogic のサーバ起動スクリプトの CLASSPATH 変数にインクルードします。
  9. WebLogic Server を起動します。
  10. イベント ジェネレータのチャネル ルールを作成するときは、コンテンツ フィルタの完全修飾クラス名を指定します。たとえば、com.bea.wli.mqseries.eventgen.ContentFilter といった名前を指定します。

関連トピック

HTTP イベント ジェネレータのチャネル ルールの定義

[HTTP ジェネレータ チャネル ルール定義] ページでは、チャネル ルールのプロパティを定義できます。

図 5-9 HTTP ジェネレータ チャネル ルール定義

HTTP ジェネレータ チャネル ルール定義

利用できる設定の概要を次の表に示します。

表 5-9 HTTP イベント ジェネレータ ページの要素
設定
説明
必須/
省略可能
[チャネル名] ドロップダウン リストから、メッセージ ブローカ チャネルを選択する。
HTTP イベントのパブリッシュ先となるメッセージ ブローカー チャネルの名前。
必須
[説明] フィールドに、チャネル ルールの説明を入力する。
チャネル ルールのわかりやすい説明。
省略可能
[代替ユーザでパブリッシュ] ドロップダウン リストから、有効なユーザ名を選択する。
[代替ユーザでパブリッシュ] プロパティを使用すると、イベント ジェネレータは特定のユーザとしてメッセージをパブリッシュできるようになる。このプロパティに値を設定すると、メッセージはセキュリティ保護されたメッセージ ブローカ チャネルに配信される。
[代替ユーザでパブリッシュ] の指定を省略した場合、メッセージは Anonymous としてパブリッシュされる。
省略可能

関連トピック

RDBMS イベント ジェネレータのチャネル ルールの定義

[RDBMS イベント ジェネレータ チャネル ルール定義] ページでは、チャネル ルールのプロパティを定義できます。

図 5-10 RDBMS イベント ジェネレータ チャネル ルール定義

RDBMS EG チャネル ルール定義

図 5-11 RDBMS イベント ジェネレータ チャネル ルール定義

表 5-10 に使用できる設定を示します。

表 5-10 [RDBMS イベント ジェネレータ チャネル ルール定義] ページの要素
設定
説明
必須/省略可能
[チャネル名] ドロップダウン リストから、メッセージ ブローカ チャネルを選択する。
コンフィグレーション条件に一致するメッセージがパブリッシュされるメッセージ ブローカ チャネルの名前。XML チャネルまたは文字列チャネルにパブリッシュする場合は、WebLogic ドメイン フォルダ内のディレクトリにチャネル ルール定義と同じ名前で XML スキーマ (.xsd) ファイルが作成される。この .XSD を検証に使用できる。
[チャネル名] ドロップダウン リストから RawData チャネル タイプを選択すると、イベント ジェネレータは、ポーリングまたは処理されたデータベース行を含むシリアライズされた weblogic.jdbc.rowset.WLCachedRowSet をパブリッシュする。
必須
[説明] フィールドに、チャネル ルールの説明を入力する。
チャネル ルールのわかりやすい説明。
省略可能
[イベント名] フィールドに、ユニークなイベント名を入力する。
チャネル全体および RDBMS イベント ジェネレータ全体でユニークなイベント名を識別する。
必須
[ポーリング間隔] を日、時間、分、または秒で指定する。
データベースをポーリングする頻度を指定する。[日] フィールドに日数を入力し (間隔が 1 日より長い場合)、[時間]、[分]、[秒] のドロップダウン リストから時間数、分数、または秒数を選択する。
必須
[データソースの JNDI 名] ドロップダウン リストから、JNDI 名を選択する。
データベースに使用するデータ ソース接続の JNDI 名を識別する。イベント ジェネレータを実行中の WebLogic Server でコンフィグレーションされたデータ ソースに基づいてリストの内容が表示される。
データ ソースのコンフィグレーションの詳細については、「RDBMS Event Generator User Guide (英語版)」を参照。
必須
[ポーリングあたりの最大行数] フィールドで、ポーリング サイクルごとに各スレッドによって取得されるレコードの数を指定する。
ポーリング サイクルごとに各スレッドによって取得されるレコードの数を指定する。この数字は、1 より大きく 10,000 より小さい有効な整数でなければならない。

注意 : デフォルト値は 1。この値は、要件に応じて変更する必要がある。

必須
[イベントあたりの最大行数] フィールドに、1 つのイベントのペイロードの一部となるレコードの数を入力する。
たとえば、該当するレコードが 10 個あり、[イベントあたりの最大行数] が 3 である場合、3 つのイベントで 3 つずつレコードが通知され、1 つのイベントで残りのレコードが通知される。該当するレコードが 2 つあり、[イベントあたりの最大行数] が 3 である場合、1 つのイベントで 2 つのレコードが通知される。
必須
[イベント タイプ]
[トリガ] または [クエリ/Post クエリ] から、必要なイベント タイプを選択する。
[トリガ] イベントは、データベース テーブルで発生する Insert、Update、または Delete イベントを通知する。
[クエリ/Post クエリ] は、データベース テーブルに対して指定された Select クエリに基づき、該当するレコードを通知し、送信された各イベントに対して Post クエリで指定された SQL を実行する。
必須
[代替ユーザでパブリッシュ] ドロップダウン リストから、ユーザ名を選択する。
[代替ユーザでパブリッシュ] プロパティを使用すると、イベント ジェネレータは特定のユーザとしてメッセージをパブリッシュできるようになる。このプロパティに値を設定すると、メッセージはセキュリティ保護されたメッセージ ブローカ チャネルに配信される。
[代替ユーザでパブリッシュ] の指定を省略した場合、メッセージは Anonymous としてパブリッシュされる。
省略可能
トリガ イベントの場合
   
[トリガ] ドロップダウン リストから、Insert、Delete、または Update を選択する。
Insert、Update、または Delete イベントがデータベース テーブルで発生したことを、トリガ メカニズムを使用して指定する。

注意 : トリガ タイプのイベントを作成する場合、データ ソースに対して入力するログイン ID とパスワードには、テーブル、トリガ、およびシーケンス (Oracle のシーケンスのみ) の CREATE/DROP パーミッションが必要。

必須 (デフォルトは Insert)
[テーブル名] フィールドで、トリガ イベントが定義されるデータベース テーブル名を入力する。
データベース テーブルの名前を入力する。以下のデータベースに対応した構文を使用する。
Oracle : SCHEMA.TABLENAME
DB2 UDB : SCHEMA.TABLENAME
Informix Dynamic Server : Catalog.Schema.Table
SQL Server : Catalog.Schema.Table
Sybase Adaptive : Catalog.Schema.Table
注意 : [テーブル名] のリンクをクリックすると、スキーマとテーブル名が表示される。必要なテーブル名の横にあるラジオ ボタンをチェックし、[送信] をクリックしてテーブルを選択する。
必須
[パブリッシュするテーブル カラムの選択]
このリンクをクリックすると、[テーブル名] フィールドに入力したデータベース テーブルのカラムが表示される。目的のカラムの横にあるチェック ボックスをチェックして、必要なカラムを選択する。[カラムの選択] をクリックして、チェックしたカラムを選択する。
イベントが発生すると、行の選択したカラムのみがパブリッシュされる。たとえば、4 つのカラムのうち 2 つを Update イベントの対象として選択した場合、イベントはこれら 2 つのカラムについてのみ更新をリスンするのではない。両者に結び付きはない。トリガ タイプのイベントをコンフィグレーションすると、そのイベントは行全体を対象とするイベントになる。1 つのカラムだけが選択され、それが更新されたカラムではない場合にも、イベントは発生する。Delete および Insert のトリガ イベントでは、挿入または削除された行から、選択したカラムがパブリッシュされる。
Update イベントを選択すると、選択したすべてのカラムがパブリッシュされ、類似したカラムにはプレフィックスとして「OLD_」が付けられる。「OLD_」カラムには、更新が発生する前のカラム値が格納される。
カラムが選択されていない場合、テーブル内のすべてのカラムがパブリッシュされる。
省略可能
[スレッド数] フィールドに、処理するスレッドの数を入力する。
イベント ジェネレータの処理スレッドの数を指定する。入力した数字が 1 より大きい場合、イベントはデータベース内での順序と同じ順序では配信されない。どの同時実行システムでもそうであるように、スレッドの数が大きいほど同時実行性が向上し、スループットが高くなる代わりに順序は保証されない。
上で指定した最大行数と最大イベント数は、処理スレッドの数に関係する。ポーリングあたりの最大行数は、イベントあたりの最大行数に最大スレッド数を乗算した数字に等しい。
必須
[クエリ/Post クエリ] イベント タイプの場合
最初のテキスト領域に、SQL クエリを指定する。
この SQL クエリが実行され、該当するレコードを返す。クエリは Select クエリとする必要がある。クエリが正しいかどうかは検証されない。
例 : SELECT FIRST_NAME, LAST_NAME, EMPLOYEE_ID FROM RDBMS_USER.EMP_TBL WHERE STATUS = 'Intern'
必須
[Post クエリ] テキスト領域に Post クエリを指定する。
上の SQL クエリで返された各行に対して実行される Post クエリを指定する。実行時の値を指定するためにカラムの正確な名前と @ プリフィックスを入力する必要がある。Post クエリが正しいかどうかは検証されない。
例 : DELETE FROM RDBMS_USER.EMP_TBL WHERE FIRST_NAME = @FIRST_NAME
SELECT *" は、Post クエリがクエリのカラムを参照している場合には、実行できない。選択したカラムは個々にリストされている必要がある。すべての SQL 文では完全修飾のテーブル名を使用すること。
[Post クエリ] は、[SQL クエリ] フィールドに指定したクエリが ResultSet を返し、その結果セットに 1 行以上の行が含まれている場合に限って実行される。
[Post クエリ] フィールドを空白のままにして、[SQL クエリ] フィールドに SELECT クエリを入力すると、選択された行は、パブリッシュされた後に削除される。[Post クエリ] フィールドに [no-op] (「No Operation」を意味する) が指定されている場合、選択された行は自動的に削除されることはない。Post クエリを指定しない場合、選択された行が自動的に削除されないようにするには、[Post クエリ] フィールドに no-op を入力する必要がある。また、automatic-delete は、SELECT クエリが 1 つのテーブルを参照している場合にのみ、機能する (SELECT DEPT. NAME, EMP.ADDRESS FROM DEPT., EMP WHERE DEPT.NAME = EMP NAME は複数のテーブルを参照)。automatic-delete は DB2 および Informix では機能しない。
省略可能

関連トピック

イベント ジェネレータのリスト表示および検索

[すべてのイベント ジェネレータを表示する] ページでは、コンフィグレーションされた各イベント ジェネレータについて、以下の情報が表示されます。

図 5-12 [すべてのファイル EG を表示] ページ

[すべてのファイル EG を表示] ページ

  1. ホーム ページで、[イベント ジェネレータ] モジュールを選択します。
  2. 左側のパネルから、イベント ジェネレータのタイプ ([ファイル]、[電子メール]、[JMS]、または [タイマー]) を選択します。
  3. 特定のイベント ジェネレータを検索するには、以下のいずれかを実行します。
    • ジェネレータ名でフィルタ処理する。検索対象を入力して (? は任意の 1 文字、* は 0 個以上の文字を指定するときに使用する)、[検索] をクリックします。検索条件に一致するジェネレータが表示されます。
    • リストを再度ソートする。ソートできるカラムには、昇順 [すべてのファイル EG を表示] ページ および降順 [すべてのファイル EG を表示] ページ の矢印ボタンが付いています。ソート順を変更するには、このボタンをクリックします。
    • ページをスクロールする。左下隅のコントロールを使用します。ページ番号を選択して任意のページに移動するか、矢印ボタンを使用して、次 [すべてのファイル EG を表示] ページ、前 [すべてのファイル EG を表示] ページ、最初 [すべてのファイル EG を表示] ページ、または最後 [すべてのファイル EG を表示] ページ を使用します。
  4. ホーム ページで、[イベント ジェネレータ] モジュールを選択します。
  5. 左側のパネルでイベント ジェネレータのタイプ ([HTTP]、[MQ Series]、または [RDBMS]) を選択します。
  6. 特定のイベント ジェネレータを検索するには、以下のいずれかを実行します。
    • ジェネレータ名でフィルタ処理する。検索対象を入力して (? は任意の 1 文字、* は 0 個以上の文字を指定するときに使用する)、[検索] をクリックします。検索条件に一致するジェネレータが表示されます。

関連トピック

イベント ジェネレータのチャネル ルールの表示および更新

[イベント ジェネレータ定義] のページでは、チャネル ルールの表示および更新ができます。JMS イベント ジェネレータの場合は、デフォルトのルール チャネルを更新することもできます。

  1. イベント ジェネレータを検索します。「イベント ジェネレータのリスト表示および検索」を参照してください。
  2. イベント ジェネレータ名をクリックして、[イベント ジェネレータ定義] のページを表示します。
  3. [ジェネレータの詳細を編集] をクリックします。
  4. [JMS イベント ジェネレータの詳細] ページが表示されます。

    図 5-13 JMS EG の詳細


    JMS EG の詳細

  5. [デフォルト ルール チャネル] ドロップダウン リストから、新しいチャネルを選択します。
  6. [送信] をクリックして更新します。
  7. イベント ジェネレータを検索します。「イベント ジェネレータのリスト表示および検索」を参照してください。
  8. イベント ジェネレータ名をクリックして、[イベント ジェネレータ定義] のページを表示します。
  9. 次のいずれかの操作を実行して、[ジェネレータ チャネル ルール定義] のページを表示します。
    • チャネル ルールを追加する場合は、[新しいチャネル ルールを定義] をクリックする。
    • 既存のルールを更新する場合は、ジェネレータ タイプに該当する値 (次のリストを参照) をクリックし、[チャネル ルールを編集] をクリックする。
    • タイマー - 有効時間
      ファイル - チャネル ディレクトリ
      電子メール - ホスト名
      JMS - プロパティ名
      MQ - ポーリング間隔
      HTTP - チャネル名

      注意 : RDBMS イベント ジェネレータのチャネル ルールは更新できません。チャネルを削除して新しいチャネルを作成する必要があります。
  10. 必要なプロパティを設定します。利用できるプロパティの詳細については、作成中のイベント ジェネレータに適したトピックを参照してください。
  11. ファイル イベント ジェネレータのチャネル ルールの定義

    電子メール イベント ジェネレータのチャネル ルールの定義

    JMS イベント ジェネレータのチャネル ルールの定義

    タイマー イベント ジェネレータのチャネル ルールの定義

    MQ イベント ジェネレータのチャネル ルールの定義

    HTTP イベント ジェネレータのチャネル ルールの定義

  12. [送信] をクリックして、チャネル ルールを追加または更新します。
  13. 削除するチャネル ルールの左側にあるチェック ボックスをチェックします。
  14. [削除] をクリックします。
  15. 確認のダイアログ ボックスが表示されます。

  16. [OK] をクリックして確認します。
  17. 選択したチャネル ルールが削除されます。

注意 : この操作ができないイベント ジェネレータのタイプもあります。

上向き矢印または下向き矢印 JMS EG の詳細 ボタンをクリックして、リスト内のエントリを上または下に移動します。リスト内の順序の変更は、すぐに有効になります。

イベント ジェネレータのサスペンドおよび再開

[すべてのイベント ジェネレータを表示する] ページから、イベント ジェネレータをサスペンドまたは再開できます。ジェネレータをサスペンドすると、イベント ジェネレータはアンデプロイされます。ジェネレータを再開すると、ジェネレータはデプロイされます。

注意 : 読み込まれたメッセージまたはエラーの数は、メモリ内にのみ格納されます。ディスクまたは他の永続ストアには格納されません。そのため、イベント ジェネレータをサスペンドおよび再開すると、読まれたメッセージ数およびエラー数は 0 にリセットされます。
注意 : すでに実行中のジェネレータを再開、またはすでにサスペンド中のジェネレータをサスペンドしようとすると、その命令は無視されます。
注意 : サーバを再起動する前にイベント ジェネレータがサスペンドされていた場合、再起動時にイベント ジェネレータは自動的に実行モードに切り替わります。これはすべてのイベント ジェネレータに共通の動作です。
  1. サスペンドするイベント ジェネレータを検索します。「イベント ジェネレータのリスト表示および検索」を参照してください。
  2. 選択するイベント ジェネレータの左側にあるチェック ボックスをチェックします。
  3. [サスペンド] をクリックします。
  4. 選択したジェネレータがサスペンドされます。

    注意 : すべてのイベント ジェネレータにおいて、イベント ジェネレータをサスペンドすると数が 0 にリセットされます。RDBMS イベント ジェネレータをサスペンドした場合は、イベント ジェネレータが 0 にリセットされるとともに、メッセージが [最後にリセットした時間] に変わります。
  5. 再開するイベント ジェネレータを検索します。「イベント ジェネレータのリスト表示および検索」を参照してください。
  6. 選択するイベント ジェネレータの左側にあるチェック ボックスをチェックします。
  7. [再開] をクリックします。
  8. 選択したジェネレータが再開されます。

数のリセット

[すべてのイベント ジェネレータを表示する] ページでは、読まれた数およびエラーの数をリセットできます。

  1. リセットするイベント ジェネレータを検索します。「イベント ジェネレータのリスト表示および検索」を参照してください。
  2. 選択するイベント ジェネレータの左側にあるチェック ボックスをチェックします。
  3. 以下のいずれかを実行します。
    • [すべてのファイル イベント ジェネレータを表示] ページで、[ファイル数のリセット] をクリックする。
    • [すべての電子メール イベント ジェネレータを表示] ページで、[電子メール数のリセット] をクリックする。
    • [すべての EGType イベント ジェネレータを表示] ページ (EGType は JMS、タイマー、MQ Series、HTTP、または RDBMS) で、[メッセージ数をリセット] をクリックする。
  4. リセットするイベント ジェネレータを検索します。「イベント ジェネレータのリスト表示および検索」を参照してください。
  5. 選択するイベント ジェネレータの左側にあるチェック ボックスをチェックします。
  6. [エラー数をリセット] をクリックします。

チャネル ルールの削除

[イベント ジェネレータ定義] のページから、チャネル ルールを削除できます。

  1. イベント ジェネレータを検索します。「イベント ジェネレータのリスト表示および検索」を参照してください。
  2. イベント ジェネレータ名をクリックして、[イベント ジェネレータ定義] のページを表示します。
  3. 削除するチャネル ルールの左側にあるチェック ボックスをチェックします。
  4. [削除] をクリックします。
  5. 選択したチャネル ルールが削除されます。

    注意 : 対象のイベントがコンフィグレーションされたユーザ テーブルにトランザクションが行を挿入しているときは、RDBMS イベント ジェネレータのチャネル ルールを削除することはできません。トランザクションが完了するまで待ってから、チャネル ルールを削除する必要があります。

イベント ジェネレータの削除

[すべてのイベント ジェネレータを表示する] ページから、イベント ジェネレータを削除できます。

  1. 削除するイベント ジェネレータを検索します。「イベント ジェネレータのリスト表示および検索」を参照してください。
  2. 削除するイベント ジェネレータの左側にあるチェック ボックスをチェックします。
  3. [削除] をクリックします。
  4. 選択したジェネレータが削除されます。

TibcoRV イベント ジェネレータの概要

TIBCO Rendezvous (TIBCORV) イベント ジェネレータは、WebLogic Integration Administration Console で作成できる WebLogic IntegrationTM イベント ジェネレータの 1 つです。TIBCORV イベント ジェネレータは特定のサブジェクトに関するメッセージをリスンし、目的のメッセージを受信したときにメッセージ ブローカに対してイベントを生成します。図 5-14 は、[TibcoRV イベント ジェネレータ] ページを示しています。

TibcoRV イベント ジェネレータおよび WebLogic Integration の最新情報については、http://edocs.beasys.co.jp/e-docs/wli/docs92/index.html を参照してください。

図 5-14 Tibco イベント ジェネレータ

Tibco イベント ジェネレータ


  ページの先頭       前  次