# NumericCount - função de gráfico

NumericCount() agrega o número de valores numéricos em cada dimensão de gráfico.

Sintaxe:

NumericCount({[SetExpression] [DISTINCT] [TOTAL [&lt;fld {,fld}&gt;]]} 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.<br><br>Usando TOTAL [&lt;fld {.fld}&gt;], 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.<br><br>[Definindo o escopo de agregação](https://help.qlik.com/pt-BR/sense/May2026/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/define-aggregation-scope.htm) |

Exemplo: expressões de gráfico

| Exemplo | Resultado |
| --- | --- |
| `NumericCount(OrderNumber)` | Retorna o número de linhas no campo `OrderNumber` que têm valores numéricos.<br><br>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 valores não numéricos e não são contadas por `NumericCount`. |
| `NumericCount(Product)` | Retorna o número de nomes de produtos que são valores numéricos. Normalmente, você pode usar isso para verificar se nenhum campo de texto recebeu conteúdo numérico. |
| `NumericCount (DISTINCT OrderNumber)/Count(DISTINCT OrderNumber)` | Conta o número de números de pedido numérico distintos e o divide pelo número de números de pedido, numéricos e não numéricos. Será 1 se todos os valores de campo forem numéricos. |

## Exemplo - Fundamentos de NumericCount

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/CounterAggregationFunctions/numericcount.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

```
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 esse campo como uma dimensão:

* `OrderNumber`

Crie as seguintes medidas:

* `=NumericCount(OrderNumber)` para calcular o número de pedidos que contêm valores numéricos.

* `=NumericCount(Product)` para retornar o número de nomes de produtos que são valores totalmente numéricos.

* `=NumericCount(DISTINCT OrderNumber)/Count(DISTINCT OrderNumber)` para calcular o número total de números de pedidos com valores numéricos distintos e dividir esse valor pelo número total de números de pedidos com valores numéricos e não numéricos distintos. Será `1` se todos os valores de campo forem numéricos.

Results table

| OrderNumber | NumericCount(OrderNumber) | NumericCount(Product) | NumericCount (DISTINCT OrderNumber)/Count(DISTINCT OrderNumber) |
| --- | --- | --- | --- |
| Totals | 7 | 0 | 0.875 |
| 1 | 1 | 0 | 1 |
| 2 | 1 | 0 | 1 |
| 3 | 1 | 0 | 1 |
| 4 | 1 | 0 | 1 |
| 5 | 1 | 0 | 1 |
| 6 | 1 | 0 | 1 |
| 7 | 1 | 0 | 1 |
|  | 0 | 0 | 0 |

A saída da primeira medida retorna `7` porque três dos dez registros em `OrderNumber` estão vazios e os demais são numéricos.

A segunda medida retorna `0` porque não há valores numéricos; todos os nomes de produtos são texto. Normalmente, você pode usar esse tipo de medida para verificar se nenhum campo de texto tem conteúdo numérico.

A terceira medida conta o número de números de ordem numérica distintos e o divide pelo número de números de ordem, tanto numéricos quanto não numéricos. Será `1` se todos os valores de campo forem numéricos. Normalmente, você pode usar isso para verificar se todos os valores de campo são numéricos. Neste exemplo, há `7` valores numéricos distintos para `OrderNumber` de `8` valores numéricos e não numéricos distintos, então a expressão retorna `0.875`.

## Exemplo - Cenário de NumericCount

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

#### Expressão de gráfico

Visão geral

Um conjunto de dados contém dados de vendas mensais em várias lojas. O gerente da loja deseja descobrir quais lojas e produtos têm valores de vendas que não são numéricos. Isso indica quais registros de vendas têm valores inválidos, por exemplo, o registro estava vazio ou contém dados não numéricos.

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:

  * `Store`

  * `StoreProduct`

  * `Sales`

Script de carregamento

```
Example:
LOAD * inline [
Store, StoreProduct, Sales
A, Widget A, 1200
B, Widget A, No data
C, Widget A, 1300
A, Widget B, 800
B, Widget B,
C, Widget B, "Error"
A, Widget C, 500
B, Widget C, 600
C, Widget C, 700
];
```

Resultados

Carregue os dados e abra uma pasta. Crie uma nova tabela dinâmica e adicione esse campo como uma dimensão de linha:

* `Store`

Adicione este campo como uma dimensão de coluna:

* `StoreProduct`

Crie a seguinte medida:

* `=NumericCount(Sales)` para calcular as vendas da loja que possuem dados numéricos.

Results table

| Store | StoreProduct |  |  |
| --- | --- | --- | --- |
| Widget A | Widget B | Widget C |  |
| A | 1 | 1 | 1 |
| B | 0 | 0 | 1 |
| C | 1 | 0 | 1 |

Os resultados mostram que há `3` registros em que a contagem numérica é `0`. Esses são os registros de vendas que precisam ser investigados, pois contêm valores não numéricos.