IBM Enterprise Records 5.1.2 版    

事件處理程式

IBM® Enterprise Records 提供下列 Base、DoD 和 PRO 資料模型的範例事件。

您可以依需要來自訂範例。請參閱軟體套件的「事件」資料夾中的 Readme 檔。

表 1. 事件和說明
事件 說明
RMAutoDeclare

配置自動宣告記錄。 當使用者對「記錄物件儲存庫 (ROS)」中的文件執行特定作業(例如移入或存檔至資料夾)時,IBM Enterprise Records 會在特定的檔案計劃物件儲存庫 (FPOS) 中自動建立對應的電子記錄。您也可以配置這個範例事件來宣告,在使用者移入文件時,每一份屬於特定文件類別的文件。

這個範例事件只支援未分類的電子記錄宣告。 這個事件必須配置成使用非同步事件,而「不是」同步事件。

RMAutoSynchronizeProperties

將記錄及其相關文件的內容同步化。例如,當使用者更新記錄的內容值時,IBM Enterprise Records 也會更新相關文件中的對應內容值。

這個範例事件適用於使用相同符號名稱的內容。 您可以從文件到記錄或從記錄到文件進行同步化,但不能兩者同時進行。如果是從記錄到文件進行同步化,當更新記錄的對應內容時,IBM Enterprise Records 會更新文件。

這個事件也可從記錄到文件或從文件到記錄,來進行物件儲存庫之間內容別名的同步化,但不能兩者同時進行。

RMUpdateDateDeclared

RMLastRetrievalOfRecord

這些範例事件共同決定儲存器的處置時間。這些範例事件也可確保處置排程不會處置最近已宣告或擷取記錄的儲存器。

當使用者宣告記錄時,IBM Enterprise Records 將這個範例事件套用於「磁區」或「方框」類別,以及在上層資料夾設定「前次宣告日期」。

對於 PRO 資料模型,IBM Enterprise Records 會自動訂閱「磁區」或「方框」類別的 RMUpdateDateDeclared 事件,且您必須啟用該事件。對於其他資料模型,您必須執行匯入 Script 來建立 RMUpdateDateDeclared 事件,並訂閱「磁區」或「產品盒」類別。

RMLastRetrievalOfRecord 會將記錄內容前次審查日期設為資料夾的 LastRetrievalofRecord 內容。

RMSecurityPropagation

(只限 PRO)這個範例事件只用於 PRO 資料模型,它會根據相關實體的最高層級,設定記錄、磁區和記錄資料夾(而不是記錄種類)的「安全種類」內容標記值。

比方說,當從記錄傳播到資料夾時,如果記錄的安全性高於其上層資料夾,IBM Enterprise Records 會更新上層資料夾的安全性。 記錄存檔所在的其他資料夾不受影響。

當從資料夾傳播到記錄時,IBM Enterprise Records 會將安全層次較低之記錄的安全性,更新為其上層資料夾的最高安全層次。

「系統配置」中的 PRO FPOS 設定可控制安全的傳播方式。此傳播可從資料夾到記錄及/或從記錄到資料夾,或不允許傳播。

RMSendEmailOnSupercede

這個範例事件會導致每次記錄由新版本取代時送出電子郵件。電子郵件訊息會包含取代記錄的說明,以及取代的日期和時間之詳細資料。 當儲存器有根據取代事件定義觸發程式的處置排程時,便會送出電子郵件。

限制: JBoss 或 WebLogic 不支援此事件。

在目標物件儲存庫中,IBM Enterprise Records 範例事件處理程式 JAR 檔會儲存為程式碼模組。優點是您可以移入新版本來新增或更新事件處理程式,而不需要重新啟動應用程式伺服器。 配置 IBM Enterprise Records 範例事件的方式如下:

建立事件動作

開始這項程序之前,請確定您將要建立事件動作的物件儲存庫之根資料夾下,存在名為 CodeModules 的資料夾。如果這個資料夾不存在,請遵循 IBM FileNet® P8 Platform Installation and Upgrade Guide 中的指示來建立該資料夾。

如果要建立事件動作,請執行下列動作:
  1. 將 CD 根目錄下的資料夾 ~CDRoot\RecordsManager.<platform>\Events,複製到執行 IBM Administration Console for Content Platform Engine 的伺服器。 這個資料夾包含匯入 Script、JAR 檔以及配置檔。
  2. 執行適當的匯入 Script 來建立要使用的事件動作。
    1. 用滑鼠右鍵按一下目標 IBM Enterprise Records 物件儲存庫。
    2. 選取全部匯入
    3. 在「匯入說明程式」對話框、「匯入選項」標籤、「匯入資訊清單檔」欄位中,瀏覽至所複製的資料夾。選取所需事件的匯入 Script。每一個檔案會以事件來命名。 例如,RMAutoDeclare 事件的匯入檔會命名為 RMAutoDeclareImport.xml
    4. 在「外部內容路徑」欄位中,瀏覽至 ~\Events\lib 資料夾。
    5. 按一下匯入

    匯入完成之後,您會看到「匯入成功」訊息。在物件儲存庫的「事件動作」資料夾下會建立事件動作。 在「程式碼模組」資料夾下會建立程式碼模組。

自訂配置檔

RMAutoDeclare 和 RMSendEmailOnSupercede 事件都有自己的配置檔。 匯入 Script 會在物件儲存庫中建立下列檔案:

WorkplaceWorkplace XTIBM Administration Console for Content Platform Engine 中移出配置檔。 進行編輯之後,再將它移入。如需相關資訊,請參閱「配置記錄的自動宣告」主題。如果是 RMSendEmailOnSupercede 檔,您所修改那一行前面的註解很容易了解:SMTP 主機、埠號、寄件者和收件者電子郵件位址。

建立訂閱

每一個事件需要訂閱一個以上的類別。

訂閱 RMAutoDeclare 事件

如果要建立訂閱,請執行下列動作:
  1. IBM Administration Console for Content Platform Engine 中,移至您想要建立訂閱的 Object Stores/ROS/Document class 或子類別。
  2. 用滑鼠右鍵按一下該類別,然後選取新增訂閱
  3. 為訂閱指定唯一名稱和說明。
  4. 選取套用到所有實例圓鈕。
  5. 在「指定觸發程式」畫面中,選取「移入」事件觸發程式。
  6. 在「指定事件動作」畫面中,選取所匯入的事件動作。
  7. 在「指定其他內容」畫面中,清除同步勾選框,針對每一個事件來適當勾選或清除包括子類別勾選框,然後完成精靈。
如果要訂閱「資料夾」類別或子類別,請執行下列動作:
  1. IBM Administration Console for Content Platform Engine 中,移至您想要建立訂閱的 Object Stores/ROS/Folder class 或子類別。
  2. 用滑鼠右鍵按一下該類別,然後選取新增訂閱
  3. 為訂閱指定唯一名稱和說明。
  4. 選取套用到所有實例圓鈕。
  5. 在「指定觸發程式」畫面中,選取「存檔」事件觸發程式。
  6. 清除同步勾選框,適當勾選或清除包括子類別勾選框,然後完成精靈。
如果要訂閱 ROS 中的特定資料夾,請執行下列動作:
  1. IBM Administration Console for Content Platform Engine 中,移至要在其中建立訂閱的資料夾。
  2. 用滑鼠右鍵按一下該資料夾,然後選取新建訂閱
  3. 為訂閱指定唯一名稱和說明。
  4. 接受預設值。
  5. 選取「存檔」事件觸發程式。
  6. 在「指定事件動作」畫面中,選取 RMAutoDeclare 事件。
  7. 在「指定其他內容」畫面中,清除同步勾選框,接受其餘的預設值,然後完成精靈。

訂閱 RMAutoSynchronizeProperties 事件

訂閱 RMAutoSynchronizeProperties 事件,會從來源文件到其記錄,或從記錄到其來源文件進行內容同步化。

請勿嘗試進行雙向同步化。 這個事件必須配置成使用同步事件。

如果要從來源文件到其記錄進行同步化,請執行下列動作:
  1. IBM Administration Console for Content Platform Engine 中,移至 Object Stores/ROS/Document class 或子類別。
  2. 按一下滑鼠右鍵選取新增訂閱
  3. 為訂閱指定唯一名稱和說明。
  4. 選取套用到所有實例圓鈕。
  5. 在「指定觸發程式」畫面中,選取「更新」事件觸發程式。
  6. 選取所匯入的事件動作。
  7. 在「指定其他內容」畫面中,選取同步勾選框,但清除包括子類別勾選框,然後完成精靈。
如果要從記錄同步化到其來源文件,請執行下列動作:
  1. IBM Administration Console for Content Platform Engine 中,移至 Object Stores/ROS/Document class 或子類別。
  2. 按一下滑鼠右鍵選取新增訂閱
  3. 為訂閱指定唯一名稱和說明。
  4. 選取套用到所有實例圓鈕。
  5. 在「指定觸發程式」畫面中,選取「更新」事件觸發程式。
  6. 選取所匯入的事件動作。
  7. 在「指定其他內容」畫面中,選取同步勾選框,但清除包括子類別勾選框,然後完成精靈。

訂閱 RMLastRetrievalOfRecord 事件

如果要訂閱 RMLastRetrievalOfRecord 事件,請執行下列動作:
  1. IBM Administration Console for Content Platform Engine 中,移至 Object Stores/FPOS/Other Classes/CustomObject/RM System class
  2. 按一下滑鼠右鍵選取新增訂閱
  3. 為訂閱指定唯一名稱和說明。
  4. 選取套用到所有實例圓鈕。
  5. 在「指定觸發程式」畫面中,選取「建立」事件觸發程式。
  6. 選取所匯入的事件動作。
  7. 在「指定其他內容」畫面中,清除包括子類別勾選框,選取同步勾選框,然後完成精靈。

訂閱 RMSecurityPropagation 事件(僅適用於 PRO)

您可以針對「記錄資料夾」類別、「磁區」類別或「記錄」類別,建立此事件訂閱。

如果要訂閱「記錄資料夾」類別的事件,請執行下列動作:
  1. IBM Administration Console for Content Platform Engine 中,移至 Object Stores/PRO-FPOS/Other Classes/Folder/RM Folder/Record Folder class
  2. 按一下滑鼠右鍵選取新增訂閱
  3. 為訂閱指定唯一名稱和說明。
  4. 選取套用到所有實例圓鈕。
  5. 在「指定觸發程式」畫面中,選取「存檔」和「更新」事件觸發程式。
  6. 選取所匯入的事件動作。
  7. 在「指定其他內容」畫面中,清除包括子類別勾選框,然後完成精靈。
如果要針對「磁區」類別訂閱事件,請執行下列動作:
  1. IBM Administration Console for Content Platform Engine 中,移至 Object Stores/PRO FPOS/Other Classes/Folder/RM Folder/Volume class
  2. 按一下滑鼠右鍵選取新增訂閱
  3. 為訂閱指定唯一名稱和說明。
  4. 選取套用到所有實例圓鈕。
  5. 在「指定觸發程式」畫面中,選取「存檔」和「更新」事件觸發程式。
  6. 選取所匯入的事件動作。
  7. 在「指定其他內容」畫面中,清除包括子類別勾選框,然後完成精靈。
如果要針對「記錄」類別訂閱事件,請執行下列動作:
  1. IBM Administration Console for Content Platform Engine 中,移至 Object Stores/PRO-FPOS/Document Class/Record class
  2. 按一下滑鼠右鍵選取新增訂閱
  3. 為訂閱指定唯一名稱和說明。
  4. 選取套用到所有實例圓鈕。
  5. 在「指定觸發程式」畫面中,選取「更新」事件觸發程式。
  6. 選取所匯入的事件動作。
  7. 在「指定其他內容」畫面中,選取包括子類別勾選框,然後完成精靈。

訂閱 RMSendEmailOnSupercede 事件

如果要訂閱 RMSendEmailOnSupercede 事件,請執行下列動作:
  1. IBM Administration Console for Content Platform Engine 中,移至 Object Stores/FPOS/Document Class/Record class
  2. 按一下滑鼠右鍵選取新增訂閱
  3. 為訂閱指定唯一名稱和說明。
  4. 選取套用到所有實例圓鈕。
  5. 在「指定觸發程式」畫面中,選取「更新」和「移入」事件觸發程式。
  6. 選取所匯入的事件動作。
  7. 在「指定其他內容」畫面中,選取包括子類別勾選框,然後完成精靈。

訂閱 RMUpdateDateDeclared 事件

對於 PRO 資料模型,您需要啟用已存在的事件。如果要啟用現有事件,請執行下列動作:
  • IBM Administration Console for Content Platform Engine 中,移至 Object Stores/FPOS/Events/Event Action 資料夾。
  • 用滑鼠右鍵按一下 UpdateDateDeclared
  • 按一下啟用

如果是 DoD 和 Base 資料模型,請在建立事件之後訂閱「記錄種類」、「磁區」和「產品盒」類別。

如果訂閱「記錄種類」類別的事件,請執行下列動作:
  1. IBM Administration Console for Content Platform Engine 中,移至 Object Stores/<FPOS>/Other Classes/Folder/RM Folder/Record Category
  2. 按一下滑鼠右鍵選取新增訂閱
  3. 為訂閱指定唯一名稱和說明。
  4. 選取套用到所有實例圓鈕。
  5. 在「指定觸發程式」畫面中,選取「存檔」事件觸發程式。
  6. 選取所匯入的事件動作。
  7. 在「指定其他內容」畫面中,清除包括子類別勾選框,然後完成精靈。
如果要針對「磁區」類別訂閱事件,請執行下列動作:
  1. IBM Administration Console for Content Platform Engine 中,移至 Object Stores/FPOS/Other Classes/Folder/RM Folder/Volume
  2. 按一下滑鼠右鍵選取新增訂閱
  3. 為訂閱指定唯一名稱和說明。
  4. 選取套用到所有實例圓鈕。
  5. 在「指定觸發程式」畫面中,選取「存檔」事件觸發程式。
  6. 選取所匯入的事件動作。
  7. 在「指定其他內容」畫面中,清除包括子類別勾選框,然後完成精靈。
如果要訂閱「方框」類別的事件,請執行下列動作:
  1. IBM Administration Console for Content Platform Engine 中,移至 Object Stores/FPOS/Other Classes/Folder/RM Folder/Physical Container/Box
  2. 按一下滑鼠右鍵選取新增訂閱
  3. 為訂閱指定唯一名稱和說明。
  4. 選取套用到所有實例圓鈕。
  5. 在「指定觸發程式」畫面中,選取「存檔」事件觸發程式。
  6. 選取所匯入的事件動作。
  7. 在「指定其他內容」畫面中,清除包括子類別勾選框,然後完成精靈。

如需自訂事件的相關資訊,請參閱「FileNet P8 軟體套件」。



意見

前次更新: 2013 年 11 月
work_with_event_handlers.htm

© Copyright IBM Corp. 2013