Cube - Função CUBEVALUE

Descrição

A função CUBEVALUE retorna um valor agregado do cubo.

Sintaxe

CUBEVALUE (connection, [member_expression1], [member_expression2], …)

Argumentos

Argumento Descrição Obrigatório / Opcional
conexão O nome da conexão com o cubo. - Uma string de texto Requeridos
member_expression

Uma sequência de texto de uma expressão multidimensional (MDX) que avalia um membro ou tupla dentro do cubo.

OU

Um conjunto definido com a função CUBESET.

Opcional
  • Use o Argumento member_expression como um divisor para definir a parte do cubo para a qual o valor agregado é retornado.

  • Se nenhuma medida for especificada em member_expression, a medida padrão para esse cubo será usada.

Notas

  • Quando a função CUBEVALUE é avaliada, ela exibe temporariamente uma mensagem "# GETTING_DATA…" na célula antes de todos os dados serem recuperados.

  • Se uma referência de célula for usada para member_expression e essa referência de célula contiver uma função CUBE, member_expression usará a expressão MDX para o item na célula referenciada e não o valor exibido nessa célula referenciada.

  • Se o nome da conexão não for uma conexão de pasta de trabalho válida armazenada na pasta de trabalho, CUBEVALUE retornará um # NOME? Valor do erro. Se o servidor OLAP (Online Analytical Processing) não estiver em execução, não estiver disponível ou retornar uma mensagem de erro, CUBEVALUE retornará um # NOME? Valor do erro.

  • Se pelo menos um elemento dentro da tupla for inválido, CUBEVALUE retornará um #VALUE! Valor do erro.

  • CUBEVALUE retorna um valor de erro # N / A quando

    • A sintaxe member_expression está incorreta

    • O membro especificado por member_expression não existe no cubo

    • A tupla é inválida porque não há interseção para os valores especificados. (Isso pode ocorrer com vários elementos da mesma hierarquia).

    • O conjunto contém pelo menos um membro com uma dimensão diferente dos outros membros.

    • CUBEVALUE pode retornar um valor de erro # N / A se você fizer referência a um objeto baseado em sessão, como um membro calculado ou conjunto nomeado, em uma Tabela Dinâmica ao compartilhar uma conexão. A tabela dinâmica é excluída ou você converte a tabela dinâmica em fórmulas. (Na guia Opções, no grupo Ferramentas, clique em Ferramentas OLAP e em Converter em Fórmulas.)

Issue: Null values are converted to zero-length strings

  • No Excel, se uma célula não tiver dados porque você nunca a alterou ou excluiu o conteúdo, a célula contém um valor vazio. Em muitos sistemas de banco de dados, um valor vazio é chamado deNullvalor. Aempty ou Nullvalor significa literalmente "Sem valor". No entanto, uma fórmula nunca pode retornar uma string vazia ou valor nulo. Uma fórmula sempre retorna um de três valores -

    • Um valor numérico
    • Um valor de texto, que pode ser uma string de comprimento zero
    • Um valor de erro, como #NUM! ou #VALUE
  • Se uma fórmula contém uma função CUBEVALUE conectada a um banco de dados OLAP (Online Analytical Processing) e uma consulta a esse banco de dados resulta em um valor Nulo, o Excel converte esse valor Nulo em uma string de comprimento zero, mesmo se a fórmula retornasse um número valor. Isso pode levar a uma situação em que um intervalo de células contém uma combinação de valores de string numéricos e de comprimento zero, e essa situação pode afetar os resultados de outras fórmulas que fazem referência a esse intervalo de células.

  • Por exemplo, se A1 e A3 contiverem números e A2 contiver uma fórmula com uma função CUBEVALUE que retorna uma string de comprimento zero, a seguinte fórmula retornaria um #VALUE! Erro -

    = A1 + A2 + A3

  • Para evitar isso, você pode testar uma string de comprimento zero usando a função ISTEXT. Você pode usar a função IF para substituir o comprimento zero por um 0 (zero) da seguinte forma -

=IF(ISTEXT(A1),0,A1)+IF(ISTEXT(A2),0,A2)+IF(ISTEXT(A3),0,A3)
  • Como alternativa, você pode aninhar a função CUBEVALUE em uma condição IF que retorna um valor 0 se a função CUBEVALUE for avaliada como uma string de comprimento zero da seguinte maneira -

=IF (CUBEVALUE ("Sales","[Measures].[Profit]","[Time].[2004]",
   "[All Product].[Beverages]")="", 0, CUBEVALUE("Sales",
   "[Measures].[Profit]","[Time].[2004]","[All Product].[Beverages]"))

Aplicabilidade

Excel 2007, Excel 2010, Excel 2013, Excel 2016

Exemplo