Report.cfg 参数

有关Report.cfg参数的信息。

默认情况下,配置报表集中显示的示例Report.cfg仅包含Report.cfg文件中包含的参数。 下表提供了所有可用Report.cfg文件参数的描述。

如果需要向Report.cfg文件添加其他参数,则必须使用文本编辑器来添加。 要执行此操作的步骤,包括如何定义每个参数条目的示例,请参阅编辑现有Report.cfg文件

注意

此表中的参数按字母顺序列出。 以Data Workbench打开Report.cfg文件时,矢量按字母顺序列出,然后按字母顺序列出各个参数。

参数 描述
警报阈值

可选. 此参数仅适用于具有量度指示器的报表。 在发送警报报告之前必须显示在工作表中的量度指标数。

如果在量度指示器工作表中只监视一个量度,请将阈值设置为1。 当工作表中的量度评估为向上/向下箭头或X时,将生成报表。如果报表中监视了多个量度,则可以选择在生成报表之前必须评估为向上/向下箭头或X的量度指标数。 例如,如果正在监控两个量度:

  • 如果阈值设置为1,则当工作表中的任一量度计算为向上/向下箭头或X时,将生成报表。
  • 如果将阈值设置为2,则这两个量度在生成报表之前必须计算为向上/向下箭头或X。

有关量度指示器的更多信息,请参阅Data Workbench用户指南

允许重新生成报告

指示在创建或修改这些报表时,报表服务器是否自动生成或重新生成特定报表。 选项为 true 或 false。如果设置为true,则创建或修改报表工作区会导致报表服务器为最近的运行重新生成该报表。

注意: 更改 Report.cfg 文件会导致报表服务器重新生成由该 Report.cfg 文件控制的所有报表。

附件

可选. 随通过电子邮件分发的报表一起发出的任何附件的名称和内容类型(包括附件的数量)的区域标识符。

要添加新附件,请执行以下操作:

  1. 在Data Workbench中打开 Report.cfg 文件。
  2. 右键单击附件 ,然后单击添加新子项 > 附件

内容类型

要附加的文件的内容类型。

示例:image/jpeg

文件名

要附加的文件的位置和名称。

示例: c:\myimage.jpg

Color Set(颜色集) 标识用于 .png 文件的颜色方案。 0表示黑色背景;1表示白色背景;2用于灰度图像。
要执行的命令 可选. 在生成报表集后运行的批处理命令或可执行文件。 如果需要启动命令shell解释器,请在命令前面添加cmd /c 。
默认Excel模板

可选. 要将报表生成为Excel文件时要使用的通用Excel模板文件( .xls .xlsx )的文件名。 此参数支持完整的文件路径,如 c:\templates\mytemplate.xls

此文件用于所有Excel报表,除非为特定报表专门定义了模板。 请参阅使用模板文件

维度名称 可选. 要动态生成报表的维度名称。 如果在此参数中输入维度名称,则必须在“查找文件”参数或“前N个量度”和“前N个值”参数中输入值。 此参数中命名的维度必须存在于要为其创建报表的数据集中。
仅当Perfect时,才发送电子邮件 可选. 允许用户指定仅在运行期间未发生错误时才发送报表集。 选项为 true 和 false。默认值为 false。
结束日期

可选. 您希望报表集运行的最后日期和时间。 此时间基于数据集的“截至”时间。

格式:MM/DD/YYYY hh:mm时区,使用24小时语法表示时间

示例:08/01/2007美国东部夏令时12:01

有关时区设置的详细信息,请参阅《数据集配置指南》

每个 报告集生成的频率:日、周或月。
Excel监视程序超时(秒)

可选. 在报表服务器确定Excel未响应并终止该过程之前,您希望报表服务器在将报表生成为Excel文件时等待Microsoft Excel响应的秒数。 使用此参数, Report Server 可在Excel无响应时终止它,并继续处理非Excel报表。 默认值为300.0。要禁用此功能,请将此参数设置为0.0。

确保定义的值足够长,以允许将报表导出到Excel。 否则,报表服务器可能会提前终止Excel,并且您的报表将不会生成。

过滤器公式

可选. 过滤器。

有关更多信息,请参阅用于创建过滤器的语法。

Gamma校正

.png 文件输出的Gamma设置。 默认值为 1.6。

注意: Adobe建议您不要更改此值。

隐藏徽标 指示在生成报表时Report Server是否隐藏徽标。 选项为 true false 。 如果设置为 false ,则会使用Report徽标生成报表。 默认值为 false
查找文件

可选. 填充此参数后,报表服务器将以动态模式运行,并为“Dimension名称”参数中指定的维度的每个元素生成报表。 此文件必须包含两个以制表符分隔的列,且不带标题行。

  • 列1包含维度元素列表。
  • 第2列包含报表收件人的电子邮件地址。 列1中给定元素的报表将发送到列2中同一行的电子邮件地址。 您可以输入多个电子邮件地址,方法是使用逗号分隔这些地址(无空格)。 如果不通过电子邮件发送报表,则此列可为空,但必须存在。

注意: 如果在此参数中输入值,则必须在Dimension名称参数中输入值。

仅通知 报表服务器设置允许您配置Data Workbench以在生成报表时发送电子邮件。 将此值设置为 true 不会发出报告,而是发送一封电子邮件,通知订阅用户报告已生成。
邮件报表

用于通过电子邮件分发报表的章节标识符。 要通过电子邮件分发报表,请完成邮件报表条目的以下参数。 报表集中的所有报表都通过一封电子邮件发送到在“收件人”参数中指定的电子邮件地址。

注意: 报表服务器仅在生成了至少一个报表时才发送电子邮件。

要启用报表的电子邮件发送,您必须至少为此条目完成以下参数:

  • SMTP服务器
  • 收件人
  • 发件人地址
  • 仅通知

注意: 要在重新生成报表集后通过电子邮件发送报表,请参阅编辑现有Report.cfg文件

仅通知值在5.4x和5.5x版本中可用。

对于要通知的大量收件人(超过20个),强烈建议您使用电子邮件分发列表。

正文XSL模板

可选. 要应用到 reports.xml 文件的XSL模板文件的路径。 使用此参数,报表服务器可以在分布式电子邮件中发送您的报表,而不是作为附件发送。 生成的文本将用作电子邮件的正文。

有关示例文件,请参阅报表示例文件

有关可扩展样式表语言(XSLT)的信息,请参阅可扩展样式表语言系列

收件人 要将报表发送到的人员的电子邮件地址。
发件人地址 发件人的电子邮件地址。
发件人名称 可选。发件人的名称。
SMTP服务器 SMTP服务器计算机的地址以及身份验证所需的密码和用户名。
主题 可选. 描述要发送的电子邮件的主题行。
仅通知 允许您将Data Workbench配置为在生成后台报表时发送电子邮件。 将此值设置为True不会发出报表,而是发送一封电子邮件,将订阅用户链接到报表位置。
输出根

可选. 生成的报表集的输出位置。 默认为Report Server安装目录中的<配置文件名称>\Reports文件夹。

要配置报表服务器将报表输出到门户,请将输出根设置为用于门户的Web服务器的文档根。

预加载查询过滤器

可选. 此参数仅适用于排名最前的Dimension元素报表类型。

要应用于查询的过滤器名称,必须运行该过滤器以确定在生成报表之前排名前N的维度元素。 默认值为 Broken_Session_Filter 。 有关无效会话过滤器的详细信息,请参阅Data Workbench用户指南

报表类型

要生成输出的格式。 您可以使用以下任意或所有选项一次以多种格式输出报表集:

  • Excel会创建一个Excel工作簿,每个工作表具有一个可视化图表。 通常,使用Excel文件进行电子邮件分发。 请参阅将报表生成为Microsoft Excel文件。 有关使用模板文件的信息,请参阅使用模板文件
  • png会创建可移植网络图形文件。 通常,使用 .png 文件在Web浏览器(门户)中显示。
  • 缩略图会创建工作区的缩略图( .jpg 文件)。 默认大小为240x180。 要更改默认大小,请编辑“缩略图X”和“缩略图Y”参数。

要在Data Workbench中编辑 Report.cfg 时添加新报表类型,请右键单击报表类型 ,单击添加新子项 ,然后选择所需的报表类型。

开始日期

您希望报表集运行的第一个日期和时间。 此时间基于数据集的“截至”时间。

格式:MM/DD/YYY hh:mm时区,使用24小时语法表示时间。

有关时区设置的详细信息,请参阅《数据集配置指南》

注意: 当配置文件中数据的时间戳与指定的日期和时间匹配时,报表将开始运行。

示例:

如果开始日期为08/08/2006 12:00 EST,则报表会针对时间戳为08/08/2006 12:00 EST及更高版本的数据运行。

  • 对于hh:mm = 12:00的数据,每日报表将运行08/08/2006,之后每天运行。
  • 对于hh:mm = 12:00的EST数据,每周报告将运行08/08/2006,之后每7天运行一次。
  • 月度报表的运行时间为08/08/2006,之后每月的第8天为hh:mm = 12:00 EST的数据。

报表时间量度影响“最近N”报表维度,如“最近7天”、“昨天”和“3周前”。 对于Report Server中的查询, 报表时间量度(报表时间.metric )可标识运行报表的日期和时间。 这最初是在“开始日期”参数中指定的日期和时间,然后按Every(每个)参数指定的时段递增。 对于Data Workbench中的查询,报表时间量度基于“截至”量度(“截至”.metric )的午夜。 由于“报表时间”量度的定义存在差异,因此如果查询使用“最后N个”维度的工作区,则可以在Data Workbench和报表服务器中为同一工作区收到不同的结果。

缩略图X 可选. 控制作为输出生成的缩略图X轴的大小(以像素为单位)的整数。
缩略图Y 可选. 控制作为输出生成的缩略图Y轴的大小(以像素为单位)的整数。
前N个量度

可选. 请参阅Top N Value参数的说明。

注意: 如果在此参数中输入值,则必须在“Dimension名称”参数和“前N值”参数中输入值。

前N值

可选. 填充此参数后,报表服务器以动态模式运行,并按“Dimension名称”参数中指定的量度计数,生成“报表名称”参数中指定维度的元素排名最前(在此参数中指定)的报表。

示例:如果您在“Dimension名称”参数中输入“页面”,在“前N个量度”参数中输入“会话”,在此参数中输入5,则生成的报表将列出会话数最多的五个排名最前的页面。

注意: 如果在此参数中输入值,则必须在Dimension名称参数和前N个量度参数中输入值。

仅使用本地示例 可选. 指示您是否希望报表服务器仅使用数据集的本地示例生成报表。 将此参数设置为true后,您可以查看报表集的示例(无需在Data Workbench Server上加载),以查看输出的外观,而无需花费完全处理数据所需的全部时间。 此操作为测试函数。 选项为 true 或 false。默认值为false。
工作区路径

可选. 给定报表集的工作区集合的位置。 这对于使用 Report.cfg 文件维护需要以多种方式生成和分发的单个工作区副本非常有用。 此路径的根目录可以是任何配置文件文件夹。 请勿在路径字符串的开头输入斜杠(\)。

示例:您可以在 Reports\Common 文件夹中保存Set A和Set B的常用工作区,然后为两个不同的报表集定义 Report.cfg 文件,每个报表集具有不同的生成和分发设置。 在两个 Report.cfg 文件中,您应将Workspace Path参数设置为配置文件名称\Reports\Common。

XSL输出文件 可选. 将 XSL模板应用于报表索引时创建的输出文件的路径。
XSL模板

可选. 要应用于报表索引的XSL模板文件的路径。 生成的转换后的 .xml 将写入指定的 XSL输出文件。 有关示例文件,请参阅报表示例文件

注意: 除非在生成报表时使用 .xsl 模板,否则所有报表都通过电子邮件作为附件分发。

在此页面上