Criar um link para um local específico nos aplicativos móveis do Power BI

  • Artigo

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.

Há dois cenários principais para acessar conteúdo usando links em aplicativos móveis do Power BI:

  • Abrir o Power BI fora do aplicativo móvel e acessar um conteúdo específico. Geralmente, esse é um cenário de integração no qual você abre o aplicativo móvel do Power BI em outro aplicativo.

  • Para navegar dentro do Power BI. Geralmente, isso ocorre quando você deseja criar uma navegação personalizada no Power BI.

Este artigo aborda os seguintes casos:

  • Uso de links para abrir conteúdo específico do Power BI fora do aplicativo móvel. Dois formatos de links são descritos. Um deles usa um método de redirecionamento e pode ser usado independentemente de onde o Power BI será aberto. 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.

  • Uso de links dentro do Power BI para navegar até conteúdo específico do Power BI.

Os aplicativos móveis dão suporte a links de relatório que incluem parâmetros de cadeia de caracteres de consulta. Esses links são abertos no aplicativo móvel e pré-filtrados de acordo com as condições definidas na cadeia de caracteres de consulta. Para obter mais informações sobre como criar URLs de relatório com parâmetros de cadeia de caracteres de consulta, confira Filtrar parâmetros de cadeia de caracteres de consulta de relatório na URL.

Os aplicativos móveis também dão suporte à passagem de parâmetros a relatórios paginados via URLs. Para obter mais informações detalhadas, confira Passar um parâmetro de relatório em uma URL para um relatório paginado no Power BI.

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:

  • 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. O link tem uma sintaxe de redirecionamento especial para habilitar esse comportamento inteligente.

  • 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. 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.

O formato de link descrito nesta seção usa o redirecionamento para garantir que o link funcione independentemente de onde ele recebe o clique.

  • 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. Se o aplicativo móvel não estiver instalado no dispositivo, ele sugerirá que o usuário acesse a loja para obtê-lo.

  • Se o link receber um clique em um computador, ele abrirá o item relevante no portal da Web do Power BI.

O link deve começar com um prefixo especial, seguido por parâmetros de consulta:

http://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.

Os parâmetros de consulta são:

Parâmetro Valor Descrição
action (obrigatório) OpenApp
OpenReport
OpenDashboard
OpenTile
appId Guid de 36 caracteres Deve ser especificado caso você deseje abrir um relatório ou dashboard que faça parte de um aplicativo.
Exemplo: appId=baf4b16d-b5bd-4360-8a3a-51d11242c09b
groupObjectId Guid de 36 caracteres Especifica o workspace quando você deseja abrir um relatório ou dashboard que não faz parte do Meu Workspace.
Exemplo: groupObjectId=9a3841c6-74b3-46f1-85fd-bdd78f27b30e
dashboardObjectId Guid de 36 caracteres ID de objeto do dashboard (se a ação for OpenDashboard ou OpenTile)
Exemplo: dashboardObjectId=033bb049-5b68-4392-b3ef-ae9a43738a4a
reportObjectId Guid de 36 caracteres ID de objeto do relatório (se a ação for OpenReport)
Exemplo: reportObjectId=6114cec7-78e1-4926-88ff-0bc5338452cf
tileObjectId Guid de 36 caracteres ID de objeto do bloco (se a ação for OpenTile)
Exemplo: tileObjectId=a845dcb8-a289-43a8-94ea-67a8c0a068f9
reportPage ReportSection<num> Nome da página se você deseja abrir uma página de relatório específica. (se a ação for OpenReport)
Exemplo: reportPage=ReportSection6
bookmarkGuid Guid de 36 caracteres ID do indicador, se você deseja abrir uma exibição específica marcada com indicador. (se a ação for OpenReport)
Exemplo: bookmarkGuid=18e8872f-6db8-4cf8-8298-3b2ab254cc7f
Observação: não há suporte para valores no formato BookmarkXXXXXXXXXXXXXXXXXXX.
ctid Guid de 36 caracteres ID da organização do item (relevante para cenários B2B. Pode ser omitida se o item pertencer à organização do usuário)
Exemplo: ctid=5367c770-09d0-4110-bf6a-d760cb5ef681
fullScreen Booliano Quando verdadeiro, abre o item no modo de tela inteira. Compatível com relatórios, scorecards, dashboards e aplicativos (se o item de destino do aplicativo for um dos itens com suporte).
Exemplo: fullScreen=1

Observação

Os indicadores de nível de relatório não têm um formato bookmarkGUID e atualmente não podem ser passados como um parâmetro de um link profundo.

Exemplos:

Nos exemplos a seguir, os espaços reservados para os valores de parâmetro estão realçados em negrito. 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.

  • Abrir um aplicativo

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

  • Abrir um dashboard que faz parte de um aplicativo

    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 Workspace

    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. Isso abre a experiência de "publicar aplicativo". 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. É possível usar esses links fora do Power BI para acessar o aplicativo e seu conteúdo diretamente.

Captura de tela dos links de publicação do aplicativo do Power BI realçados.

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. 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.

Os exemplos mostram onde é possível encontrar as IDs necessárias nas URLs dos itens aos quais você deseja vincular.

  • 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:

    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. Este exemplo contém uma referência a uma página de relatório específica e a um indicador específico.

    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. Este exemplo mostra o relatório de um workspace diferente do Meu Workspace.

    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. Esse formato de link abre o local diretamente, sem nenhum dos redirecionamentos envolvidos no método descrito na seção anterior. Esse formato só pode ser aberto em dispositivos móveis que tenham o aplicativo do Power BI instalado.

Os links desse formato podem apontar diretamente para dashboards, blocos e relatórios. O destino do link profundo determina o formato. Siga estas etapas para criar links profundos para locais diferentes.

  • Abra o aplicativo móvel de Power BI

    Use este link para abrir o aplicativo móvel do Power BI em qualquer dispositivo:

    mspbi://app/

  • Abrir em um painel específico

    Este link abre o aplicativo móvel do Power BI em um dashboard específico:

    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. Por exemplo, a ID de objeto do dashboard está realçada na seguinte URL do serviço do Power BI:

    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. O link profundo mostrado tem o parâmetro de ID de objeto de grupo adicionado após a ID de objeto de dashboard:

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

    Observe o E comercial (&) entre os dois parâmetros.

  • Abrir em um bloco específico em foco

    Este link abre um bloco específico no modo de foco no aplicativo móvel do Power BI:

    mspbi://app/OpenTile?DashboardObjectId=<id-do-dashboard-de-36-caracteres>&TileObjectId=<id-do-bloco-de-36-caracteres>

    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. No exemplo, as IDs do dashboard e do bloco estão realçadas.

    https://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:

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

    Observe o E comercial (&) entre os dois parâmetros.

    Se o dashboard não estiver no Meu Workspace, adicione o parâmetro GroupObjectId, por exemplo, &GroupObjectId=<id-do-grupo-de-36-caracteres>

  • Abra em um relatório específico

    Este link abre um relatório específico no aplicativo móvel do Power BI:

    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. A URL a seguir do serviço do Power BI ilustra a ID do relatório que você deve extrair.

    https://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=<id-de-grupo-de-36-caracteres> também, antes ou depois da ID do relatório. Por exemplo, nesse caso, o link profundo seria:

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

    Observe o E comercial (&) entre os dois parâmetros.

  • Abrir uma página específica do relatório

    Este link abre uma página específica do relatório no aplicativo móvel do Power BI:

    mspbi://app/OpenReport?ReportObjectId=<id-do-relatório-de-36-caracteres>&reportPage=ReportSection<número>

    A página do relatório se chama ReportSection, seguida por um número. 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. 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:

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

  • Abrir no modo de tela inteira (somente para dispositivos Windows)

    Em dispositivos Windows, você também pode adicionar o parâmetro openFullScreen para abrir um relatório específico no modo de tela inteira. O seguinte exemplo abre uma página de relatório no modo de tela inteira:

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

  • Adicionar contexto (opcional)

    Você também pode adicionar contexto à cadeia de caracteres. Assim, se precisar entrar em contato conosco, poderemos usar esse contexto para filtrar nossos dados e encontrar o que é relevante para seu aplicativo. Para incluir contexto, adicione o parâmetro context=<app-name> ao link:

    Por exemplo, o seguinte exemplo mostra um link que inclui um parâmetro de contexto:

    mspbi://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.

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. Para obter mais informações, confira Adicionar um hiperlink a uma caixa de texto em um relatório.

Considerações e limitações

Há suporte para links profundos para relatórios com um parâmetro bookmarkGuid nos Aplicativos Móveis somente quando o valor do parâmetro bookmarkGuid tem o formato GUID padrão de 36 caracteres. Não há suporte para links em que o valor do parâmetro bookmarkGuid tem o formato BookmarkXXXXXXXXXXXXXXXXXXX.

Conteúdo relacionado

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.