# FieldIndex Função de script e de 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:

Argumentos

| Argumento | Descrição |
| --- | --- |
| 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:

* Se value valor não for encontrado entre os valores do campo field\_name, 0 será retornado.

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

Exemplos e resultados:

Os exemplos a seguir usam o campo: First name da tabelaNames.

Exemplos e resultados

| Exemplos | Resultados |
| --- | --- |
| Adicione os dados de exemplo ao seu aplicativo e execute-o. | A tabela Names é carregada, como nos dados de amostra. |
| Função de gráfico: em uma tabela contendo a dimensão First name, adicione como medida: |  |
| `FieldIndex ('First name','John')` | 1, 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, pois é classificado em ordem alfabética e não na ordem de carregamento. |
| `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 um painel de filtro, John apareceria como número 2 a partir do topo, pois é classificado em ordem alfabética e não na ordem de carregamento. |
| `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;
```