COLLAPSE

Aplica-se a:Coluna calculadaTabela calculadaMedidaCálculo visual

Recupera um contexto em um nível mais alto em comparação com o contexto atual. Se uma expressão for fornecida, retorna seu valor no novo contexto, permitindo a navegação em hierarquias e o cálculo em um nível mais alto.

Sintaxe

As sintaxes que executam a navegação e o cálculo.

COLLAPSE ( <expression>, <axis>[, N] )
COLLAPSE ( <expression>, <column>[, <column>] ... )

As sintaxes que executam apenas a navegação.

COLLAPSE ( <axis>[, N] )
COLLAPSE ( <column>[, <column>] ... )

Parâmetros

Vigência	Definição
expression	A expressão a ser avaliada no novo contexto.
axis	Uma referência de eixo.
column	Uma coluna na grade de dados.
N	(Opcional) O número de níveis a colapsar. Se omitido, o valor padrão é 1.

Valor de retorno

Para versões que executam navegação e cálculo, a função retorna o valor da expressão no novo contexto depois de navegar para um novo nível. Para versões que executam apenas navegação, a função modifica o contexto de avaliação navegando para um novo nível.

Comentários

• Esta função só pode ser utilizada em cálculos visuais.
• As versões somente de navegação da função podem ser usadas dentro da função CALCULATE.
• Os níveis da hierarquia são determinados por todas as colunas em cada eixo referenciado pela referência do eixo.
• Quando as colunas são especificadas, os eixos são determinados incluindo o eixo de cada coluna na primeira vez que são encontradas.
• Quando N é especificado, a função navega para cima na hierarquia N níveis a partir do nível atual ou do nível mais alto, o que ocorrer primeiro.
• Quando várias colunas são especificadas, a função navega para cima na hierarquia até atingir o primeiro nível em que nenhuma das colunas especificadas está presente.
• A navegação começa na célula atual na matriz de dados, subindo na hierarquia. Se uma coluna especificada estiver em um nível inferior à célula atual, ela será desconsiderada.

Exemplo

Dada uma tabela que resume o total de vendas para uma hierarquia com níveis para total, ano, trimestre e mês, os cálculos de DAX a seguir obtêm o valor de [SalesAmount] no nível pai, no nível dos avós e no nível ano ou auto, respectivamente.

ParentValue = COLLAPSE([SalesAmount], ROWS)
GrandParentValue = COLLAPSE([SalesAmount], ROWS, 2)
QuarterOrSelfValue = COLLAPSE([SalesAmount], [Month])

A imagem abaixo mostra a matriz com os três cálculos visuais.

Ver também

EXPAND EXPANDALL COLLAPSEALL