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.
Använda länkar utanför mobilappen
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.
Skapa en länk som fungerar var som helst
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<>
Så här hämtar du rätt länkformat
Länkar till appar och objekt i appar
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.
Länkar till objekt som inte finns i en app
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=>
Skapa en länk som endast öppnas på en enhet som har Power BI-mobilappen installerad
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
Använda länkar i Power BI
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.
Relaterat innehåll
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.
- Vilka är Power BI-mobilapparna?
- Följ @MSPowerBI på Twitter
- Delta i konversationen i Power BI Community
- Vad är Power BI?