# Dimensionality - função de gráfico

Dimensionality() retorna o número de dimensões da linha atual. No caso de tabelas dinâmicas, a função que retorna o número total de colunas da dimensão que têm conteúdo não agregado, isto é, não contêm somas parciais ou agregações contraídas.

Sintaxe:

Dimensionality ( )

Tipo de dados de retorno: inteiro

Limitações:

Essa função só está disponível para gráficos. Para todos os tipos de gráfico, exceto tabelas dinâmicas, ela retornará o número de dimensões em todas as linhas, exceto o total, que será 0.

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.

## Exemplo: Fundamentos do Dimensionality

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

#### Exemplo: expressão de gráfico

A função Dimensionality() pode ser usada com uma tabela dinâmica como uma expressão de gráfico onde você deseja aplicar uma formatação de célula diferente, dependendo do número de dimensões em uma linha que tenha dados não agregados. Este exemplo usa a função Dimensionality() para aplicar uma cor de fundo às células da tabela que correspondem a uma determinada condição.

### Script de carregamento

Carregue os seguintes dados como um carregamento inline no editor de carregamento de dados para criar o exemplo de expressão de gráfico abaixo.

```
ProductSales:

Load * inline [
Country,Product,Sales,Budget
Sweden,AA,100000,50000
Germany,AA,125000,175000
Canada,AA,105000,98000
Norway,AA,74850,68500
Ireland,AA,49000,48000
Sweden,BB,98000,99000
Germany,BB,115000,175000
Norway,BB,71850,68500
Ireland,BB,31000,48000
] (delimiter is ',');
```

Para obter mais informações sobre como usar carregamentos inline, consulte [Usando carregamentos inline para carregar dados](https://help.qlik.com/pt-BR/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/inline-loads-qs.htm).

### Expressão de gráfico

Crie uma visualização de tabela dinâmica em uma Qlik Sense do Qlik Cloud com País e Produto como dimensões. Adicione Sum(Sales), Sum(Budget) e Dimensionality() como medidas.

No painel Propriedades, insira a seguinte expressão como a Expressão de cor de fundo para a medida Sum(Sales).

```
If(Dimensionality()=1 and Sum(Sales)<Sum(Budget),RGB(255,156,156),
If(Dimensionality()=2 and Sum(Sales)<Sum(Budget),RGB(178,29,29)
))
```

### Resultado:

![Tabela dinâmica usando dimensionalidade.](https://help.qlik.com/pt-BR/sense/May2025/Subsystems/Hub/Content/Resources/Images/dimensionality-pivot-table.png)

### Explicação

A expressão `If(Dimensionality()=1 and Sum(Sales)<Sum(Budget),RGB(255,156,156),
If(Dimensionality()=2 and Sum(Sales)<Sum(Budget),RGB(178,29,29)))` contém declarações condicionais que verificam o valor da dimensionalidade e a Sum(Sales) e Sum(Budget) para cada produto. Se as condições forem atendidas, uma cor de fundo será aplicada ao valor de Sum(Sales).