As regras desta página vêm de quatro fontes:
| Fonte | Cobre | Regras |
|---|---|---|
| Best Practice Rules da Microsoft (licença MIT) | Modelo semântico: Performance, Expressões DAX, Prevenção de Erros, Manutenção, Nomenclatura e Formatação | 62 |
| PBI-Inspector, de Nat Van Gulck (licença MIT) | Relatório: as regras base de Relatórios e Visuais | 11 |
| Best Practices Analyser do Measure Killer (Gregor Brunner) | Extensões: pizza e rosca, medidas implícitas e indicadores; e "Evite colunas calculadas com definições duplicadas" | 4 |
| Storytelling with Data, de Cole Nussbaumer Knaflic, e Information Dashboard Design, de Stephen Few | Storytelling e Comunicação: checklist de revisão manual | 13 |
O PBI-Inspector é um projeto da comunidade, sem suporte da Microsoft. O suporte ao formato PBIR está no repositório PBI-Inspector V2.
Como ler a severidade
A severidade usa a escala de 1 a 3 do Best Practice Analyzer:
| Na página | No Best Practice Analyzer | O que fazer |
|---|---|---|
| Alta | 3 | Corrija antes de publicar: quebra o modelo, falha no deploy ou dá resultado errado |
| Média | 2 | Corrija no próximo ciclo de manutenção |
| Baixa | 1 | Recomendação; aplique quando fizer sentido |
As regras de modelo seguem o valor oficial da Microsoft. As regras de relatório seguem a severidade usada pelo Measure Killer. As regras de Storytelling e Comunicação não são pontuadas por ferramentas: a severidade indica a prioridade na revisão.
Adaptações para o Brasil e para o Full HD
- Formato de data: a regra de colunas de data usa
dd/mm/yyyy. A Microsoft usamm/dd/yyyyna correção automática da regra. - Categorias: "Avalie se RLS dinâmico é realmente necessário" é oficialmente de Performance, e "Corrija violações de integridade referencial" é de Manutenção. Aqui as duas estão em Prevenção de Erros. O ID oficial aparece na fonte de cada regra.
- Página Full HD, sem rolagem: rolagem vertical continua não recomendada. O que mudou foi o tamanho padrão da página, de HD (1280 × 720) para Full HD (1920 × 1080). O PBI-Inspector e o Measure Killer ainda verificam 720 px; em relatórios Full HD, ajuste o parâmetro para 1080 ou desconsidere esse alerta.
Rodar as regras no seu modelo e no seu relatório
As regras da Microsoft rodam de forma automática no Best Practice
Analyzer do Tabular Editor: carregue o BPARules.json e execute contra o
modelo aberto ou contra a pasta TMDL de um projeto .pbip. As regras de
relatório rodam no PBI-Inspector ou no Best Practices Analyser do Measure
Killer, que também verifica o modelo. Para rodar por linha de comando num
pipeline de CI/CD, veja a skill bi-qa-documentacao em
Skills de IA.