Este artigo descreve a sintaxe da fórmula e a utilização da função MEMBROCUBO no Microsoft Excel.
Descrição
Retorna um membro ou uma tupla a partir de um cubo. Use para validar a existência do membro ou da tupla no cubo.
Sintaxe
MEMBROCUBO(conexão, expressão_membro, [legenda])
A sintaxe da função MEMBROCUBO tem os seguintes argumentos:
- Ligação Obrigatório. Uma cadeia de texto do nome da conexão com o cubo.
- Member_expression Obrigatório. Uma cadeia de texto de uma expressão multidimensional (MDX) que resulta em um único membro no cubo. De modo alternativo, expressão_membro pode ser uma tupla, especificada como um intervalo de células ou uma constante de matriz.
- Legenda Opcional. Uma cadeia de texto exibida na célula em vez da legenda do cubo, se uma estiver definida. Quando uma tupla é retornada, a legenda usada é aquela do último membro da tupla.
Comentários
Quando a função MEMBROCUBO faz uma avaliação, ela temporariamente exibe a mensagem "#OBTENDO_DADOS…" na célula antes de recuperar todos os dados.
Ao usar MEMBROCUBO como um argumento de outra função de CUBO, a expressão MDX que identifica o membro ou a tupla é usada por essa função de CUBO, não o valor exibido na célula da função MEMBROCUBO.
Se o nome da ligação não for uma ligação de livro válida armazenada no livro, MEMBROCUBO devolve um #NAME? valor de erro. Se o servidor OLAP (Online Analytical Processing) não estiver em execução, não estiver disponível ou devolver uma mensagem de erro, MEMBROCUBO devolve uma #NAME? valor de erro.
Se pelo menos um elemento da tupla for inválido, a função MEMBROCUBO retornará um valor de erro #VALOR! .
Se expressão_membro tiver mais de 255 caracteres, que é o limite para um argumento na função, MEMBROCUBO retornará um valor de erro #VALOR! . Para usar sequências de texto com mais de 255 caracteres, insira a sequência em uma célula (para a qual o limite é de 32.767 caracteres) e use uma referência de célula como argumento.
MEMBROCUBO retornará um valor de erro #N/D quando:
- A sintaxe da expressão_membro estiver incorreta.
- O membro especificado pela cadeia de caracteres MDX não existe no cubo.
- A tupla será válida porque não haverá 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.
A função MEMBROCUBO poderá retornar um valor de erro #N/D, se você fizer referência a um objeto baseado em sessão, como um membro calculado ou um conjunto nomeado, em uma Tabela Dinâmica ao compartilhar uma conexão, e essa Tabela Dinâmica for excluída ou você a converter em fórmulas. (Na guia Opções no grupo ferramentas Clique em Ferramentas OLAP e depois em Converter em Fórmulas.)
Exemplos
=MEMBROCUBO("Vendas";"[Hora].[Fiscal].[2004]")
=MEMBROCUBO($A$1;D$12)
=MEMBROCUBO("Vendas";(B4; C6; D5),"VendasDe2004")
=MEMBROCUBO("xlextdat8 FoodMart 2000 Sales";"([Produto].[Alimento];[Hora].[1997])")