イベントの登録

イベントが生成される Exchange フォルダーごとに、イベント登録ファイルを作成する必要があります。イベント登録は、Event Listener にバインドされた隠しファイルに格納されます。Microsoft インフォメーション・ストア・サービスは、始動時にイベント登録ファイルを検索し、モニター対象フォルダーのリストに、指定されたフォルダーを追加します。

単一のフォルダー用のイベント登録 (浅い登録)、親フォルダーとそのすべてのサブフォルダー用のイベント登録 (深い登録)、または組織内のすべてのフォルダー用のイベント登録 (ストア全体の登録) を作成することができます。

イベント登録は、Exchange Explorer の GUI を用いて容易に作成することができます。RegEvent.vbs ユーティリティーを使用して作成することもできます。以下のセクションでは、これらのツールを用いたイベント登録の作成方法を説明します。

Exchange Explorer によるイベント登録の作成

Exchange Explorer は、イベント登録作成用の GUI です。このツールは Microsoft の Web サイトからダウンロードすることができます。

ヒント

Microsoft のダウンロード・ページ (www.microsoft.com/downloads) で以下の検索基準を指定することにより、Exchange Explorer を探し出すことができます。

「スタート」-->「プログラム」-->「Exchange SDK」-->「Exchange SDK Development Tools」-->「Exchange Explorer」をクリックして、Exchange Explorer を始動します。「認証 (Authorization)」ダイアログ・ボックスで、ログオンのプロンプトが出されたら、以下の値を入力します。

浅いイベント登録の作成

フォルダーに対して浅いイベント登録を作成するには以下のステップを実行します。

  1. Exchange Explorer を始動し、ログオンします。
  2. 「Exchange ストア階層 (Exchange Store Hierarchy)」ペインで、登録するフォルダーを選択します。
  3. 「ファイル」-->「イベント登録を追加 (Add Event Registration)」をクリックします。Exchange ストア・イベント・シンク登録ウィザードが開き、イベント登録の名前を選択するプロンプトが表示されます。
  4. 「このイベント シンク登録の名前を入力 (Enter a name for this event sink registration)」フィールドに使用する名前を入力し、「次へ」をクリックします。
  5. 登録したいイベントの種類を指定するように求められます。「同期」をクリックし、「次へ」をクリックします。
  6. 登録したい同期イベントの種類を指定するように求められます。OnSyncSave および OnSyncDelete の両方をクリックし、「次へ」をクリックします。
  7. イベント登録の範囲を指定するように求められます。「浅い (Shallow)」をクリックし、「次へ」をクリックします。
  8. 登録を行うイベント・シンクの種類を指定するように求められます。「COM イベント シンク (COM Event Sink)」をクリックし、「次へ」をクリックします。
  9. イベント・シンク・クラスを指定するように求められます。「イベント シンク クラスの ProgID (What is the ProgID of your event sink class?)」フィールドで、BIA_Exchange.Events.1 と入力し、「次へ」をクリックします。
  10. これまでに選択した項目を確認するように求めるプロンプトが出されます。イベント登録に問題がなければ、「完了」をクリックしてウィザードを終了します。

これでイベント登録が作成されます。登録されたフォルダー内で項目が作成、更新、または削除されるたびに、Event Listener へイベントが送信されます。

注:
登録項目作成時にエラーが発生した場合は、トラブルシューティングとエラー処理を参照してください。

深いイベント登録の作成

深いイベント登録 (親フォルダーとそのすべてのサブフォルダーが登録されます) を作成するには以下のステップを実行します。

  1. Exchange Explorer を始動し、ログオンします。
  2. 「Exchange ストア階層 (Exchange Store Hierarchy)」ペインで、登録するフォルダーを選択します。
  3. 「ファイル」-->「イベント登録を追加 (Add Event Registration)」をクリックします。Exchange ストア・イベント・シンク登録ウィザードが開き、イベント登録の名前を選択するプロンプトが表示されます。
  4. 「このイベント シンク登録の名前を入力 (Enter a name for this event sink registration)」フィールドに使用する名前を入力し、「次へ」をクリックします。
  5. 登録したいイベントの種類を指定するように求められます。「同期」をクリックし、「次へ」をクリックします。
  6. 登録したい同期イベントの種類を指定するように求められます。OnSyncSave および OnSyncDelete の両方をクリックし、「次へ」をクリックします。
  7. イベント登録の範囲を指定するように求められます。「深い (Deep)」をクリックし、「次へ」をクリックします。
  8. 登録を行うイベント・シンクの種類を指定するように求められます。「COM イベント シンク (COM Event Sink)」をクリックし、「次へ」をクリックします。
  9. イベント・シンク・クラスを指定するように求められます。「イベント シンク クラスの ProgID (What is the ProgID of your event sink class?)」フィールドで、BIA_Exchange.Events.1 と入力し、「次へ」をクリックします。
  10. これまでに選択した項目を確認するように求めるプロンプトが出されます。イベント登録に問題がなければ、「完了」をクリックしてウィザードを終了します。

これでイベント登録が作成されます。登録されたフォルダーまたはそのサブフォルダー内で項目が作成、更新、または削除されるたびに、Event Listener へイベントが送信されます。

注:
登録項目作成時にエラーが発生した場合は、トラブルシューティングとエラー処理を参照してください。

ストア全体のイベント登録の作成

プライベート・メールボックス・ストア向けのストア全体の (グローバルな) イベント登録を行うことができるのは、次のフォルダーのみです。ここで、domain はご使用の E メール・ドメインを指し、GUID は SystemMailbox のグローバルな一意の ID を指します。file://./backofficestorage/domain/mbx/SystemMailbox{GUID} /StoreEvents/GlobalEvents

さらに、ストア全体のイベント登録を作成するには、適切なアクセス許可が必要です。グローバル・イベントを登録できるのは、Administrator グループまたは Domain Administrators グループのメンバー、あるいは Exchange Administrators 役割のユーザーのみです。

適切なストア全体のイベント登録を作成するには、浅いイベント登録の作成または 深いイベント登録の作成で説明されているステップを実行してください。

RegEvent.vbs によるイベント登録の作成

RegEvent.vbs ユーティリティーによって、浅いイベント登録、深いイベント登録、およびストア全体のイベント登録を作成することができます。RegEvent.vbs ユーティリティーを用いて浅いイベント登録と深いイベント登録を作成する方法の詳細については、Microsoft Developer Network (MSDN) Library および Knowledge Base (www.msdn.microsoft.com) を参照し、キーワード RegEvent を検索してください。

RegEvent.vbs によるストア全体のイベント登録の作成

プライベート・メールボックス・ストア向けのストア全体の (グローバルな) イベント登録を行うことができるのは、次のフォルダーのみです。ここで、domain はご使用の E メール・ドメインを指し、GUID は SystemMailbox のグローバルな一意の ID を指します。file://./backofficestorage/domain/mbx/SystemMailbox{GUID} /StoreEvents/GlobalEvents

さらに、ストア全体のイベント登録を作成するには、適切なアクセス許可が必要です。グローバル・イベントを登録できるのは、Administrator グループまたは Domain Administrators グループのメンバー、あるいは Exchange Administrators 役割のユーザーのみです。

次のコマンドを入力して、ストア全体のイベント登録を作成します。

cscript RegEvent.vbs Add "OnSyncSave;OnSyncDelete" ¥
 BIA_Exchange.Events.1 "file://./backofficestorage/domain/mbx ¥
 /SystemMailbox{GUID}StoreEvents/GlobalEvents/globalSynchReg.eml" ¥ 
 -m ANY

Copyright IBM Corp. 2004, 2005