Publicar na Web do Power BIPublish to web from Power BI

Com a opção Publicar na Web do Power BI, pode incorporar facilmente conteúdos do Power BI em publicações de blogue, sites, e-mails ou redes sociais.With the Power BI Publish to web option, you can easily embed interactive Power BI content in blog posts, websites, emails, or social media. Também pode facilmente editar, atualizar ou parar de partilhar os seus elementos visuais publicados.You can also easily edit, update, refresh, or stop sharing your published visuals.

Aviso

Quando utilizar a funcionalidade Publicar na Web, qualquer pessoa poderá ver os seus relatórios ou elementos visuais publicados.When you use Publish to web, anyone on the Internet can view your published report or visual. A visualização não requer autenticação.Viewing requires no authentication. Está incluída a visualização de dados detalhados agregados pelos seus relatórios.It includes viewing detail-level data that your reports aggregate. Antes de publicar um relatório, certifique-se de que pode partilhar 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 ou proprietárias.Don't publish confidential or proprietary information. Se tiver dúvidas, consulte as políticas da sua organização antes da publicação.If in doubt, check your organization's policies before publishing.

Nota

Pode incorporar o seu conteúdo de forma segura num portal interno ou num site.You can embed your content securely in an internal portal or website. Utilize as opções Incorporar ou Incorporar no SharePoint Online.Use the Embed or Embed in SharePoint Online options. Estas opções garantem que todas as permissões e a segurança de dados são impostas quando os utilizadores veem os seus dados internos.These options ensure that all permissions and data security are enforced when your users view your internal data.

Criar códigos incorporados com a funcionalidade Publicar na WebCreate embed codes with Publish to web

A funcionalidade Publicar na Web está disponível para relatórios editáveis na sua área de trabalho pessoal ou de grupo.Publish to web is available for reports you can edit in your personal and group workspaces. Não está disponível para relatórios partilhados consigo ou cuja segurança de dados dependa da segurança ao nível da linha.It isn't available for reports shared with you, or ones relying on row-level security to secure data. Consulte a secção Limitações para obter uma lista completa dos casos em que a funcionalidade Publicar na Web não é suportada.See the Limitations section below for a complete list of cases where Publish to web isn't supported. Consulte o Aviso indicado anteriormente neste artigo antes de utilizar a funcionalidade Publicar na Web.Review the Warning earlier in this article before using Publish to web.

Os passos seguintes descrevem como utilizar a funcionalidade Publicar na Web.The following steps describe how to use Publish to web.

  1. Abra um relatório numa área de trabalho que possa editar e selecione Mais opções (...) > Incorporar > 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 seu administrador do Power BI não lhe concedeu permissão para criar códigos incorporados, poderá ter de o contactar.If your Power BI admin hasn't allowed you to create embed codes, you may need to contact them.

    Contactar o seu administrador do Power BI

    Para obter ajuda para encontrar a pessoa que pode ativar a funcionalidade Publicar na Web na sua organização, veja Encontrar o seu 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. Consulte o conteúdo da caixa de diálogo e selecione Criar código de incorporação.Review the dialog content and select Create embed code.

    Consultar Incorporar num site público

  4. Consulte o aviso, como aqui mostrado, e certifique-se de que os dados podem ser incorporados num site público.Review the warning, as shown here, and confirm that the data is okay to embed in a public website. Se sim, selecione Publicar.If it is, select Publish.

    Consultar o aviso

  5. É apresentada uma caixa de diálogo com uma ligação.A dialog appears with a link. Selecione a ligação para a enviar por e-mail ou copie o HTML.Select the link to send it in email, or copy the HTML. Pode incorporar a ligação em código, por exemplo, num iFrame, ou colá-la diretamente numa página Web ou num blogue.You can embed it in code such as an iFrame, or paste it directly into a web page or blog.

    Bem-sucedido: uma ligação e o HTML

  6. Se já tiver criado um código de incorporação para um relatório e selecionar Publicar na Web, não verá as caixas de diálogo nos passos 2-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, será apresentada a caixa de diálogo Código de incorporação:Instead, the Embed code dialog appears:

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

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

Sugestões para os modos de visualizaçãoTips for view modes

Normalmente, ao incorporar conteúdos numa publicação de um blogue, é necessário ajustá-los a um tamanho de ecrã específico.When you embed content within a blog post, you typically need to fit it within a specific screen size. Pode ajustar a altura e largura na etiqueta iFrame, conforme necessário.You can adjust the height and the width in the iFrame tag as needed. No entanto, deve certificar-se de que o seu relatório cabe na área de iFrame fornecida. Assim, deve também definir um Modo de Visualização adequado 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 seguinte tabela fornece instruções sobre o Modo de Visualização e a forma como será apresentado quando for incorporado.The following table provides guidance about the View Mode, and how it will appear when embedded.

Modo de VisualizaçãoView Mode O aspeto que terá quando incorporadoHow it looks when embedded
PtW6b A opção Ajustar à página respeita a altura e a largura de página do seu relatório.Fit to page respects your report's page height and width. Se definir a página para proporções dinâmicas, como 16:9 ou 4:3, os conteúdos serão dimensionados 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. Ao incorporar num iFrame, a opção Ajustar à página poderá resultar em letterboxing, fazendo com que seja apresentado um fundo cinzento na área do iFrame após os conteúdos serem ajustados de forma a caber no mesmo.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 o letterboxing, defina adequadamente a altura e a largura do iFrame.To minimize letterboxing, set the height and width of the iFrame appropriately.
PtW6d A opção Tamanho real garante que o relatório mantém o tamanho definido na página de relatórios.Actual size ensures the report preserves its size as set on the report page. Isto poderá originar barras de deslocamento no seu iFrame.This can result in scrollbars appearing in your iFrame. Defina a altura e largura do iFrame para evitar as barras de deslocamento.Set the iFrame height and width to avoid scrollbars.
PtW6c A opção Ajustar à largura garante que os conteúdos preenchem a área horizontal do iFrame.Fit to width ensures the content fills the horizontal area of the iFrame. Continua a ser apresentado um limite, mas os conteúdos ajustam-se de forma a ocupar todo o espaço horizontal disponível.A border is still shown, but the content scales to use all the horizontal space available.

Sugestões para a altura e a largura do iFrameTips for iFrame height and width

Um código de incorporação da definição Publicar na Web é semelhante ao exemplo seguinte:A Publish to web embed code looks like the following example:

PtW7

Pode editar a largura e altura manualmente para garantir um melhor dimensionamento na página em que está a fazer a incorporação.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 melhor ajuste, experimente adicionar 56 pixéis à 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 a sua página de relatório utilizar o tamanho dinâmico, a seguinte tabela apresenta alguns tamanhos que pode utilizar para obter um ajuste sem letterboxing.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ão (largura x altura)Dimension (width x height)
16:916:9 SmallSmall 640 x 416 px640 x 416 px
16:916:9 MédiaMedium 800 x 506 px800 x 506 px
16:916:9 GrandeLarge 960 x 596 px960 x 596 px
4:34:3 PequenoSmall 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

Gerir códigos de incorporaçãoManage embed codes

Depois de criar um código de incorporação Publicar na Web, poderá gerir os seus códigos a partir do menu Definiçõ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. A gestão de códigos de incorporação inclui a capacidade de remover o relatório ou elemento visual de destino de um código (tornando o código de incorporação inutilizável) ou de obter o código de incorporação novamente.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 gerir os seus códigos de incorporação da funcionalidade Publicar na Web, abra a engrenagem das Definições e selecione Gerir códigos de incorporação.To manage your Publish to web embed codes, open the Settings gear and select Manage embed codes.

    Gerir códigos de incorporação

  2. Os seus códigos de incorporação são apresentados.Your embed codes appear.

    PtW9

  3. Pode obter ou eliminar um código de incorporação.You can either retrieve or delete an embed code. Eliminá-lo desativa todas as ligações para esse relatório ou elemento visual.Deleting it disables any links to that report or visual.

    PtW10

  4. Se selecionar Eliminar, ser-lhe-á pedida uma confirmação.If you select Delete, you're asked for a confirmation.

    PtW11

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

Depois de criar e partilhar o seu código de incorporação da funcionalidade Publicar na Web, o relatório será atualizado com as alterações que fizer e a ligação do código de incorporação ficará imediatamente ativa.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 abra a ligação poderá vê-lo.Anyone who opens the link can view it. Após a criação inicial, as atualizações aos relatórios ou aos elementos visuais podem demorar até duas horas até que os utilizadores as vejam.After the initial creation, updates to reports or visuals may take up to two hours before your users see them. Os dados são colocados em cache durante uma hora a partir do momento em que são obtidos.The data is cached for one hour from the time it is retrieved. Não recomendamos a utilização de Publicar na Web para obter dados que têm de ser atualizados com frequência.We don’t recommend using Publish to web for data that needs to refresh frequently. Para obter mais informações, consulte a secção Como funciona, mais à frente neste artigo.To learn more, see the How it works section later in this article.

Atualização de dadosData refresh

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

Elementos Visuais do Power BIPower BI visuals

Os elementos visuais do Power BI são suportados na funcionalidade Publicar na Web.Power BI visuals are supported in Publish to web. Ao utilizar a funcionalidade Publicar na Web, os utilizadores com quem partilha os elementos visuais publicados não precisam de ativar os elementos 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.

Compreender a coluna do estado do código de incorporaçãoUnderstanding the embed code status column

Nota

Consulte os códigos de incorporação que publicou com frequência.Review the embed codes you've published often. Remova os que já não precisarem de estar disponíveis publicamente.Remove any that no longer need to be available publicly.

A página Gerir códigos de incorporação inclui uma coluna de estado.The Manage embed codes page includes a status column. Os códigos de incorporação estão predefinidos como Ativos, mas também poderá encontrar um dos estados descritos abaixo.By default, embed codes are Active, but could also be one of the statuses listed below.

EstadoStatus DescriçãoDescription
AtivoActive O relatório está disponível para visualização e interação por utilizadores da Internet.The report is available for Internet users to view and interact with.
BloqueadoBlocked O conteúdo do relatório infringe os Termos de Serviço do Power BI.The report content violates the Power BI Terms of Service. A Microsoft bloqueou o relatório.Microsoft has blocked it. Se achar que o bloqueio dos conteúdos foi um erro, contacte o suporte.Contact support if you believe the content was blocked in error.
Não suportadoNot supported O conjunto de dados do relatório está a utilizar segurança ao nível da linha ou outra configuração não suportada.The report's dataset is using row-level security, or another unsupported configuration. Consulte a secção Limitações para obter uma lista completa.See the Limitations section for a complete list.
Em violaçãoInfringed O código de incorporação está fora da política de inquilino definida.The embed code is outside the defined tenant policy. Normalmente, este estado ocorre quando um código de incorporação foi criado e a definição de inquilino da funcionalidade Publicar na Web foi alterada para excluir o utilizador a quem pertence o código de incorporaçã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 definição de inquilino tiver sido desativada ou o utilizador já não tiver permissão para criar códigos de incorporação, os códigos de incorporação existentes apresentarão o estado Em violação.If the tenant setting is disabled, or the user is no longer allowed to create embed codes, existing embed codes show an Infringed status. Veja a secção Encontrar o seu administrador do Power BI neste artigo para obter mais detalhes.See the Find your Power BI administrator section in this article for details.

Comunicar um problema relacionado com conteúdos da funcionalidade Publicar na WebReport a concern with Publish to web content

Para comunicar um problema relacionado com os conteúdos da funcionalidade Publicar na Web incorporados num site ou num blogue, selecione o ícone de Sinalização na barra inferior do relatório da funcionalidade 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

É-lhe pedido que envie um e-mail para a Microsoft a explicar o problema.You're asked to send an email to Microsoft explaining your concern. A Microsoft avalia os conteúdos com base nos Termos de Serviço do Power BI e toma as medidas adequadas.Microsoft evaluates the content based on the Power BI Terms of Service and takes appropriate action.

LicensingLicensing

Tem de ser utilizador do Microsoft Power BI para utilizar a funcionalidade Publicar na Web.You need to be a Microsoft Power BI user to use Publish to web. As pessoas que veem o seu relatório não têm de ser utilizadores do Power BI.Your report viewers don't need to be Power BI users.

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

Quando cria um código de incorporação através da funcionalidade Publicar na Web, o relatório fica visível para os utilizadores na Internet.When you create an embed code using Publish to web, the report is made visible to Internet users. Encontra-se disponível publicamente, pelo que é expectável que os utilizadores partilhem facilmente o relatório através das redes sociais.It's publicly available, so you can expect viewers to easily share the report through social media in the future. Quando os utilizadores virem o relatório, quer ao abrir o URL público direto ou ao vê-lo incorporado numa página Web ou blogue, o Power BI regista a definição do relatório e os resultados das consultas necessários para ver o relatório.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. Esta colocação em cache garante que milhares de utilizadores podem ver o relatório em simultâneo, sem afetar o desempenho.This caching ensures that thousands of concurrent users can view the report without impacting performance.

Os dados são colocados em cache durante uma hora a partir do momento em que são obtidos.The data is cached for one hour from the time it is retrieved. Se atualizar a definição do relatório (por exemplo, se alterar o Modo de visualização) ou atualizar os dados do relatório, poderá demorar até duas horas para que as alterações se reflitam na versão do relatório vista pelos utilizadores.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. Uma vez que cada elemento e valor de dados é colocado em cache independentemente, quando uma atualização de dados ocorre, uma mistura de valores atuais e anteriores pode ser mostrada a um utilizador.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. Por conseguinte, recomendamos que teste o seu trabalho antecipadamente e crie o código de incorporação Publicar na Web apenas quando estiver satisfeito com as definiçõ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 os seus dados se atualizarem, minimize o número de atualizações e execute as atualizações durante horas de inatividade.If your data will refresh, minimize the number of refreshes and perform the refreshes at off hours. Não recomendamos a utilização de Publicar na Web para obter dados que têm de ser atualizados com frequência.We don’t recommend using Publish to web for data that needs to refresh frequently.

Encontrar o seu administrador do Power BIFind your Power BI administrator

O portal de administração do Power BI tem definições que controlam quem pode publicar na Web.The Power BI admin portal has settings that control who can publish to the web. Trabalhe em conjunto com o administrador do Power BI da sua organização para alterar as definições de inquilino da funcionalidade 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.

As organizações mais pequenas ou os indivíduos que se inscreveram no Power BI podem ainda não ter 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 o nosso processo de obtenção de controlo administrativo do inquilino.Follow our process for tenant admin takeover. Assim que tiver um administrador do Power BI, este pode ativar a criação de códigos incorporados para si.Once you have a Power BI administrator, they can enable creating embed codes for you.

Geralmente, as organizações estabelecidas 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 desempenhar o papel de administrador do Power BI:People in any of the following roles can act as a Power BI administrator:

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

Precisa de encontrar uma destas pessoas na sua organização e pedir-lhes para atualizar as definições de inquilino da funcionalidade 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

A funcionalidade Publicar na Web é suportada para a grande maioria das origens de dados e relatórios no serviço Power BI.Publish to web is supported for the vast majority of data sources and reports in the Power BI service. No entanto, os seguintes tipos de relatórios não são atualmente suportados ou não estão disponíveis com a funcionalidade Publicar na Web:However, the following kinds of reports aren't currently supported or available with Publish to web:

  • Relatórios com segurança ao nível da linha.Reports using row-level security.
  • Relatórios que utilizam qualquer origem de dados de Ligação em Direto, incluindo Tabelas do Analysis Services no local, modelos Multidimensionais do Analysis Services 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 utilizam um conjunto de dados partilhado armazenado numa área de trabalho diferente da do relatório.Reports using a shared dataset that is stored in a different workspace from the report.
  • Conjuntos de dados partilhados e certificados.Shared and certified datasets.
  • Relatórios partilhados diretamente consigo ou através de um pacote de conteúdos organizacionais.Reports shared to you directly or through an organizational content pack.
  • Relatórios numa área de trabalho na qual não é um membro de edição.Reports in a workspace in which you aren't an edit member.
  • Os elementos visuais "R" não são atualmente suportados nos relatórios da funcionalidade Publicar na Web."R" visuals aren't currently supported in Publish to web reports.
  • Exportar dados de elementos visuais num relatório publicado na Web.Exporting data from visuals in a report that has been published to the web.
  • ArcGIS Maps para elementos visuais do Power BI.ArcGIS Maps for Power BI visuals.
  • Relatórios que contêm medidas DAX ao nível do relatório.Reports containing report-level DAX measures.
  • Modelos de consulta de dados de início de sessão único.Single sign-on data query models.
  • Informações confidenciais ou proprietárias.Secure confidential or proprietary information.
  • A capacidade de autenticação automática fornecida com a opção Incorporar não funciona com a API de 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 de JavaScript do Power BI, utilize a abordagem O utilizador detém os dados para incorporar.For the Power BI JavaScript API, use the user owns data approach to embedding.

Próximos passosNext steps

Mais perguntas?More questions? Pergunte à Comunidade do Power BITry the Power BI Community