IBM Enterprise Records V5.1.2    

事件处理程序

IBM® Enterprise Records 提供了以下 Base、DoD 和 PRO 数据模型的样本事件。

您可以根据需要定制样本。请参阅软件包的 Events 文件夹中的自述文件。

表 1. 事件和描述
事件 描述
RMAutoDeclare

配置记录的自动申报。当用户对记录对象库 (ROS) 中的文档执行特定操作(例如检入或归档到文件夹中)时,IBM Enterprise Records 会在特定的归档计划对象库 (FPOS) 中自动创建相应的电子记录。您还可将此样本事件配置为当用户检入属于特定“文档”类的每个文档时,都申报该文档。

该样本事件仅支持电子记录的未分类的申报。必须将此事件配置为使用异步事件而非同步事件。

RMAutoSynchronizeProperties

将记录的属性与其关联的文档同步。例如,当用户更新记录的属性值时,IBM Enterprise Records 还将更新关联文档中的相应属性值。

此示例事件处理使用相同符号名称的属性。 您可以从文档同步至记录,也可以从记录同步至文档,但不能双向同步。如果您从记录同步至文档,那么当该记录的对应属性更新时,IBM Enterprise Records 会更新该文档。

此事件还可以跨对象库将属性别名从记录同步至文档,或从文档同步至记录,但不能双向同步。

RMUpdateDateDeclared

RMLastRetrievalOfRecord

这些样本事件一起用于确定容器的处理时间。这些样本事件还确保处理调度不会处理最近在其中申报或检索记录的容器。

IBM Enterprise Records 会将此样本事件应用于“卷”和“框”类,并且在用户申报记录时设置父文件夹上的“上次申报日期”。

对于 PRO 数据模型,IBM Enterprise Records 会将 RMUpdateDateDeclared 事件自动订阅至“卷”或“框”类,并且您需要启用该事件。对于其他数据模型,您必须运行导入脚本以创建 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 的服务器。此文件夹包含导入脚本、JAR 文件和配置文件。
  2. 运行适当的导入脚本以创建要使用的事件操作。
    1. 右键单击 IBM Enterprise Records 目标对象库。
    2. 选择全部导入
    3. 在“导入帮助程序”对话框上,从“导入选项”选项卡的“导入清单文件”字段中,浏览至您复制的文件夹。选择所需事件的导入脚本。每个文件均按事件命名。 例如,RMAutoDeclare 事件的导入文件命名为 RMAutoDeclareImport.xml
    4. 在“外部内容路径”字段中,浏览至 ~\Events\lib 文件夹。
    5. 单击导入

    在导入完成后,您将看到“导入成功”的消息。事件操作可以创建在对象库的 Event Action 文件夹下。代码模块创建在 Code Module 文件夹中。

定制配置文件

RMAutoDeclare 和 RMSendEmailOnSupercede 事件有它们自己的配置文件。 导入脚本将在对象库中创建这些文件:

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 Corporation 2013