VALORCUBO (Função VALORCUBO)
Este artigo descreve a sintaxe da fórmula e o uso da FUNÇÃO VALORCUBO no Microsoft Excel.
Descrição
Retorna um valor agregado do cubo.
Sintaxe
VALORCUBO(conexão, [expressão_membro1], [expressão_membro2], …)
A sintaxe da função VALORCUBO tem os seguintes ARGUMENTOS :
- Conexão Obrigatório. Uma cadeia de texto do nome da conexão com o cubo.
- Expressão_membro Opcional Uma cadeia de texto de uma expressão multidimensional (MDX) que resulta em um membro ou em uma tupla no cubo. De maneira alternativa, expressão_membro pode ser um conjunto definido com a função CONJUNTOCUBO. Use expressão_membro como um slicer para definir a porção do cubo para a qual o valor agregado é retornado. Se nenhuma medida for especificada na expressão_membro, será usada a medida padrão para esse cubo.
Comentários
- Quando a função VALORCUBO faz uma avaliação, ela mostra temporariamente uma mensagem "#OBTENDO_DADOS…" na célula antes de todos os dados serem recuperados.
- Se for usada uma referência de célula para expressão_membro, e essa referência de célula contiver uma função de CUBO, a expressão_membro usará a expressão MDX para esse 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, o VALORCUBO retornará um valor de erro #NOME?. Se o servidor OLAP não estiver em execução, não estiver disponível ou retornar uma mensagem de erro, o VALORCUBO retornará um valor de erro #NOME?.
- Se pelo menos um elemento da tupla for inválido, VALORCUBO retornará um valor de erro #VALOR!.
- VALORCUBO retornará um valor de erro #N/D quando:
- A sintaxe da expressão_membro estiver incorreta.
- O membro especificado pela expressão_membro não existir no cubo.
- A tupla for inválida porque não existe uma interseção para os valores especificados. (Isso pode ocorrer com vários elementos da mesma hierarquia.)
- O conjunto contiver pelo menos um membro com uma dimensão diferente dos outros membros.
- O VALORCUBO pode retornar um valor de erro #N/D se você fizer referência um objeto com base na sessão, como um conjunto nomeado ou membro calculado em uma Tabela Dinâmica ao compartilhar a conexão com a Tabela Dinâmica quando ela é excluída ou quando você a converte em fórmulas. (Na guia Opções no grupo Ferramentas clique em Ferramentas OLAP , e em Converter em Fórmulas.)
No Excel, quando uma célula não contém dados, porque você nunca a alterou ou excluiu o conteúdo, ela contém um valor vazio. Em vários sistemas de bancos de dados, um valor vazio é chamado de valor Nulo. Um valor vazio ou Nulo significa literalmente "sem valor". Entretanto, uma fórmula jamais pode retornar uma cadeia de caracteres vazia ou um valor Nulo. Uma fórmula sempre retorna um destes três valores: um número; um texto, que pode ser uma cadeia de comprimento zero, ou um erro como #NUM! ou #VALOR.
Caso uma fórmula contenha uma função VALORCUBO conectada a um banco de dados OLAP (Online Analytical Processing) e uma consulta ao banco de dados resulte em um valor Nulo, o Excel converte o valor em uma cadeia de comprimento zero, mesmo que a fórmula fosse retornar um valor numérico. Isso pode levar a uma situação em que um intervalo de células contém uma combinação entre valores numéricos e de cadeia de comprimento zero, e essa situação pode afetar os resultados de outras fórmulas que referenciam o intervalo. Por exemplo, se A1 e A3 contiverem números e A2 contiver uma fórmula com uma função VALORCUBO que retorne uma cadeia de comprimento zero, a fórmula seguinte retornaria um erro #VALOR!
=A1+A2+A3
Para evitar isso, é possível testar uma cadeia de comprimento zero, usando a função ÉTEXTO e a função IF para substituir o comprimento zero por um 0 (zero) como mostra o seguinte exemplo:
=IF(ISTEXT(A1),0,A1)+IF(ISTEXT(A2),0,A2)+IF(ISTEXT(A3),0,A3)
Como alternativa, é possível testar a função VALORCUBO em uma condição IF que retorne um valor 0 caso a função VALORCUBO avalie como cadeia de comprimento zero, como mostra o exemplo a seguir:
=IF (CUBEVALUE("Sales","[Measures].[Profit]","[Time].[2004]","[All Product].[Beverages]")="", 0, CUBEVALUE("Sales","[Measures].[Profit]","[Time].[2004]","[All Product].[Beverages]"))
Observe que a função SOMA não exige o teste para uma cadeia de comprimento zero porque ignora automaticamente cadeias de comprimento zero durante o cálculo do valor de retorno.
Exemplos
=CUBEVALUE("Sales","[Measures].[Profit]","[Time].[2004]","[All Product].[Beverages]")
=CUBEVALUE($A$1,"[Measures].[Profit]",D$12,$A23)
=CUBEVALUE("Sales",$B$7,D$12,$A23)