Dela via


Skapa en länk till en specifik plats i Power BI-mobilapparna

Du kan använda länkar för direkt åtkomst till specifikt Power BI-innehåll, till exempel en specifik rapport, rapportsida, instrumentpanel, panel osv.

Det finns två huvudsakliga scenarier för att använda länkar för att komma åt innehåll i Power BI-mobilapparna:

  • Öppna Power BI utanför mobilappen och landa på specifikt innehåll. Det här är vanligtvis ett integrationsscenario där du öppnar Power BI-mobilappen från en annan app.

  • Så här navigerar du i Power BI. Detta görs vanligtvis när du vill skapa anpassad navigering i Power BI.

Den här artikeln beskriver följande fall:

  • Använda länkar för att öppna specifikt Power BI-innehåll utanför mobilappen. Två länkformat beskrivs. Man använder en omdirigeringsmetod och kan användas oavsett var Power BI öppnas. Den andra öppnas direkt i Power BI-mobilappen och fungerar endast på mobila enheter som har mobilappen installerad.

  • Använda länkar i Power BI för att navigera till specifikt Power BI-innehåll.

Mobilapparna stöder rapportlänkar som innehåller frågesträngsparametrar. Sådana länkar öppnas i mobilappen förfiltrerad enligt de villkor som definierats i frågesträngen. Mer information om hur du skapar rapport-URL:er med frågesträngsparametrar finns i Filtrera en rapportfrågesträngsparametrar i URL:en.

Mobilapparna har också stöd för att skicka parametrar till sidnumrerade rapporter via URL:er. Mer information finns i Skicka en rapportparameter i en URL för en sidnumrerad rapport för mer information.

När du vill länka till ett specifikt objekt i Power BI utanför mobilappen finns det två alternativ, beroende på var länken ska öppnas:

  • Om du vill att länken ska öppnas korrekt oavsett om den klickas i en datorwebbläsare eller på en mobil enhet kan du skapa en länk som ser till att den öppnas korrekt oavsett var den klickas. Den här länken har en särskild omdirigeringssyntax för att aktivera det här smarta beteendet.

  • Om du vet att länken bara kommer att öppnas på en mobil enhet som har Power BI-mobilappen installerad kan du undvika omdirigeringskostnaderna för metoden ovan och använda en annan länksyntax som öppnar länken direkt i Power BI-mobilappen på den mobila enheten. Observera dock att även om den här länken undviker omdirigeringskostnaderna för den första metoden fungerar den inte om den öppnas någon annanstans än på en mobil enhet som har Power BI-mobilappen installerad.

Länkformatet som beskrivs i det här avsnittet använder omdirigering för att se till att länken fungerar oavsett var den klickas.

  • Om länken klickas på en mobil enhet ser den till att enheten använder Power BI-mobilappen för att öppna länken. Om mobilappen inte är installerad på enheten föreslår den att användaren går till butiken för att hämta den.

  • Om länken klickas på en dator öppnas relevant objekt i Power BI-webbportalen.

Länken måste börja med ett särskilt prefix följt av frågeparametrar:

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

Viktigt!

Om ditt innehåll finns i ett särskilt datacenter, till exempel Myndigheter, Kina osv., bör länken börja med lämplig Power BI-adress, till exempel app.powerbigov.us eller app.powerbi.cn.

Frågeparametrarna är:

Parameter Värde beskrivning
åtgärd (obligatoriskt) OpenApp
OpenReport
OpenDashboard
OpenTile
appId Guid med 36 tecken Måste anges om du vill öppna en rapport eller instrumentpanel som är en del av en app.
Exempel: appId=00001111-aaaa-2222-bbbb-3333cccc4444
groupObjectId Guid med 36 tecken Anger arbetsytan när du vill öppna en rapport eller instrumentpanel som inte är en del av Min arbetsyta.
Exempel: groupObjectId=aaaaaaaaa-0000-1111-2222-bbbbbbbbbbbb
dashboardObjectId Guid med 36 tecken Instrumentpanelsobjekt-ID (om åtgärden är OpenDashboard eller OpenTile)
Exempel: dashboardObjectId=aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb
reportObjectId Guid med 36 tecken Rapportobjekt-ID (om åtgärden är OpenReport)
Exempel: reportObjectId=aaaaaaaaa-0000-1111-2222-bbbbbbbbbbbb
tileObjectId Guid med 36 tecken Objekt-ID för panel (om åtgärden är OpenTile)
Exempel: tileObjectId=aaaaaaaaa-0000-1111-2222-bbbbbbbbbbbb
reportPage sträng Sidnamn om du vill öppna en specifik rapportsida. (om åtgärden är OpenReport)
Exempel: reportPage=ReportSection6
bookmarkGuid Guid med 36 tecken Bokmärkes-ID om du vill öppna en specifik bokmärkesvy. (om åtgärden är OpenReport)
Exempel: bookmarkGuid=aaaaaaaaa-0000-1111-2222-bbbbbbbbbbbb
Obs! Värden i formatet BookmarkXXXXXXXXXXXXXXXXXXXXXXX STÖDS inte.
ctid Guid med 36 tecken Objektorganisations-ID (relevant för B2B-scenarier. Detta kan utelämnas om objektet tillhör användarens organisation)
Exempel: aaaaaaaaa-0000-1111-2222-bbbbbbbbbbbb
fullScreen Booleskt När det är sant öppnas objektet i helskärmsläge. Stöds för rapporter, styrkort, instrumentpaneler och appar (om applandningsobjektet är ett av de objekt som stöds).
Exempel: fullScreen=1

Kommentar

Bokmärken på rapportnivå har inget bookmarkGUID-format och kan för närvarande inte skickas som en parameter för en djuplänk.

Exempel:

I följande exempel markeras platshållarna för parametervärdena i fetstil. Om du vill hämta de faktiska värdena går du till Power BI-tjänst, öppnar det objekt som du vill länka till och extraherar de värden du behöver från objektets URL.

  • Öppna en app

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

  • Öppna en instrumentpanel som ingår i en app

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

  • Öppna en rapport som är en del av en annan arbetsyta än Min arbetsyta

    https://app.powerbi.com/Redirect?Action=OpenReport& reportObjectId=<&groupObjectId=>&reportPage=ReportSectionnum<>

För appar och för rapporter och instrumentpaneler som ingår i en app är det enklaste sättet att hämta länken att gå till apparbetsytan och välja Uppdatera app. Då öppnas upplevelsen "publicera app". Öppna behörighetsfliken och expandera avsnittet länkar för att se länkarna till appen och allt dess innehåll. Du kan använda dessa länkar utanför Power BI för att komma åt appen och dess innehåll direkt.

Skärmbild av fliken Appbehörigheter som visar hur du hittar djupa länkar till appen, rapporten och instrumentpanelen som ingår i appen.

För rapporter och instrumentpaneler som inte ingår i en app måste du extrahera objekt-ID:t som du behöver från objektets URL. Om du vill göra det går du till Power BI-tjänst, navigerar till det objekt som du vill länka till och letar efter de värden du behöver i url:en som visas i webbläsarens adressfält.

Exemplen visar var du kan hitta de ID:er som du behöver i URL:erna för de objekt som du vill länka till.

  • Om du vill hitta ett objekt-ID på 36 tecken navigerar du till den specifika instrumentpanel som du vill länka till i Power BI-tjänst och hittar objekt-ID:t för instrumentpanelen och andra nödvändiga ID:er på de platser som anges:

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

  • Om du vill hitta ett objekt-ID på 36 tecken går du till den specifika rapport som du vill länka till i Power BI-tjänst och hittar de nödvändiga ID:erna enligt bilden. Det här exemplet innehåller en referens till en specifik rapportsida och ett specifikt bokmärke.

    https://app.powerbi.com/groups/me/reports/ >

  • Om du vill länka till ett objekt på en annan arbetsyta än Min arbetsyta måste du extrahera gruppobjektets ID. Det här exemplet visar en rapport från en annan arbetsyta än Min arbetsyta.

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

Länkformatet som beskrivs i det här avsnittet länkar till en specifik plats i Power BI-mobilapparna på alla mobila plattformar: iOS, Android-enheter och Windows. Det här länkformatet öppnar platsen direkt, utan någon av de omdirigeringar som ingår i metoden som beskrivs i föregående avsnitt. Det här formatet kan bara öppnas på mobila enheter som har Power BI-mobilappen installerad.

Länkar i det här formatet kan peka direkt på instrumentpaneler, paneler och rapporter. Målet för djuplänken avgör dess format. Följ de här stegen för att skapa djupa länkar till olika platser.

  • Öppna Power BI-mobilappen

    Använd den här länken om du vill öppna Power BI-mobilappen på valfri enhet:

    mspbi://app/

  • Öppna till en specifik instrumentpanel

    Den här länken öppnar Power BI-mobilappen till en specifik instrumentpanel:

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

    Om du vill hämta objekt-ID:t för instrumentpanelen med 36 tecken går du till den specifika instrumentpanelen i Power BI-tjänst och extraherar den från URL:en. Objekt-ID:t för instrumentpanelen är till exempel markerat i följande URL från Power BI-tjänst:

    https://app.powerbi.com/groups/me/dashboards/ <aaaaaaaaa-0000-1111-2222-bbbbbbbbbbbb>

    Om instrumentpanelen inte finns i Min arbetsyta måste du också lägga till gruppobjekt-ID:t, antingen före eller efter instrumentpanelens ID. Den djuplänk som visas innehåller parametern gruppobjekt-ID som lagts till efter instrumentpanelens objekt-ID:

    mspbi://app/OpenDashboard?DashboardObjectId=aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb&GroupObjectId=cccccccc-2222-3333-4444-dddddddddddd

    Observera etet (&) mellan de två parametrarna.

  • Öppna till en specifik panel i fokus

    Den här länken öppnar en specifik panel i fokusläge i Power BI-mobilappen:

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

    Om du vill hitta objekt-ID:erna på 36 tecken navigerar du till den specifika instrumentpanelen i Power BI-tjänst och öppnar panelen i fokusläge. I exemplet är instrumentpanelen och panel-ID:na markerade.

    https://app.powerbi.com/groups/me/dashboards/ aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/tiles/cccccccc-2222-3333-4444-dddddddddddd/infocus

    Om du vill öppna den här panelen direkt då är länken:

    mspbi://app/OpenTile?DashboardObjectId=aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb&TileObjectId=cccccccc-2222-3333-4444-dddddddddddd

    Observera etet (&) mellan de två parametrarna.

    Om instrumentpanelen inte finns i Min arbetsyta lägger du till parametern GroupObjectId, till exempel &GroupObjectId=<36-character-group-id>

  • Öppna för en specifik rapport

    Den här länken öppnar en specifik rapport i Power BI-mobilappen:

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

    Om du vill hitta rapportobjektets ID på 36 tecken går du till den specifika rapporten i Power BI-tjänst. Följande URL från Power BI-tjänst illustrerar det rapport-ID som du skulle behöva extrahera.

    https://app.powerbi.com/groups/me/reports/ dddddddd-3333-4444-5555-eeeeeeeeeeeeee

    Om rapporten inte finns i Min arbetsyta måste du också lägga till &GroupObjectId=<36-character-group-id> , antingen före eller efter rapport-ID:t. I det här fallet skulle till exempel den djupa länken vara:

    mspbi://app/OpenReport?ReportObjectId=ddddddddd-3333-4444-5555-eeeeeeeeeeeeee&GroupObjectId=ffffffff-5555-6666-7777-aaaaaa

    Observera etet (&) mellan de två parametrarna.

  • Öppna en specifik rapportsida

    Den här länken öppnar en specifik rapportsida i Power BI-mobilappen:

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

    Rapportsidan kallas ReportSection följt av ett tal. Om du vill hitta de värden du behöver öppnar du rapporten i Power BI-tjänst, navigerar till den specifika rapportsidan och extraherar de värden du behöver från URL:en. Till exempel representerar de markerade avsnitten i den här URL:en de värden som du skulle behöva öppna för en specifik rapportsida:

    https://app.powerbi.com/groups/me/reports/ ddddddddd-3333-4444-5555-eeeeeeeeeeeeee/ReportSection11

  • Lägg till kontext (valfritt)

    Du kan också lägga till kontext i strängen. Om du sedan behöver kontakta oss kan vi använda den kontexten för att filtrera våra data för att hitta det som är relevant för din app. Lägg till kontext genom att lägga till parametern context=<app-name> i länken:

    I följande exempel visas till exempel en länk som innehåller en kontextparameter:

    mspbi://app/OpenReport?ReportObjectId=ddddddddd-3333-4444-5555-eeeeeeeeeeee&GroupObjectId=eeeeeeeeee-4444-5555-6666-ffffffffffffff&context=SlackDeepLink

I Power BI-mobilappar fungerar länkar i Power BI precis som de fungerar i Power BI-tjänst.

Om du vill lägga till en länk till rapporten som pekar på ett annat Power BI-objekt kan du bara kopiera objektets URL från webbläsarens adressfält. Mer information finns i Lägga till en hyperlänk i en textruta i en rapport.

Beaktanden och begränsningar

Djupa länkar till rapporter med en bookmarkGuid-param stöds endast i Mobilappar när värdet för parametern bookmarkGuid har GUID-standardformatet på 36 tecken. Länkar där parametervärdet bookmarkGuid har formatet BookmarkXXXXXXXXXXXXXXXXXXXXXXXXXXX stöds inte.

Din feedback hjälper oss att bestämma vad vi ska implementera i framtiden, så glöm inte att rösta på andra funktioner som du vill se i Power BI-mobilappar.