# 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:

Argumentos

| Argumento | Descrição |
| --- | --- |
| field\_name | Nome do campo para o qual é exigido o valor. 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 da carga, 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:

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

* 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.

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/InterRecordFunctions/fieldvalue.htm)

#### Exemplo

### Script de carregamento

Carregue os seguintes dados como um carregamento inline no editor de carregamento de dados para criar o exemplo abaixo.

```
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',5) as MyPos2
Resident Names;
```

Para obter mais informações sobre como usar carregamentos inline, consulte [Usando carregamentos inline para carregar dados](https://help.qlik.com/pt-BR/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/inline-loads-qs.htm).

### Criar uma visualização

Crie uma visualização de tabela em uma Qlik Sense do Qlik Cloud. Adicione os campos First name, MyPos1 e MyPos2 à tabela.

### Resultado

| First name | MyPos1 | MyPos2 |
| --- | --- | --- |
| Jane | John | Jane |
| John | John | Jane |
| Mark | John | Jane |
| Peter | John | Jane |
| Sue | John | Jane |

### Explicação

FieldValue('First name','1') resulta em John como o valor para MyPos1 para todos os nomes porque John aparece primeiro na ordem de carregamento do campo First name. Observe que em um painel de filtro John apareceria como número 2 a partir do topo, depois de Jane, porque é classificado em ordem alfabética e não na ordem de carregamento.

FieldValue('First name','5') resulta em Jane como o valor para MyPos2 para todos os nomes porque Jane aparece em quinto lugar na ordem de carregamento do campo First name.