# GetFieldSelections - função de gráfico

GetFieldSelections() retorna uma cadeia de caracteres com as seleções atuais em um campo.

Se todos exceto dois ou todos exceto um dos valores forem selecionados, o formato 'NOT x,y' ou 'NOT y' será utilizado, respectivamente. Se você selecionou todos os valores e a contagem de todos os valores for maior que max\_values, o texto ALL será retornado.

Sintaxe:

GetFieldSelections ( field\_name [, value\_sep [, max\_values [, state\_name]]])

Tipo de dados de retorno: caractere

Formatos de strings de retorno

| Formato | Descrição |
| --- | --- |
| 'a, b, c' | Se o número de valores selecionados for max\_values ou menor, a string retornada será uma lista dos valores selecionados.<br><br>Os valores são separados com value\_sep como delimitador. |
| 'NOT a, b, c' | Se o número de valores não selecionados for max\_values ou menor, a string retornada será uma lista dos valores não selecionados com NOT como prefixo.<br><br>Os valores são separados com value\_sep como delimitador. |
| 'x of y' | x = o número de valores selecionados<br><br>y = o número total de valores<br><br>Isso é retornado quando max\_values &lt; x &lt; (y - max\_values). |
| 'ALL' | Retornado se todos os valores estiverem selecionados. |
| '-' | Retornado se nenhum valor estiver selecionado. |
| &lt;search string&gt; | Se você tiver selecionado com o uso de uma pesquisa, a string de pesquisa será retornada. |

Argumentos:

Argumentos

| Argumentos | Descrição |
| --- | --- |
| field\_name | O campo que contém o intervalo de dados que será medido. |
| value\_sep | O separador a ser colocado entre valores de campo. O padrão é ', '. |
| max\_values | O número máximo de valores de campo que serão listados individualmente. Quando um grande número de valores é selecionado, será usado o formato “x valores de y”. O padrão é 6. |
| state\_name | O nome de um estado alternativo que foi escolhido para a visualização específica. Se o argumento state\_name for usado, apenas as seleções associadas ao nome do estado especificado serão levadas em consideração.<br><br>Para obter mais informações, consulte [Usando estados alternados para análises comparativas](https://help.qlik.com/pt-BR/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Visualizations/alternate-states-comparative-analysis.htm). |

Exemplos e resultados:

O exemplo a seguir usa o campo First name carregado em um painel de filtro.

Exemplos e resultados

| Exemplos | Resultados |
| --- | --- |
| Dado que John está selecionado em First name.<br><br>`GetFieldSelections ([First name])` | 'John' |
| Dado que John e Peter estão selecionados.<br><br>`GetFieldSelections ([First name])` | 'John,Peter' |
| Dado que John e Peter estão selecionados.<br><br>`GetFieldSelections ([First name],'; ')` | 'John; Peter' |
| Dado que John, Sue, Mark estão selecionados em First name.<br><br>`GetFieldSelections ([First name],';',2)` | 'NOT Jane;Peter', pois o valor 2 é indicado como o valor do argumento max\_values. Caso contrário, o resultado teria sido John; Sue; Mark. |

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