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

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

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

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

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

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

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

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

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

可选. 过滤器。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

有关示例文件，请参阅报表示例文件 。

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

可选. 生成的报表集的输出位置。 默认为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和报表服务器中为同一工作区收到不同的结果。

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

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

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

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

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

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

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

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

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