# ValueList - función de gráfico

ValueList() devuelve un conjunto de valores mostrados que, cuando se utilicen en una dimensión calculada, formarán una dimensión sintética.

Nota informativaEn los gráficos con una dimensión sintética creada con la función ValueList es posible referenciar el valor de la dimensión correspondiente a una celda específica de la expresión restableciendo la función ValueList con los mismos parámetros que en la expresión del gráfico. La función, por supuesto, puede utilizarse en cualquier parte del diseño, pero aparte de su uso en las dimensiones sintéticas, sólo tendrá sentido dentro de una función de agregación.

Nota informativaLas dimensiones sintéticas no se ven afectadas por las selecciones.

Sintaxis:

ValueList(v1 {,...})

Tipo de datos que devuelve: dual

Argumentos:

* v1: Valor estático (suele ser una cadena, pero puede ser un número).
* {,...}: Lista opcional de valores estáticos.

Ejemplos:

Ejemplos y resultados

| Ejemplo | Resultado |
| --- | --- |
| `ValueList('Number of Orders', 'Average Order Size', 'Total Amount')` | Cuando se utiliza para crear una dimensión en una tabla, por ejemplo, esto da como resultado los tres valores de cadena como etiquetas de fila en la tabla. A continuación se puede hacer referencia a ellos en una expresión. |
| ` =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)  ))  ` | Esta expresión toma los valores de la dimensión creada y hace referencia a ellos en una sentencia IF anidada como entrada para tres funciones de agregación: |

Ejemplo de resultados en forma de tabla

| Dimensión creada | Año | Expresión agregada |
| --- | --- | --- |
| - | - | 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 |

**Datos utilizados en los ejemplos:**

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