Skip to main content

Função CUBEKPIMEMBER do Excel

Author: Amanda Li Last Modified: 2025-08-06

A função CUBEKPIMEMBER retorna a propriedade do indicador-chave de desempenho (KPI) e exibe o nome do KPI na célula.

cubekpimember function 1


Sintaxe

=CUBEKPIMEMBER(conexão, nome_kpi, propriedade_kpi, [legenda])


Argumentos

  • conexão (obrigatório): Uma string de texto com o nome da conexão para o modelo de dados (cubo).
  • nome_kpi (obrigatório): Uma string de texto com o nome do KPI no cubo.
  • propriedade_kpi (obrigatório): O componente KPI retornado e pode ser uma das constantes enumeradas na tabela abaixo:
  • Inteiro Constante enumerada Descrição
    1 KPIValue O valor real
    2 KPIGoal Um valor-alvo
    3 KPIStatus O estado do KPI em um momento específico no tempo
    4 KPITrend Uma medida do valor ao longo do tempo
    5 KPIWeight Uma importância relativa atribuída ao KPI
    6 KPICurrentTimeMember Um contexto temporal para o KPI
  • legenda (opcional): Uma string de texto que substitui o nome_kpi e a propriedade_kpi e é exibida na célula.

Valor de Retorno

A função CUBEKPIMEMBER retorna uma propriedade KPI.


Notas da Função

  • A mensagem #OBTENDO_DADOS… é exibida enquanto os dados estão sendo recuperados.
  • Para usar o KPI em um cálculo, aninhe a função CUBEKPIMEMBER como um argumento member_expression na função CUBEVALUE.
  • CUBEKPIMEMBER retorna o #NOME? valor de erro se:
    • a conexão não for uma conexão válida armazenada na pasta de trabalho, por exemplo, ThisWorkbookDataModel;
    • O servidor de Processamento Analítico Online (OLAP) está indisponível, não está em execução ou retornou uma mensagem de erro.
  • CUBEKPIMEMBER retorna o #N/D valor de erro se:
    • nome_kpi ou propriedade_kpi não forem válidos;
    • referenciar um objeto baseado em sessão em uma tabela dinâmica ao compartilhar uma conexão e a tabela dinâmica for excluída ou convertida em fórmulas.
  • Os argumentos de CUBEKPIMEMBER, exceto propriedade_kpi e referências de célula, devem ser fechados com aspas duplas ("").

Exemplo

Tenho aqui uma tabela chamada “sales2021” que inclui informações de vendas e classificações de diferentes produtos de 2 categorias ao longo do ano de 2021. Para usar a função CUBEKPIMEMBER para obter o total de vendas de ambas as categorias em 2021, você deve primeiro concluir os dois passos a seguir:

  1. Adicione os dados desta tabela ao Modelo de Dados na pasta de trabalho existente, seu nome sempre será "ThisWorkbookDataModel".
  2. Adicione um KPI ao seu Modelo de Dados.
    1. Vá para Dados > Ferramentas de Dados > Gerenciar Modelo de Dados. Selecione a aba na parte inferior dos seus dados específicos. Aqui vou selecionar sale2021.
    2. Realize os cálculos necessários. Neste exemplo, aplicarei AutoSoma em Vendas coluna, primeiro selecionando a coluna de vendas e depois clicando em AutoSoma. Você verá a Soma de Vendas 2 medida criada conforme mostrado na captura de tela abaixo.
      cubekpimember function 2
    3. Repita a etapa acima, mas aplique Média da lista suspensa após clicar na seta suspensa ao lado de AutoSoma para criar uma Média medida.
      cubekpimember function 3
    4. Clique com o botão direito na Soma medida e selecione Criar KPI. Na caixa de diálogo pop-up, escolha a Média de Vendas 2 Medida no menu suspenso e clique em OK.
      cubekpimember function 4

Agora o KPI está disponível no seu modelo de dados, copie ou insira a fórmula abaixo na célula G21 e pressione Enter para obter o resultado:

=CUBEKPIMEMBER("ThisWorkbookDataModel","Soma de Vendas 2",1, "Total de vendas")

cubekpimember function 5

√ Nota: Você pode obter o valor KPI correspondente usando a função CUBEVALUE na célula H21:

=CUBEVALUE("ThisWorkbookDataModel","[Measures].[Soma de Vendas 2]")


Funções relacionadas

Função CUBEVALUE do Excel

A função CUBEVALUE retorna um valor agregado de um cubo filtrado por múltiplos argumentos member_expression.

Função CUBEMEMBER do Excel

A função CUBEMEMBER recupera um membro ou tupla de um cubo, se existir. Caso contrário, um valor de erro #N/D será retornado.

Função CUBESET do Excel

A função CUBESET define um conjunto calculado de membros ou tuplas enviando uma expressão de conjunto para o cubo no servidor. A função pode extrair todos os valores únicos de uma expressão de conjunto e oferece opções de ordenação.

Função CUBESETCOUNT do Excel

A função CUBESETCOUNT retorna o número de itens em um conjunto.


As Melhores Ferramentas de Produtividade para o Office

Kutools para Excel - Ajuda Você a Se Destacar da Multidão

🤖 Assistente AI do KUTOOLS: Revolucione a análise de dados com base em: Execução Inteligente   |  Gerar Código  |  Criar Fórmulas Personalizadas  |  Analisar Dados e Gerar Gráficos  |  Invocar Funções Aprimoradas
Recursos Populares: Encontrar, Destacar ou Identificar Duplicatas  |  Excluir Linhas em Branco  |  Combinar Colunas ou Células sem Perder Dados  |  Arredondar sem Fórmula ...
Super VLookup: Múltiplos Critérios  |  Múltiplos Valores  |  Entre Multi-Planilhas  |  Correspondência Fuzzy...
Lista Suspensa Avançada: Lista Suspensa Fácil  |  Lista Suspensa Dependente  |  Lista Suspensa Multi-seleção...
Gerenciador de Colunas: Adicionar um Número Específico de Colunas  |  Mover Colunas  |  Alternar Status de Visibilidade das Colunas Ocultas  Comparar Colunas para Selecionar Mesmas & Células Diferentes ...
Recursos em Destaque: Grade de Foco  |  Visualização de Design  |  Barra de Fórmulas Aprimorada  |  Gerenciador de Pasta de Trabalho & Planilha | Biblioteca de Recursos (Auto Text)  |  Selecionador de Data  |  Mesclar Planilhas  |  Criptografar/Descriptografar Células  |  Enviar Emails por Lista  |  Super Filtro  |  Filtro Especial (filtrar negrito/itálico/tachado...) ...
Os 15 Principais Conjuntos de Ferramentas12 Ferramentas de Texto (Adicionar Texto, Excluir Caracteres ...)  |  Mais de 50 Tipos de Gráficos (Gráfico de Gantt ...)  |  Mais de 40 Fórmulas Práticas (Calcular a idade com base na data de nascimento ...)  |  19 Ferramentas de Inserção (Inserir Código QR, Inserir Imagem a partir do Caminho ...)  |  12 Ferramentas de Conversão (Converter em Palavras, Conversão de Moeda ...)  |  7 Ferramentas de Mesclar & Dividir (Mesclar Linhas Avançado, Dividir Células do Excel ...)  |  ... e mais
Use o Kutools no seu idioma preferido – suporta Inglês, Espanhol, Alemão, Francês, Chinês e mais de 40 outros!

Kutools para Excel Conta com Mais de 300 Recursos, Garantindo Que O Que Você Precisa Está Apenas Um Clique de Distância...


Office Tab - Ative a Leitura e Edição com Guias no Microsoft Office (inclui Excel)

  • Um segundo para alternar entre dezenas de documentos abertos!
  • Reduz centenas de cliques do mouse por dia, diga adeus à síndrome do mouse.
  • Aumenta sua produtividade em 50% ao visualizar e editar vários documentos.
  • Traz Guias Eficientes para o Office (inclui Excel), Assim Como Chrome, Edge e Firefox.