Criar um link para um local específico nos aplicativos móveis do Power BICreate a link to a specific location in the Power BI mobile apps

Você pode usar links para acessar diretamente conteúdo específico do Power BI, como um relatório, uma página de relatório, um dashboard, um bloco e outros itens.You can use links to directly access specific Power BI content, such as a specific report, report page, dashboard, tile, etc.

Há principalmente dois cenários para acessar conteúdo usando links em aplicativos móveis do Power BI:There are mainly two scenarios for using links to access content in the Power BI mobile apps:

  • Abrir o Power BI fora do aplicativo móvel e acessar um conteúdo específico.To open Power BI from outside of the mobile app, and land on specific content. Geralmente, esse é um cenário de integração no qual você abre o aplicativo móvel do Power BI em outro aplicativo.This is usually an integration scenario, where you are opening the Power BI mobile app from another app.
  • Para navegar dentro do Power BI.To navigate inside Power BI. Geralmente, isso ocorre quando você deseja criar uma navegação personalizada no Power BI.This is typically done when you want to create custom navigation in Power BI.

Este artigo aborda os seguintes casos:This article covers the following cases:

  • Uso de links para abrir conteúdo específico do Power BI fora do aplicativo móvel.Using links to open specific Power BI content from outside the mobile app. Dois formatos de links são descritos.Two link formats are described. Um deles usa um método de redirecionamento e pode ser usado independentemente de onde o Power BI será aberto.One uses a redirect method and can be used no matter where Power BI will open. O outro é aberto diretamente no aplicativo móvel do Power BI e funciona somente em dispositivos móveis que têm o aplicativo móvel instalado.The other opens directly in the Power BI mobile app and will work only on mobile devices that have the mobile app installed.
  • Uso de links dentro do Power BI para navegar até conteúdo específico do Power BI.Using links inside Power BI to navigate to specific Power BI content.

Quando você deseja vincular a um item específico no Power BI de fora do aplicativo móvel, há duas opções, dependendo de onde o link será aberto:When you want to link to a specific item in Power BI from outside the mobile app, there are two options, depending on where the link is going to be opened:

  • Se você deseja que o link seja aberto de forma correta, não importa se ele receba o clique no navegador de um computador ou em um dispositivo móvel, é possível criar um link que seja aberto do modo adequado, independentemente do local.If you want the link to open correctly regardless of whether it is clicked in a computer browser or on a mobile device, you can create a link that ensures it will open correctly no matter where it is clicked. O link tem uma sintaxe de redirecionamento especial para habilitar esse comportamento inteligente.This link has a special redirect syntax to enable this smart behavior.

  • Se você souber que o link será aberto apenas em um dispositivo móvel que tem o aplicativo móvel do Power BI instalado, poderá evitar a sobrecarga de redirecionamento do método acima e usar outra sintaxe de link que o abra diretamente no aplicativo móvel do Power BI.If you know the link is only going to be opened on a mobile device that has the Power BI mobile app installed, you can avoid the redirect overhead of the above method and use another link syntax that opens the link directly in the Power BI mobile app on the mobile device. No entanto, é importante observar que, embora esse link evite a sobrecarga de redirecionamento do primeiro método, ele não funcionará se for aberto em qualquer lugar que não seja em um dispositivo móvel que tenha o aplicativo do Power BI instalado.It is important to note however that while this link avoids the redirect overhead of the first method, it will not work if opened anywhere other than on a mobile device that has the Power BI mobile app installed.

O formato de link descrito nesta seção usa o redirecionamento para garantir que o link funcione independentemente de onde ele recebe o clique.The link format described in this section uses redirection to make sure the link works no matter where it is clicked.

  • Se o clique no link for feito em um dispositivo móvel, esse formato garantirá que o dispositivo use o aplicativo móvel do Power BI para abrir o link.If the link is clicked on a mobile device, it makes sure that the device uses the Power BI mobile app to open the link. Se o aplicativo móvel não estiver instalado no dispositivo, ele sugerirá que o usuário acesse a loja para obtê-lo.If the mobile app is not installed on the device, it suggests to the user to go to the store to get it.
  • Se o link receber um clique em um computador, ele abrirá o item relevante no portal da Web do Power BI.If the link is clicked on a PC, it will open the relevant item in the Power BI web portal.

O link deve começar com um prefixo especial, seguido por parâmetros de consulta:The link must start with a special prefix, followed by query parameters:

https://app.powerbi.com/Redirect? [QUERYPARAMETERS] https://app.powerbi.com/Redirect?[QUERYPARAMETERS]

Importante

Se o conteúdo estiver hospedado em um datacenter especial, como Governo, China etc., o link deverá começar com o endereço adequado do Power BI, como app.powerbigov.us ou app.powerbi.cn.If your content is hosted in special datacenter such as Government, China, etc., the link should start with the appropriate Power BI address, such as app.powerbigov.us or app.powerbi.cn.

Os parâmetros de consulta são:The query parameters are:

ParâmetroParameter ValorValue DescriçãoDescription
action (obrigatório)action (mandatory) OpenAppOpenApp
OpenReportOpenReport
OpenDashboardOpenDashboard
OpenTileOpenTile
appIdappId Guid de 36 caracteres36 character guid Deve ser especificado caso você deseje abrir um relatório ou dashboard que faça parte de um aplicativo.Must be specified if you want to open a report or dashboard that is part of an app.
Exemplo: appId=baf4b16d-b5bd-4360-8a3a-51d11242c09bExample: appId=baf4b16d-b5bd-4360-8a3a-51d11242c09b
groupObjectIdgroupObjectId Guid de 36 caracteres36 character guid Especifica o workspace quando você deseja abrir um relatório ou dashboard que faz parte do Meu Workspace.Specifies the workspace when you want to open a report or dashboard that is not part of My Workspace.
Exemplo: groupObjectId=9a3841c6-74b3-46f1-85fd-bdd78f27b30eExample: groupObjectId=9a3841c6-74b3-46f1-85fd-bdd78f27b30e
dashboardObjectIddashboardObjectId Guid de 36 caracteres36 character guid ID de objeto do dashboard (se a ação for OpenDashboard ou OpenTile)Dashboard object ID (if action is OpenDashboard or OpenTile)
Exemplo: dashboardObjectId=033bb049-5b68-4392-b3ef-ae9a43738a4aExample: dashboardObjectId=033bb049-5b68-4392-b3ef-ae9a43738a4a
reportObjectIdreportObjectId Guid de 36 caracteres36 character guid ID de objeto do relatório (se a ação for OpenReport)Report object ID (if action is OpenReport)
Exemplo: reportObjectId=6114cec7-78e1-4926-88ff-0bc5338452cfExample: reportObjectId=6114cec7-78e1-4926-88ff-0bc5338452cf
tileObjectIdtileObjectId Guid de 36 caracteres36 character guid ID de objeto do bloco (se a ação for OpenTile)Tile object ID (if action is OpenTile)
Exemplo: tileObjectId=a845dcb8-a289-43a8-94ea-67a8c0a068f9Example: tileObjectId=a845dcb8-a289-43a8-94ea-67a8c0a068f9
reportPagereportPage ReportSection<num>ReportSection<num> Nome da página se você deseja abrir uma página de relatório específica.Page name if you want to open a specific report page. (se a ação for OpenReport)(if action is OpenReport)
Exemplo: reportPage=ReportSection6Example: reportPage=ReportSection6
bookmarkGuidbookmarkGuid Guid de 36 caracteres36 character guid ID do indicador, se você deseja abrir uma exibição específica marcada com indicador.Bookmark ID, if you want to open a specific bookmarked view. (se a ação for OpenReport)(if action is OpenReport)
Exemplo: bookmarkGuid=18e8872f-6db8-4cf8-8298-3b2ab254cc7fExample: bookmarkGuid=18e8872f-6db8-4cf8-8298-3b2ab254cc7f
ctidctid Guid de 36 caracteres36 character guid ID da organização do item (relevante para cenários B2B.Item organization ID (relevant for B2B scenarios. Isso poderá ser omitido se o item pertencer à organização do usuário)This can be omitted if the item belongs to the user's organization)
Exemplo: ctid=5367c770-09d0-4110-bf6a-d760cb5ef681.Example: ctid=5367c770-09d0-4110-bf6a-d760cb5ef681 .

Exemplos:Examples:

Nos exemplos a seguir, os espaços reservados para os valores de parâmetro estão realçados em negrito.In the following examples, placeholders for the parameter values are highlighted in bold. Para obter os valores reais, acesse o serviço do Power BI, abra o item ao qual você deseja vincular e extraia os valores necessários da URL do item.To get the actual values, go to the Power BI service, open the item you want to link to, and extract the values you need from the item's URL.

  • Abrir um aplicativoOpen an app

    https://app.powerbi.com/Redirect?action=OpenApp&appId= <appid-guid> &ctid= <ctid-guid>https://app.powerbi.com/Redirect?action=OpenApp&appId=<appid-guid>&ctid=<ctid-guid>

  • Abrir um dashboard que faz parte de um aplicativoOpen a dashboard that is part of an app

    https://app.powerbi.com/Redirect?action=OpenDashboard&appId= <appid-guid> &dashboardObjectId= <dashboardid-guid> &ctid= <ctid-guid>https://app.powerbi.com/Redirect?action=OpenDashboard&appId=<appid-guid>&dashboardObjectId=<dashboardid-guid>&ctid=<ctid-guid>

  • Abrir um relatório que faz parte de um workspace diferente do Meu WorkspaceOpen a report that is part of a workspace other than My Workspace

    https://app.powerbi.com/Redirect?Action=OpenReport&reportObjectId= <reportid-guid> &groupObjectId= <groupobjectid-guid> &reportPage=ReportSection<num>https://app.powerbi.com/Redirect?Action=OpenReport&reportObjectId=<reportid-guid>&groupObjectId=<groupobjectid-guid>&reportPage=ReportSection<num>

Para aplicativos e para relatórios e dashboards que fazem parte de um aplicativo, a maneira mais fácil de obter o link é acessar o workspace do aplicativo e escolher Atualizar aplicativo.For apps, and for reports and dashboards that are part of an app, the easiest way to get the link is to go to the app workspace and choose Update app. Isso abre a experiência de "publicar aplicativo".This opens the "publish app" experience. Abra a guia de permissões e expanda a seção de links a fim de ver os links para o aplicativo e todo o seu conteúdo.Open the permissions tab and expand the links section to see the links to the app and all its contents. É possível usar esses links fora do Power BI para acessar o aplicativo e seu conteúdo diretamente.You can use these links from outside Power BI to access the app and its contents directly.

Links de Publicar aplicativo do Power BIPower BI publish app links

Para relatórios e dashboards que não fazem parte de um aplicativo, você precisa extrair as IDs de objeto necessárias da URL do item.For reports and dashboards that are not part of an app, you need to extract the object IDs you need from the item's URL. Para fazer isso, acesse o serviço do Power BI, navegue até o item ao qual você deseja vincular e procure os valores necessários na URL que você vê na barra de endereços do navegador.To do this, go to the Power BI service, navigate to the item you want to link to, and look for the values you need in the URL you see in the browser's address bar.

Os exemplos abaixo mostram onde é possível encontrar as IDs necessárias nas URLs dos itens aos quais você deseja vincular.The examples below show where you can find the IDs you need in the URLs of the items you want to link to.

  • Para localizar uma ID de objeto de dashboard de 36 caracteres, navegue até o dashboard específico ao qual você deseja vincular no serviço do Power BI e localize a ID de objeto correspondente e qualquer outra ID necessária nos locais indicados abaixo:To find a 36-character dashboard object ID, navigate to the specific dashboard you want to link to in the Power BI service and find the dashboard object ID and any other required IDs in the places indicated below:

    https://app.powerbi.com/groups/me/dashboards/ <dashboard-object-id> ?ctid= <org-object-id>https://app.powerbi.com/groups/me/dashboards/<dashboard-object-id>?ctid=<org-object-id>

  • Para localizar uma ID de objeto de relatório de 36 caracteres, navegue até o relatório específico ao qual você deseja vincular no serviço do Power BI e localize as IDs necessárias, conforme ilustrado abaixo.To find a 36-character report object ID, navigate to the specific report you want to link to in the Power BI service and find the necessary IDs as illustrated below. Observe que este exemplo contém uma referência a uma página de relatório específica e a um indicador específico.Note that this example contains a reference to a specific report page and a specific bookmark.

    https://app.powerbi.com/groups/me/reports/ <report-object-id> /ReportSection<num> ?bookmarkGuid= <bookmark-id>https://app.powerbi.com/groups/me/reports/<report-object-id>/ReportSection<num>?bookmarkGuid=<bookmark-id>

  • Para vincular a um item em um workspace diferente do Meu Workspace, é preciso extrair a ID de objeto de grupo.To link to an item in a workspace other than My Workspace, you need to extract the group object ID. Este exemplo mostra o relatório de um workspace diferente do Meu Workspace.This example shows a report from a workspace other than My Workspace.

    https://app.powerbi.com/groups/ <group-object-id> /reports/ <report-object-id> /ReportSection<report-section-num> ?ctid= <org-object-id>https://app.powerbi.com/groups/<group-object-id>/reports/<report-object-id>/ReportSection<report-section-num>?ctid=<org-object-id>

O formato de link descrito nesta seção vincula a um local específico dentro dos aplicativos móveis do Power BI em todas as plataformas móveis: iOS, dispositivos Android e Windows 10.The link format described in this section links to a specific location within the Power BI mobile apps on all the mobile platforms: iOS, Android devices, and Windows 10. Esse formato de link abre o local diretamente, sem nenhum dos redirecionamentos envolvidos no método descrito na seção anterior.This link format opens the location directly, without any of the redirection involved in the method described in the previous section. Esse formato só pode ser aberto em dispositivos móveis que tenham o aplicativo do Power BI instalado.This format can only be opened on mobile devices that have the Power BI mobile app installed.

Os links desse formato podem apontar diretamente para dashboards, blocos e relatórios.Links of this format can point directly to dashboards, tiles, and reports. O destino do link profundo determina o formato.The destination of the deep link determines its format. Siga estas etapas para criar links profundos para locais diferentes.Follow these steps to create deep links to different locations.

  • Abra o aplicativo móvel de Power BIOpen the Power BI mobile app

    Use este link para abrir o aplicativo móvel do Power BI em qualquer dispositivo:Use this link to open the Power BI mobile app on any device:

    mspbi://app/mspbi://app/

  • Abrir em um painel específicoOpen to a specific dashboard

    Este link abre o aplicativo móvel do Power BI em um dashboard específico:This link opens the Power BI mobile app to a specific dashboard:

    mspbi://app/OpenDashboard?DashboardObjectId= <36-character-dashboard-id>mspbi://app/OpenDashboard?DashboardObjectId=<36-character-dashboard-id>

    Para obter a ID de objeto de 36 caracteres do dashboard, navegue até o dashboard específico no serviço do Power BI e a extraia da URL.To get the 36-character dashboard object id, navigate to the specific dashboard in the Power BI service and extract it from the URL. Por exemplo, a ID de objeto do dashboard está realçada na seguinte URL do serviço do Power BI:For example, the dashboard object id is highlighted in the following URL from the Power BI service:

    https://app.powerbi.com/groups/me/dashboards/ <61b7e871-cb98-48ed-bddc-6572c921e270>https://app.powerbi.com/groups/me/dashboards/<61b7e871-cb98-48ed-bddc-6572c921e270>

    Se o dashboard não estiver no Meu Workspace, você precisará adicionar a ID de objeto de grupo também, antes ou depois da ID do dashboard.If the dashboard is not in My Workspace, you need to add the group object ID as well, either before or after the dashboard ID. O link profundo mostrado abaixo tem o parâmetro de ID de objeto de grupo adicionado após a ID de objeto de dashboard:The deep link shown below has the group object id parameter added after the dashboard object id:

    mspbi://app/OpenDashboard?DashboardObjectId=e684af3a-9e7f-44ee-b679-b9a1c59b5d60&GroupObjectId=8cc900cc-7339-467f-8900-fec82d748248mspbi://app/OpenDashboard?DashboardObjectId=e684af3a-9e7f-44ee-b679-b9a1c59b5d60&GroupObjectId=8cc900cc-7339-467f-8900-fec82d748248

    Observe o E comercial (&) entre os dois parâmetros.Note the ampersand (&) between the two parameters.

  • Abrir em um bloco específico em focoOpen to a specific tile in focus

    Este link abre um bloco específico no modo de foco no aplicativo móvel do Power BI:This link opens a specific tile in focus mode in the Power BI mobile app:

    mspbi://app/OpenTile?DashboardObjectId= <36-character-dashboard-id> &TileObjectId= <36-character-tile-id>mspbi://app/OpenTile?DashboardObjectId=<36-character-dashboard-id>&TileObjectId=<36-character-tile-id>

    Para localizar as IDs de objeto de 36 caracteres do dashboard e do bloco, navegue até o dashboard específico no serviço do Power BI e abra o bloco em modo de foco.To find the 36-character dashboard and tile object IDs, navigate to the specific dashboard in the Power BI service and open the tile in focus mode. No exemplo abaixo, as IDs do dashboard e do bloco estão realçadas.In the example below the dashboard and tile IDs are highlighted.

    https://app.powerbi.com/groups/me/dashboards/3784f99f-b460-4d5e-b86c-b6d8f7ec54b7/tiles/565f9740-5131-4648-87f2-f79c4cf9c5f5/infocushttps://app.powerbi.com/groups/me/dashboards/3784f99f-b460-4d5e-b86c-b6d8f7ec54b7/tiles/565f9740-5131-4648-87f2-f79c4cf9c5f5/infocus

    Para abrir esse bloco diretamente, o link seria:To open to this tile directly then, the link would be:

    mspbi://app/OpenTile?DashboardObjectId=3784f99f-b460-4d5e-b86c-b6d8f7ec54b7&TileObjectId=565f9740-5131-4648-87f2-f79c4cf9c5f5mspbi://app/OpenTile?DashboardObjectId=3784f99f-b460-4d5e-b86c-b6d8f7ec54b7&TileObjectId=565f9740-5131-4648-87f2-f79c4cf9c5f5

    Observe o E comercial (&) entre os dois parâmetros.Note the ampersand (&) between the two parameters.

    Se o dashboard não estiver no Meu Workspace, adicione o parâmetro GroupObjectId, por exemplo, &GroupObjectId=<36-character-group-id>If the dashboard is not in My Workspace, add the GroupObjectId parameter, e.g. &GroupObjectId=<36-character-group-id>

  • Abra em um relatório específicoOpen to a specific report

    Este link abre um relatório específico no aplicativo móvel do Power BI:This link opens a specific report in the Power BI mobile app:

    mspbi://app/OpenReport?ReportObjectId= <36-character-report-id>mspbi://app/OpenReport?ReportObjectId=<36-character-report-id>

    Para localizar a ID de objeto de 36 caracteres do relatório, navegue até o relatório específico no serviço do Power BI.To find the 36-character report object id, navigate to the specific report in the Power BI service. A URL a seguir do serviço do Power BI ilustra a ID do relatório que você deve extrair.The following URL from the Power BI service illustrates the report ID you would need to extract.

    https://app.powerbi.com/groups/me/reports/df9f0e94-31df-450b-b97f-4461a7e4d300https://app.powerbi.com/groups/me/reports/df9f0e94-31df-450b-b97f-4461a7e4d300

    Se o relatório não estiver no Meu Workspace, você precisará adicionar &GroupObjectId=<36-character-group-id> também, antes ou depois da ID do relatório.If the report is not in My Workspace, you need to add &GroupObjectId=<36-character-group-id> as well, either before or after the report ID. Por exemplo, nesse caso, o link profundo seria:For example, in this case the deep link would be:

    mspbi://app/OpenReport?ReportObjectId=e684af3a-9e7f-44ee-b679-b9a1c59b5d60&GroupObjectId=8cc900cc-7339-467f-8900-fec82d748248mspbi://app/OpenReport?ReportObjectId=e684af3a-9e7f-44ee-b679-b9a1c59b5d60&GroupObjectId=8cc900cc-7339-467f-8900-fec82d748248

    Observe o E comercial (&) entre os dois parâmetros.Note the ampersand (&) between the two parameters.

  • Abrir uma página específica do relatórioOpen a specific report page

    Este link abre uma página específica do relatório no aplicativo móvel do Power BI:This link opens a specific report page in the Power BI mobile app:

    mspbi://app/OpenReport?ReportObjectId= <36-character-report-id> &reportPage=ReportSection<number>mspbi://app/OpenReport?ReportObjectId=<36-character-report-id>&reportPage=ReportSection<number>

    A página do relatório se chama ReportSection, seguida por um número.The report page is called ReportSection, followed by a number. Novamente, para localizar os valores necessários, abra o relatório no serviço do Power BI, navegue até a página de relatório específica e extraia os valores necessários da URL.Again, to find the values you need, open the report in the Power BI service, navigate to the specific report page, and extract the values you need from the URL. Por exemplo, as seções realçadas desta URL representam os valores de que você precisaria para abrir uma página de relatório específica:For example, the highlighted sections of this URL represent the values you would need to open to a specific report page:

    https://app.powerbi.com/groups/me/reports/df9f0e94-31df-450b-b97f-4461a7e4d300/ReportSection11https://app.powerbi.com/groups/me/reports/df9f0e94-31df-450b-b97f-4461a7e4d300/ReportSection11

  • Abrir no modo de tela inteira (somente para dispositivos Windows)Open in full-screen mode (for Windows devices only)

    Em dispositivos Windows, você também pode adicionar o parâmetro openFullScreen para abrir um relatório específico no modo de tela inteira.For Windows devices, you can also add the openFullScreen parameter to open specific report in full-screen mode. O seguinte exemplo abre uma página de relatório no modo de tela inteira:The following example opens a report page in full screen mode:

    mspbi://app/OpenReport?ReportObjectId=500217de-50f0-4af1-b345-b81027224033&openFullScreen=truemspbi://app/OpenReport?ReportObjectId=500217de-50f0-4af1-b345-b81027224033&openFullScreen=true

  • Adicionar contexto (opcional)Add context (optional)

    Você também pode adicionar contexto à cadeia de caracteres.You can also add context to the string. Assim, se precisar entrar em contato conosco, poderemos usar esse contexto para filtrar nossos dados e encontrar o que é relevante para seu aplicativo.Then, if you need to contact us, we can use that context to filter our data to find what is relevant to your app. Para incluir contexto, adicione o parâmetro context=<app-name> ao link:To add context, add the parameter context=<app-name> to the link:

    Por exemplo, o seguinte exemplo mostra um link que inclui um parâmetro de contexto:For example, the following example shows a link that includes a context parameter:

    mspbi://app/OpenReport?ReportObjectId=e684af3a-9e7f-44ee-b679-b9a1c59b5d60&GroupObjectId=8cc900cc-7339-467f-8900-fec82d748248&context=SlackDeepLinkmspbi://app/OpenReport?ReportObjectId=e684af3a-9e7f-44ee-b679-b9a1c59b5d60&GroupObjectId=8cc900cc-7339-467f-8900-fec82d748248&context=SlackDeepLink

Nos aplicativos móveis do Power BI, os links funcionam do mesmo modo que funcionam no serviço do Power BI.In the Power BI mobile apps, links inside Power BI work just as they work in the Power BI service.

Caso deseje adicionar um link ao relatório que aponte para outro item do Power BI, basta copiar a URL desse item da barra de endereços do navegador.If you want to add link to your report that points to another Power BI item, you can just copy that item's URL from the browser address bar. Leia mais sobre como adicionar um hiperlink a uma caixa de texto em um relatório.Read more about how to add a hyperlink to a text box in a report.

Próximas etapasNext steps

Seus comentários nos ajudam a decidir o que implementar no futuro, portanto, não se esqueça de votar em outros recursos que você gostaria de ver em aplicativos móveis do Power BI.Your feedback helps us decide what to implement in the future, so don’t forget to vote for other features you'd like to see in Power BI mobile apps.