# FieldValue – função de script e gráfico

FieldValue() retorna o valor de campo encontrado na posição elem\_no do campo field\_name (por ordem de carga).

Sintaxe:

FieldValue(field\_name , elem\_no)

Tipo de dados de retorno: dual

Argumentos:

* field\_name: Nome do campo para o qual é exigido o índice. Por exemplo, a coluna em uma tabela. Deve ser dado como um valor de caracteres. Isto significa que o nome do campo deve ser colocado entre aspas simples.
* elem\_no: O número da posição (elemento) do campo, seguindo a ordem do carregamento, para a qual o valor é retornado. Isso poderia corresponder à fileira na tabela, mas depende da ordem na qual os elementos (linhas) estiverem carregados.

Limitações:

* A classificação por valores y em gráficos ou por colunas de expressão em tabelas não é permitida quando essa função de gráfico é usada em qualquer uma das expressões do gráfico. Essas alternativas de classificação estão, portanto, automaticamente desabilitadas. Quando você usar essa função de gráfico em uma visualização ou tabela, a classificação da visualização será revertida para a entrada classificada dessa função. Essa limitação não se aplica à função de script equivalente.

* Se elem\_no for maior que o número de valores de campo, será retornadoNULL.

Exemplos:

Adicione os dados de exemplo abaixo ao seu documento e execute-o. Os exemplos a seguir usam o campo: First name da tabelaNames.

Exemplos e resultados

| Exemplo | Resultado |
| --- | --- |
| Função de gráfico - em uma tabela contendo a dimensão First name, adicione como medida:<br><br>`FieldValue('First name','1')` | John, pois John aparece primeiro na ordem de carregamento do campo First name. Observe que em uma lista, John apareceria como segundo de cima para baixo, depois de Jane, porque é classificada em ordem alfabética e não na ordem de carregamento. |
| Função de gráfico com First name:<br><br>`FieldValue('First name','7')` | NULL, porque há apenas 6 valores no campo First name. |
| Função de script, considerando que a tabela Names está carregada, como nos dados de exemplo:<br><br>`John1:`<br>`Load FieldValue('First name',1) as MyPos1`<br>`Resident Names;` | `MyPos1=`John, porque 'John' aparece primeiro na ordem de carregamento do campo First name. |
| Função de script com Names:<br><br>`Peter1:`<br>`Load FieldValue('First name',7) as MyPos2`<br>`Resident Names;` | `MyPo2s=` - (Null), porque há apenas 6 valores no campo First name. |

Dados usados no exemplo:

`Names:` `LOAD * inline [` `"First name"|"Last name"|Initials|"Has cellphone"` `John|Anderson|JA|Yes` `Sue|Brown|SB|Yes` `Mark|Carr|MC |No` `Peter|Devonshire|PD|No` `Jane|Elliot|JE|Yes` `Peter|Franc|PF|Yes ] (delimiter is '|');` `
                ` `John1:` `Load FieldValue('First name',1) as MyPos1` `Resident Names;` ` ` `Peter1:` `Load FieldValue('First name',7) as MyPos2` `Resident Names;`