# TextCount - função de gráfico
TextCount() é utilizada para agregar o número de valores de campo que são não numéricos em cada dimensão de gráfico.
Sintaxe:
TextCount({[SetExpression] [DISTINCT] [TOTAL [<fld {,fld}>]]} expr)
Tipo de dados de retorno: inteiro
Argumentos
| Argumento | Descrição |
| --- | --- |
| expr | A expressão ou campo que contém os dados a serem medidos. |
| SetExpression | Por padrão, a função de agregação agregará um conjunto de registros possíveis definidos pela seleção. Um conjunto de registros alternativos pode ser definido por uma expressão de análise. |
| DISTINCT | Se a palavra DISTINCT aparecer antes dos argumentos de função, as duplicatas resultantes da avaliação dos argumentos de função serão ignoradas. |
| TOTAL | Se a palavra TOTAL ocorrer antes dos argumentos da função, o cálculo será feito sobre todos os valores possíveis, dadas as seleções atuais, e não apenas sobre os pertinentes ao valor dimensional atual, isto é, desconsiderando as dimensões do gráfico.
Usando TOTAL [<fld {.fld}>], em que o qualificador TOTAL é seguido por uma lista de um ou mais nomes de campo como um subconjunto das variáveis de dimensão de gráfico, você cria um subconjunto dos valores possíveis totais.
[Definindo o escopo de agregação](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/define-aggregation-scope.htm) |
Exemplo: expressões de gráfico
| Exemplo | Resultado |
| --- | --- |
| `TextCount(Product)` | Retorna o número de nomes de produtos que possuem valores de texto. |
| `TextCount(OrderNumber)` | Retorna o número de linhas no campo `OrderNumber` que possuem valores de texto.
Nota informativa"0" conta como um valor, e não uma célula vazia. No entanto, se uma lista agregar ao 0 para uma dimensão, esta não será incluída nas tabelas. As células vazias são avaliadas como não sendo texto e não são contadas por `TextCount`. |
| `TextCount (DISTINCT Product)/Count(Product)` | Conta todos os números de valores de texto distintos de `Product` e divide-os pelo número total de valores em `Product`. |
## Exemplo - Fundamentos de TextCount
[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/CounterAggregationFunctions/textcount.htm)
#### Expressão de gráfico
Visão geral
Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova seção.
O script de carregamento contém:
* Um conjunto de dados que é carregado em uma tabela de dados denominada `Example`.
* Os campos a seguir na tabela de dados:
* `Customer`
* `Product`
* `OrderNumber`
Script de carregamento
```
Set NULLINTERPRET = ' ';
Example:
LOAD * inline [
Customer|Product|OrderNumber
Astrida|AA|1
Astrida|AA|7
Astrida|BB|4
Betacab|CC|6
Betacab|AA|5
Betacab|BB|
Canutility|AA|
Canutility|CC|
Divadip|CC|2
Divadip|DD|3
](delimiter is '|');
```
Resultados
Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione as seguintes medidas:
* `=TextCount(Product)` para retornar o número de nomes de produtos que são valores de texto.
* `=TextCount(OrderNumber)` para calcular a quantidade de números de pedidos que são valores de texto.
* `=TextCount(DISTINCT Product)/Count(Product)` para contar o número total de valores de texto distintos de `Product` e dividi-lo pelo número total de valores em `Product`.
Results table
| TextCount(Product) | TextCount(OrderNumber) | TextCount(DISTINCT Product)/Count(Product) |
| --- | --- | --- |
| 10 | 3 | 0.4 |
A primeira medida retorna `10` porque todos os dez registros em `Product` são texto.
A segunda medida retorna `3` porque as células vazias são tratadas como texto e contadas. Normalmente, você pode usar esse tipo de medida para verificar se nenhum campo numérico recebeu valores de texto ou está vazio.
A terceira medida retorna `0.4`. Este resultado é calculado dividindo o número total de valores de texto distintos de `Product` (`4`) pelo número total de valores em `Product` (`10`).
## Exemplo - Cenário de TextCount
[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/CounterAggregationFunctions/textcount.htm)
#### Expressão de gráfico
Visão geral
Um conjunto de dados contém dados de respostas de pesquisas com reclamações e feedback geral por produto. Você deseja revisar apenas as respostas com valores de texto.
Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova seção.
O script de carregamento contém:
* Um conjunto de dados que é carregado em uma tabela de dados denominada `Example`.
* Os campos a seguir na tabela de dados:
* `CustomerID`
* `ProductPurchased`
* `Complaint`
* `Feedback`
Script de carregamento
```
Set NullInterpret = '';
Example:
Load * Inline [
CustomerID, ProductPurchased, Complaint, Feedback
1, Laptop, Slow performance, "The laptop is slow, poor battery, slow graphics"
2, Mobile, Heating issue, "Mobile heats up, average camera"
3, Laptop, Battery problem, "Battery not working, slow to charge"
4, Tablet, Screen issue, "Screen is broken, unresponsive touch"
5, Mobile, No issues, "Excellent performance"
6, Mobile, 123, "123"
7, Laptop, ,
8, Tablet, Warranty expired,
9, Mobile, , "Contact customer service"
];
```
Resultados
Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esses campos como dimensões:
* `ProductPurchased`
Crie as seguintes medidas:
* `=TextCount(ProductPurchased)` para calcular o número de nomes de produtos com valores não numéricos.
* `=TextCount(Complaint)` para calcular o número de reclamações com valores não numéricos.
* `=TextCount(Feedback)` para calcular o número de valores de feedback com valores não numéricos.
Results table
| ProductPurchased | TextCount(ProductPurchased) | TextCount(Complaint) | TextCount(Feedback) |
| --- | --- | --- | --- |
| Laptop | 3 | 2 | 2 |
| Mobile | 4 | 2 | 3 |
| Tablet | 2 | 2 | 1 |
Os resultados mostram que, para o produto `Laptop`, há `3` registros, dos quais `2` têm reclamações e `2` têm feedback. Da mesma forma, para o produto `Mobile`, há registros `4`, incluindo `2` reclamações e `3` respostas de feedback. Valores numéricos ou valores vazios não são contados porque se espera que os campos `ProductPurchased`, `Complaint` e `Feedback` sejam valores de texto.