# 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, как значения, вводимые в три функции агрегирования:
 |
Данные, используемые в примерах:
`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 '|');`