Publicar na web do Power BI

Com a recurso Publicar na Web do Power BI, você pode inserir conteúdo interativo do Power BI com facilidade em postagens no blog, sites, emails ou mídia social. Você também pode editar, atualizar ou interromper o compartilhamento dos seus visuais publicados com facilidade.

Aviso

Quando você usa Publicar na Web, qualquer pessoa na Internet pode exibir seu relatório ou visual publicado. A exibição não exige nenhuma autenticação. Ela inclui a exibição de dados no nível de detalhes que os relatórios agregam. Antes de publicar um relatório, verifique se não há nenhum problema em compartilhar os dados e as visualizações publicamente. Não publique informações confidenciais nem proprietárias. Em caso de dúvida, verifique as políticas de sua organização antes da publicação.

Observação

Você pode inserir o conteúdo com segurança em um site ou um portal interno. Use as opções Inserir ou Inserir no SharePoint Online. Essas opções verificam se todas as permissões e a segurança de dados são aplicadas quando os usuários veem seus dados internos.

Pré-requisitos

  • Você precisa de uma licença do Microsoft Power BI para publicar na Web por meio de Meu workspace.
  • Você precisa de uma licença do Microsoft Power BI Pro ou Premium por Usuário para publicar na Web por meio de workspaces.
  • Publicar na web está disponível para relatórios que podem ser editados em "Meu Workspace" e workspaces.
  • Ele não está disponível para relatórios compartilhados com você ou para aqueles que dependem da Segurança em Nível de Linha para proteger os dados.
  • Os visualizadores do seu relatório não precisam ser usuários do Power BI.

Confira a seção Considerações e limitações abaixo para ver uma lista completa de casos em que o recurso Publicar na Web não tem suporte.

Criar códigos de inserção com o recurso Publicar na Web

Siga as etapas a seguir para usar Publicar na Web. Leia o Aviso indicado anteriormente neste artigo antes de publicar na Web.

  1. Abra um relatório em um workspace que você possa editar e selecione Arquivo>Inserir relatório>Publicar na Web (público) .

    Screenshot of Publish to web on More options.

  2. Se o administrador do Power BI não tiver concedido a você a permissão de criar códigos de inserção, você poderá precisar entrar em contato com ele.

    Screenshot of Contact your Power BI admin.

    Para obter ajuda e encontrar a pessoa que pode habilitar o recurso Publicar na Web na sua organização, confira Como encontrar o administrador do Power BI mais adiante neste artigo.

  3. Examine o conteúdo da caixa de diálogo e selecione Criar um código de inserção.

    Screenshot of Review Embed in a public website.

  4. Leia o aviso, conforme mostrado aqui, e confirme se os dados estão corretos para ser inseridos em um site público. Em caso afirmativo, selecione Publicar.

    Screenshot of dialog box with the warning

  5. Na caixa de diálogo Sucesso, você verá uma versão prévia de como o relatório será exibido. Selecione o tamanho e a página padrão.

    Você também pode adicionar um imagem de espaço reservado, para que a página da Web seja carregada mais rapidamente. Com uma imagem de espaço reservado, as pessoas que visualizam seu relatório na Web veem um botão Exibir conteúdo interativo que pode ser usado para exibir o próprio relatório.

    Faça essas alterações primeiro. Em seguida, copie o link para enviá-lo por email ou copie o HTML para colar em um site. Insira-o em um código como um iFrame ou cole-o diretamente em uma página da Web ou um blog.

    Screenshot of Success: a link and HTML.

  6. Se anteriormente você tiver criado um código de inserção para um relatório e selecionar o recurso Publicar na Web, você não verá as caixas de diálogo nas etapas 2 a 4. Em vez disso, você verá a caixa de diálogo Código de inserção.

    Screenshot of Embed code dialog box.

    Você pode criar apenas um código de inserção para cada relatório.

Dicas para modos de exibição

Quando você insere conteúdo em uma postagem no blog, normalmente é necessário ajustá-lo em um tamanho específico da tela. É possível ajustar a altura e a largura na marca iFrame conforme necessário. No entanto, é necessário verificar se seu relatório se ajusta à área fornecida do iFrame; portanto, defina um Modo de Exibição ao editar o relatório.

A tabela a seguir fornece diretrizes sobre o Modo de Exibição e como ele aparecerá quando for inserido.

Modo de Exibição Sua aparência quando inserido
Screenshot of Fit to page. Ajustar à página respeita a altura e a largura da página de seu relatório. Se você definir sua página para proporções dinâmicas como 16:9 ou 4:3, seu conteúdo será ajustado para caber no iFrame. Quando inserido em um iFrame, o uso de Ajustar à página pode resultar na aplicação do formato letterbox: uma tela de fundo cinza é mostrada nas áreas do iFrame depois que o conteúdo é dimensionado para caber no iFrame. Para minimizar a aplicação do formato letterbox, defina a altura e a largura do iFrame de modo condizente.
Screenshot of Actual size. Tamanho real verifica se o relatório preserva seu tamanho, conforme definido na página do relatório. Isso pode resultar na exibição de barras de rolagem no iFrame. Defina a altura e a largura do iFrame para evitar barras de rolagem.
Screenshot of Fit to width. Ajustar à largura verifica se o conteúdo preenche a área horizontal do iFrame. Uma borda ainda será mostrada, mas o conteúdo será dimensionado para usar todo o espaço horizontal disponível.

Dicas para altura e largura do iFrame

Um código de inserção da configuração Publicar na Web será parecido com o exemplo a seguir:

Screenshot of Embed code.

É possível editar a largura e a altura manualmente para verificar se o código se ajusta exatamente da forma como você deseja na página em que é inserido.

Para obter um ajuste mais perfeito, tente adicionar 56 pixels à altura do iFrame para acomodar o tamanho atual da barra inferior. Se sua página de relatório usar o tamanho dinâmico, a tabela abaixo fornecerá alguns tamanhos que podem ser usados para obter um ajuste sem a aplicação do formato letterbox.

Proporção Tamanho Dimensões (largura x altura)
16:9 Pequena 640 x 416 px
16:9 Médio 800 x 506 px
16:9 grande 960 x 596 px
4:3 Pequena 640 x 536 px
4:3 Médio 800 x 656 px
4:3 grande 960 x 776 px

Gerenciar códigos de inserção

Após criar um código de inserção no recurso Publicar na Web, será possível gerenciar seus códigos no menu Configurações no Power BI. O gerenciamento de códigos de inserção inclui a capacidade de remover o visual ou o relatório de destino de um código (tornando o código de inserção inutilizável) ou de obter o código de inserção.

  1. Para gerenciar seus códigos de inserção de Publicar na Web, abra o workspace no qual o relatório reside, selecione a engrenagem de Configurações e selecione Gerenciar códigos de inserção.

    Screenshot of Manage embed codes

  2. Os códigos de inserção para os relatórios nesse workspace são exibidos.

    Screenshot of list of embed codes.

  3. É possível recuperar ou excluir um código de inserção. Excluí-lo desabilita qualquer link para esse relatório ou visual.

    Screenshot of retrieving or deleting embed codes.

  4. Se você selecionar Excluir, será solicitado a confirmar.

    Screenshot of confirming deletion.

Atualizações em relatórios e atualização de dados

Depois de você criar seu código de inserção de Publicar na Web e compartilhá-lo, o relatório é atualizado com todas as alterações feitas. O link de código de inserção fica ativo imediatamente. Qualquer pessoa que abrir o link poderá vê-lo. Os dados são armazenados em cache por uma hora a partir do momento em que são recuperados. Não recomendamos o uso de Publicar na Web para dados que precisam ser atualizados com frequência. Para saber mais, confira a seção Como isso funciona posteriormente neste artigo.

Atualização de dados

As atualizações de dados são refletidas automaticamente no relatório ou visual inserido. Quando os dados são atualizados para um modelo de dados de importação no serviço do Power BI, o serviço limpa o cache de dados, fazendo com que os dados atualizem rapidamente. Para desabilitar a atualização automática, selecione não atualizar no agendamento do modelo semântico que o relatório usa.

Sobrecarregamento de uso

Uma experiência de sobrecarregamento de uso pode ocorrer quando um relatório recebe muitas consultas em um curto período de tempo. Quando ocorre um sobrecarregamento de uso, os usuários não podem exibir nem interagir com o relatório até que o período de sobrecarregamento passe.

É recomendável definir uma imagem de espaço reservado para o relatório. Se ocorrer um sobrecarregamento de uso, os usuários verão a imagem de espaço reservado.

Para ajudar a evitar a experiência de sobrecarregamento de uso, limite o número de consultas distintas que seu relatório pode gerar e a frequência de atualização de dados. Consulte o guia de otimização do Power BI para obter dicas sobre como simplificar seus relatórios.

Visuais do Power BI

Há suporte para visuais do Power BI no recurso Publicar na Web. Quando você usa o recurso Publicar na Web, os usuários com os quais você compartilha seu visual publicado não precisam habilitar os visuais do Power BI para ver o relatório.

Noções básicas sobre a coluna de status do código de inserção

Observação

Examine periodicamente os códigos de inserção que você publicou. Remova qualquer um que não precise mais estar disponível publicamente.

A página Gerenciar códigos de inserção inclui uma coluna de status. Por padrão, os códigos de inserção estão Ativos, mas também podem ter um dos status listados abaixo.

Status Descrição
Ativo O relatório está disponível para que os usuários da Internet o vejam e interajam com ele.
Bloqueado O conteúdo do relatório viola os Termos de Serviço do Power BI. A Microsoft o bloqueou. Entre em contato com o suporte se acreditar que o conteúdo foi bloqueado por engano.
Sem suporte O modelo semântico do relatório usa a Segurança em Nível de Linha ou outra configuração sem suporte. Confira a seção Considerações e limitações para ver uma lista completa.
Violado O código de inserção está fora da política de locatário definida. Normalmente, esse status ocorre quando um código de inserção foi criado e a configuração de locatário do recurso Publicar na Web foi alterada para excluir o usuário que tem o código de inserção. Se a configuração do locatário estiver desabilitada ou o usuário não tiver mais permissão para criar códigos de inserção, os códigos de inserção existentes mostrarão um status Violado. Confira a seção Encontrar o Administrador do Power BI neste artigo para obter detalhes.

Relatar um problema com o conteúdo de Publicar na Web

Para relatar um problema relacionado ao conteúdo de Publicar na Web inserido em um site ou um blog, selecione o ícone Compartilhar na barra inferior do relatório Publicar na Web, depois selecione o ícone Sinalizador na caixa de diálogo Compartilhar.

Screenshot of sharing a concern.

Você precisará enviar um email à Microsoft explicando o problema. A Microsoft avaliará o conteúdo com base nos Termos de Serviço do Power BI e tomará as devidas providências.

Como isso funciona (detalhes técnicos)

Quando você cria um código de inserção usando Publicar na Web, o relatório fica visível para os usuários da Internet. Está disponível publicamente e, portanto, você pode esperar que as pessoas que verão seu relatório o compartilhem com facilidade por meio da mídia social no futuro. Os usuários exibem o relatório abrindo a URL pública direta ou exibindo-a inserida em uma página da Web ou em um blog. Quando isso ocorre, o Power BI armazena em cache a definição do relatório e os resultados das consultas necessárias para exibir o relatório. Esse cache verifica se milhares de usuários simultâneos podem ver o relatório sem afetar o desempenho.

Os dados são armazenados em cache por uma hora a partir do momento em que são recuperados. Se você atualizar a definição do relatório (por exemplo, alterar o modo de exibição) ou atualizar os dados do relatório, poderá levar algum tempo até que as alterações sejam refletidas na versão do relatório que será vista pelos usuários. Quando uma atualização de dados ocorre para um modelo de dados de importação, o serviço limpa os dados armazenados em cache e recupera novos dados. Na maioria dos casos, os dados são atualizados quase simultaneamente com a importação dos dados. No entanto, para relatórios com muitas consultas distintas, pode levar algum tempo para atualizar. Como cada elemento e valor de dados é armazenado em cache de modo independente, quando ocorre uma atualização de dados, uma combinação de valores atuais e anteriores pode ser mostrada ao usuário. Portanto, recomendamos que você prepare seu trabalho antecipadamente e crie o código de inserção de Publicar na Web somente quando estiver satisfeito com as configurações. Se for preciso atualizar os dados, reduza o número de atualizações e as execute fora do horário comercial. Não recomendamos o uso de Publicar na Web para dados que precisam ser atualizados com frequência.

Encontrar o Administrador do Power BI

O portal de administração do Power BI apresenta configurações que controlam quem pode usar o recurso Publicar na Web. Trabalhe com o Administrador do Power BI da sua organização para alterar as configurações de locatário de Publicar na Web no portal de administração.

Para organizações menores ou indivíduos que se inscreveram no Power BI, talvez você ainda não tenha um administrador do Power BI. Siga nosso processo para obter a tomada de controle administrativo. Quando você tiver um administrador do Power BI, ele poderá habilitar a criação de códigos de inserção para você.

As organizações estabelecidas geralmente já têm um administrador do Power BI. As pessoas em qualquer uma das seguintes funções podem atuar como administradoras do Power BI:

  • Administradores globais
  • Usuários com a função de administrador do Fabric no Microsoft Entra ID

Você precisará encontrar uma dessas pessoas na sua organização e solicitar a elas que atualizem as configurações de locatário de Publicar na Web no portal de administração.

Considerações e limitações

Há suporte para o recurso Publicar na Web na grande maioria das fontes de dados e relatórios do serviço do Power BI. No entanto, os seguintes tipos de relatórios não têm suporte ou não estão disponíveis no momento com o recurso Publicar na Web:

  • Relatórios que usam a Segurança em Nível de Linha.
  • Relatórios que se conectam a dados usando o DirectQuery. Conecte-se usando o modo de composição ou importação. Leia sobre as diferenças entre os modos.
  • Relatórios que usam qualquer fonte de dados de Conexão Dinâmica, incluindo Tabulares do Analysis Services hospedados localmente no Analysis Service Multidimensional e o Azure Analysis Services.
  • Relatórios que usam um modelo semântico compartilhado que está armazenado em um workspace diferente daquele do relatório.
  • Modelos semânticos compartilhados e certificados.
  • Relatórios compartilhados diretamente ou por meio de um aplicativo.
  • Relatórios em um workspace no qual você não é um membro de edição.
  • Atualmente, não há suporte para os visuais do "R" nem do Python nos relatórios Publicar na Web.
  • Exportação de dados de visuais em um relatório que foi publicado na Web.
  • P e R para visuais do Power BI.
  • Relatórios que contêm medidas DAX no nível do relatório.
  • Modelos de consulta de dados de logon único, incluindo modelos compostos em modelos semânticos do Power BI ou no Azure Analysis Services.
  • Informações confidenciais ou proprietárias.
  • O recurso de autenticação automática fornecido com a opção Inserir não funciona com a API JavaScript do Power BI. Para a API JavaScript do Power BI, use a abordagem o usuário possui dados para inserção.
  • Os administradores podem bloquear o acesso à Internet pública, conforme descrito em Links privados para acesso seguro ao Fabric. Nesse caso, a opção Publicar na Web está esmaecida para o seu locatário no portal de administração do Power BI.
  • Imposição de licença para visuais personalizados.
  • Visuais não certificados do repositório organizacional, quando a opção de locatário global da organização para visuais não certificados está ativada.
  • Visuais públicos do repositório organizacional, quando a opção de locatário global da organização não permite visuais criados usando o SDK do Power BI.
  • O usuário que criou o código de inserção precisa manter o acesso ao relatório para que o código de inserção funcione. Isso inclui exigir uma licença Pro ou Premium por Usuário, conforme exigido pelo workspace.
  • Relatórios paginados.
  • Relatórios em vários idiomas.

Mais perguntas? Experimente a Comunidade do Power BI