IBM® Enterprise
Records 提供下列 Base、DoD 和 PRO 資料模型的範例事件。
您可以依需要來自訂範例。請參閱軟體套件的 Events 資料夾中的 Readme 檔。
表 1. 事件和說明事件 |
說明 |
RMAutoDeclare |
配置自動宣告記錄。
當使用者在「記錄物件儲存庫 (ROS)」中,對某份文件執行特定作業(如移入或存檔到資料夾中)時,IBM Enterprise
Records 會在特定的「檔案計劃物件儲存庫 (FPOS)」中,自動建立對應的電子記錄。
您也可以配置這個範例事件來宣告,在使用者移入文件時,每一份屬於特定文件類別的文件。
這個範例事件只支援未分類的電子記錄宣告。
這個事件必須配置成使用非同步事件,而不是同步事件。
|
RMAutoSynchronizeProperties |
將記錄及其相關文件的內容同步化。例如,當使用者更新記錄的內容值時,IBM Enterprise
Records 也會更新相關文件中的對應內容值。
這個範例事件適用於使用相同符號名稱的內容。
您可以從文件到記錄或從記錄到文件進行同步化,但不能兩者同時進行。如果是從記錄到文件進行同步化,當更新記錄的對應內容時,IBM Enterprise
Records 會更新文件。
這個事件也可從記錄到文件或從文件到記錄,來進行物件儲存庫之間內容別名的同步化,但不能兩者同時進行。
|
RMUpdateDateDeclared RMLastRetrievalOfRecord
|
這些範例事件共同決定儲存器的處置時間,或共同確保處置排程不會處置最近已宣告或擷取記錄的儲存器。
當使用者宣告記錄時,IBM Enterprise
Records 將這個範例事件套用於 Volume 和 Box 類別,以及在上層資料夾設定「前次宣告日期」。
如果是 PRO 資料模型,IBM Enterprise
Records 會自動訂閱 Volume 或 Box 類別的 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
中的指示來建立該資料夾。
- 將 CD 根目錄下的資料夾 ~CDRoot\RecordsManager.<platform>\Events 複製到執行 EM 的伺服器。這個資料夾包含匯入 Script、JAR 檔以及配置檔。
- 執行適當的匯入 Script 來建立要使用的事件動作。
- 用滑鼠右鍵按一下目標 IBM Enterprise
Records 物件儲存庫。
- 選取「全部匯入」。
- 在「匯入說明程式」對話框、「匯入選項」標籤、「匯入資訊清單檔」欄位中,瀏覽至所複製的資料夾,並選取所需事件的匯入 Script。每一個檔案會以事件來命名。
例如,RMAutoDeclare 事件的匯入檔會命名為 RMAutoDeclareImport.xml。
- 在「外部內容路徑」欄位中,瀏覽至 ~\Events\lib 資料夾。
- 按一下「匯入」。
匯入完成之後,您應該會看到「匯入成功」訊息。
在物件儲存庫的「事件動作」資料夾下應該會建立事件動作,且在「程式碼模組」資料夾中會建立程式碼模組。
自訂配置檔
RMAutoDeclare 和 RMSendEmailOnSupercede 事件都有自己的配置檔。
匯入 Script 會在物件儲存庫中建立下列檔案:
- RMAutoDeclare 配置檔是位於 Root Folder\RM Samples 資料夾下的 RMAutoDeclare.properties。
- RMSendEmailOnSupercede 配置檔是位於相同 Root Folder\RM Samples 資料夾下的 RMSendEmailOnSupercede.properties。
請從 Workplace 或 Workplace XT 或 Enterprise Manager 移出配置檔。
進行編輯之後,再將它移入。請參閱配置記錄的自動宣告。如果是 RMSendEmailOnSupercede 檔,您所修改那一行前面的註解很容易了解(SMTP 主機、埠號、寄件者和收件者電子郵件位址)。
訂閱 RMAutoDeclare 事件
- 在 Enterprise Manager 中,導覽至您想要建立訂閱的 Object Stores/ROS/Document class 或子類別。
- 用滑鼠右鍵按一下該類別,然後選取「新增訂閱」。
- 為訂閱指定唯一名稱和說明。
- 選取「套用到所有實例」圓鈕。
- 在「指定觸發程式」畫面中,選取「移入」事件觸發程式。
- 在「指定事件動作」畫面中,選取所匯入的事件動作。
- 在「指定其他內容」畫面中,建議清除「同步」勾選框,並針對每一個事件來適當勾選或清除「包括子類別」勾選框,然後完成精靈。
如果要訂閱「資料夾」類別或子類別,請執行下列動作:
- 在 Enterprise Manager 中,導覽至您想要建立訂閱的 Object Stores/ROS/Folder class 或子類別。
- 用滑鼠右鍵按一下該類別,然後選取「新增訂閱」。
- 為訂閱指定唯一名稱和說明。
- 選取「套用到所有實例」圓鈕。
- 在「指定觸發程式」畫面中,選取「存檔」事件觸發程式。
- 建議清除同步勾選框,並適當勾選或清除包括子類別勾選框,然後完成精靈。
如果要訂閱 ROS 中的特定資料夾,請執行下列動作:
- 在 Enterprise Manager 中,導覽至想要建立訂閱的資料夾。
- 用滑鼠右鍵按一下該資料夾,然後選取「新建訂閱」。
- 為訂閱指定唯一名稱和說明。
- 接受預設值。
- 選取「存檔」事件觸發程式。
- 在「指定事件動作」畫面中,選取 RMAutoDeclare 事件。
- 在「指定其他內容」畫面中,建議清除同步勾選框,並接受其餘的預設值,然後完成精靈。
訂閱 RMAutoSynchronizeProperties 事件
訂閱 RMAutoSynchronizeProperties 事件,會從來源文件到其記錄,或從記錄到其來源文件進行內容同步化。
請勿嘗試進行雙向同步化。
這個事件必須配置成使用同步事件。
如果要從來源文件到其記錄進行同步化,請執行下列動作:
- 在 Enterprise Manager 中,導覽至 Object Stores/ROS/Document class 或子類別。
- 按一下滑鼠右鍵選取「新增訂閱」。
- 為訂閱指定唯一名稱和說明。
- 選取「套用到所有實例」圓鈕。
- 在「指定觸發程式」畫面中,選取「更新」事件觸發程式。
- 選取所匯入的事件動作。
- 在「指定其他內容」畫面中,選取同步勾選框,但清除包括子類別勾選框,然後完成精靈。
如果要從記錄到其來源文件進行同步化,請執行下列動作:
- 在 Enterprise Manager 中,導覽至 Object Stores/ROS/Document class 或子類別。
- 按一下滑鼠右鍵選取「新增訂閱」。
- 為訂閱指定唯一名稱和說明。
- 選取「套用到所有實例」圓鈕。
- 在「指定觸發程式」畫面中,選取「更新」事件觸發程式。
- 選取所匯入的事件動作。
- 在「指定其他內容」畫面中,選取同步勾選框,但清除包括子類別勾選框,然後完成精靈。
訂閱 RMLastRetrievalOfRecord 事件
如果要訂閱 RMLastRetrievalOfRecord 事件,請執行下列動作:
- 在 Enterprise Manager 中,導覽至 Object Stores/FPOS/Other Classes/CustomObject/RM System class。
- 按一下滑鼠右鍵選取「新增訂閱」。
- 為訂閱指定唯一名稱和說明。
- 選取「套用到所有實例」圓鈕。
- 在「指定觸發程式」畫面中,選取「建立」事件觸發程式。
- 選取所匯入的事件動作。
- 在「指定其他內容」畫面中,清除包括子類別勾選框,選取同步勾選框,然後完成精靈。
訂閱 RMSecurityPropagation 事件(僅適用於 PRO)
您可以針對「記錄資料夾」類別、「磁區」類別或「記錄」類別,建立此事件訂閱。
如果要針對「記錄資料夾」類別訂閱事件,請執行下列動作:
- 在 Enterprise Manager 中,導覽至 Object Stores/PRO-FPOS/Other Classes/Folder/RM Folder/Record Folder class。
- 按一下滑鼠右鍵選取「新增訂閱」。
- 為訂閱指定唯一名稱和說明。
- 選取「套用到所有實例」圓鈕。
- 在「指定觸發程式」畫面中,選取「存檔」和「更新」事件觸發程式。
- 選取所匯入的事件動作。
- 在「指定其他內容」畫面中,清除包括子類別勾選框,然後完成精靈。
如果要針對「磁區」類別訂閱事件,請執行下列動作:
- 在 Enterprise Manager 中,導覽至 Object Stores/PRO FPOS/Other Classes/Folder/RM Folder/Volume class。
- 按一下滑鼠右鍵選取「新增訂閱」。
- 為訂閱指定唯一名稱和說明。
- 選取「套用到所有實例」圓鈕。
- 在「指定觸發程式」畫面中,選取「存檔」和「更新」事件觸發程式。
- 選取所匯入的事件動作。
- 在「指定其他內容」畫面中,清除包括子類別勾選框,然後完成精靈。
如果要針對「記錄」類別訂閱事件,請執行下列動作:
- 在 Enterprise Manager 中,導覽至 Object Stores/PRO-FPOS/Document Class/Record class。
- 按一下滑鼠右鍵選取「新增訂閱」。
- 為訂閱指定唯一名稱和說明。
- 選取「套用到所有實例」圓鈕。
- 在「指定觸發程式」畫面中,選取「更新」事件觸發程式。
- 選取所匯入的事件動作。
- 在「指定其他內容」畫面中,選取包括子類別勾選框,然後完成精靈。
訂閱 RMSendEmailOnSupercede 事件
如果要訂閱 RMSendEmailOnSupercede 事件,請執行下列動作:
- 在 Enterprise Manager 中,導覽至 Object Stores/FPOS/Document Class/Record class。
- 按一下滑鼠右鍵選取「新增訂閱」。
- 為訂閱指定唯一名稱和說明。
- 選取「套用到所有實例」圓鈕。
- 在「指定觸發程式」畫面中,選取「更新」和「移入」事件觸發程式。
- 選取所匯入的事件動作。
- 在「指定其他內容」畫面中,選取包括子類別勾選框,然後完成精靈。
訂閱 RMUpdateDateDeclared 事件
如果是 PRO 資料模型,您必須啟用現存的事件,如下所示:
- 在 Enterprise Manager 中,導覽至 Object Stores/FPOS/Events/Event Action 資料夾。
- 用滑鼠右鍵按一下 UpdateDateDeclared。
- 按一下「啟用」。
如果是 DoD 和 Base 資料模型,請在建立事件之後訂閱「記錄種類」、「磁區」和「產品盒」類別。
如果要針對「記錄種類」類別訂閱事件,請執行下列動作:
- 在 Enterprise Manager 中,導覽至 Object Stores/<FPOS>/Other Classes/Folder/RM Folder/Record Category
- 按一下滑鼠右鍵選取「新增訂閱」。
- 為訂閱指定唯一名稱和說明。
- 選取「套用到所有實例」圓鈕。
- 在「指定觸發程式」畫面中,選取「存檔」事件觸發程式。
- 選取所匯入的事件動作。
- 在「指定其他內容」畫面中,清除包括子類別勾選框,然後完成精靈。
如果要針對「磁區」類別訂閱事件,請執行下列動作:
- 在 Enterprise Manager 中,導覽至 Object Stores/FPOS/Other Classes/Folder/RM Folder/Volume
- 按一下滑鼠右鍵選取「新增訂閱」。
- 為訂閱指定唯一名稱和說明。
- 選取「套用到所有實例」圓鈕。
- 在「指定觸發程式」畫面中,選取「存檔」事件觸發程式。
- 選取所匯入的事件動作。
- 在「指定其他內容」畫面中,清除包括子類別勾選框,然後完成精靈。
如果要針對「產品盒」類別訂閱事件,請執行下列動作:
- 在 Enterprise Manager 中,導覽至 Object Stores/FPOS/Other Classes/Folder/RM Folder/Physical Container/Box
- 按一下滑鼠右鍵選取「新增訂閱」。
- 為訂閱指定唯一名稱和說明。
- 選取「套用到所有實例」圓鈕。
- 在「指定觸發程式」畫面中,選取「存檔」事件觸發程式。
- 選取所匯入的事件動作。
- 在「指定其他內容」畫面中,清除包括子類別勾選框,然後完成精靈。