输出参数
下列输出参数决定存储在报表存储或文件系统中的报表的名称和目的地。默认的路径在“报表管理器 (RMA)”中设置。
- 存储输出 - storeOutput
确定报表是否存储在报表存储中。
- 输出文件名称 - outputFileName
报表在存储或输出到文件系统时的名称。
- 输出描述 - outputDescription
在报表存储中查看时报表的描述。如果您需要来自爆裂报表的运行时值,您可以设置承载该值的另一个参数,并在表达式中引用。
- 输出路径 - outputPath
选择 storeOutput 参数时,报表要存入到其中的报表存储文件夹。
- 输出到文件系统 - outputToFileSystem
确定报表是否存储在文件系统中。当[输出到文件系统]报表属性设为“真”时,系统将创建此参数。
- 文件系统路径 - fileSystemPath
选择 outputToFileSystem 参数时,报表要输出到其中的根文件夹和路径。当[输出到文件系统]报表属性设为“真”时,系统将创建此参数。以FileSystem格式显示根路径:其后附上根文件夹中的路径。
注意:管理员必须向用户提供访问文件夹系统文件夹的操作系统权限,以便其能保存报表。 - 运行 XSL 变换 – runXSLTRansformation
确定报表是否根据相关的 xsl 文件进行变换。当[XLS 变换文件]报表属性设为某一值时,系统将创建此参数。
- 时间戳 - timeStamp
输出运行报表的日期和时间的一个独立参数。
- 使用表达式
路径、文件名和描述可以设置为基于系统变量和其他报表参数的表达式。也可以通过修改默认名称来排除时间戳后缀。您可以在设计时将任何输出参数设置到基于系统输出变量、报表参数或固定值的表达式中。
要设置表达式,请选择参数,然后将条件类型设为[表达式]。默认值将设为适当的值;例如:对于[输出路径],参数设为
$MyOutput
,其值在[报表管理器]中设置。通过手动输入路径或表达式来修改该“默认值”。如果之前没有输入过值,则使用默认的报表存储。
从特殊字段中选择输出变量时,其带有前导 $ 符号。但是,从特殊字段中选择参数时,其带有前导 @ 符号。例如:如果您输入
$BusinessUnit/Invoices/@AccountCode
,则输出将为“PK1/Invoices/64001”。 - 特殊字段
下方设置的系统输出变量均带有前缀 $,以便将它们和同一名称的标准参数区别开。用户设置的变量在[报表管理器]中设定,以下三种类型中每个变量可能都会存在多个:[报表存储]路径、[文件系统]路径和[变换输出]路径。
在选择“”图标以打开表达式创建器时,可用的选项限于:
- 按上文所述在 EXT1 中定义的[输出变量],具体根据输出参数
- 参数
- 输出变量
可用变量的完整列表如下:
-
$<OutputPath>
设置为[报表管理器工具]中[输出路径]的文件夹的路径。该变量将选择性地采用其中一个 OutputPath 变量的名称。
-
$TimeStamp
TimeStamp 变量可以采用标准 Visual Basic 格式语法的格式参数。例如:
$TimeStamp("yyyyMMddhhmmssfff")
。如果没有设置格式,则使用默认格式。
-
- 输出变量
- 运行时参数录入
您可以在运行时查看输出参数。变量将尽可能进行解析,但下列除外:
- 文件系统根路径
-
$KeyValue
-
$BatchId
- 与上例中 @Account 相似的数据驱动参数
所以,
$MyReports
更改为 /My Reports。您可以通过多种方式修改输出参数。例如:
- 如果默认输出路径设为
$BusinessUnit
,这会修改为“/PK1”。 - 如果默认输出路径设为
$MyReports
,这会修改为“/My Reports”。 - 如果默认描述设为
$ReportDescription-EnterMonthHere
,这会修改为“Account Listing - EnterMonthHere”。注意:虽然可以在运行时输入参数表达式,管理员也可在设计时预设值路径和名称,以及将相关参数设为固定值或将其隐藏。
- 运行时输出
值表达式在运行时解析,并将值中的空白考虑在内。
当报表为爆裂报表时,任何输出参数表达式中将使用参数的数据驱动值。如果报表在运行时没有爆裂,则使用输入的参数范围中的第一个。
不生成运行时值的变量将被忽略。例如,如果变量设为
/Invoices$BusinessUnit/$KeyValue
,输出将为“/Invoice PK1/”。无效表达式将被替换为空格,但路径中的 "/" 除外。
- 预定报表
在设置时间表中的参数时,输出参数可以修改为与任何其他报表运行相同。
- 链接报表
如果在创建或运行时设置链接报表中的参数,可以向任何一般报表运行一样修改输出参数。
- 变换输出
在变换报表时,其输出文件路径由 fileSystemPath 参数值确定。如果此项为空,则使用设置为[变换输出]默认值的路径。变换输出文件名由 outputFileName 参数值确定。
- 向报表添加输出变量
如果在报表中包含特殊字段,您可以将[输出变量]从[特殊字段]中拖放到报表上,或者随后右键单击并插入标签或字段值。您可以在任何表达式中使用[输出变量]。