Compartilhar via


Integração do Git a relatórios paginados

APLICA-SE A: Serviço do Power BI Power BI Report Builder Power BI Desktop

Este artigo explica como publicar um relatório paginado e mantê-lo em sincronia com seu workspace do Git. Os desenvolvedores podem aplicar seus processos de desenvolvimento, ferramentas e práticas recomendadas.

Pré-requisitos

Para integrar o Git ao seu espaço de trabalho do Microsoft Fabric, você precisará configurar os pré-requisitos a seguir no Fabric e no Git.

Pré-requisitos do Fabric

Para acessar o recurso de integração do Git, você precisa de um dos itens a seguir:

Além disso, as seguintes opções de locatário devem ser habilitadas no portal do administrador:

Essas opções podem ser habilitadas pelo administrador de locatários, pelo administrador de capacidade ou pelo administrador do espaço de trabalho, dependendo das configurações da organização.

Pré-requisitos do Git

Atualmente, a integração do Git é compatível com o Azure DevOps e o GitHub. Para usar a integração do Git com seu espaço de trabalho do Fabric, você precisa do seguinte no Azure DevOps ou no GitHub:

  • Uma conta ativa do Azure registrada para o mesmo usuário que está utilizando o espaço de trabalho do Fabric. Criar uma conta gratuita.
  • Acesso a um repositório existente.

Leia sobre a integração do Git com o Microsoft Fabric em Introdução à integração do git.

Pré-requisitos do Power BI

Consulte a seção Pré-requisitos na Introdução à criação de relatórios paginados no serviço do Power BI.

Adicionar um gráfico a um relatório paginado

  1. Conecte seu espaço de trabalho ao repositório git seguindo as instruções em Conectar um espaço de trabalho a um repositório do Azure.

    Captura de tela das informações para se conectar ao workspace.

    Observação

    Se o branch for novo, você será solicitado a Criar e sincronizar.

  2. Carregue o arquivo .rdl no workspace no serviço. Ainda não há suporte para o OneDrive ou Sharepoint.

    Captura de tela do botão Carregar.

    Depois de carregar o arquivo, você deverá ver o relatório e o status do Git Não confirmados e de Controle do código-fonte.

    Captura de tela do status.

  3. Selecione Controle do código-fonte. No painel de controle do código-fonte, selecione o arquivo e confirme.

    Captura de tela do Commit.

    Depois de confirmar o arquivo, o status do Git será alterado para Síncrono.

    Captura de tela do Git sincronizado.

    Uma pasta aparece no repositório git que contém .rdl e dois arquivos .json. Talvez seja necessário atualizar o repositório.

    Captura de tela do repositório Git.

Editar um relatório paginado salvo no GitHub

  1. Abra o arquivo .rdl no repositório git local no Power BI Report Builder.
  2. Faça as edições desejadas.
  3. Faça commit das alterações e efetue push delas para o repositório remoto.
  4. Criar uma PR para a ramificação principal.
  5. Depois de aprovada, a PR é mesclada à ramificação principal.
  6. No branch principal, aplique as alterações revisadas ao workspace relevante.

Considerações e limitações

  • Publique/carregue o relatório paginado no serviço e use o Git. Os relatórios paginados não serão renderizados se você começar com os arquivos no git.

  • Ao excluir um relatório paginado do Git, exclua toda a pasta e não apenas o relatório .rdl.

  • Renomear um relatório paginado no git não funciona. No entanto, renomear o .rdl no serviço do Power BI realmente funciona. Para renomear o relatório paginado, exclua-o do git, exclua a pasta inteira e recrie a pasta com o .rdl com o novo nome.

  • O relatório paginado permanece conectado ao conjunto de dados original quando você o move para um workspace diferente. Se você mover um relatório paginado para um espaço de trabalho diferente, atualize o conjunto de dados no construtor de relatórios do Power BI e republique o relatório paginado no serviço do Power BI.

Próximas etapas