创建仪表板规范

创建仪表板报告行动生成图形化报告基于一个或多个表的数据集的内容。报告的布局,确定每个图表的类型和格式的XML代码中设置操作的仪表板Spec属性。这个XML代码应该有以下结构:

报告部分

每个规格都有顶级<报告>部分如下:

<报告>

< /报告>

仪表板的背景颜色和标题字体颜色可以使用属性指定<报告>标记,例如:

<报告写成BackgroundColor = " DarkSlateGray " TitleColor =“小麦”>

如果创建仪表板报告行动的“嵌入式”参数设置为“假”,NoHeader和NoFooter属性可能用于<报告>标记隐藏报告的页眉和页脚。

隐藏标题只有:

<报告NoHeader = " true " >

< /报告>

只隐藏页脚:

<报告NoFooter = " true " >

< /报告>

隐藏的页眉和页脚:

<报告NoHeader = " true " NoFooter = " true " >

< /报告>

行部分

<报告>部分包含一个或多个<行>部分。尽管有超过一个<行>部分可能被指定,一个<行>部分是足够的对于许多类型的报告。

<报告>

<行>

< /行>

< /报告>

以下可选属性可用于<行>标记:

  • 标题:指定要使用的标题行。
  • TitleColor:指定颜色用于标题的文本。
  • TitleBackgroundColor:指定用于标题的背景颜色。

例如:

<报告>

<行标题= "第一行“TitleColor =“红色”TitleBackgroundColor = "黄色" >

< /行>

< /报告>

细胞部分

每个<行>部分规范中包含一个或多个<细胞>部分,代表在报告中列。每个<细胞>部分有一个跨度属性指定列数的细胞应该占领。

跨属性值“span1”…“span12”。建议总跨度值在每个<行>部分不应超过6。

<报告>

<行>

<细胞跨度= " span1 " >

< /细胞>

<细胞跨度= " span1 " >

< /细胞>

<细胞跨度= " span2 " >

< /细胞>

< /行>

< /报告>

对象的部分

每个<细胞>部分包含一个或多个<对象>部分,它描述图表和文本对象将显示垂直的细胞。每个<对象>部分指定源参数,数据存储表或文本对象提供的数据图表。

<报告>

<行>

<细胞跨度= " span1 " >

< Param对象= " Source1“UrlLink = " String1 " >

< /对象>

< Param对象= " Source2“UrlLink = " String2相等" >

< /对象>

< /细胞>

< /行>

< /报告>

UrlLink值指的是一个输入字符串属性应该添加到创建仪表板报告操作使用动作参数定义向导。属性应该与一个字符串参数或数据集,其中包含一个URL,例如,或外部网站链接到一个HTML报告。

URL链接可以被添加到任何<对象>标记,包括那些包含<文本>,<图像>或<图形>标记。点击一个仪表板报告对象来显示其关联的URL。在多层次仪表盘报告的情况下,单击图表的标题打开关联的URL。显示了一个例子在这里

OBJECT_LINK部分

每个<细胞>部分可能包含一个或多个OBJECT_LINK部分。这些引用的url仪表板报告要包括在报告生成。

<报告>

<行>

<细胞跨度= " span1 " >

< OBJECT_LINK Param = " Link1“LinkedParam = " Source1 " / >

< /细胞>

<细胞跨度= " span1 " >

< OBJECT_LINK Param = " Link2“LinkedParam = " Source2 " / >

< /细胞>

< /行>

< /报告>

参数值是一个字符串属性与仪表板报告URL。它可能是一个新创建的字符串参数使用动作参数定义向导或现有的字符串参数,例如Subchart1。LinkedParam值指的是源属性创建仪表板报告相关的操作,它提供了有关的数据图表。

多层次仪表盘报告示例

图形部分

每个<对象>部分,指定一个源参数可能包含一个<图形>部分描述的属性表。如果你想使用默认属性设置为一个图表,<图形>部分可以省略。

<报告>

<行>

<细胞跨度= " span1 " >

< Param对象= " Source1 " >

<图形>

< /图形>

< /对象>

< /细胞>

< /行>

< /报告>

请注意,每个<图形>对象必须指定一个不同的源参数。然而<图形>和<表>对象可以共享相同的源参数。

<图形>标记

下面的标签可能包含在<图形>部分。在大多数情况下,这些标签只需要以覆盖默认值。

<类型>(默认值:酒吧)

这个属性描述图表的类型。许用值:酒吧、Bar-Cylinder列,Column-Cylinder,甜甜圈,行,派,StackedBar, StackedBar-Cylinder, StackedColumn, StackedColumn100 StackedColumn-Cylinder。

注意:StackedColumn100图表显示多个系列的百分比值,因此,图表中的每一列的高度100。

<宽度>

图的宽度(以像素为单位)。如果没有设置这个值,图的宽度是由跨属性中指定数量乘以240像素。在大多数情况下,<宽度>标记不是必需的。

<高度>

高度图的像素。如果没有设置这个值,图的高度是由跨属性中指定数量乘以240像素。<高度>标记可能需要限制一个宽的高度图。

< CHART_PROPERTIES >

自定义属性的列表应用到图表中,指定为一个逗号分隔的名称/值对列表,例如:

< CHART_PROPERTIES > Name1 = Value1,名字= Value2,…< / CHART_PROPERTIES >

自定义属性的列表可能会发现https://docs.microsoft.com/en-us/previous-versions/dd456764%28v%3dvs.140%29。请注意,并不是所有的自定义属性适用于所有类型的图表。

LiveCompare这个版本,甜甜圈和饼图将呈现为平在默认情况下,不使用软边缘。之前的行为可能恢复通过设置如下:

< CHART_PROPERTIES > PieDrawingStyle = SoftEdge < / CHART_PROPERTIES >

< CHART_TITLE >

标题用于图表。默认值是表的数据集的名称,提供的数据图表。图表的标题可以设置动态执行以下步骤:

  1. 使用动作参数定义向导添加一个新的输入属性的类型为String创建仪表板报告行动。字符串属性应该有一个适当的名称,例如,ChartName。
  2. 创建一个字符串参数或数据集ChartName属性节点,并将其值设置为标题用于图表。
  3. 在< CHART_TITLE >标记图,参考ChartName属性如下:

< CHART_TITLE > % ChartName % < / CHART_TITLE >

< BACKGROUND_COLOR >(默认值:AliceBlue)

用于文本的背景颜色,指定为一个符号名称或十六进制# RGB值。

< TITLE_FONT_FAMILY >(默认值是Helvetica)

要使用的字体为图表标题。

< TITLE_FONT_SIZE >(默认值:16)

字体大小(点)用于图表标题。

< TITLE_FONT_STYLE >(默认值:常规)

要使用的字体样式的图表标题。许用值:粗体、斜体、定期删除线,突显。

< TITLE_FONT_COLOR >(默认:黑色)

颜色用于图表标题、指定为一个符号名称或十六进制# RGB值。

< LEGEND_FONT_FAMILY >(默认值是Helvetica)

字体用于图表传奇。

< LEGEND_FONT_SIZE >(默认值:9)

字体大小(点)用于图表传奇。

< LEGEND_FONT_STYLE >(默认值:常规)

字体风格用于图表图例。许用值:粗体、斜体、定期删除线,突显。

< LEGEND_FONT_COLOR >(默认:黑色)

颜色用于传说文本,指定为一个符号名称或十六进制# RGB值。

< SERIES_FONT_FAMILY >(默认值是Helvetica)

要使用的字体为图表系列。

< SERIES_FONT_SIZE >(默认值:9)

字体大小(点)用于图表传奇。

< SERIES_FONT_STYLE >(默认值:常规)

字体样式用于图表系列。许用值:粗体、斜体、定期删除线,突显。

< SERIES_FONT_COLOR >(默认:黑色)

颜色用于系列文本,指定为一个符号名称或十六进制# RGB值。

< AXES_FONT_FAMILY >(默认值是Helvetica)

要使用的字体的图表坐标轴。

< AXES_FONT_SIZE >(默认值:9)

字体大小(点)用于轴的图表。

< AXES_FONT_STYLE >(默认值:常规)

要使用的字体样式的图表坐标轴。许用值:粗体、斜体、定期删除线,突显。

< AXES_FONT_COLOR >(默认:黑色)

颜色用于轴文本,指定为一个符号名称或十六进制# RGB值。

<色调>(默认值:淡)

面板的颜色用于多个系列图。许用值:浆果、明亮,BrightPastel,巧克力,EarthTones, Excel,火,灰度,IntelliCorp, IntelliCorp2, IntelliCorp3,光,柔和的,海绿色,半透明。也可以使用自定义面板名称。请参阅下面的“自定义调色板”部分。

< PALETTE_INDEX >(默认值:0)

这个属性指定索引值的调色板颜色用于一个系列图。如果一个图有多个系列和一个指定PALETTE_INDEX,相同的颜色为每个系列的使用。

< IS3D >(默认值:false)

指定是否在三维空间中应该显示一个图表。

<倾向>(默认值:15)

三维图的倾角。

< LINE_WIDTH >(默认值:1)

要使用的线宽线形图。

< REVERSE_LEGEND >(默认值:false)

指定项目的顺序显示在图表的传说应该逆转。

<转>(默认值:30)

三维图旋转的角度。

<最大>

轴的最大价值,显示一个图表的价值观。并不适用于甜甜圈或饼图。如果没有指定这个属性,设置最大适应值表中被报道。

< SHOW_LEGEND >

指定一个传奇是否应该显示相关系列的颜色系列的名字。默认值是“真正”的多个系列的图表,图表类型的甜甜圈或者派。

< SHOW_VALUE_LABELS >(默认值是真实的)

指定数字标签是否应该显示在图。

< SHOW_X_MAJOR_GRID >(默认值是真实的)

指定大间隔X网格线是否应该显示在图。

< SHOW_X_MINOR_GRID >(默认值:false)

指定小间隔X网格线是否应该显示在图。

< SHOW_Y_MAJOR_GRID >(默认值是真实的)

指定间隔大Y网格线是否应该显示在图。

< SHOW_Y_MINOR_GRID >(默认值:false)

指定小间隔Y网格线是否应该显示在图。

< X_AXIS_INTERVAL >(默认值:1)

间隔用于图表的X轴上的标签。将这个值设置为0来去除X轴标签。

< Y_AXIS_INTERVAL >(默认值:间隔自动选择)

图表上的标签使用的间隔的Y轴。将这个值设置为0来移除Y轴标签。

< X_AXIS_LABEL_ANGLE >(默认:-45)

轴的角度相对于X轴的标识度。

< Y_AXIS_LABEL_ANGLE >(默认值:0)

轴的角度相对于X轴的标识度。

表部分

如果一个<对象>部分定义了一个图表,相关表数据可能显示在仪表板下面报告。这是通过使用一个额外的<对象>部分指的是图的源参数,和有一个<表>部分,定义了表的高度和宽度(以像素为单位),和它的背景颜色。

下列指示板规范显示两列图及其相关表。

<报告>

<行>

<细胞跨度= " span2 " >

< Param对象= " Source1 " >

<图形>

<类型> < /列类型>

< SHOW_VALUE_LABELS >假< / SHOW_VALUE_LABELS >

< /图形>

< /对象>

< Param对象= " Source1 " >

<表>

<宽度> 400 < /宽度>

<高度> 150 < /高度>

< BACKGROUND_COLOR >玉米雌穗花丝< / BACKGROUND_COLOR >

< /表>

< /对象>

< /细胞>

<细胞跨度= " span2 " >

< Param对象= " Source2 " >

<图形>

<类型> < /列类型>

< SHOW_VALUE_LABELS >假< / SHOW_VALUE_LABELS >

< /图形>

< /对象>

< Param对象= " Source2 " >

<表>

<宽度> 400 < /宽度>

<高度> 150 < /高度>

< BACKGROUND_COLOR >玉米雌穗花丝< / BACKGROUND_COLOR >

< /表>

< /对象>

< /细胞>

< /行>

< /报告>

表标签

下面的标签可能包含在<表>部分。

<宽度>(默认:500)

表的宽度(以像素为单位)。

<高度>(默认:500)

高度图的像素。如果一个表比它的高度设置,高的表显示垂直滚动条。

<标题>

标题用于表。默认值是表的数据集的名称,提供相关的数据图表。表的标题可以设置动态执行以下步骤:

  1. 使用动作参数定义向导添加一个新的输入属性的类型为String创建仪表板报告行动。字符串属性应该有一个适当的名称,例如,表名。
  2. 为表名创建一个字符串参数或数据集节点属性,并将其值设置为标题用于表。
  3. 在<标题>标记表,参考表属性如下:

<标题> %的表% < /名称>

< BACKGROUND_COLOR >(默认值:AliceBlue)

用于表格的背景颜色,指定为一个符号名称或十六进制# RGB值。

< TITLE_FONT_FAMILY >(默认值是Helvetica)

要使用的字体表标题。

< TITLE_FONT_SIZE >(默认值:16)

字体大小(点)用于表标题。

< TITLE_FONT_STYLE >(默认值是正常的)

要使用的字体样式表的标题。许用值:粗体,斜体。

< TITLE_FONT_COLOR >(默认:黑色)

颜色用于表标题、指定为一个符号名称或十六进制# RGB值。

< SHOW_HEADER >(默认值是真实的)

决定是否显示表的标题。设置这个标记错误隐藏表格的标题行。

< HEADER_COLOR >(默认值是白色)

颜色用于表标题的文本,指定为一个符号名称或十六进制# RGB值。

< HEADER_BLACKGROUND_COLOR >

颜色用于表标题的背景,指定为一个符号名称或十六进制# RGB值。

文本对象

文本对象允许一个标题,价值和字幕显示在仪表板的一份报告中。静态文本对象可能被指定在一个<对象>标记如下:

<对象>

<文本索引= " 0 " >

<标题> LiveCompare < /名称>

<价值> < /值> 4.2

< <副标题>仪表板报告文本例子/字幕>

< /文本>

< /对象>

如果没有指定索引值为0或,被认为是静态的文本对象。动态文本对象可以通过指定一个积极的索引值显示如下:

<对象>

<文本索引= " 1 " / >

< /对象>

索引值< n >是指n项表参数提供给“文本”创建仪表板报告行动。文本表应该有标题、价值和副标题列包含要显示的文本条目。下面的标签可用于指定背景颜色,字体和边框属性文本对象:

< BACKGROUND_COLOR >(默认值:AliceBlue)

用于文本的背景颜色,指定为一个符号名称或十六进制# RGB值。

< BORDER_COLOR >

文本的颜色对象的边界,作为一个符号名称或十六进制# RGB值。这个标签适用于如果BORDER_WIDTH大于0。

< BORDER_WIDTH >

文本对象边界的宽度(以像素为单位)。

<标题>

标题用于文本对象。默认值是标题的文本对象中指定文本表。文本对象的标题可以设置动态执行以下步骤:

  1. 使用动作参数定义向导添加一个新的输入属性的类型为String创建仪表板报告行动。字符串属性应该有一个适当的名称,例如,TextName。
  2. 创建一个字符串参数或数据集TextName属性节点,并将其值设置为标题使用的文本对象
  3. <标题>标记的文本对象,指TextName属性如下:

<标题> % TextName % < /名称>

< TITLE_FONT_FAMILY >(默认值是Helvetica)

字体用于标题文本。

< TITLE_FONT_SIZE >(默认值:30)

字体大小(点)用于标题文本

< TITLE_FONT_STYLE >(默认值:常规)

字体样式用于标题文本。许用值:粗体、斜体、定期删除线,突显。

< TITLE_FONT_COLOR >(默认:黑色)

字体用于标题文本,指定为一个符号名称或十六进制# RGB值。

< VALUE_FONT_FAMILY >(默认值是Helvetica)

的字体用于文本价值。

< VALUE_FONT_SIZE >(默认值:60)

字体大小(点)用于文本价值。

< VALUE_FONT_STYLE >(默认值:常规)

字体样式用于文本价值。许用值:粗体、斜体、定期删除线,突显。

< VALUE_FONT_COLOR >(默认:黑色)

字体家庭用于文本值,指定为一个符号名称或十六进制# RGB值。

< SUBTITLE_FONT_FAMILY >(默认值是Helvetica)

要使用的字体的文本字幕。

< SUBTITLE_FONT_SIZE >(默认值:20)

字体大小(点)用于标题文本

< SUBTITLE_FONT_STYLE >(默认值:常规)

字体样式用于字幕文本。许用值:粗体、斜体、定期删除线,突显。

< SUBTITLE_FONT_COLOR >(默认:黑色)

使用的字体是字幕文本,指定为一个符号名称或十六进制# RGB值。

仪表板报告文本例子

子图表部分

每个<对象>部分可能包含一个<子图表>部分列出了子图表属性中设置仪表板报告。在创建使用子图表多层次的仪表板的报告。子图表是分配给指定的顺序图表区域。当指定子图表multi-series图表要特别小心。

<子图表>

<子图表参数= " Subchart1 " / >

<子图表参数= " Subchart2 " / >

<子图表参数= " Subchart3 " / >

< /子图表>

额外的子图表类型的输入参数字符串可能添加到创建仪表板报告操作使用动作参数定义向导

用户自定义调色板

用户定义的自定义调色板可以定义在仪表板中使用<色调>标签规范的顶级<报告>标记。颜色可以指定为一个符号名称或十六进制# RGB值。

<报告>

<调色板Name = " Custom1 " >

布朗<颜色> < /颜色>

< >颜色深红色> < /颜色

<色调> DarkBlue > < /颜色

<色调>暗绿色> < /颜色

<色调> DarkMagenta > < /颜色

<色调> DarkRed > < /颜色

<色调> DarkSlateBlue > < /颜色

<颜色>耐火砖> < /颜色

< /面板>

<调色板Name = " Custom2 " >

<颜色> # FFD6EB > < /颜色

<颜色> # FFADD6 > < /颜色

<颜色> # FF85C2 > < /颜色

<颜色> # FF5CAD > < /颜色

<颜色> # FF3399 > < /颜色

<颜色> # CC297A > < /颜色

< >颜色# 991 f5c > < /颜色

< >颜色# 66143 d > < /颜色

< /面板>

< /报告>

每个面板都可以有任意数量的颜色标签;颜色用于旋转如果图表数据点超过指定的颜色的调色板。定制调色板中可以使用名称<面板>标记在仪表板规范<图形>部分。

图片

生成的图像执行R行动可能包括在仪表板的报告。将图像添加到仪表板报告,使用动作参数定义向导添加一个新类型的输入属性图像创建仪表板报告行动,和链接属性返回的图像数据集执行R行动。

使用仪表板中的<图像>标记如下规范的XML包含图像在仪表板的一份报告中。在这些例子中,Image1指动作的名称属性定义动作参数定义的向导。

< Param对象= " Image1 " >

<图像/ >

< /对象>

另外,参数设置可以放在<图像>标记如下:

<对象>

<图像参数= " Image1 " / >

< /对象>

<宽度>和<高度>标记也可以用于指定图像的像素宽度和高度:

< Param对象= " Image1 " >

<图片>

<宽度> 520 < /宽度>

<高度> 400 < /高度>

< /图片>

< /对象>

任何图像可能由一个URL引用存储在一个图像参数或数据集可能包含在一个仪表板报告。如果一个图像的URL包含“工作区”作为路径的一部分,它被认为是由执行生成R行动,和图像将被复制到< LiveCompare用户数据dir > \公共报告\ \ <工作区名称>目录创建仪表板报告操作运行时。否则,它将不会被复制和仪表板报告的链接将指向图像的原始位置。

treemap

treemap提供可视化表示的对象存储在一个表的数据集的层次结构的智能影响应用程序的仪表板报告,treemap用于表示没有影响,影响和最危险的对象。

  • 节点在treemap显示为矩形代表个体;每个节点的区域代表一个对象的数值属性,例如使用统计,相对于其他节点的面积。
  • 容器treemap中显示为框标题行。每个容器的名字命名一个父对象,包括所有父母的子对象。

仪表板treemap占据的空间可用的报告的跨度设置。下面显示了一个简单的规范treemap。

<报告>

<行>

<细胞跨度= " span6 " >

< Param对象= " Source1 " >

< TREEMAP >

2 < MAX_DEPTH > < / MAX_DEPTH >

< / TREEMAP >

< /对象>

< /细胞>

< /行>

< /报告>

源表

源表代表对象的层次结构,每个节点都有一个父和零个或更多的孩子(唯一的例外是层次结构的根节点,没有父母。用于源表的列的名称并不重要,但他们的顺序很重要。

  • 第一列存储节点的惟一标识符。
  • 第二列存储节点的父节点的标识符(根节点,本专栏应该设置为null)。
  • 第三列存储节点相对大小值。
  • 第四列存储关键treemap过滤器和互动的传奇。
  • 第五列存储节点的名称,它是节点的工具提示。

支持以下值表中第四列。

价值 描述
1 不影响
0 影响
1 最高危
2 一个顶级层次项目不应该被过滤

例如,下面的源表列表对象在三个功能应用领域。

ID 大小 FILTER_KEY 的名字
功能的应用领域 0 2
成本会计 功能的应用领域 0 2
跨应用程序 功能的应用领域 0 2
财务会计 功能的应用领域 0 2
ZLEASEDCAR——TCOD 成本会计 50 1 程序ZTRV_LEASEDCAR_REPORT
CATSSHOW——掠夺 跨应用程序 20. 0 显示表数据
RFFOAVIS——掠夺 财务会计 10 1 中等国际-零平衡付款通知
RFFOUS_C——掠夺 财务会计 10 1 国际收支中期检查(检查管理)

在这个例子中:

  • 功能应用面积、成本会计、跨应用程序和财务会计文件夹大小为0,不过滤。
  • 跨应用程序功能的应用程序中的对象区域则不受影响。
  • 成本会计功能的应用程序中的对象区域受到影响。
  • 财务会计功能的应用程序中的对象是最高危领域。

节点工具提示形成价值观的ID、名称和大小列。如果在treemap中选择标题行(例如财务会计),工具提示显示子组件的大小值的总和。

注意,上面的尺寸值0必须在降序排序允许treemap的变焦功能正常工作。

的传奇treemap可能修改描述在这里

TREEMAP标签

下面的标签可能包含在< TREEMAP >部分。

< FONT_COLOR >(默认值是白色)

颜色用于treemap文本,指定为一个符号名称或十六进制# RGB值。

< HEADER_HEIGHT >默认的20

用于头元素的高度(以像素为单位)。这个标签设置为0显示treemap没有头元素。

<高度>

treemap中像素的高度(可选)。在默认情况下,使用所有可用的空间。

< MAX_COLOR >默认# CC1C0D(红色)

颜色用于treemap中最高危对象,指定为一个符号名称或十六进制# RGB值。

< MAX_DEPTH >默认为1

节点的最大深度treemap中显示。

< MAX_POST_DEPTH >默认为1

节点的数量水平超出< MAX_DEPTH >以暗示的方式显示。暗示节点显示为阴影矩形内< MAX_DEPTH >中的一个节点,该节点是极限。

< MID_COLOR >默认的# FCB128(橙色)

颜色用于treemap中影响对象,指定为一个符号名称或十六进制# RGB值。

< MIN_COLOR >默认# 8 bc34a(绿色)

颜色用于treemap中不影响对象,指定为一个符号名称或十六进制# RGB值。

<宽度>

treemap中像素的宽度(可选)。在默认情况下,使用所有可用的空间。

修改Treemap的传奇

treemap定义的<传奇>部分的颜色和标签允许违约的影响,不影响和最高危传说要修改。两个或三个项条目可能在<传奇>部分中指定的内容,例如:

<传奇>

<项目标签=“没有影响”的颜色= " # cad 3直流" / >

<项目标签= "影响"颜色= " # D7F2FF " / >

<项目标签= "最高危“颜色= " # 10泡沫" / >

< /传奇>

<传奇>

<项目标签= "打击"颜色= "绿色" / >

<项目标签=“缺口”颜色= "红色" / >

< /传奇>

属性可以是一个颜色符号名称或十六进制# RGB值。

如果一个标签:<传奇>部分有三个项目

  • 传说在第一个标签是用于物品与FILTER_KEY源表的值为1。
  • 传说在第二个标签用于源表中的条目FILTER_KEY值0。
  • 传说在第三个标签是用于项目FILTER_KEY值的源表1所示。

如果<传奇>部分有两项标签:

  • 传说在第一个标签是用于物品与FILTER_KEY源表的值为1。
  • 传说在第二个标签用于源表中的条目FILTER_KEY值0。

如果指定一个<传奇>部分,与每一项相关的标签标记treemap中使用的工具提示。

创建仪表板报告行动