Anaplan

  • Artigo

Observação

O artigo do conector a seguir é fornecido pela Anaplan, proprietária desse conector e membro do Programa de Certificação de Conector do Microsoft Power Query. Se tiver dúvidas sobre o conteúdo deste artigo ou desejar fazer alterações neste artigo, acesse o site da Anaplan e use os canais de suporte.

Resumo

Item Descrição
Estado da liberação Disponibilidade geral
Produtos Power BI (Modelos semânticos)
Power BI (Fluxos de dados)
Malha (fluxo de dados Gen2)
Tipos de autenticação compatíveis Basic
Organizational account

Pré-requisitos

Há requisitos de sistema que devem ser verificados antes da instalação do Microsoft Power BI Desktop.

Funcionalidades com suporte

O Anaplan Connector permite acesso às exportações do seu modelo do Anaplan. Além disso:

  • Funciona por meio de APIs de integração de dados públicos do Anaplan.
  • Carrega ações de exportação salvas em seus modelos do Anaplan diretamente no Power BI.
  • Exibe modelos do Anaplan (os modelos não arquivados) em seu locatário padrão.
  • Cria modelos semânticos no Power BI Desktop e os exporta ou atualiza para o serviço do Power BI (nuvem).

Conectar-se ao Anaplan por meio do Power BI Desktop

Obter dados

Para acessar sua exportação salva no Power BI Desktop:

  1. Selecione Obter dados no menu da faixa de opções, que exibe o menu Fontes de dados comuns.

    Obter dados e lista suspensa.

  2. No menu, selecione Mais.

  3. Em Obter dados, insira Anaplan no campo de pesquisa, que exibe o Anaplan Connector.

  4. Selecione Anaplan Connector.

  5. Selecione Conectar.

Configurar o conector

Configure o conector depois de baixá-lo. Esta etapa permite que você se conecte usando APIs do Anaplan.

O conector usa autenticação básica (ID de usuário, senha) ou o IDP configurado pelo Anaplan para fazer logon no Anaplan. Para usar o segundo método, você deve ser designado como um usuário de logon único (Single-Sign On, SSO) do Anaplan em seu modelo do Anaplan. Você pode definir sua própria configuração.

A imagem a seguir mostra a caixa de diálogo Configuração de conexão do Anaplan.

Diálogo de configuração da conexão do Anaplan.

  1. Insira a API e as URLs de autenticação (auth).

    1. Se você escolher Autenticação básica, insira as seguintes URLs e selecione OK.

      URL da API da Anaplan: https://api.anaplan.com

      URL da Autenticação da Anaplan: https://auth.anaplan.com

    2. Se você preferir o IDP configurado pelo Anaplan para fazer logon no Anaplan, insira as seguintes URLs e selecione OK.

      URL da API da Anaplan: https://api.anaplan.com

      URL da Autenticação da Anaplan: https://us1a.app.anaplan.com

    3. Selecione OK.

  2. Na próxima caixa de diálogo Anaplan, escolha Conta básica ou organizacional (que aciona o IDP configurado pelo Anaplan).

    Caixa de diálogo de autenticação do Anaplan. As setas mostram as opções de menu Conta Básica ou Institucional (IDP configurado pelo Anaplan).

Autenticar

Você escolheu a autenticação básica ou IDP configurado pelo Anaplan.

  1. Se você optar pela autenticação Básica, na caixa de diálogo Anaplan:

    1. Insira o Nome de Usuário e a Senha.

    2. Selecione Conectar.

    3. Continue na próxima etapa: Obter dados.

      A caixa de diálogo Anaplan Connect. Aqui você insere seu Nome de Usuário e Senha.

  2. Se você optar pela Conta organizacional (IDP configurado pela Anaplan), na caixa de diálogo Anaplan:

    1. Selecione Entrar.

    2. Em Bem-vindo(a) ao Anaplan, selecione Fazer logon com SSO (logon único).

      Caixa de diálogo Anaplan, com nome de usuário e senha, além de Entrar usando SSO na parte inferior.

    3. Na caixa de diálogo SSO da sua empresa, insira seu nome de usuário e senha.

    4. Selecione Entrar.

      Observação

      O serviço IDP configurado pelo Anaplan da sua empresa gera esta caixa de diálogo. Um serviço comum de gerenciamento de ID é o Okta.

      Caixa de diálogo de entrada do Okta. O Okta é um exemplo de uma provável ferramenta de gerenciamento de identidade.

    5. Selecione Conectar na próxima caixa de diálogo Anaplan.

      A caixa de diálogo Conectar do conector do Power BI ao Anaplan.

Executar uma ação de exportação do Power BI

O conector do Anaplan para Power BI utiliza exportações para descarregar dados do seu modelo do Anaplan. Verifique se você tem uma ação de exportação definida. A etapa do navegador é onde você carrega e executa essas exportações.

Ao executar uma ação de exportação:

  • Só há suporte para exportações que geram arquivos .csv e .txt.
  • Se você não encontrar a ação de exportação no conector do Power BI, verifique a sua função de modelo e as ações de exportação no seu modelo.

Para executar uma ação de exportação, use a caixa de diálogo Navegador para localizar a exportação.

Executar ação de exportação e carregamento.

  1. Pesquise seus modelos da Anaplan para localizar e definir a exportação.

    • Selecione a divisa branca, que se expande em uma lista suspensa.
    • Você também pode localizar o nome do seu modelo usando o campo de pesquisa.

  2. Marque a caixa ao lado de ƒx Executar Ação de Exportação para selecionar sua exportação.

    • Quando você seleciona ƒx Executar ação de exportação, esta seleção não aciona a execução de exportação. Em vez disso, essa seleção baixa a última versão dos dados da Anaplan exportados para visualização.
    • Uma visualização é exibida no painel à direita. Se a exportação do Anaplan estiver definida como Somente administradores, os usuários do modelo poderão ver uma visualização em branco, mas a exportação será executada normalmente.
    • Você terá acesso à visualização na próxima vez que definir uma integração com a mesma exportação.

  3. Selecione Carregar, que inicia a exportação. A caixa de diálogo Carregar é exibida.

Seus dados são carregados.

Gerencie seus dados

Depois que seus dados forem carregados no Power BI Desktop, você poderá realizar visualizações de dados.

Como aproveitar ao máximo a visualização de dados ajuda você a selecionar Colunas, aplicar Filtros, realizar Visualizações e Publicar.

Dados e tabelas.

Publicar um relatório no serviço Power BI

A etapa de publicação envia o relatório do Power BI Desktop para o serviço do Power BI.

Mais informações: Criar relatórios no Power BI. Você precisa de um relatório para começar.

Para publicar um relatório no serviço Power BI, selecione Publicar na caixa de diálogo de relatório do Power BI Desktop.

Caixa de diálogo de relatório do Microsoft Power BI com um menu à esquerda que exibe a opção Publicar. O relatório agora está no serviço do Power BI. Entre no serviço do Power BI para ver o relatório.

Agendar uma atualização (serviço do Power BI)

Depois de criar um modelo semântico no serviço do Power BI, você poderá agendar uma atualização de dados.

Primeiro, crie um relatório no Power BI Desktop. Mais informações: Criar relatórios no Power BI.

Para atualizar o modelo semântico:

  1. Selecione Adicionar fonte de dados (canto superior esquerdo da caixa de diálogo).

  2. Selecione nas listas suspensas Tipo de fonte de dados e Informações da fonte de dados.

  3. Escolha Aplicar.

A caixa de diálogo Nova fonte de dados da Microsoft. As setas apontam para o próprio botão e duas listas suspensas.

Esta imagem exibe um modelo semântico de exemplo chamado Nova fonte de dados.

Na caixa de diálogo Anaplan:

  1. Selecione OAuth2 no menu suspenso Método de autenticação.

  2. Selecione Entrar.

    A caixa de diálogo do método de Autenticação do Anaplan com um menu suspenso e o botão Entrar.

Depois de criar uma atualização agendada no serviço do Power BI:

  • Se a frequência de atualização programada for superior a 15 dias, você deverá inserir novamente suas credenciais de logon antes do final do 15º dia. Caso contrário, você precisará autenticar novamente.
  • Recomendamos uma frequência de atualização inferior a 15 dias.
  • Além das atualizações de dados, você precisa inserir novamente suas credenciais de logon a cada 90 dias.

Limites, considerações e solução de problemas

Você pode receber mensagens de erro. Aqui estão alguns cenários comuns e etapas para resolução.

Se você receber uma mensagem de erro, selecione o ícone de atualização. Esta atualização resolve o erro na maioria dos casos.

Erro de credencial no Navegador

We couldn't authenticate with the credentials provided, please try again.

Para resolver esse erro:

  1. Selecione Atualizar (canto superior direito).

    Erro de autenticação. Esta imagem mostra uma seta para realçar o botão de atualização.

  2. Selecionar Arquivo.

  3. Selecione Opções e configurações.

  4. Selecione Configurações de fonte de dados.

  5. Selecione a permissão Anaplan Connector na lista.

  6. Selecione Limpar permissões.

  7. Selecione Excluir.

Estas etapas removem tokens de API do Anaplan expirados. Você deve autenticar novamente para continuar.

Erro de credenciais no editor do Power Query

Você pode enfrentar um erro de credencial no Editor do Power Query ao reabrir um relatório do Power BI ou ao editar um conjunto de dados anterior.

Para resolver esse erro, selecione Fechar e Aplicar ou Atualizar Visualização.

Erro do Power Query. Seus dados são atualizados.

Lista de integração, erro de exibição

Solução: se você não vir sua lista completa de integrações depois de mudar seu Espaço de trabalho, é possível:

  • Selecione o botão atualizar ao lado de Integrações.
  • Atualize seu navegador.

Também é possível:

  1. Selecione Fontes recentes.

    Selecionar fontes recentes.

  2. Selecione Mais.

  3. Clique com o botão direito na conexão.

  4. Selecione Remover da lista.

    Remover fonte da lista.

  5. Conecte-se à exportação novamente. Seus dados são atualizados.

    Ícones Fechar e Aplicar e Atualizar visualização.

Erro de expressão do Power Query

Expression.Error: The key didn't match any rows in the table.

Selecione Atualizar Visualização.

Erro do Power Query Chave e Tabela. As primeiras 1.000 linhas de dados são exibidas.

Atualizar visualização. Mais informações: Funções de expressão M do Power Query

Erro de download de arquivo grande

Se você ultrapassar o limite de tamanho de 5 gigabytes (GB), receberá o erro a seguir.

Anaplan connector supports file downloads up to 5 GB in size.

Mensagem de erro quando um arquivo é muito grande. Volte ao seu modelo do Anaplan, diminua o tamanho do seu arquivo e tente novamente.