# ValueList - 图表函数

ValueList() 用于返回一组列出的值，当这组列出的值用于计算维度时将形成一个组合维度。

信息注释在具有使用 ValueList 函数创建的组合维度的图表中，通过在图表表达式中使用相同的参数重述 ValueList 函数，可以引用对应特定表达式单元格的维度值。 当然，此函数还可以用于布局的任意位置，但组合维度除外，因为此函数仅在聚合函数内才有实质意义。

信息注释组合维度不会受到选择项影响。

语法：

ValueList(v1 {,...})

返回数据类型： 双

参数：

* v1: 静态值（通常是字符串，但可以是数字）。
* {,...}: 可选静态值列表。

示例：

示例和结果

| 示例 | 结果 |
| --- | --- |
| `ValueList('Number of Orders', 'Average Order Size', 'Total Amount')` | 例如，当用于在表格中创建维度时，此函数可生成三个字符串值，作为表格中的行标签。这些值随后可引用到表达式中。 |
| ` =IF( ValueList('Number of Orders', 'Average Order Size', 'Total Amount') = 'Number of Orders',             count(SaleID),IF( ValueList('Number of Orders', 'Average Order Size', 'Total Amount') = 'Average Order Size',                          avg(Amount),                          sum(Amount)  ))  ` | 此表达式可从创建的维度中获取值，并将它们引用到嵌套的 IF 语句中，作为三个聚合函数的输入，如下面示例表格所示。 |

表格形式示例输出

| 已创建维度 | 年 | 已添加表达式 |
| --- | --- | --- |
| - | - | 522.00 |
| Number of Orders | 2012 | 5.00 |
| Number of Orders | 2013 | 7.00 |
| Average Order Size | 2012 | 13.20 |
| Average Order Size | 2013 | 15.43 |
| Total Amount | 2012 | 66.00 |
| Total Amount | 2013 | 108.00 |

**示例中所使用的数据：**

`SalesPeople:
` `LOAD * INLINE  [
` `SaleID|SalesPerson|Amount|Year
` `1|1|12|2013` `
2|1|23|2013
` `3|1|17|2013
` `4|2|9|2013
` `5|2|14|2013
` `6|2|29|2013
` `7|2|4|2013` `
8|1|15|2012` `
9|1|16|2012
` `10|2|11|2012
` `11|2|17|2012
` `12|2|7|2012` `
] (delimiter is '|');`