Microsoft Integração com Power BI (Prévia) #
As saídas dos relatórios podem ser acessadas diretamente via Microsoft Power BI usando a tradução REST API. Isso permite que os relatórios de comunicações sejam combinados com outras fontes de dados usando a plataforma Power BI.
info
Para acessar relatórios via Power BI, o REST API deve estar ativado nas contas de revendedor e cliente. Por favor, consulte a API Documentation para mais informações.
warning
Atualmente, o conector não é suportado nativamente no serviço PowerBI, então os relatórios precisam ser criados e atualizados usando o Power BI Desktop. Uma vez finalizado o conector, o suporte ao serviço PowerBI será adicionado.
O On-Premise Gateway pode ser usado para atualizar relatórios publicados.
Instalação #
Download do Conector Personalizado #
~.Dimensions.~ fornece um conector personalizado que deve ser instalado manualmente no Power BI Desktop para permitir o acesso aos relatórios. Dependendo da versão do Power BI instalado, o conector personalizado é instalado manualmente de duas formas:
warning
A tradução do ~.Dimensions.~ O conector personalizado do Power BI está atualmente em BETA. Uma vez finalizado o conector, ele estará disponível no marketplace oficial Microsoft Power BI.
- Baixe a versão mais recente da tradução ~.Dimensions.~ Power BI custom connector.
- Copie o arquivo para a sua pasta 'Documents\Power BI Desktop\Custom Connectors' no seu computador:

note
Se as pastas 'Power BI Desktop \ Custom Connectors' não existirem, elas precisarão ser criadas manualmente.
warning
Se você configurou o OneDrive para sincronizar sua pasta Documentos, certifique-se de colocar o Conector Personalizado na pasta Documentos do OneDrive.
Uma vez que o conector personalizado tenha sido copiado para o local correto, o Power BI Desktop deve ser configurado para permitir conectores não certificados.
Ativar Conector Personalizado Side-loading #
- Abra o Power BI Desktop, depois navegue até Opções de Arquivo -> e Configurações -> Opções.
- Em 'Extensão de Dados de Segurança ->', selecione 'Permitir que qualquer extensão carregue sem validação ou aviso'.
- Reinicie o Power BI Desktop para aplicar as mudanças.
~.Dimensions.~ Configuração do Conector #
Para completar essa etapa, você precisará do ID do cliente e do segredo do cliente da configuração REST API.
- Abra o Power BI Desktop e selecione a opção 'Obter Dados' na fita de vídeo.
![]()
- Procure por '~.Dimensions.~' na caixa de busca.

- Selecione o '~.Dimensions.~ Analytics' conector, então pressione 'Conectar'.
- Selecione a região correta na lista suspensa.

- Insira a configuração 'ID do Cliente' e 'Secret do Cliente' da configuração REST API.

- Pressione 'OK' para conectar.
Se o id do cliente e o segredo forem válidos, a conexão será feita e uma consulta será retornada - NÃO PRESSIONE 'Load' pressione 'Transform Data'. Siga os próximos passos para selecionar os dados do relatório que deseja importar ao transformar a consulta.
note
Se estiver no passo '2' o '~.Dimensions.~ Analytics' não aparece nos resultados de busca, verifique se o conector personalizado foi copiado para o local correto e se o Power BI Desktop foi reiniciado.
Transformando Dados #
- Selecione 'Transformar Dados' para abrir o Power Query Editor.
Você deve estar presente com uma lista de 'Workspaces' disponíveis na conta.
- Clique no link 'Table' na coluna 'Lista de Relatório' do espaço de trabalho que deseja acessar.

Agora você deve receber uma lista de relatórios disponíveis no espaço de trabalho selecionado.
- Clique no link 'Função' na coluna 'Relatório de Dados' para o relatório que deseja acessar.

*Agora você deve receber o pop-up 'Parâmetros Ener'.

-
Selecione um dos intervalos de datas contextuais pré-definidos ou selecione 'Custom' e insira um intervalo fixo. Depois, pressione 'OK'
-
Renomeie a consulta para um nome significativo para o relatório que você está acessando.

- Pressione 'Fechar & Aplicar' para carregar os dados no Power BI Desktop.

A fonte de dados agora deve estar disponível na janela principal do Power BI Desktop e pode ser usada como qualquer outra fonte de dados para criar relatórios e painéis.
note
Repita os passos acima para adicionar relatórios adicionais conforme necessário.
Atualizando API Credenciais #
Se o ID do cliente ou o segredo API precisar ser atualizado, isso pode ser feito navegando até 'Data Source Settings' no Power BI Desktop.

Atualizações de Esquema #
Se campos foram adicionados ou removidos do(s) relatório(s) que estão sendo executados pelo Power BI, o esquema de consulta pode precisar ser atualizado para refletir as mudanças.
Para isso, clique com o botão direito no Query no painel direito do Power BI, depois selecione 'Refresh -> Schema' no menu suspenso.

note
Solicitações de lista de workspace e de relatórios podem ser armazenadas em cache por até 1 hora. Se novos relatórios ou espaços de trabalho foram adicionados e não aparecem na lista, tente atualizar a fonte de dados ou esperar até uma hora para o cache expirar.
Erros #
Se forem encontrados erros ao abrir uma planilha com ~.Dimensions.~ dados ou atualizar os dados, isso geralmente significa que há um problema com o esquema. Siga os passos da seção anterior para atualizar o esquema.
Se os campos foram removidos do relatório e ainda estiverem sendo referenciados na interface do Power BI, você precisará clicar em 'Corrigir isso' para remover os campos ausentes da consulta:
