在交互式通信中使用图表 using-charts-in-interactive-communications

使用交互式通信中的图表，您可以将大量信息压缩为易于分析和理解的可视化格式

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

在创建交互式通信时，可以添加图表以直观地表示来自交互式通信表单数据模型的二维数据。 图表组件允许您添加和配置以下类型的图表：

在交互式通信中添加和配置图表 add-and-configure-chart-in-an-interactive-communication

完成以下步骤以向交互式通信添加图表：

示例1:打印和Web中的图表输出 chartoutputprintweb

在“基本”选项卡中，您可以定义图表类型、包含数据的源表单数据模型属性、要在图表的x轴和y轴上绘制的标签，以及（可选）用于计算图表上绘制的值的统计函数。

让我们借助使用交互式通信生成的信用卡报表，详细了解基本属性中所需的最低信息。 假设您要生成一个图表来描述报表中不同费用的金额。 要使用不同类型的图表来打印和输出交互式通信。

要完成此操作，您需要指定：

图： 交互式通信的打印输出中的列图

A. Y轴 — 从表单数据模型属性和标题属性中获取的金额设置为金额($) B. 将X轴设置为“左倾”的标签方向 C. X轴 — 从表单数据模型属性和标题属性设置为“费用”的表单获取的费用描述

图： 交互式通信Web输出中的圆环图

A. 已设置圆环的“内半径”属性 B. 已选择“显示图例”属性，并将“图例位置”属性设置为“右侧” C. 工具提示将鼠标悬停在上方时显示项目的详细信息 — 工具提示设置为${x}:$ $

示例2:和频函数在折线图中的应用 applicationsumfrequency

通过在图表中应用函数，可以绘制表单数据模型不直接提供的数据。 在本例中，我们使用信用卡对帐单示例来了解如何将总和和频率函数应用于图表。

图： 没有包含三个“Bed and Breakfast”交易的函数的折线图

求和函数 sum-function

您可以应用sum函数来累加同一数据属性的多个实例的值，并只显示一次。 例如，在下图中，Y轴上应用Sum函数，以累计三个Bed and Breakfast交易（$99.45、$78和$12）的金额，并仅显示一个交易($189.45)。

当您想要对同一数据属性的多个实例进行汇总和显示总和时，总和函数可以使图表更有用。

频率函数 frequency-function

Frequency函数返回X轴或Y轴上另一轴上给定值的值数。 通过在y轴(Amount/TransAmount)上应用频率函数，该图表显示，“Bed and Breakfast”事务处理已发生三次，其余事务类型已发生一次。

图表中的基本属性 basicpropertiescharts

在“基本”选项卡中，您可以配置以下属性：

名称 图表元素的标识符。 名称在图表上不可见，但在引用其他组件、脚本和SOM表达式中的元素时会有所帮助。

标题（仅限打印渠道） 指定图表的标题。

图表类型 指定要生成的图表类型。 可用选项包括饼图、列、圆环图、条形图（仅限Web渠道）、折线图、折线图和点、点和区域。 有关详细信息，请参见示例1:打印和Web中的图表输出。

X轴>标题 指定x轴的标题。

X轴>数据模型对象(&A); 指定要在x轴上绘制的表单数据模型集合项的名称。

X轴>函数 指定用于计算x轴上值的统计/自定义函数。 有关函数的更多信息，请参阅在图表和示例2中使用函数：求和和和均值函数在折线图中的应用。

X轴>标签方向 打印渠道中图表上标签的方向。 如果选择标签的方向作为“自定义旋转”(Custom Rotation)，则会显示“自定义旋转角度（度）”(Custom Rotation Angle(degres))字段。 在“自定旋转角度（度）”(Custom Rotation Angle(degres))字段中，可以按15度的步骤选择旋转角度。

Y轴>标题 指定y轴的标题。

Y轴>数据模型对象(&A); 指定要在y轴上绘制的表单数据模型集合项。 在打印通道中，Y轴的数据模型对象应为“数字”类型。

Y轴>函数 指定用于计算y轴上值的统计/自定义函数。 有关函数的更多信息，请参阅在图表和示例2中使用函数：求和和和均值函数在折线图中的应用。

显示图例 显示饼图或圆环图的图例（启用时）。

图例位置 指定图例相对于图表的位置。 可用选项包括“右”、“左”、“上”和“下”。

高度（仅限打印渠道） 图表的高度（以像素为单位）。

宽度（仅限打印渠道） 图表的宽度（以像素为单位）。

工具提示（仅限Web渠道） 指定工具提示在Web渠道图表中数据点上鼠标悬停时显示的格式。 默认值为${x}(${y})。 根据图表类型，当您将鼠标指向图表中的点、条或切片时，变量${x}和${y}将动态替换为x轴和y轴上的相应值，并显示在工具提示中。

要禁用工具提示，请将“工具提示”字段留空。 此选项不适用于折线图和面积图。 例如，请参阅 示例1:打印和Web中的图表输出.

CSS类（仅限Web渠道） 在CSS类字段中指定CSS类的名称，以将自定义样式应用于图表。

之前的必填分页符（仅限打印渠道） 选择以在图表之前添加强制的分页符，并将图表置于新页面的顶部。

之后的强制分页（仅限打印渠道） 选择以在图表之后添加强制的分页符，并将内容放在图表之后的新页面顶部。

缩进（仅打印渠道） 从页面左侧指定图表的缩进。

特定于图表的配置 除了常见配置外，还提供以下特定于图表的配置：

在图表中使用函数 usefunction

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

虽然图表组件附带一些内置函数，但您可以编写自己的函数，并将其用于Web渠道的图表配置中。

默认函数 default-functions

图表组件默认提供以下函数：

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

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

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

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

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

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

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

模式 返回在X轴或Y轴上出现次数最多的值，该值对应于另一个轴上的给定值

Web渠道中的自定义函数 custom-functions-in-web-channel

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

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

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

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

函数现在可在图表中使用。