𝘛𝘦𝘤𝘩 𝘚𝘰𝘭𝘶𝘵𝘪𝘰𝘯 𝘏𝘶𝘣

Antes de avançarmos vou explicar de forma resumida todo fluxo:

Extrair

Vamos pegar o PBIX/PBIT e o transforma em uma pasta (arquivos legíveis e versionáveis).

Organizar fonte

A pasta extraída _{^{(ex.: src/Relatorio)}} passa a ser o código-fonte do seu relatório/dataset. Aqui é onde você faz ajustes de medidas, partições, parâmetros, layouts , como se fosse um projeto Visual Studio.

Revisar e padronizar

Valide nomes de tabelas/medidas, parâmetros de conexão, traduções e pastas. Garanta convenções ^{(estrutura src/ para fonte e dist/ para artefatos gerados)}.

Compilar para validar

Gere um artefato de teste:

• PBIT quando há modelo/dataset;
• PBIX para thin report (sem modelo).
  Abrir o artefato no Desktop confirma que a fonte está íntegra.

Preparar o commit
Inclua apenas o fonte no Git ^{(pasta src/)}. Artefatos de build (^{dist/, .pbix/.pbit gerados)} ficam fora com .gitignore, para evitar ruído no histórico.

Commit & Push para o Azure DevOps
Crie/atualize sua branch, escreva uma mensagem de commit clara e faça push para o repositório remoto no DevOps. O commit aparece lá e pode disparar o pipeline.

PR e automação
Abra um Pull Request para revisão. O pipeline pode recompilar a partir do src/ e, se aprovado, publicar no Power BI Service (deploy), mantendo o processo reprodutível e auditável.

Vamos extrair o conteúdo para uma estrutura Pbix versionável. Você também pode usar -watch para re-extrair a cada “Salvar” no Desktop.

Extrair PBIX/PBIT → Pbix

pbi-tools extract .\Relatorio.pbix -extractFolder .\src\Relatorio

Compilar uma pasta PbixProj → PBIX/PBIT

# gerar PBIT
pbi-tools compile ".\src\Relatorio" -format PBIT -outPath ".\dist\Relatorio.pbit" -overwrite


pbi-tools compile ".\src\ReportOnly" -format PBIX -outPath ".\dist\Report.pbix" -overwrite

Em resumo: PBIX/PBIT fechado → (extract) código-fonte legível → (compile) validação determinística → (commit/push) controle de versão e CI/CD no Azure DevOps (Deploy automatizado – Espero trazer esse assunto em breve).

Dicas

• Verifique a instalação/ambiente:

pbi-tools info