# FieldIndex – função de script e gráfico
FieldIndex() retorna a posição do valor de campo value encontrado no campo field\_name (por ordem de carga).
Sintaxe:
FieldIndex(field\_name , value)
Tipo de dados de retorno: inteiro
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.
* value: o valor do campo field\_name.
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 value valor não for encontrado entre os valores do campo field\_name, 0 será retornado.
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 uma medida:
`FieldIndex ('First name','John')` | 1, porque 'John' aparece primeiro na ordem de carregamento do campo First name. Observe que em uma lista, John apareceria como segundo de cima para baixo, porque é classificada em ordem alfabética e não na ordem de carregamento. |
| Função de gráfico com First name:
`FieldIndex ('First name','Peter')` | 4, porque FieldIndex() retorna apenas um valor, que é a primeira ocorrência na ordem de carregamento. |
| Função de script - dado que a tabela Names seja carregada, como nos dados de exemplo:
`John1:` `Load FieldIndex('First name','John') as MyJohnPos` `Resident Names;` | `MyJohnPos=`1, porque 'John' aparece primeiro na ordem de carregamento do campo First name. Observe que em uma lista, John apareceria como número 2 do topo, pois está classificado em ordem alfabética e não na ordem de carregamento. |
| Função de script com Names:
`Peter1:` `Load FieldIndex('First name','Peter') as MyPeterPos` `Resident Names;` | `MyPeterPos=`4, porque FieldIndex() retorna apenas um valor, que é a primeira ocorrência na ordem de carregamento. |
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 FieldIndex('First name','John') as MyJohnPos` `Resident Names;` ` ` `Peter1:` `Load FieldIndex('First name','Peter') as MyPeterPos` `Resident Names;`