在将新报告添加至 ReportDefintions.xml 之前,您应在 Crystal Reports Designer 中创建一个新报告模板。
如何将新报告添加至 ReportDefinitions.xml:
- 使用 XML 编辑器来打开位于 <ier_install_path>\Config
中的 ReportDefinitions.xml。
- 找到您在归档计划对象库 (FPOS) 中使用的数据模型的数组。该 xml 文件包含用于 DoD 报告、DoD 分类报告、PRO 报告和 BASE 报告的数组。
- 添加新值标记(例如,<value>42</value>)。
此值是一个整数,标识您在 Crystal Reports Designer 中创建的报告, 每个报告的该值均唯一。此值等于现有报告数加 1 。
- 在 <List key="ReportDefinitions"> 内,为您的新报告添加 <object
key="reportDefinition">。 如果存在某个现有报告与您创建的报告相似:
- 在 XML 文件中,复制现有报告的整个 reportDefinition 对象关键字。
- 将已复制的对象关键字粘贴到 XML 文件中的另一位置。
- 根据需要,通过更改或添加以下标记的值,修改新报告的 reportDefinition 对象关键字。
n 是您在上面步骤 3 中输入的数字。
<setting
key="id">n</setting>。
<setting key="title"
localizationKey="server.report_title.n">报告名称</setting>,其中报告名称是 IBM® Enterprise Records 显示的报告标题。
<setting
key="desc" localizationKey="server.report_desc.n">描述</setting>,其中描述是 IBM Enterprise Records 显示的用于简要描述该报告用途的文本。例如,“此报告列出在特定时间段内打开/关闭的卷。”
<setting
key="reportName" localizationKey="server.report_name.n">文件名.rpt</setting>,其中文件名是在 Crystal Reports Designer 中创建的报告模板的名称。
<setting key="img">图像文件的相对路径</setting> 此可选值用于插入图形。例如,images/action/report.gif。
- 要将新报告从特定归档计划对象库 (FPOS) 排除,请输入以下标记:
<array key="excludedObjectStores">
<value>fpos</value> </array>
其中,fpos 是将从中排除新报告的 FPOS 的名称。您可以添加更多值标记,以将报告从多个 FPOS 中排除。
- 添加报告条件,例如,FPOS 位置、操作、时间、调度和日期。
- 在 <object key="reportDefinition"> 下,添加 <list
key="properties">(如需要)。如果您从现有报告复制了 reportDefinition 对象关键字,那么 <list key="properties:> 已经存在。
- 在 properties 列表关键字下,根据需要,为每个报告条件添加或修改符号名称设置关键字。如果您创建了任何新条件,还应在此处为该新条件添加符号名称设置关键字。
在每个符号名称设置关键字后面加上此标记:<setting key="required"> 0 或 1 </setting>,以指示是否需要值。0 表示用户无需进行选择或输入值,而 1 表示需要用户这样做。
将每对符号名称和所需的设置关键字用此标记括起来:<object key="property"> </object>。
例如:
<object key="property"> <setting
key="symbolicname">symbolic name</setting>
<setting key="required">1</setting> </object>
其中,symbolic
name 是您创建的新条件,或任何以下设置关键字:
- fileplan_browse - 指示 IBM Enterprise Records 允许用户浏览至归档计划对象库中的某个位置。
- ros_browse - 指示 IBM Enterprise Records 允许用户浏览至记录对象库中的某个位置。
- start_date - 报告条件的开始日期。
- end_date - 报告条件的结束日期。
- application_type - 用作条件的记录的类型,例如,PDF、DOC 和 XLS 等。
- security_category - 取决于数据模型的安全性标记,例如,“分级”、“机密”和“保密”等。
- review_decision - 审阅的决定,包括核准或拒绝。
- action - 对实体的操作,例如,打开或关闭。
- disposal_schedule - 与实体关联的处理调度。
- disposal_action - 对实体的处理操作,例如,转移、审阅、过渡转移或销毁。
- disposal_action_export - 导出实体后的处理操作。
- report_type - 指示 IBM Enterprise Records 显示“摘要”或“详细”单选按钮。
- disposal_trigger - 触发对实体的处理的事件,例如,某个日期、关闭容器,或某个外部事件
对于
ros_browse、security_category、disposal_action、disposal_action_export、review_decision 和
disposal_trigger,IBM Enterprise Records 在运行时从 Content Engine 中检索缺省值,并将这些缺省值显示在菜单中,您可从该菜单中选择值。
- 如果您的报告使用实体类型作为条件:
- 在 properties 列表关键字下,添加 entity_type 符号名称,后跟“required”设置关键字(1=必需,0=非必需)。
例如:
<object key="property">
<setting key="symbolicname">entity_type</setting>
<setting key="required">1</setting>
- 在您输入用户可选择包括到报告中的实体类型的位置,添加 <list key="values">。例如:
<list key="values">
<object key="value">
<setting key="id">EntityType</setting>
<setting key="value" localizationKey=serve.report_n.EntityType">Entity</setting>
</object>
其中,
- EntityType 是 RecordCategory、RecordFolder 或 Record。
您可以包括所有三个实体类型,但是必须将每个类型分别用 <object key="value"> 标记括起来。
- n 是在上面步骤 3 中指定的数字。
- Entity 是“记录类别”、“记录文件夹”或“记录”。
本地化环境需要“localizationKey”。
例如,如果您的报告包括有关“记录类别”和“记录文件夹”的统计信息,XML 文件的此部分将类似于以下内容:
<object key="property">
<setting key="symbolicname">entity_type</setting>
<setting key="required">1</setting>
<list key="values">
<object key="value">
<setting key="id">RecordCategory</setting>
<setting key="value" localizationKey=serve.report_42.RecordCategory">记录类别</setting>
</object>
<object key="value">
<setting key="id">RecordFolder</setting>
<setting key="value" localizationKey=serve.report_42.RecordFolder">记录文件夹</setting>
</object>
</list>
</object>
- 如果您的报告使用分类作为操作:
在 properties 列表关键字下,添加 classification_action 符号名称,后跟“required”设置关键字(1=必需,0=非必需)。
例如:
<object key="property">
<setting key="symbolicname">classification_action</setting>
<setting key="required">1</setting>
在您输入用户可选择包括到报告中的分类操作的位置,添加 <list
key="values">。例如:
<list key="values">
<object key="value">
<setting key="id">ClassificationAction</setting>
<setting key="value" localizationKey=serve.report_n.ClassificationAction">ClassificationAction</setting>
</object>
其中:
- ClassificationAction 是“升级”、“降级”或“解密”。您可以包括所有三个实体类型,但是必须将每个类型分别用 <object key="value"> 标记括起来。
- n 是此报告在数据模型数组中的“标识”值。
本地化环境需要“localizationKey”。
例如,如果您的报告包括有关降级和解密操作的统计信息,XML 文件的此部分将类似于以下内容:
<object key="property">
<setting key="symbolicname">classification_action</setting>
<setting key="required">1</setting>
<list key="values">
<object key="value">
<setting key="id">Downgrading</setting>
<setting key="value" localizationKey=serve.report_42.Downgrading">降级</setting>
</object>
<object key="value">
<setting key="id">Declassification</setting>
<setting key="value" localizationKey=serve.report_42.Declassification">解密</setting>
</object>
</list>
</object>
- 在输入所有报告条件后:
- 使用 </list> 关闭 <list key="properties">。
- 使用 </object> 关闭 <object key="reportDefinition">
- 保存 XML 文件。
- 重新启动运行 IBM Enterprise Records 的 Web 应用程序服务器,以使更改生效。
当您结束修改时,reportDefinition 对象关键字部分应类似于以下内容:
<object key="reportDefinition">
<setting key="id">22</setting>
<setting key="title" localizationKey="server.report_title.42">记录主管分类更新报告</setting>
<setting key="desc" localizationKey="server.report_desc.42">此报告列出在特定时间段内被更改过分类的实体。</setting>
<setting key="url">RMViewReport.jsp</setting>
<setting key="img">images/action/report.gif</setting>
<setting key="reportName" localizationKey="server.report_name.42">分类更新.rpt</setting>
<list key="properties">
<object key="property">
<setting key="symbolicName">fileplan_browse</setting>
<setting key="required">0</setting>
</object>
<object key="property">
<setting key="symbolicName">start_date</setting>
<setting key="required">1</setting>
</object>
<object key="property">
<setting key="symbolicName">end_date</setting>
<setting key="required">1</setting>
</object>
<object key="property">
<setting key="symbolicName">report_type</setting>
<setting key="required">0</setting>
</object>
<object key="property">
<setting key="symbolicname">entity_type</setting>
<setting key="required">1</setting>
<list key="values">
<object key="value">
<setting key="id">RecordCategory</setting>
<setting key="value" localizationKey=serve.report_42.RecordCategory">记录类别</setting>
</object>
<object key="value">
<setting key="id">RecordFolder</setting>
<setting key="value" localizationKey=serve.report_42.RecordFolder">记录文件夹</setting>
</object>
<object key="property">
<setting key="symbolicname">classification_action</setting>
<setting key="required">1</setting>
<list key="values">
<object key="value">
<setting key="id">Downgrading</setting>
<setting key="value" localizationKey=serve.report_42.Downgrading">降级</setting>
</object>
<object key="value">
<setting key="id">Declassification</setting>
<setting key="value" localizationKey=serve.report_42.Declassification">解密</setting>
</object>
</list>
</object>
</list>
</object>
</list>
</object>