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。

For more information about metric indicators, see the Data Workbench User Guide.

允许报告重新生成

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

注意: 更改 Report.cfg文件 会导致 Report Server重新生成由该 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个值”参数中输入值。 在此参数中命名的维必须存在于为其创建报表的数据集中。
仅在完美时通过电子邮件发送 可选. 允许用户指定仅在运行期间未发生错误时才发送报表集。 选项为 true 和 false。默认值为 false。
结束日期

可选. 您希望报表集运行的上次日期和时间。 此时间基于数据集的截止时间。

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

示例:08/01/2007 12:01 EDT

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

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

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

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

滤镜公式

可选. 应用于报表集中每个工作区的过滤器。

有关详细信息,请参阅 创建过滤器的语法

Gamma校正

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

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

隐藏徽标 指示在生成报表时,报表服务器是否隐藏徽标。 The options are true or false . 如果设置为 false,则 会使用“报告”徽标生成报告。 The default is false .
查找文件

可选. 填充此参数后,Report Server以动态模式运行,并为在Dimension Name(维名称)参数中指定的维的每个元素生成报表。 此文件必须包含两个制表符分隔的列,不含标题行。

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

注意: 如果在此参数中输入值,则必须在“维名称”(Dimension Name)参数中输入值。

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

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

注意: 仅当报告服务器生成至少一个报告时,它才会发送电子邮件。

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

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

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

“仅通知”值在5.4x和5.5x发行版中可用。

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

正文XSL模板

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

有关 示例文件,请参 阅报告示例文件。

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

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

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

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

预载查询过滤器

可选. 此参数仅适用于“顶 级维元素”报 告类型。

要应用到查询的过滤器的名称,必须运行该名称才能确定前N个维元素,然后才能生成报告。 默认值为 Broken_Session_Filter 。 For more information about the Broken Session Filter , see the Data Workbench User Guide.

报表类型

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

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

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

开始日期

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

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

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

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

示例:

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

  • 2006年8月08日和之后每天为hh:mm = 12:00的数据运行每日报告。
  • 每周报告将于2006年8月08日运行,其后每7天为hh:mm = 12:00的数据运行一次。
  • 月度报告将于2006年8月运行,其后每月的第8天运行,其中hh:mm = 12:00 EST。

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

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

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

注意: 如果在此参数中输入值,则必须在“维名称”(Dimension Name)参数和“前N个值”(Top N Value)参数中输入值。

前N个值

可选. 填充此参数后, Report Server以动态模式运行,并为“Dimension Name”(维名称)参数中指定的维的元素顶数(在此参数中指定)生成报表,按Top N Metric(前N个度量)参数中指定的度量计数。

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

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

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

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

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

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

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

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

在此页面上