参数标记

组件使用参数(如 view ID、string 和 numbers)向报告添加信息。这些参数是使用 fp:*Param 标记指定的。
每个组件都有必需标记和可选标记。所有参数标记都具有属性。
表 1. 参数标记和属性
名称 描述
参数标记
fp:attrParam 指定一个属性。例如,“需求”模块中的 Status
fp:checkboxParam 包含布尔值 true 或 false。
fp:critParam 包含一个整数值。例如,(...,-2,-1,0,1,2,....)。
fp:memberParam 指定一个成员。例如,Admin
fp:stringParam 包含一个字符串值。
fp:viewParam 指定一个视图。例如,“所有需求”。
参数标记属性
changeable 必需属性,用于确定何时更改参数,适用于所有 *Param 标记。该属性具有四个值:
  • Template:在创建或编辑报告类型时更改。
  • Runtime:在创建报告时更改。
  • Never:不能更改,用于创建模板时值已知的情况。该值是从 defaultvalue 属性中读取的。
  • Fetch:该值是自动获取的。获取的值由“name”属性的值确定:
    • currentdate:当前日期
    • currenttime:当前时间
    • currentuser:已登录的用户
    • fortune:“fortune cookie”,每次都是最新的。在添加了额外的 .jar 文件时使用该值。
    • numpages:报告中的页数。该值用于页眉和页脚。
    • workspacename:工作空间的名称
    • pageno:当前页码。该值用于页眉和页脚。
id 必需属性,用于指定参数的标识,适用于所有 *Param 标记。每个参数都具有唯一的标识。 您可以对多个参数使用相同的标识。

在用户界面中仅显示第一个参数。其他参数将从第一个参数复制值。如果在多个页眉中显示相同的信息或在多个组件中使用相同的视图,那么该约定将很有用。

name 必需属性,用于指定参数的名称,适用于所有 *Param 标记。在组件标记中,该名称是搜索参数时使用的唯一标识。通用名称包括 viewId、attrId、elementId 和 pageno。
masterid 控制参数的参数的标识。 该属性是必需属性,但是可能不会使用,这取决于组件。 该属性适用于 attrParam。通常,主参数为 viewParam。您必须先设置主参数,否则无法确定哪些属性或元素可用。
type 确定该参数允许的属性类型。 该属性是必需属性,但是可能不会使用,这取决于组件。 该属性适用于 attrParam。您可以使用以下类型属性:
  • choice:用于“选项”属性
  • number:用于“整数”和“浮点”属性
  • numbertext:用于“整数”、“浮点”和“矩阵”属性
  • link:用于“链接”和“链接列表”属性
  • all:用于所有属性类型
defaultvalue 第一次创建或编辑报告类型或第一次生成报告时,参数会被设置为 defaultvalue。该属性为可选属性,适用于所有 *Param 标记。 缺省值为空字符串:defaultvalue=""
descr 参数的描述。该属性是可选属性。当创建或编辑报告类型,或生成报告时,将显示该描述。 缺省情况下不使用描述:descr=""

反馈