Een koppeling maken naar een specifieke locatie in de mobiele Power BI-apps

  • Artikel

U kunt koppelingen gebruiken om rechtstreeks toegang te krijgen tot specifieke Power BI-inhoud, zoals een specifiek rapport, rapportpagina, dashboard, tegel, enzovoort.

Er zijn twee hoofdscenario's voor het gebruik van koppelingen voor toegang tot inhoud in de mobiele Power BI-apps:

  • Als u Power BI van buiten de mobiele app wilt openen en op specifieke inhoud wilt terechtkomen. Dit is meestal een integratiescenario, waarbij u de mobiele Power BI-app opent vanuit een andere app.

  • Navigeren in Power BI. Dit wordt meestal gedaan wanneer u aangepaste navigatie wilt maken in Power BI.

In dit artikel worden de volgende gevallen behandeld:

  • Koppelingen gebruiken om specifieke Power BI-inhoud van buiten de mobiele app te openen. Er worden twee koppelingsindelingen beschreven. Eén gebruikt een omleidingsmethode en kan worden gebruikt, ongeacht waar Power BI wordt geopend. De andere wordt rechtstreeks geopend in de mobiele Power BI-app en werkt alleen op mobiele apparaten waarop de mobiele app is geïnstalleerd.

  • Koppelingen in Power BI gebruiken om naar specifieke Power BI-inhoud te navigeren.

De mobiele apps ondersteunen rapportkoppelingen met queryreeksparameters. Dergelijke koppelingen worden geopend in de mobiele app die vooraf is gefilterd op basis van de voorwaarden die zijn gedefinieerd in de querytekenreeks. Zie Filter a report query string parameters in the URL voor meer informatie over het maken van rapport-URL's met queryreeksparameters.

De mobiele apps ondersteunen ook het doorgeven van parameters aan gepagineerde rapporten via URL's. Zie Een rapportparameter doorgeven in een URL voor een gepagineerd rapport voor meer informatie.

Als u een koppeling wilt maken naar een specifiek item in Power BI van buiten de mobiele app, zijn er twee opties, afhankelijk van waar de koppeling wordt geopend:

  • Als u wilt dat de koppeling correct wordt geopend, ongeacht of deze wordt geklikt in een computerbrowser of op een mobiel apparaat, kunt u een koppeling maken die ervoor zorgt dat deze correct wordt geopend, ongeacht waar deze wordt geklikt. Deze koppeling heeft een speciale omleidingssyntaxis om dit slimme gedrag mogelijk te maken.

  • Als u weet dat de koppeling alleen wordt geopend op een mobiel apparaat waarop de mobiele Power BI-app is geïnstalleerd, kunt u de omleidingsoverhead van de bovenstaande methode voorkomen en een andere koppelingssyntaxis gebruiken waarmee de koppeling rechtstreeks in de mobiele Power BI-app op het mobiele apparaat wordt geopend. Het is belangrijk om te weten dat hoewel deze koppeling de omleidingsoverhead van de eerste methode vermijdt, deze niet werkt als deze ergens anders wordt geopend dan op een mobiel apparaat waarop de mobiele Power BI-app is geïnstalleerd.

De koppelingsindeling die in deze sectie wordt beschreven, maakt gebruik van omleiding om ervoor te zorgen dat de koppeling werkt, ongeacht waar deze wordt geklikt.

  • Als op een mobiel apparaat op de koppeling wordt geklikt, zorgt u ervoor dat het apparaat de mobiele Power BI-app gebruikt om de koppeling te openen. Als de mobiele app niet op het apparaat is geïnstalleerd, wordt de gebruiker voorgesteld om naar de Store te gaan om deze te downloaden.

  • Als op een pc op de koppeling wordt geklikt, wordt het relevante item geopend in de Power BI-webportal.

De koppeling moet beginnen met een speciaal voorvoegsel, gevolgd door queryparameters:

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

Belangrijk

Als uw inhoud wordt gehost in een speciaal datacenter, zoals government, China, enzovoort, moet de koppeling beginnen met het juiste Power BI-adres, zoals app.powerbigov.us of app.powerbi.cn.

De queryparameters zijn:

Parameter Weergegeven als Beschrijving
actie (verplicht) OpenApp
Openreport
OpenDashboard
OpenTile
Appid Guid met 36 tekens Moet worden opgegeven als u een rapport of dashboard wilt openen dat deel uitmaakt van een app.
Voorbeeld: appId=baf4b16d-b5bd-4360-8a3a-51d11242c09b
groupObjectId Guid met 36 tekens Hiermee geeft u de werkruimte op wanneer u een rapport of dashboard wilt openen dat geen deel uitmaakt van Mijn werkruimte.
Voorbeeld: groupObjectId=9a3841c6-74b3-46f1-85fd-bdd78f27b30e
dashboardObjectId Guid met 36 tekens Dashboardobject-id (als de actie OpenDashboard of OpenTile is)
Voorbeeld: dashboardObjectId=033bb049-5b68-4392-b3ef-ae9a43738a4a
reportObjectId Guid met 36 tekens Rapportobject-id (als de actie OpenReport is)
Voorbeeld: reportObjectId=6114cec7-78e1-4926-88ff-0bc5338452cf
tileObjectId Guid met 36 tekens Tegelobject-id (als de actie OpenTile is)
Voorbeeld: tileObjectId=a845dcb8-a289-43a8-94ea-67a8c0a068f9
reportPage Rapportnummer<> Paginanaam als u een specifieke rapportpagina wilt openen. (als de actie OpenReport is)
Voorbeeld: reportPage=ReportSection6
bookmarkGuid Guid met 36 tekens Bladwijzer-id als u een specifieke weergave met bladwijzers wilt openen. (als de actie OpenReport is)
Voorbeeld: bookmarkGuid=18e8872f-6db8-4cf8-8298-3b2ab254cc7f
Opmerking: waarden van de indeling BookmarkXXXXXXXXXXXXXXXXXXXXXXXXX WORDEN niet ondersteund.
ctid Guid met 36 tekens Organisatie-id van items (relevant voor B2B-scenario's. Dit kan worden weggelaten als het item deel uitmaakt van de organisatie van de gebruiker)
Voorbeeld: ctid=5367c770-09d0-4110-bf6a-d760cb5ef681
Fullscreen Booleaanse waarde Wanneer waar, opent u het item in de modus Volledig scherm. Ondersteund voor rapporten, scorecards, dashboards en apps (als het app-landingsitem een van de ondersteunde items is).
Voorbeeld: fullScreen=1

Notitie

Bladwijzers op rapportniveau hebben geen bladwijzerGUID-indeling en kunnen momenteel niet worden doorgegeven als parameter van een dieptekoppeling.

Voorbeelden:

In de volgende voorbeelden worden tijdelijke aanduidingen voor de parameterwaarden vet gemarkeerd. Als u de werkelijke waarden wilt ophalen, gaat u naar de Power BI-service, opent u het item waarnaar u een koppeling wilt maken en haalt u de waarden op die u nodig hebt uit de URL van het item.

  • Een app openen

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

  • Een dashboard openen dat deel uitmaakt van een app

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

  • Een rapport openen dat deel uitmaakt van een andere werkruimte dan Mijn werkruimte

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

Voor apps en voor rapporten en dashboards die deel uitmaken van een app, is de eenvoudigste manier om de koppeling op te halen naar de app-werkruimte en de app bijwerken te kiezen. Hiermee opent u de ervaring 'App publiceren'. Open het tabblad Machtigingen en vouw de sectie Koppelingen uit om de koppelingen naar de app en alle inhoud ervan weer te geven. U kunt deze koppelingen van buiten Power BI gebruiken om rechtstreeks toegang te krijgen tot de app en de inhoud ervan.

Schermopname van app-koppelingen voor publiceren in Power BI gemarkeerd.

Voor rapporten en dashboards die geen deel uitmaken van een app, moet u de object-id's extraheren die u nodig hebt uit de URL van het item. Hiervoor gaat u naar de Power BI-service, gaat u naar het item waarnaar u een koppeling wilt maken en zoekt u naar de waarden die u nodig hebt in de URL die u in de adresbalk van de browser ziet.

In de voorbeelden ziet u waar u de id's kunt vinden die u nodig hebt in de URL's van de items waarnaar u een koppeling wilt maken.

  • Als u een dashboardobject-id van 36 tekens wilt vinden, gaat u naar het specifieke dashboard waarnaar u een koppeling wilt maken in de Power BI-service en zoekt u de id van het dashboardobject en eventuele andere vereiste id's op de aangegeven plaatsen:

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

  • Als u een object-id van 36 tekens wilt zoeken, gaat u naar het specifieke rapport waarnaar u een koppeling wilt maken in de Power BI-service en zoekt u de benodigde id's zoals geïllustreerd. Dit voorbeeld bevat een verwijzing naar een specifieke rapportpagina en een specifieke bladwijzer.

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

  • Als u een koppeling wilt maken naar een item in een andere werkruimte dan Mijn werkruimte, moet u de groepsobject-id extraheren. In dit voorbeeld ziet u een rapport uit een andere werkruimte dan Mijn werkruimte.

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

De koppelingsindeling die in deze sectie wordt beschreven, is gekoppeld aan een specifieke locatie in de mobiele Power BI-apps op alle mobiele platforms: iOS- en Android-apparaten en Windows. Met deze koppelingsindeling wordt de locatie rechtstreeks geopend, zonder dat er een omleiding is betrokken bij de methode die in de vorige sectie is beschreven. Deze indeling kan alleen worden geopend op mobiele apparaten waarop de mobiele Power BI-app is geïnstalleerd.

Koppelingen van deze indeling kunnen rechtstreeks verwijzen naar dashboards, tegels en rapporten. De bestemming van de dieptekoppeling bepaalt de indeling. Volg deze stappen om dieptekoppelingen naar verschillende locaties te maken.

  • De mobiele Power BI-app openen

    Gebruik deze koppeling om de mobiele Power BI-app op elk apparaat te openen:

    mspbi://app/

  • Openen naar een specifiek dashboard

    Met deze koppeling opent u de mobiele Power BI-app naar een specifiek dashboard:

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

    Als u de object-id van het dashboard met 36 tekens wilt ophalen, gaat u naar het specifieke dashboard in de Power BI-service en extraheert u het uit de URL. De object-id van het dashboard is bijvoorbeeld gemarkeerd in de volgende URL uit de Power BI-service:

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

    Als het dashboard zich niet in Mijn werkruimte bevindt, moet u ook de groepsobject-id toevoegen, vóór of na de dashboard-id. De dieptekoppeling die wordt weergegeven, bevat de parameter object-id van de groep toegevoegd na de object-id van het dashboard:

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

    Let op het en-teken (&) tussen de twee parameters.

  • Openen naar een specifieke tegel met focus

    Met deze koppeling opent u een specifieke tegel in de focusmodus in de mobiele Power BI-app:

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

    Als u de dashboard- en tegelobject-id's van 36 tekens wilt vinden, gaat u naar het specifieke dashboard in de Power BI-service en opent u de tegel in de focusmodus. In het voorbeeld zijn de dashboard- en tegel-id's gemarkeerd.

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

    Als u deze tegel rechtstreeks wilt openen, is de koppeling:

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

    Let op het en-teken (&) tussen de twee parameters.

    Als het dashboard zich niet in Mijn werkruimte bevindt, voegt u de parameter GroupObjectId toe, bijvoorbeeld &GroupObjectId=<36-character-group-id>

  • Openen voor een specifiek rapport

    Met deze koppeling wordt een specifiek rapport geopend in de mobiele Power BI-app:

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

    Als u de object-id van het rapport van 36 tekens wilt vinden, gaat u naar het specifieke rapport in de Power BI-service. De volgende URL uit de Power BI-service illustreert de rapport-id die u moet extraheren.

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

    Als het rapport zich niet in Mijn werkruimte bevindt, moet u ook &GroupObjectId=<36-character-group-id> toevoegen, voor of na de rapport-id. In dit geval is de dieptekoppeling bijvoorbeeld:

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

    Let op het en-teken (&) tussen de twee parameters.

  • Een specifieke rapportpagina openen

    Met deze koppeling opent u een specifieke rapportpagina in de mobiele Power BI-app:

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

    De rapportpagina heet ReportSection, gevolgd door een getal. Als u de gewenste waarden wilt vinden, opent u het rapport in de Power BI-service, navigeert u naar de specifieke rapportpagina en haalt u de waarden op die u nodig hebt uit de URL. De gemarkeerde secties van deze URL vertegenwoordigen bijvoorbeeld de waarden die u moet openen voor een specifieke rapportpagina:

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

  • Openen in de modus Volledig scherm (alleen voor Windows-apparaten)

    Voor Windows-apparaten kunt u ook de parameter openFullScreen toevoegen om een specifiek rapport in de modus Volledig scherm te openen. In het volgende voorbeeld wordt een rapportpagina geopend in de modus Volledig scherm:

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

  • Context toevoegen (optioneel)

    U kunt ook context toevoegen aan de tekenreeks. Als u vervolgens contact met ons moet opnemen, kunnen we die context gebruiken om onze gegevens te filteren om te vinden wat relevant is voor uw app. Als u context wilt toevoegen, voegt u de parametercontext =<app-name> toe aan de koppeling:

    In het volgende voorbeeld ziet u bijvoorbeeld een koppeling met een contextparameter:

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

In de mobiele Power BI-apps werken koppelingen in Power BI op dezelfde wijze als in de Power BI-service.

Als u een koppeling naar uw rapport wilt toevoegen die verwijst naar een ander Power BI-item, kunt u de URL van dat item gewoon kopiëren vanuit de adresbalk van de browser. Zie Een hyperlink toevoegen aan een tekstvak in een rapport voor meer informatie.

Overwegingen en beperkingen

Dieptekoppelingen naar rapporten met een parameter bookmarkGuid worden alleen ondersteund in de mobiele apps wanneer de waarde van de parameter bookmarkGuid de standaard GUID-indeling van 36 tekens heeft. Koppelingen waarin de parameterwaarde bookmarkGuid de indeling BookmarkXXXXXXXXXXXXXXXXXXXXXXXXXXX HEEFT , worden niet ondersteund.

Gerelateerde inhoud

Uw feedback helpt ons te bepalen wat u in de toekomst wilt implementeren, dus vergeet niet te stemmen op andere functies die u wilt zien in mobiele Power BI-apps.