报告 › 如何创建和运行自定义快照报告 › 创建报告参数 XML 文件

创建报告参数 XML 文件

参数是报告中的一个字段，可以用来筛选报告。 您可以通过使用参数筛选数据来生成报告。 要允许自定义报告搜索屏幕，每个报告（RPT 文件）都要与报告参数 XML 文件关联。 在 CA IdentityMinder 中，您可以创建报告任务并创建搜索屏幕，以便用户在报告生成期间可以输入或选择所需的数据。

注意：如果报告查询对象上的属性，您只需一个报告参数 XML 文件即可。

报告参数 XML 文件必须与报告（RPT 文件）同名，并使用 .xml 扩展名。 例如，如果您将名为 test1.rpt 的报告上传至报告服务器，则应将 XML 文件命名为 test1.xml。

报告参数 XML 文件包含以下元素：

<product>

指明使用参数的产品。 您可以使用同一参数 XML 文件为多个产品创建不同的参数。

<screen>

定义在屏幕上显示的参数。 您可以使用屏幕元素来将参数绑定到指定屏幕。 屏幕 ID 由字母数字组成，并且是唯一的，用于指明屏幕及其参数。

<parameters>

指定屏幕的参数集合。

<param>

定义将指定数据传递到报告的参数元素。 <param> 元素中使用以下属性：

id

定义报告中要关联的参数。

注意：ID 必须有与 Crystal Reports 中的参数相同的名称。

name

此字段当前未用于 CA IdentityMinder。 将此属性设置为与 id 同样的值。

displaytext

为该参数指定要在屏幕中显示的用户友好的文本。

type

定义参数的类型。 屏幕根据此属性显示相应更改。 支持的参数类型如下所示：

• 文本框

  示例：<param id="param1" displaytext="First Name" name="param1" type="string"/>

• 日期和时间

  示例：<param id="dateVal" displaytext="Date" name="dateVal" type="date_str"/>

  <param id="timeVal" displaytext="Time" name="timeVal" type="time_str"/>

  <param id="datetimeVal" displaytext="Date &amp; Time" name="datetimeVal" type="date_time_str"/>

• 下拉列表

  示例：<param id="lastname1" displaytext="Name" name="lastname1" type="dropdown" default="key1%1FMy Value1%1Ekey2%1FMy Value2" selected_value="My Value2"/>

• 列表框

  示例：<param id="lstlastname1" displaytext="Name" name="lstlastname1" type="listbox" rows="10" default="key1%1FSuper%1Ekey2%1Fsql2kSuser01%1E key1F%Super"/>

• 单选框

  示例：<param id="optionslist" displaytext="Option 1" name="optionslist" type="radiobox" value="option1"/>

  <param id="optionslist" displaytext="Option 2" name="optionslist" type="radiobox" value="option2"/>

  <param id="optionslist" displaytext="Option 3" name="optionslist" type="radiobox" value="option3"/>

• 复选框

  示例：<param id="enabled" displaytext="Enabled" name="enabled" type="checkbox"/>

row

定义列表框中显示的行数。

默认值：5

default

定义屏幕上显示的给定参数的默认值。 此属性可以与字符串、列表框和下拉列表类型一起使用。