Creare un collegamento a una posizione specifica nelle app Power BI per dispositivi mobili

  • Articolo

È possibile usare i collegamenti per accedere direttamente a contenuto specifico di Power BI, ad esempio un report specifico, una pagina del report, un dashboard, un riquadro e così via.

Esistono due scenari principali per l'uso di collegamenti per accedere al contenuto nelle app Power BI per dispositivi mobili:

  • Per aprire Power BI dall'esterno dell'app per dispositivi mobili e passare a contenuti specifici. Si tratta in genere di uno scenario di integrazione in cui si apre l'app Power BI per dispositivi mobili da un'altra app.

  • Per spostarsi all'interno di Power BI. Questa operazione viene in genere eseguita quando si vuole creare una struttura di spostamento personalizzata in Power BI.

Questo articolo illustra i casi seguenti:

  • Uso di collegamenti per aprire contenuto di Power BI specifico dall'esterno dell'app per dispositivi mobili. Vengono descritti due formati di collegamento. Uno usa un metodo di reindirizzamento e può essere usato indipendentemente dalla posizione in cui verrà aperto Power BI. L'altra si apre direttamente nell'app Power BI per dispositivi mobili e funzionerà solo nei dispositivi mobili in cui è installata l'app per dispositivi mobili.

  • Uso dei collegamenti all'interno di Power BI per passare a contenuto di Power BI specifico.

Le app per dispositivi mobili supportano i collegamenti ai report che includono parametri di stringa di query. Tali collegamenti vengono aperti nell'app per dispositivi mobili pre-filtrati in base alle condizioni definite nella stringa di query. Per altre informazioni sulla creazione di URL di report con parametri di stringa di query, vedere Filtrare i parametri di una stringa di query del report nell'URL.

Le app per dispositivi mobili supportano anche il passaggio di parametri ai report impaginati tramite URL. Per altre informazioni, vedere Passare un parametro del report in un URL per un report impaginato per informazioni dettagliate.

Quando si vuole collegare a un elemento specifico in Power BI dall'esterno dell'app per dispositivi mobili, sono disponibili due opzioni, a seconda della posizione in cui verrà aperto il collegamento:

  • Se si desidera che il collegamento venga aperto correttamente indipendentemente dal fatto che sia selezionato in un browser del computer o in un dispositivo mobile, è possibile creare un collegamento che garantisce che venga aperto correttamente indipendentemente dalla posizione in cui viene fatto clic. Questo collegamento ha una sintassi di reindirizzamento speciale per abilitare questo comportamento intelligente.

  • Se si sa che il collegamento verrà aperto solo in un dispositivo mobile in cui è installata l'app Power BI per dispositivi mobili, è possibile evitare il sovraccarico di reindirizzamento del metodo precedente e usare un'altra sintassi di collegamento che apre il collegamento direttamente nell'app Power BI per dispositivi mobili nel dispositivo mobile. È importante notare tuttavia che, mentre questo collegamento evita il sovraccarico di reindirizzamento del primo metodo, non funzionerà se aperto in qualsiasi punto diverso da un dispositivo mobile in cui è installata l'app Power BI per dispositivi mobili.

Il formato di collegamento descritto in questa sezione usa il reindirizzamento per assicurarsi che il collegamento funzioni indipendentemente dal punto in cui viene fatto clic.

  • Se si fa clic sul collegamento su un dispositivo mobile, assicurarsi che il dispositivo usi l'app Power BI per dispositivi mobili per aprire il collegamento. Se l'app per dispositivi mobili non è installata nel dispositivo, suggerisce all'utente di passare allo Store per ottenerla.

  • Se il collegamento viene fatto clic su un PC, verrà aperto l'elemento pertinente nel portale Web di Power BI.

Il collegamento deve iniziare con un prefisso speciale, seguito dai parametri di query:

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

Importante

Se il contenuto è ospitato in data center speciali, ad esempio Government, Cina e così via, il collegamento deve iniziare con l'indirizzo di Power BI appropriato, ad esempio app.powerbigov.us o app.powerbi.cn.

I parametri di query sono:

Parametro valore Descrizione
azione (obbligatoria) OpenApp
Aprireport
OpenDashboard
OpenTile
IDapp Guid di 36 caratteri Deve essere specificato se si vuole aprire un report o un dashboard che fa parte di un'app.
Esempio: appId=baf4b16d-b5bd-4360-8a3a-51d11242c09b
groupObjectId Guid di 36 caratteri Specifica l'area di lavoro quando si vuole aprire un report o un dashboard che non fa parte dell'area di lavoro personale.
Esempio: groupObjectId=9a3841c6-74b3-46f1-85fd-bdd78f27b30e
dashboardObjectId Guid di 36 caratteri ID oggetto dashboard (se action è OpenDashboard o OpenTile)
Esempio: dashboardObjectId=033bb049-5b68-4392-b3ef-ae9a43738a4a
reportObjectId Guid di 36 caratteri ID oggetto report (se action è OpenReport)
Esempio: reportObjectId=6114cec7-78e1-4926-88ff-0bc5338452cf
tileObjectId Guid di 36 caratteri ID oggetto riquadro (se action è OpenTile)
Esempio: tileObjectId=a845dcb8-a289-43a8-94ea-67a8c0a068f9
reportPage Numero reportSection<> Nome pagina se si desidera aprire una pagina del report specifica. (se l'azione è OpenReport)
Esempio: reportPage=ReportSection6
bookmarkGuid Guid di 36 caratteri ID segnalibro, se si desidera aprire una visualizzazione con segnalibro specifica. (se l'azione è OpenReport)
Esempio: bookmarkGuid=18e8872f-6db8-4cf8-8298-3b2ab254cc7f
Nota: i valori del formato BookmarkXXXXXXXXXXXXXXXXXXXXXX NON sono supportati.
ctid Guid di 36 caratteri ID organizzazione dell'elemento (rilevante per gli scenari B2B. Questo può essere omesso se l'elemento appartiene all'organizzazione dell'utente)
Esempio: ctid=5367c770-09d0-4110-bf6a-d760cb5ef681
Fullscreen Booleano Se true, apre l'elemento in modalità schermo intero. Supportato per report, scorecard, dashboard e app (se l'elemento di destinazione dell'app è uno degli elementi supportati).
Esempio: fullScreen=1

Nota

I segnalibri a livello di report non hanno un formato bookmarkGUID e attualmente non possono essere passati come parametro di un collegamento diretto.

Esempi:

Negli esempi seguenti i segnaposto per i valori dei parametri sono evidenziati in grassetto. Per ottenere i valori effettivi, passare al servizio Power BI, aprire l'elemento a cui si vuole collegare ed estrarre i valori necessari dall'URL dell'elemento.

  • Aprire un'app

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

  • Aprire un dashboard che fa parte di un'app

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

  • Aprire un report che fa parte di un'area di lavoro diversa da Area di lavoro personale

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

Per le app e per i report e i dashboard che fanno parte di un'app, il modo più semplice per ottenere il collegamento consiste nell'accedere all'area di lavoro per le app e scegliere Aggiorna app. Verrà aperta l'esperienza di pubblicazione dell'app. Aprire la scheda Autorizzazioni ed espandere la sezione collegamenti per visualizzare i collegamenti all'app e tutto il relativo contenuto. È possibile usare questi collegamenti dall'esterno di Power BI per accedere direttamente all'app e al relativo contenuto.

Screenshot dei collegamenti alle app di pubblicazione di Power BI evidenziati.

Per i report e i dashboard che non fanno parte di un'app, è necessario estrarre gli ID oggetto necessari dall'URL dell'elemento. A tale scopo, passare alla servizio Power BI, passare all'elemento a cui si vuole collegare e cercare i valori necessari nell'URL visualizzato nella barra degli indirizzi del browser.

Gli esempi mostrano dove è possibile trovare gli ID necessari negli URL degli elementi a cui si vuole collegare.

  • Per trovare un ID oggetto dashboard a 36 caratteri, passare al dashboard specifico a cui si vuole collegarsi nella servizio Power BI e trovare l'ID oggetto dashboard e qualsiasi altro ID richiesto nelle posizioni indicate:

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

  • Per trovare un ID oggetto report a 36 caratteri, passare al report specifico a cui si desidera collegarsi nella servizio Power BI e trovare gli ID necessari come illustrato. Questo esempio contiene un riferimento a una pagina del report specifica e a un segnalibro specifico.

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

  • Per collegare un elemento in un'area di lavoro diversa da Area di lavoro personale, è necessario estrarre l'ID oggetto gruppo. Questo esempio mostra un report di un'area di lavoro diversa da Area di lavoro personale.

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

Il formato di collegamento descritto in questa sezione è collegato a una posizione specifica all'interno delle app Power BI per dispositivi mobili in tutte le piattaforme per dispositivi mobili: iOS, dispositivi Android e Windows. Questo formato di collegamento apre direttamente la posizione, senza alcun reindirizzamento coinvolto nel metodo descritto nella sezione precedente. Questo formato può essere aperto solo nei dispositivi mobili in cui è installata l'app Power BI per dispositivi mobili.

I collegamenti di questo formato possono puntare direttamente a dashboard, riquadri e report. La destinazione del collegamento diretto determina il formato. Seguire questa procedura per creare collegamenti diretti a posizioni diverse.

  • Aprire l'app Power BI per dispositivi mobili

    Usare questo collegamento per aprire l'app Power BI per dispositivi mobili in qualsiasi dispositivo:

    mspbi://app/

  • Aprire a un dashboard specifico

    Questo collegamento apre l'app Power BI per dispositivi mobili a un dashboard specifico:

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

    Per ottenere l'ID oggetto dashboard a 36 caratteri, passare al dashboard specifico nella servizio Power BI ed estrarlo dall'URL. Ad esempio, l'ID oggetto dashboard è evidenziato nell'URL seguente del servizio Power BI:

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

    Se il dashboard non si trova nell'area di lavoro personale, è necessario aggiungere anche l'ID oggetto gruppo prima o dopo l'ID dashboard. Il collegamento diretto mostrato include il parametro ID oggetto gruppo aggiunto dopo l'ID oggetto dashboard:

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

    Prendere nota della e commerciale (&) tra i due parametri.

  • Aprire un riquadro specifico con lo stato attivo

    Questo collegamento apre un riquadro specifico in modalità messa a fuoco nell'app Power BI per dispositivi mobili:

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

    Per trovare gli ID oggetto riquadro e dashboard a 36 caratteri, passare al dashboard specifico nella servizio Power BI e aprire il riquadro in modalità messa a fuoco. Nell'esempio, i dashboard e gli ID riquadro sono evidenziati.

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

    Per aprire direttamente questo riquadro, il collegamento sarà:

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

    Prendere nota della e commerciale (&) tra i due parametri.

    Se il dashboard non si trova nell'area di lavoro personale, aggiungere il parametro GroupObjectId, ad esempio &GroupObjectId=<36-character-group-id>

  • Aprire un report specifico

    Questo collegamento apre un report specifico nell'app Power BI per dispositivi mobili:

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

    Per trovare l'ID oggetto report a 36 caratteri, passare al report specifico nella servizio Power BI. L'URL seguente del servizio Power BI illustra l'ID del report da estrarre.

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

    Se il report non si trova nell'area di lavoro personale, è necessario aggiungere anche &GroupObjectId=<36-character-group-id> , prima o dopo l'ID del report. In questo caso, ad esempio, il collegamento diretto sarà:

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

    Prendere nota della e commerciale (&) tra i due parametri.

  • Aprire una pagina specifica del report

    Questo collegamento apre una pagina del report specifica nell'app Power BI per dispositivi mobili:

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

    La pagina del report è denominata ReportSection, seguita da un numero. Anche in questo caso, per trovare i valori necessari, aprire il report nella servizio Power BI, passare alla pagina del report specifica ed estrarre i valori necessari dall'URL. Ad esempio, le sezioni evidenziate di questo URL rappresentano i valori che è necessario aprire a una pagina del report specifica:

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

  • Apri in modalità schermo intero (solo per i dispositivi Windows)

    Per i dispositivi Windows, è anche possibile aggiungere il parametro openFullScreen per aprire un report specifico in modalità schermo intero. Nell'esempio seguente viene aperta una pagina del report in modalità schermo intero:

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

  • Aggiungi contesto (facoltativo)

    È anche possibile aggiungere contesto alla stringa. Quindi, se devi contattarci, possiamo usare tale contesto per filtrare i dati per trovare ciò che è rilevante per la tua app. Per aggiungere contesto, aggiungere il parametro context=<app-name> al collegamento:

    Ad esempio, l'esempio seguente mostra un collegamento che include un parametro di contesto:

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

Nelle app Power BI per dispositivi mobili i collegamenti all'interno di Power BI funzionano esattamente come funzionano nel servizio Power BI.

Se si vuole aggiungere un collegamento al report che punta a un altro elemento di Power BI, è sufficiente copiare l'URL dell'elemento dalla barra degli indirizzi del browser. Per altre informazioni, vedere Aggiungere un collegamento ipertestuale a una casella di testo in un report.

Considerazioni e limitazioni

I collegamenti diretti ai report con un parametro bookmarkGuid sono supportati nelle app per dispositivi mobili solo quando il valore del parametro bookmarkGuid ha il formato GUID a 36 caratteri standard. I collegamenti in cui il valore del parametro bookmarkGuid ha il formato BookmarkXXXXXXXXXXXXXXXXXXXXXX NON sono supportati.

Contenuto correlato

I commenti e suggerimenti ci aiutano a decidere cosa implementare in futuro, quindi non dimenticare di votare per altre funzionalità che si vuole visualizzare nelle app Power BI per dispositivi mobili.