Ir para conteúdo principal

ValueList - função de gráfico

ValueList() retorna um conjunto de valores listados que, quando usados em uma dimensão calculada, formarão uma dimensão sintética.

Nota: Em gráficos com uma dimensão sintética criada com a função ValueList é possível fazer referência ao valor da dimensão correspondente a uma célula de expressão específica declarando novamente a função ValueList com os mesmos parâmetros na expressão de gráfico. A função pode, é claro, ser usada em qualquer lugar do layout, mas, exceto quando usada para dimensões sintéticas, ela só terá significado dentro de uma função de agregação.
Nota: Dimensões sintéticas não são afetadas pelas seleções.

Syntax:  

ValueList(v1 {,...})

Return data type: dual

Arguments:  

  • v1: Valor estático (normalmente uma string, mas pode ser um número).
  • {,...}: Lista opcional de valores estáticos.

Examples:  

Exemplos e resultados
Exemplo Resultado
ValueList('Number of Orders', 'Average Order Size', 'Total Amount')

Quando usado para criar uma dimensão em uma tabela, por exemplo, isso resulta em três valores de string como rótulos de linha na tabela. Eles podem ser então referenciados em uma expressão.

=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) ))

Essa expressão usa os valores da dimensão criada e os referencia em um comando IF aninhado como entrada para três funções de agregação, conforme visto na tabela de exemplo abaixo.

Exemplo de saída em formato de tabela
Dimensão criada Ano Expressão adicionada
- - 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

Dados usados nos exemplos:

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