Visuais do Power BI certificados

2025-04-30

Visuais certificados do Power BI são visuais do Power BI no AppSource que atendem aos requisitos e testes de código da equipe do Microsoft Power BI. Os testes executados são projetados para verificar que o componente visual não utiliza serviços ou recursos externos. Porém, a Microsoft não é a autora de visuais personalizados de terceiros e recomenda aos clientes contatar o autor diretamente para verificar a funcionalidade destes recursos visuais.

Visuais certificados do Power BI podem ser usados como qualquer outro visual do Power BI. Eles oferecem mais funcionalidades do que os visuais não certificados. Por exemplo, você pode exportá-los para o PowerPoint ou exibir o visual em emails recebidos quando um usuário assina páginas de relatório.

O processo de certificação é opcional. Cabe aos desenvolvedores decidir se querem sua certificação visual. Os visuais do Power BI que não são certificados não são necessariamente inseguros. Alguns visuais do Power BI não são certificados porque não estão em conformidade com um ou mais dos requisitos de certificação. Por exemplo, um visual do mapa do Power BI que se conecta a um serviço externo ou um visual do Power BI que usa bibliotecas comerciais não pode ser certificado.

Remoção da certificação

A Microsoft se reserva o direito de remover um visual da lista certificada, a seu critério.

Requisitos de certificação

Para certificar seu visual do Power BI, ele deverá atender os requisitos listados nesta seção.

Requisitos gerais

Seu visual do Power BI precisa ser aprovado pelo Partner Center. Antes de solicitar a certificação, recomendamos que você publique seu visual do Power BI no AppSource. Para saber como publicar um visual do Power BI no AppSource, consulte Publicar visuais do Power BI no Partner Center.

Antes de enviar seu visual do Power BI para certificação, verifique se:

O visual não é um R-visual
O visual está em conformidade com as diretrizes para visuais do Power BI
O visual foi aprovado em todos os testes necessários
O pacote compilado corresponde exatamente ao pacote enviado

Requisitos do repositório de códigos

Embora não seja necessário compartilhar publicamente seu código no GitHub, o repositório de códigos deverá estar disponível para análise da equipe do Power BI. A melhor maneira de fazer isso é fornecendo o código-fonte (JavaScript ou TypeScript) no GitHub.

O repositório deve conter:

Código para apenas um visual do Power BI. Ele não pode conter o código de vários visuais do Power BI nem de códigos não relacionados.
Uma ramificação chamada certification (é necessário usar letras minúsculas). O código-fonte nessa ramificação deve corresponder ao pacote enviado. Esse código só poderá ser atualizado durante o próximo processo de envio, se você estiver reenviando seu visual do Power BI.

Se seu visual do Power BI usar pacotes npm privados ou submódulos git, você também deverá fornecer acesso aos repositórios que contêm esse código.

Para entender a aparência de um repositório de visuais do Power BI, examine o repositório do GitHub do gráfico de barras de exemplo de visuais do Power BI.

Requisitos de arquivo

Use a versão mais recente da API para gravar o visual do Power BI.

O repositório deve incluir os seguintes arquivos:

.gitignore – Adicionar node_modules.tmp e, dist a este arquivo. O código não pode incluir as pastas node_modules, .tmp ou dist .
capabilities.json - Se você estiver enviando uma versão mais recente de um visual existente do Power BI com alterações nas propriedades neste arquivo, verifique se elas não interrompem relatórios para usuários existentes.
pbiviz.json
package.json. O visual deve ter os seguintes pacotes instalados:
- "typescript"
- "eslint"
- "eslint-plugin-powerbi-visuals"
- O arquivo deve conter um comando para a execução do linter – "eslint": "npx eslint . --ext .js,.jsx,.ts,.tsx"
package-lock.json
tsconfig.json

Requisitos de comando

Os comandos a seguir não devem retornar erros.

npm install
pbiviz package
npm audit – não deve retornar qualquer aviso de nível alto ou moderado.
ESlint com a configuração necessária. Esse comando não deve retornar erros de lint.

Requisitos de compilação

Use a versão mais recente do powerbi-visuals-tools para gravar o visual do Power BI.

Faça a compilação do visual do Power BI com pbiviz package. Se estiver usando seus próprios scripts de compilação, forneça um comando personalizado de compilação npm run package.

Dica

A partir da versão 6.1.0 do powerbi-visuals-tools, você pode verificar seu visual para chamadas não seguras a fetch, XMLHttpRequest e eval usando o seguinte comando:pbiviz package --certification-audit Se algum código não seguro for detectado durante a auditoria, você poderá criar automaticamente um pacote com as correções necessárias executando: pbiviz package --certification-fix

Requisitos do código-fonte

Siga a lista de políticas adicionais de certificação de visuais do Power BI. Se o envio não seguir essas diretrizes, você receberá um email de rejeição do Partner Center com os números da política listados nesse link.

Siga os requisitos de código listados aqui para garantir que seu código esteja alinhado com as políticas de certificação do Power BI.

Obrigatório

Use apenas componentes públicos OSS analisáveis, como bibliotecas JavaScript ou TypeScript públicas.
O código deve dar suporte à API de Eventos de Renderização.
Verifique se o DOM é manipulado com segurança. Use a limpeza para os dados do usuário ou a entrada do usuário, antes de adicioná-lo ao DOM.
Use o relatório de exemplo como um conjunto de dados de teste.

Não permitido

Acesso a serviços ou recursos externos. Por exemplo, nenhuma solicitação HTTP/S ou WebSocket pode sair do Power BI para outros serviços. Portanto, os privilégios do WebAccess devem estar vazios ou omitidos nas configurações de funcionalidades.
Uso de XMLHttpRequest ou fetch.
Uso de innerHTML ou D3.html(user data or user input).
Erros ou exceções de JavaScript no console do navegador, para qualquer dado de entrada.
Código arbitrário ou dinâmico, como eval(), uso inseguro de settimeout(), requestAnimationFrame(), setinterval(user input function) e entrada do usuário ou dados do usuário.
Arquivos ou projetos reduzidos do JavaScript.

Enviar um visual do Power BI para certificação

Agora você está pronto para enviar uma solicitação para ter seu visual do Power BI certificado pela equipe do Power BI.

Dica

O processo de certificação do Power BI pode demorar um pouco. Se você estiver criando um novo visual do Power BI, recomendamos que o publique por meio do Partner Center antes de solicitar a certificação do Power BI. Isso garante que a publicação do visual não seja adiada.

Para solicitar a certificação do Power BI:

Conecte-se ao Partner Center.
Na página Visão geral, escolha seu visual do Power BI e vá para a página de configuração do Produto .
Marque a caixa de seleção Solicitar certificação do Power BI .
Na página Revisar e publicar , na caixa de texto Anotações para certificação , forneça um link para o código-fonte e as credenciais necessárias para acessá-lo.

Processo de envio de repositório privado

Se você estiver usando um repositório particular, como o GitHub, para enviar seu visual do Power BI para certificação, siga as instruções nesta seção.

Crie uma nova conta para a equipe de validação.
Configure a autenticação de dois fatores para sua conta.
Gere um novo conjunto de códigos de recuperação.
Ao enviar o visual do Power BI, você precisa fornecer os seguintes detalhes:
- Um link para o repositório
- Credenciais de conexão (incluindo uma senha)
- Códigos de recuperação
- Permissões somente de leitura para nossa conta (pbicvsupport)

Selos de visuais certificados do Power BI

Quando um visual do Power BI é certificado, ele recebe um selo que indica essa certificação.

Visuais certificados do Power BI no AppSource

Quando alguém pesquisa online por visuais do Power BI no AppSource, um pequeno selo amarelo no cartão do visual indica que ele é um visual certificado do Power BI.
Quando o cartão visual do Power BI é clicado no AppSource, um selo amarelo intitulado PBI Certified indica que esse visual do Power BI é certificado.

Visuais certificados do Power BI na interface do Power BI

Ao importar um visual do Power BI, de dentro do Power BI (Desktop ou serviço), um selo azul indicará que este visual é certificado.
Você só pode exibir visuais certificados do Power BI selecionando a opção de filtro Certificado do Power BI .

Linha do tempo da publicação

O processo de implantação no AppSource pode levar tempo. Seu visual do Power BI estará disponível para download no AppSource quando esse processo for concluído.

Quando os usuários poderão baixar meu visual?

Se você enviou um novo visual do Power BI, ele estará disponível para download no link do AppSource dentro de algumas horas. No entanto, leva mais de 10 a 14 dias para chegar à produção e ficar disponível no Power BI Desktop/Serviço.
Se você enviou uma atualização para um visual existente do Power BI, a nova versão também será exibida no AppSource, mas levará até duas semanas para ser implantada no ambiente de produção.

Observação

O campo de versão no AppSource será atualizado com o dia em que o Power BI foi aprovado pelo AppSource, aproximadamente uma semana depois que você enviou seu visual. Os usuários poderão baixar o visual atualizado, mas os recursos atualizados não entrarão em vigor. As novas funcionalidades do visual afetarão os relatórios do usuário após cerca de duas semanas.

Quando meu visual do Power BI exibirá uma notificação de certificação?

O selo de certificação deve estar visível em até três semanas após a aprovação do envio.

Mais perguntas? Experimente a Comunidade do Power BI.

Compartilhar via