Função MEMBROCUBO

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:

• Conexão    Obrigatório. Uma cadeia de texto do nome da conexão com o cubo.

• Expressão_membro    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.

• Caso o nome da conexão não seja uma conexão válida armazenada na pasta de trabalho, a função MEMBROCUBO retornará um valor de erro #NOME? . Se o servidor OLAP (Processamento Analítico Online) estiver inoperante, indisponível ou retornar uma mensagem de erro, a função MEMBROCUBO retornará um valor de erro #NOME? .

• 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])")

=MEMBROCUBO($A$1;C$12:D$12)