Report.cfg 参数

重要

阅读有关Data Workbench 生命周期终止公告.

有关Report.cfg参数的信息。

示例 Report.cfg 显示 配置报表集 仅包含 Report.cfg 文件。 下表提供了所有可用 Report.cfg 文件参数。

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

注意

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

参数 描述
警报阈值

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

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

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

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

允许重新生成报告

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

注意:更改 Report.cfg 文件原因 报表服务器 重新生成由 Report.cfg 文件。

附件

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

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

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

内容类型

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

示例:image/jpeg

文件名

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

示例: c:\myimage.jpg

Color Set(颜色集) 标识要用于 .png 文件。 0表示黑色背景;1表示白色背景;2用于灰度图像。
要执行的命令 可选. 在生成报表集后运行的批处理命令或可执行文件。 如果需要启动命令shell解释器,请在命令前面添加cmd /c 。
默认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监视程序超时(秒)

可选. 您需要的秒数 报表服务器 等待Microsoft Excel在将报表生成为Excel文件之前做出响应 报表服务器 决定Excel不响应并终止该过程。 使用此参数可启用 报表服务器 终止Excel(当其变得无响应时),并继续处理非Excel报表。 默认值为300.0。要禁用此功能,请将此参数设置为0.0。

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

过滤器公式

可选. 过滤器。

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

Gamma校正

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

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

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

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

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

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

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

用于通过电子邮件分发报表的区域标识符。 要通过电子邮件分发报表,请为 邮件报表 中。 报表集中的所有报表都通过一封电子邮件发送到在“收件人”参数中指定的电子邮件地址。

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

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

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

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

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

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

正文XSL模板

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

请参阅 报表示例文件 示例文件。

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

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

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

配置 报表服务器 要将报表输出到门户,请将 输出根 到用于门户的web服务器的文档根目录。

预加载查询过滤器

可选. 此参数仅适用于 热门Dimension元素 报表类型。

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

报表类型

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

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

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

开始日期

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

格式: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 Time.metric )标识运行报表的日期和时间。 这最初是在“开始日期”参数中指定的日期和时间,然后按Every(每个)参数指定的时段递增。 对于Data Workbench中的查询, 报表时间 量度基于“截止”量度的午夜( As Of.metric )。 由于“报表时间”量度的定义存在差异,因此,如果查询使用“最后N”维度的工作区,则可以在Data Workbench和 报表服务器 的URL。

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

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

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

前N值

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

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

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

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

可选. 给定报表集的工作区集合的位置。 这对于使用 Report.cfg 文件。 此路径的根目录可以是任何配置文件文件夹。 请勿在路径字符串的开头输入斜杠(\)。

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

XSL输出文件 可选. 在 XSL模板 将应用于报表索引。
XSL模板

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

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

在此页面上