Introdução
Este guia foi elaborado para ajudá-lo a implementar com facilidade o modelo de cadeia “Power BI: Carregar dados no Power BI”. Seja para carregar novos dados, atualizar dados existentes ou remover dados do seu Espaço de Trabalho do Power BI, este modelo pode ajudá-lo nessa jornada. Ele fornece instruções claras sobre como definir as permissões necessárias para a configuração do Power BI, as permissões da API do aplicativo e as diversas vantagens de usar o Chain Template. Seguindo este guia, você poderá garantir um processo de implementação tranquilo e eficiente, tornando suas tarefas com dados no Power BI mais fáceis e eficazes.
Pré-requisitos
Correntes
- Os seguintes conectores devem ser ativados e configurados em seu espaço de trabalho:
Dados
- É necessário um arquivo CSV com os dados (O arquivo CSV não deve conter Byte Order Mark)
- É essencial ter uma lista dos nomes das colunas e dos respectivos tipos de dados
Informações adicionais sobre a configuração do Power BI
- Verifique se a conta do usuário possui uma licença do Power BI Pro do tipo “ ” ou superior, com permissões para realizar alterações na conta do Azure
- Faça login no Portal do Azure “ ”
- Selecione o locatário “ ” do Microsoft Entra , escolhendo sua conta no canto superior direito da página
- Selecione “ ” > “App Registrations” .
-
- Em “Registros de aplicativos”, selecione “ ar novo registro”
-
- Preencha os seguintes campos:
- Nome - Dê um nome ao seu aplicativo
- Tipo de conta compatível — Selecione quem pode usar o aplicativo
- Preencha os seguintes campos:
-
- Selecione . Cadastre-se em . Após o registro do seu aplicativo, você será redirecionado para a página de visão geral do seu aplicativo
- Na página de visão geral, identifique o aplicativo (ID do cliente) e o ID do locatário e guarde essas informações em um local seguro; você precisará delas para conectar o Workiva ao Power BI
Permissões da API para o Power BI
- Ajuste as permissões do aplicativo Power BI por meio do painel à direita
- Expandir Gerenciar
- Acesse as permissões da API
- Certifique-se de que as seguintes permissões de API estejam selecionadas.
- Certifique-se de que as seguintes permissões de API estejam selecionadas.
URIs de redirecionamento
- Ajuste as permissões do aplicativo Power BI por meio do painel à direita
- Expandir Gerenciar
- Acesse a seção “Autenticação”
| Campo | Valor |
|---|---|
| URI do Azure | https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback |
| Campo | Valor |
|---|---|
| URI do Azure | https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback |
| Campo | Valor |
|---|---|
| URI do Azure | https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback |
| Campo | Valor |
|---|---|
| URI do Azure | https://h.ca.wdesk.com/s/wdata/oc/app/oauth/callback |
Depois de configurar corretamente as permissões do Power BI, consulte o guia “ : Conector para o Power BI” ( ) para configurar o conector do Power BI.
Implantar a cadeia
O modelo “ ” do Power BI: Carregar dados no Power BI está localizado na seção “Workiva Chains” da tela “Modelos”.
Veja como encontrá-lo:
- No Construtor de Cadeia, acesse a guia Modelos
- Selecione Cadeias Workiva no menu na parte superior
- Pesquise “ ” no Power BI: Carregar dados no Power BI Clique no modelo “Chain” no canto superior direito e abra o modelo
Depois de localizar seu modelo, configure -o para sua área de trabalho usando as entradas de tempo de execução listadas abaixo.
Observação: Para obter instruções detalhadas sobre como criar uma cadeia a partir de um modelo, consulte o artigo “Criar e gerenciar cadeias” ( ) em .
Observação: Este usuário de integração requer permissões apropriadas para os comandos que o conector executa, como proprietário das planilhas ou do espaço de trabalho com o qual interage.
Entrada de tempo de execução
| Entrada de tempo de execução | Descrição | Tipo de campo | Necessário? |
| ID do Espaço de Trabalho do PBI | Esta é a variável que armazenará o ID do espaço de trabalho do Power BI. O ID é destinado a espaços de trabalho distintos do seu espaço de trabalho pessoal do PBI. Ele está localizado após “/group/” na URL. | TextField | Sim |
| ID do conjunto de dados PBI | Esta é a variável que contém o ID do conjunto de dados PBI existente. Isso pode ser encontrado no PBI, após “/datasets/” na URL. Este é o conjunto de dados que desejamos atualizar com novos dados ou excluir. | TextField | Não |
| Nome da tabela PBI | Este é o nome da tabela no conjunto de dados à qual você deseja adicionar dados no Power BI. | TextField | Sim |
| Arquivo de dados | Arquivo CSV que você deseja importar para o Power BI. | FileField | Não |
| Adicionar ao conjunto de dados existente, criar um novo ou excluir o conjunto de dados |
Opção de adicionar dados a um conjunto de dados existente no Power BI, criar um novo conjunto de dados para carregar os dados ou excluir um conjunto de dados. Opções
|
Campo suspenso | Sim |
Mais informações sobre a rede
Para executar o processo de cadeias de forma eficaz e começar a ver resultados, o espaço de trabalho do Power BI associado precisará estar alinhado com as respectivas variáveis dentro do Chains.
Veja a seguir como inserir os IDs das tabelas em suas respectivas entradas de tempo de execução no guia “ ” do Power BI: Carregar dados no Power BI Chain
- Acesse sua cadeia de dados habilitada no Power BI: Carregar dados no Power BI .
- Edite as entradas de tempo de execução clicando duas vezes no comando
- Atualize os respectivos IDs de tabela e IDs de área de trabalho localizados no Power BI no comando “Runtime Inputs”
Observação: . Esteja ciente de que este modelo requer um usuário adicional em um comando a jusante em um pipeline.
No comando “Criar Conjunto de Dados”, o usuário precisará inserir e configurar as colunas do conjunto de dados e os respectivos tipos de dados antes de prosseguir com a execução da cadeia.
- Edite a opção “Criar conjunto de dados” clicando duas vezes no comando
- Em “Colunas”, selecione “ADICIONAR” e preencha os campos “Nome” e “Tipo de dados” das colunas.
Observação: Certifique-se de substituir a primeira coluna “CHANGE_ME” antes de prosseguir. Cada comando permite apenas 70 colunas. Tabelas com mais de 70 colunas precisarão ser reunidas novamente no Power BI.
Solução de problemas
As etapas a seguir podem ser usadas para solucionar problemas com o modelo de cadeia:
Erros de execução de cadeia
Arquivo CSV contendo a marca de ordem de bytes (BOM)
Os comandos do Power BI não conseguem carregar e processar arquivos CSV com lista de materiais (BOM). Para remover o BOM, consulte as seguintes dicas de solução de problemas:
Para o Visual Studio Code ( , VS Code):
- Abra seu arquivo CSV no VS Code.
- Clique na codificação exibida no canto inferior direito da janela (pode estar escrito “UTF-8 com BOM”).
- Aparecerá um menu suspenso. Selecione UTF-8. Isso geralmente remove a lista de materiais (BOM) no próximo salvamento. Talvez seja necessário acessar Arquivo > Salvar como e verificar se a opção “UTF-8” está selecionada no menu suspenso de codificação.
Para o Notepad++ (Windows):
- Abra seu arquivo CSV no Notepad++.
- Vá até o menu “Codificação” na barra de ferramentas superior.
- Selecione “Converter para UTF-8 sem BOM”.
- Salve o arquivo (Arquivo > Salvar).