# 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 '|');`