Função CONJUNTOCUBO

Descrição

Define um conjunto calculado de membros ou cadeias de identificação enviando uma expressão de conjunto para o cubo no servidor, que cria o conjunto e, em seguida, devolve o conjunto ao Microsoft Excel.

Sintaxe

CONJUNTOCUBO(ligação, expressão_conjunto, [legenda], [sequência_ordenação], [ordenar_por])

A sintaxe da função CONJUNTOCUBO tem os seguintes argumentos:

• Ligação    obrigatório. É uma cadeia de texto com o nome da ligação ao cubo.

• Expressão_conjunto    Obrigatório. É uma cadeia de texto com uma expressão de conjunto que resulta num conjunto de membros ou cadeias de identificação. Expressão_conjunto também pode ser uma referência de célula para um intervalo do Excel que contenha um ou vários membros, cadeias de identificação ou conjuntos incluídos no conjunto.

• Legenda    Opcional. É uma cadeia de texto mostrada na célula em vez da legenda, se estiver definida uma legenda, do cubo.

• Sequência_ordenação    Opcional. É o tipo de ordenação, se existir uma ordenação, a executar, e pode ser um dos seguintes:

• O valor predefinido é 0. Uma ordenação alfabética de um conjunto de cadeias de identificação ordena pelo último elemento de cada cadeia de identificação. Para mais informações sobre as diferentes sequências de ordenação, consulte o sistema de ajuda do Microsoft Office SQL Analysis Services.

• Sort_by    Opcional. Uma cadeia de texto do valor pelo qual ordenar. Por exemplo, para obter a cidade com as vendas mais altas, set_expression seria um conjunto de cidades e sort_by seria a medida de vendas. Ou, para obter a cidade com a população mais alta, set_expression seria um conjunto de cidades, e sort_by seria a medida da população. Se sort_order exigir sort_by e sort_by for omitido, CONJUNTOCUBO devolve o #VALUE! mensagem de erro.

Observações

• Quando a função CONJUNTOCUBO é avaliada, mostra temporariamente uma mensagem "#A_OBTER_DADOS…" na célula, antes de todos os dados serem recuperados.

• Se o nome da ligação não for uma ligação de livro válida armazenada no livro, CONJUNTOCUBO devolve uma #NAME? #VALOR! Se o servidor OLAP (Online Analytical Processing) não estiver em execução, não estiver disponível ou devolver uma mensagem de erro, a função CONJUNTOCUBO devolverá uma #NAME? #VALOR!

• Se a sintaxe de expressão_conjunto estiver incorreta ou o conjunto contiver pelo menos um membro com uma dimensão diferente dos outros membros, a função CONJUNTOCUBO devolverá um valor de erro #N/D.

• Se set_expression tiver mais de 255 carateres, que é o limite de um argumento para uma função, CONJUNTOCUBO devolve um #VALUE! #VALOR! Para utilizar cadeias de texto com mais de 255 carateres, introduza a cadeia de texto numa célula (para a qual o limite é de 32.767 carateres) e, em seguida, utilize uma referência de célula como argumento.

• A função CONJUNTOCUBO poderá devolver um valor de erro #N/D se referenciar um objeto baseado na sessão, como, por exemplo, um membro calculado ou conjunto nomeado, numa Tabela Dinâmica ao partilhar uma ligação, e essa Tabela Dinâmica for eliminada ou convertida em fórmulas. No separador Opções, no grupo Ferramentas, clique em Ferramentas OLAP e, em seguida, clique em Converter em Fórmulas.

Exemplos

=CONJUNTOCUBO("Finanças";"Encomenda([Produto].[Produto].[Categoria do Produto].Membros;[Medidas].[Vendas de Unidades];ASC)";"Produtos")

=CONJUNTOCUBO("Vendas";"[Produto].[Todos os Produtos].Crianças";"Produtos";1;"[Medidas].[Volume de Vendas]")