Publicar na web do Power BIPublish to web from 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.With the Power BI Publish to web option, you can easily embed interactive Power BI content in blog posts, websites, emails, or social media. Você também pode editar, atualizar ou interromper o compartilhamento dos seus visuais publicados com facilidade.You can also easily edit, update, refresh, or stop sharing your published visuals.

Aviso

Quando você usa Publicar na Web, qualquer pessoa na Internet pode exibir seu relatório ou visual publicado.When you use Publish to web, anyone on the Internet can view your published report or visual. A exibição não exige nenhuma autenticação.Viewing requires no authentication. Ela inclui a exibição de dados no nível de detalhes que os relatórios agregam.It includes viewing detail-level data that your reports aggregate. Antes de publicar um relatório, verifique se não há nenhum problema em compartilhar os dados e as visualizações publicamente.Before publishing a report, make sure it's okay for you to share the data and visualizations publicly. Não publique informações confidenciais nem proprietárias.Don't publish confidential or proprietary information. Em caso de dúvida, verifique as políticas de sua organização antes da publicação.If in doubt, check your organization's policies before publishing.

Observação

Você pode inserir o conteúdo com segurança em um site ou um portal interno.You can embed your content securely in an internal portal or website. Use as opções Inserir ou Inserir no SharePoint Online.Use the Embed or Embed in SharePoint Online options. 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.These options ensure that all permissions and data security are enforced when your users view your internal data.

Criar códigos de inserção com o recurso Publicar na WebCreate embed codes with Publish to web

Publicar na Web está disponível para relatórios que podem ser editados em seus workspaces pessoais e de grupo.Publish to web is available for reports you can edit in your personal and group 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.It isn't available for reports shared with you, or ones relying on row-level security to secure data. Confira a seção Limitações abaixo para ver uma lista completa de casos em que o recurso Publicar na Web não é compatível.See the Limitations section below for a complete list of cases where Publish to web isn't supported. Leia o Aviso indicado anteriormente neste artigo antes de usar o recurso Publicar na Web.Review the Warning earlier in this article before using Publish to web.

As etapas a seguir descrevem como usar o recurso Publicar na Web.The following steps describe how to use Publish to web.

  1. Abra um relatório em um workspace que você possa editar e selecione Mais opções (...) > Inserir > Publicar na Web (público) .Open a report in a workspace that you can edit, and select More options (...) > Embed > Publish to web (public).

    Publicar na Web em Mais opções

  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.If your Power BI admin hasn't allowed you to create embed codes, you may need to contact them.

    Entrar em contato com o administrador do Power BI

    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.For help finding the person who can enable Publish to web in your organization, see How to find your Power BI administrator later in this article.

  3. Examine o conteúdo da caixa de diálogo e selecione Criar um código de inserção.Review the dialog content and select Create embed code.

    Examinar Inserção em um site público

  4. Leia o aviso, conforme mostrado aqui, e confirme se os dados estão corretos para ser inseridos em um site público.Review the warning, as shown here, and confirm that the data is okay to embed in a public website. Em caso afirmativo, selecione Publicar.If it is, select Publish.

    Leia o aviso

  5. Uma caixa de diálogo é exibida com um link.A dialog appears with a link. Selecione o link para enviá-lo por email ou copie o HTML.Select the link to send it in email, or copy the HTML. Insira-o em um código como um iFrame ou cole-o diretamente em uma página da Web ou um blog.You can embed it in code such as an iFrame, or paste it directly into a web page or blog.

    Êxito: um link e um 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.If you previously created an embed code for a report and you select Publish to web, you won't see the dialogs in steps 2-4. Em vez disso, a caixa de diálogo Código de inserção será exibida:Instead, the Embed code dialog appears:

    Caixa de diálogo Código de inserção

    Você pode criar apenas um código de inserção para cada relatório.You can only create one embed code for each report.

Dicas para modos de exibiçãoTips for view modes

Quando você insere conteúdo em uma postagem no blog, normalmente é necessário ajustá-lo em um tamanho específico da tela.When you embed content within a blog post, you typically need to fit it within a specific screen size. É possível ajustar a altura e a largura na marca iFrame conforme necessário.You can adjust the height and the width in the iFrame tag as needed. No entanto, é necessário verificar se seu relatório se encaixa na área fornecida do iFrame; portanto, também é necessário definir um Modo de Exibição ao editar o relatório.However, you need to ensure your report fits within the given iFrame area, so you also need to set an appropriate View Mode when editing the report.

A tabela a seguir fornece diretrizes sobre o Modo de Exibição e como ele aparecerá quando for inserido.The following table provides guidance about the View Mode, and how it will appear when embedded.

Modo de ExibiçãoView Mode Sua aparência quando inseridoHow it looks when embedded
PtW6b Ajustar à página respeita a altura e a largura da página de seu relatório.Fit to page respects your report's page height and width. 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.If you set your page to dynamic ratios like 16:9 or 4:3, your content scales to fit within the iFrame. Quando inserido em um iFrame, o uso de Ajustar à página pode resultar na aplicação do formato letterbox, no qual uma tela de fundo cinza é mostrada nas áreas do iFrame depois que o conteúdo é ajustado para caber no iFrame.When embedded in an iFrame, using Fit to page can result in letterboxing, where a gray background is shown in iFrame areas after the content is scaled to fit within the iFrame. Para minimizar a aplicação do formato letterbox, defina a altura e a largura do iFrame de modo condizente.To minimize letterboxing, set the height and width of the iFrame appropriately.
PtW6d Tamanho real verifica se o relatório preserva seu tamanho, conforme definido na página do relatório.Actual size ensures the report preserves its size as set on the report page. Isso pode resultar na exibição de barras de rolagem no iFrame.This can result in scrollbars appearing in your iFrame. Defina a altura e a largura do iFrame para evitar barras de rolagem.Set the iFrame height and width to avoid scrollbars.
PtW6c Ajustar à largura verifica se o conteúdo preenche a área horizontal do iFrame.Fit to width ensures the content fills the horizontal area of the iFrame. Uma borda ainda será mostrada, mas o conteúdo será dimensionado para usar todo o espaço horizontal disponível.A border is still shown, but the content scales to use all the horizontal space available.

Dicas para altura e largura do iFrameTips for iFrame height and width

Um código de inserção da configuração Publicar na Web será parecido com o exemplo a seguir:A Publish to web embed code looks like the following example:

PtW7

É 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.You can edit the width and height manually to ensure it's precisely how you want it to fit in the page where you're embedding it.

Para obter um ajuste mais perfeito, tente adicionar 56 pixels à altura do iFrame para acomodar o tamanho atual da barra inferior.To achieve a more perfect fit, you can try adding 56 pixels to the height of the iFrame to accommodate the current size of the bottom bar. 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.If your report page uses the dynamic size, the table below provides some sizes you can use to achieve a fit without letterboxing.

ProporçãoRatio TamanhoSize Dimensões (largura x altura)Dimension (width x height)
16:916:9 PequenaSmall 640 x 416 px640 x 416 px
16:916:9 MédioMedium 800 x 506 px800 x 506 px
16:916:9 grandeLarge 960 x 596 px960 x 596 px
4:34:3 PequenaSmall 640 x 536 px640 x 536 px
4:34:3 MédioMedium 800 x 656 px800 x 656 px
4:34:3 grandeLarge 960 x 776 px960 x 776 px

Gerenciar códigos de inserçãoManage embed codes

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.Once you create a Publish to web embed code, you can manage your codes from the Settings menu in 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.Managing embed codes includes the ability to remove the destination visual or report for a code (rendering the embed code unusable), or getting the embed code.

  1. Para gerenciar seus códigos de inserção de Publicar na Web , abra a engrenagem Configurações e selecione Gerenciar códigos de inserção.To manage your Publish to web embed codes, open the Settings gear and select Manage embed codes.

    Gerenciar códigos de inserção

  2. Seus códigos de inserção são exibidos.Your embed codes appear.

    PtW9

  3. É possível recuperar ou excluir um código de inserção.You can either retrieve or delete an embed code. Excluí-lo desabilita qualquer link para esse relatório ou visual.Deleting it disables any links to that report or visual.

    PtW10

  4. Se você selecionar Excluir, será solicitado a confirmar.If you select Delete, you're asked for a confirmation.

    PtW11

Atualizações em relatórios e atualização de dadosUpdates to reports, and data refresh

Depois de criar seu código de inserção no recurso Publicar na Web e compartilhá-lo, o relatório será atualizado com todas as alterações feitas, e o link do código de inserção ficará ativo imediatamente.After you create your Publish to web embed code and share it, the report is updated with any changes you make, and the embed code link is immediately active. Qualquer pessoa que abrir o link poderá vê-lo.Anyone who opens the link can view it. Após a criação inicial, pode demorar até duas horas para que as atualizações em relatórios ou visuais fiquem visíveis para os usuários.After the initial creation, updates to reports or visuals may take up to two hours before your users see them. Os dados são armazenados em cache por uma hora a partir do momento em que são recuperados.The data is cached for one hour from the time it is retrieved. Não recomendamos o uso de Publicar na Web para dados que precisam ser atualizados com frequência.We don’t recommend using Publish to web for data that needs to refresh frequently. Para saber mais, confira a seção Como isso funciona posteriormente neste artigo.To learn more, see the How it works section later in this article.

Atualização dedadosData refresh

As atualizações de dados são refletidas automaticamente no relatório ou visual inserido.Data refreshes are automatically reflected in your embedded report or visual. Pode levar até duas horas para que os dados atualizados fiquem visíveis nos códigos de inserção.It can take up to two hours for refreshed data to be visible from embed codes. Para desabilitar a atualização automática, selecione não atualizar no agendamento do conjunto de dados que o relatório usa.To disable automatic refresh, select don't refresh on the schedule for the dataset the report uses.

Visuais do Power BIPower BI visuals

Há suporte para visuais do Power BI no recurso Publicar na Web.Power BI visuals are supported in Publish to 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.When you use Publish to web, users with whom you share your published visual don't need to enable Power BI visuals to view the report.

Noções básicas sobre a coluna de status do código de inserçãoUnderstanding the embed code status column

Observação

Examine periodicamente os códigos de inserção que você publicou.Review the embed codes you've published often. Remova qualquer um que não precise mais estar disponível publicamente.Remove any that no longer need to be available publicly.

A página Gerenciar códigos de inserção inclui uma coluna de status.The Manage embed codes page includes a status column. Por padrão, os códigos de inserção estão Ativos, mas também podem ter um dos status listados abaixo.By default, embed codes are Active, but could also be one of the statuses listed below.

StatusStatus DescriçãoDescription
AtivoActive O relatório está disponível para que os usuários da Internet o vejam e interajam com ele.The report is available for Internet users to view and interact with.
BloqueadoBlocked O conteúdo do relatório viola os Termos de Serviço do Power BI.The report content violates the Power BI Terms of Service. A Microsoft o bloqueou.Microsoft has blocked it. Entre em contato com o suporte se acreditar que o conteúdo foi bloqueado por engano.Contact support if you believe the content was blocked in error.
Sem suporteNot supported O conjunto de dados do relatório usa a Segurança em Nível de Linha ou outra configuração sem suporte.The report's dataset is using row-level security, or another unsupported configuration. Confira a seção Limitações para ver uma lista completa.See the Limitations section for a complete list.
VioladoInfringed O código de inserção está fora da política de locatário definida.The embed code is outside the defined tenant policy. 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.This status typically occurs when an embed code was created and then the Publish to web tenant setting was changed to exclude the user owning the embed code. 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.If the tenant setting is disabled, or the user is no longer allowed to create embed codes, existing embed codes show an Infringed status. Confira a seção Encontrar o Administrador do Power BI neste artigo para obter detalhes.See the Find your Power BI administrator section in this article for details.

Relatar um problema com o conteúdo de Publicar na WebReport a concern with Publish to web content

Para relatar um problema relacionado ao conteúdo de Publicar na Web inserido em um site ou um blog, selecione o ícone Sinalizador na barra inferior do relatório Publicar na Web.To report a concern related to Publish to web content embedded in a website or blog, select the Flag icon in the bottom bar of the Publish to web report.

PtW12

Você precisará enviar um email à Microsoft explicando o problema.You're asked to send an email to Microsoft explaining your concern. A Microsoft avaliará o conteúdo com base nos Termos de Serviço do Power BI e tomará as devidas providências.Microsoft evaluates the content based on the Power BI Terms of Service and takes appropriate action.

LicenciamentoLicensing

Você precisa ser um usuário do Microsoft Power BI para usar o recurso Publicar na Web.You need to be a Microsoft Power BI user to use Publish to web. Os visualizadores do seu relatório não precisam ser usuários do Power BI.Your report viewers don't need to be Power BI users.

Como isso funciona (detalhes técnicos)How it works (technical details)

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.When you create an embed code using Publish to web, the report is made visible to Internet users. 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.It's publicly available, so you can expect viewers to easily share the report through social media in the future. Conforme os usuários exibem o relatório, abrindo a URL pública direta ou exibindo-o inserido em uma página da Web ou em um blog, o Power BI armazena em cache a definição do relatório e os resultados das consultas necessárias para exibi-lo.As users view the report, either by opening the direct public URL or viewing it embedded in a web page or blog, Power BI caches the report definition and the results of the queries required to view the report. Esse cache verifica se milhares de usuários simultâneos podem ver o relatório sem afetar o desempenho.This caching ensures that thousands of concurrent users can view the report without impacting performance.

Os dados são armazenados em cache por uma hora a partir do momento em que são recuperados.The data is cached for one hour from the time it is retrieved. 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 até duas horas até que as alterações sejam refletidas na versão do relatório que será vista pelos usuários.If you update the report definition (for example, if you change its View mode) or refresh the report data, it can take up to two hours before changes are reflected in the version of the report that your users view. Como cada elemento e valor de dados é armazenado em cache de forma independente, quando ocorre uma atualização de dados, uma combinação de valores atuais e anteriores pode ser mostrada ao usuário.Since each element and data value is cached independently, when a data update occurs a mix of current and previous values can be shown to a user. 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.Therefore, we recommend staging your work ahead of time, and creating the Publish to web embed code only when you're satisfied with the settings. Se for preciso atualizar os dados, reduza o número de atualizações e as execute fora do horário comercial.If your data will refresh, minimize the number of refreshes and perform the refreshes at off hours. Não recomendamos o uso de Publicar na Web para dados que precisam ser atualizados com frequência.We don’t recommend using Publish to web for data that needs to refresh frequently.

Encontrar o Administrador do Power BIFind your Power BI administrator

O portal de administração do Power BI apresenta configurações que controlam quem pode usar o recurso Publicar na Web.The Power BI admin portal has settings that control who can publish to the 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.Work with your organization's Power BI administrator to change the Publish to web tenant settings in the admin portal.

Para organizações menores ou indivíduos que se inscreveram no Power BI, talvez você ainda não tenha um administrador do Power BI.For smaller organizations or individuals who signed up for Power BI, you may not have a Power BI administrator yet. Siga nosso processo para a tomada de controle do administrador de locatários.Follow our process for tenant admin takeover. Quando você tiver um administrador do Power BI, ele poderá habilitar a criação de códigos de inserção para você.Once you have a Power BI administrator, they can enable creating embed codes for you.

As organizações estabelecidas geralmente já têm um administrador do Power BI.Established organizations usually already have a Power BI administrator. As pessoas em qualquer uma das seguintes funções podem atuar como administradoras do Power BI:People in any of the following roles can act as a Power BI administrator:

  • Administradores globaisGlobal administrators
  • Usuários com a função de administrador de serviço do Power BI no Azure Active DirectoryUsers with the Power BI service admin role in Azure Active Directory

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.You need to find one of these people in your organization and ask them to update the Publish to web tenant settings in the admin portal.

LimitaçõesLimitations

Há suporte para o recurso Publicar na Web na grande maioria das fontes de dados e relatórios do serviço do Power BI.Publish to web is supported for the vast majority of data sources and reports in the Power BI service. No entanto, atualmente, não há suporte nem disponibilidade para os seguintes tipos de relatórios no recurso Publicar na Web:However, the following kinds of reports aren't currently supported or available with Publish to web:

  • Relatórios que usam a Segurança em Nível de Linha.Reports using row-level security.
  • 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.Reports using any Live Connection data source, including Analysis Services Tabular hosted on-premises, Analysis Services Multidimensional, and Azure Analysis Services.
  • Relatórios que usam um conjunto de dados compartilhado, armazenado em um workspace diferente daquele do relatório.Reports using a shared dataset that is stored in a different workspace from the report.
  • Conjuntos de dados compartilhados e certificados.Shared and certified datasets.
  • Relatórios compartilhados com você diretamente ou por meio de um pacote de conteúdo organizacional.Reports shared to you directly or through an organizational content pack.
  • Relatórios em um workspace no qual você não é um membro de edição.Reports in a workspace in which you aren't an edit member.
  • Atualmente, não há suporte para os visuais do "R" em relatórios Publicar na Web."R" visuals aren't currently supported in Publish to web reports.
  • Exportação de dados de visuais em um relatório que foi publicado na Web.Exporting data from visuals in a report that has been published to the web.
  • Visuais do ArcGIS Maps for Power BI.ArcGIS Maps for Power BI visuals.
  • Relatórios que contêm medidas DAX no nível do relatório.Reports containing report-level DAX measures.
  • Modelos de consulta de dados de logon único.Single sign-on data query models.
  • Informações confidenciais ou proprietárias.Secure confidential or proprietary information.
  • O recurso de autenticação automática fornecido com a opção Inserir não funciona com a API JavaScript do Power BI.The automatic authentication capability provided with the Embed option doesn't work with the Power BI JavaScript API. Para a API JavaScript do Power BI, use a abordagem o usuário possui dados para inserção.For the Power BI JavaScript API, use the user owns data approach to embedding.

Próximas etapasNext steps

Mais perguntas?More questions? Experimente a Comunidade do Power BITry the Power BI Community