在交互通信中使用图表

图表或图表是数据的可视表示。它将大量信息浓缩为易于理解的可视格式，使交互通信的收件人能够更好地可视化、解释和分析复杂数据。

在创建交互式通信时，您可以添加图表以可视方式表示交互式通信的表单数据模型中的二维数据。图表组件允许您添加和配置以下类型的图表：饼图、列、甜圈、条、线、线和点、点、面积和象限。

在交互通信中添加和配置图表

执行以下步骤以在交互式通信中添加和配置图表：

从交互式通信的Sidekick点按组件。
将Chart组件拖放到以下组件之一：
- 打印渠道:目标区域或图像字段
- Web渠道:面板或目标区
点按交互式通信编辑器中的图表组件，并从组件工具栏中选择配置( )。

图表属性显示在左窗格中。

打印渠道中线型图表的基本属性

Web渠道中线型图的基本属性
根据渠道类型配置图表属性。
(仅打印渠道)在代理设置中，指定代理是否必须使用此图表。如果未选择此图表选项，则代理可点击代理UI的内容选项卡中图表的眼睛图标以显示或隐藏图表。
点按以保存图表属性。

点按预览以视图与图表关联的外观和数据。点按编辑以重新配置图表的属性。

配置图表属性

在为打印和Web渠道创建图表时配置以下属性：

字段	描述	渠道类型
名称	图表元素的标识符。在此字段中指定的图表的名称在图表上不可见。它用于引用来自其他组件、脚本和SOM表达式的元素。	印刷和Web
图表类型	要生成的图表类型。可用的选项有饼图、列、圆环、条、线、线和点、点和区域。	印刷和Web
“系列”>“多系列”	选择此项可为X轴和Y轴上绘制的表单数据模型集合项添加多个系列。	印刷和Web
“序列”>“数据模型对象”	用于向图表添加多个系列的表单数据模型集合项的名称。为在X轴和Y轴上绘制的属性选择父表单数据模型对象属性，以形成有意义的系列。绑定的数据模型对象必须是“数字”、“字符串”或“日期”类型。	印刷和Web
显示排列	选择将各系列的数值排列程序。	印刷和Web
X轴>标题	X轴的标题。	印刷和Web
X轴>数据模型对象	要绘制在X轴上的表单数据模型集合项的名称。选择同一父数据模型对象的两个集合／数组类型属性，这些属性彼此有意义，可绘制图表的X和Y轴。绑定的数据模型对象必须是“数字”、“字符串”或“日期”类型。	印刷和Web
Y轴>标题	Y轴的标题。	印刷和Web
Y轴>数据模型对象	在Y轴上绘制数据模型收集项。在“打印”渠道中，Y轴的数据模型对象应为“编号”类型。选择同一父数据模型对象的两个集合／数组类型属性，这些属性彼此有意义，可绘制图表的X和Y轴。	印刷和Web
Y轴>函数	用于计算Y轴上值的统计／自定义函数。	印刷和Web
隐藏对象	选择此项可在最终输出中隐藏图表。	印刷和Web
标题	图表的标题。	打印
高度	图表的高度（以像素为单位）。	打印
宽度	图表的宽度（以像素为单位）。您可以使用样式图层或通过应用主题在Web渠道中控制图表的宽度。	打印
之前必填分页符	选择此项可在图表前添加一个强制分页符，并将图表放在新页面的顶部。	打印
之后必填分页符	选择此项可在图表后添加一个强制分页符，并将图表后的内容放在新页面的顶部。	打印
缩进	图表从页面左侧缩进。	打印
工具提示	格式，工具提示显示在Web渠道中图表中数据点的鼠标上。默认值为${x}(${y})。根据图表类型，当您将鼠标指向图表中的点、条或切片时，变量${x}和${y}将动态替换为X轴和Y轴上的相应值，并显示在工具提示中。要禁用工具提示，请将工具提示字段留空。此选项不适用于线图和面积图。例如，请参见示例1:打印和Web中的图表输出。	Web
图表特定配置	除了常见配置之外，还提供以下图表特定配置：显示图例：在启用时显示饼图或甜圈图的图例。图例位置：指定图例相对于图表的位置。可用选项有“右”、“左”、“上”和“下”。建议在打印渠道中使用右侧图例。内半径:可用于圆环图指定图表中内圆的半径（以像素为单位）。线条颜色:可用于折线图、折线图、点图和面积图以指定图表中折线的颜色。点颜色:点图和线图和点图可用于指定图表中点的颜色。区域颜色:面积图可用于指定图表中线下区域的颜色。 “参考点”>“绑定类型”: 可用于象限图表指定参考点的绑定类型。使用静态文本或数据模型对象属性定义参考点的值。 “参照点”(Reference Point)>“X轴”(X-axis): 如果从“绑定类型”(Binding Type)下拉列表中选择“状态”(Static)来指定参考点的X轴值，则此图表可用。参照点> Y轴：如果从“绑定类型”(Binding Type)下拉列表中选择“状态”(Static)来指定参考点的Y轴值，则此图表可用。 “参考点”>“序列的数据模型对象”: 如果从“绑定类型”下拉列表中选择“ 数据模型对象”，则可用于多个系列象限图表。定义表单数据模型对象属性以确定参考点的系列. “参考点”>“序列的数据模型对象值”: 如果从“绑定类型”下拉列表中选择“ 数据模型对象”，则可用于多个系列象限图表。使用序列的表单数据模型对象属性和此字段中定义的值来标识参考点的序列。 “参照点”(Reference Point)>“参照点的数据模型对象”(Data Model Object for Reference Point): 如果从“绑定类型”下拉列表中选择“数据模型对象”，则可用于象限图表。定义表单数据模型对象属性，该属性是绘制在X轴和Y轴上的属性的同级。此外，对于多个系列，定义一个数据模型对象属性，该属性是为该系列定义的数据模型对象属性的子实体。 “参照点”(Reference Point)>“参照点的数据模型对象值”(Data Model Object Value for Reference Point): 如果从“绑定类型”下拉列表中选择“数据模型对象”，则可用于象限图表。将表单数据模型对象属性用于引用点以及此字段中定义的值，以标识图表的引用点。象限标签>左上图：可用于象限图表，以指定左上图的名称。象限标签>右上：可用于象限图表，以指定右上象限的名称。象限标签>右下：可用于象限图表以指定右下象限的名称。象限标签>左下：可用于象限图表以指定左下象限的名称。	印刷和Web

在图表中使用函数

您可以将图表配置为使用统计函数从源数据计算值以在图表上绘制。通过在图表中应用函数，可以绘制表单数据模型不直接提供的数据。

图表中的函数

当图表组件包含一些内置函数时，您可以编写自定义函数并使它们可用于Web渠道的图表配置。

图表组件默认提供以下功能：

平均值(平 均值)返回X轴或Y轴上另一个轴上给定值的平均值。

Sum 返回X或Y轴上另一个轴上给定值的所有值的和。

最大值返回X轴或Y轴上另一个轴上给定值的最大值。

频率返回X轴或Y轴上另一个轴上给定值的值数。

范围返回X轴或Y轴上给定值在其它轴上的最大值和最小值之间的差值。

中值返回在X或Y轴上分隔较高值和较低值的值，在另一个轴上分隔给定值。

最小值返回X或Y轴上另一个轴上给定值的最小值。

模式在X或Y轴上返回在另一个轴上给定值出现次数最多的值。

有关详细信息，请参阅示例2:求和和和频率函数在线图中的应用。

Web渠道中的自定义函数

除了使用图表中的默认函数外，您还可以在JavaScript™中编写自定义函数，并在图表组件中的函数列表中使用这些函数进行Web渠道。

函数将数组或值以及类别名称作为输入并返回值。例如：

Multiply(valueArray, category) {
 var val = 1;
 _.each(valueArray, function(value) {
 val = val * value;
 });
 return val;
}

编写自定义函数后，请执行以下操作，使其可用于图表配置：

在与相关交互通信关联的客户端库中添加自定义函数。有关详细信息，请参阅配置提交操作和使用客户端库。
要在“函数”下拉框中显示自定义函数，请在CRXDe Lite中，使用以下属性在apps文件夹中创建一个nt:unstructured节点：
- 添加值为fd/af/reducer的属性guideComponentType。 (mandatory)
- 将属性value添加到自定义JavaScript™函数的完全限定名称。（必填），将其值设置为自定义函数的名称，如Multiply。
- 添加属性jcr:description，其值要显示为“函数”下拉列表中显示的自定义函数的名称。例如，Multiply。
- 添加属性qtip，其值将是自定义函数的简短描述。将指针悬停在Function下拉列表中的函数名称上时，它将显示为工具提示。
单击保存全部以保存配置。