Udostępnij za pośrednictwem

Tworzenie linku do określonej lokalizacji w aplikacjach mobilnych usługi Power BI

  • Artykuł

Możesz użyć linków, aby bezpośrednio uzyskać dostęp do określonej zawartości usługi Power BI, takiej jak określony raport, strona raportu, pulpit nawigacyjny, kafelek itp.

Istnieją dwa główne scenariusze używania linków do uzyskiwania dostępu do zawartości w aplikacjach mobilnych usługi Power BI:

  • Aby otworzyć usługę Power BI spoza aplikacji mobilnej i wylądować na określonej zawartości. Zazwyczaj jest to scenariusz integracji, w którym otwierasz aplikację mobilną Power BI z innej aplikacji.

  • Aby przejść do usługi Power BI. Zazwyczaj jest to wykonywane, gdy chcesz utworzyć niestandardową nawigację w usłudze Power BI.

W tym artykule opisano następujące przypadki:

  • Używanie linków do otwierania określonej zawartości usługi Power BI spoza aplikacji mobilnej. Opisano dwa formaty linków. Jedna z nich używa metody przekierowania i może być używana niezależnie od tego, gdzie usługa Power BI zostanie otwarta. Drugi zostanie otwarty bezpośrednio w aplikacji mobilnej Power BI i będzie działać tylko na urządzeniach przenośnych z zainstalowaną aplikacją mobilną.

  • Użyj linków w usłudze Power BI, aby przejść do określonej zawartości usługi Power BI.

Aplikacje mobilne obsługują linki do raportów, które zawierają parametry ciągu zapytania. Takie linki są otwierane w aplikacji mobilnej wstępnie filtrowane zgodnie z warunkami zdefiniowanymi w ciągu zapytania. Aby uzyskać więcej informacji na temat tworzenia adresów URL raportu z parametrami ciągu zapytania, zobacz Filtrowanie parametrów ciągu zapytania raportu w adresie URL.

Aplikacje mobilne obsługują również przekazywanie parametrów do raportów podzielonych na strony za pośrednictwem adresów URL. Aby uzyskać więcej informacji, zobacz Przekazywanie parametru raportu w adresie URL raportu podzielonego na strony, aby uzyskać szczegółowe informacje.

Jeśli chcesz połączyć się z określonym elementem w usłudze Power BI spoza aplikacji mobilnej, istnieją dwie opcje, w zależności od tego, gdzie link ma zostać otwarty:

  • Jeśli chcesz, aby link został otwarty poprawnie niezależnie od tego, czy został kliknięty w przeglądarce komputera, czy na urządzeniu przenośnym, możesz utworzyć link, który gwarantuje, że zostanie otwarty poprawnie niezależnie od tego, gdzie jest kliknięty. Ten link ma specjalną składnię przekierowania, aby umożliwić to inteligentne zachowanie.

  • Jeśli wiesz, że link zostanie otwarty tylko na urządzeniu przenośnym, na którym zainstalowano aplikację mobilną Power BI, możesz uniknąć przerzuconego przekierowania powyższej metody i użyć innej składni linku, która otwiera link bezpośrednio w aplikacji mobilnej Power BI na urządzeniu przenośnym. Należy jednak pamiętać, że chociaż ten link unika narzutu przekierowania pierwszej metody, nie będzie działać w przypadku otwarcia w dowolnym miejscu innym niż na urządzeniu przenośnym, na którym zainstalowano aplikację mobilną Power BI.

Format linku opisany w tej sekcji używa przekierowania, aby upewnić się, że link działa bez względu na to, gdzie jest kliknięty.

  • Jeśli link zostanie kliknięty na urządzeniu przenośnym, upewnij się, że urządzenie używa aplikacji mobilnej Power BI do otwarcia linku. Jeśli aplikacja mobilna nie jest zainstalowana na urządzeniu, sugeruje użytkownikowi przejście do sklepu, aby go pobrać.

  • Jeśli link zostanie kliknięty na komputerze, otworzy odpowiedni element w portalu internetowym usługi Power BI.

Link musi zaczynać się od specjalnego prefiksu, a następnie parametrów zapytania:

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

Ważne

Jeśli Zawartość jest hostowana w specjalnym centrum danych, takim jak instytucje rządowe, Chiny itp., link powinien zaczynać się od odpowiedniego adresu usługi Power BI, takiego jak app.powerbigov.us lub app.powerbi.cn.

Parametry zapytania to:

Parametr Wartość Opis
akcja (obowiązkowe) Otwórz aplikację
OpenReport
OpenDashboard
OpenTile
Appid 36-znakowy identyfikator GUID Należy określić, jeśli chcesz otworzyć raport lub pulpit nawigacyjny, który jest częścią aplikacji.
Przykład: appId=baf4b16d-b5bd-4360-8a3a-51d11242c09b
groupObjectId 36-znakowy identyfikator GUID Określa obszar roboczy, gdy chcesz otworzyć raport lub pulpit nawigacyjny, który nie jest częścią obszaru Mój obszar roboczy.
Przykład: groupObjectId=9a3841c6-74b3-46f1-85fd-bdd78f27b30e
dashboardObjectId 36-znakowy identyfikator GUID Identyfikator obiektu pulpitu nawigacyjnego (jeśli akcja to OpenDashboard lub OpenTile)
Przykład: dashboardObjectId=033bb049-5b68-4392-b3ef-ae9a43738a4a
reportObjectId 36-znakowy identyfikator GUID Identyfikator obiektu raportu (jeśli akcja to OpenReport)
Przykład: reportObjectId=6114cec7-78e1-4926-88ff-0bc5338452cf
tileObjectId 36-znakowy identyfikator GUID Identyfikator obiektu kafelka (jeśli akcja to OpenTile)
Przykład: tileObjectId=a845dcb8-a289-43a8-94ea-67a8c0a068f9
reportPage ReportSection<num> Nazwa strony, jeśli chcesz otworzyć określoną stronę raportu. (jeśli akcja to OpenReport)
Przykład: reportPage=ReportSection6
bookmarkGuid 36-znakowy identyfikator GUID Identyfikator zakładki, jeśli chcesz otworzyć określony widok zakładki. (jeśli akcja to OpenReport)
Przykład: bookmarkGuid=18e8872f-6db8-4cf8-8298-3b2ab254cc7f
Uwaga: Wartości formatu BookmarkXXXXXXXXXXXXXXXXXXXXXXX NIE są obsługiwane.
ctid 36-znakowy identyfikator GUID Identyfikator organizacji elementów (odpowiedni dla scenariuszy B2B. Można to pominąć, jeśli element należy do organizacji użytkownika)
Przykład: ctid=5367c770-09d0-4110-bf6a-d760cb5ef681
Pełny ekran Wartość logiczna Gdy wartość true, otwiera element w trybie pełnoekranowym. Obsługiwane w przypadku raportów, kart wyników, pulpitów nawigacyjnych i aplikacji (jeśli element docelowy aplikacji jest jednym z obsługiwanych elementów).
Przykład: fullScreen=1

Uwaga

Zakładki na poziomie raportu nie mają formatu bookmarkGUID i obecnie nie można przekazać go jako parametru linku głębokiego.

Przykłady:

W poniższych przykładach symbole zastępcze wartości parametrów są wyróżnione pogrubioną czcionką. Aby uzyskać rzeczywiste wartości, przejdź do usługa Power BI, otwórz element, do którego chcesz utworzyć łącze, i wyodrębnij potrzebne wartości z adresu URL elementu.

  • Otwieranie aplikacji

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

  • Otwieranie pulpitu nawigacyjnego będącego częścią aplikacji

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

  • Otwieranie raportu, który jest częścią obszaru roboczego innego niż Mój obszar roboczy

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

W przypadku aplikacji i raportów i pulpitów nawigacyjnych będących częścią aplikacji najprostszym sposobem uzyskania linku jest przejście do obszaru roboczego aplikacji i wybranie pozycji Aktualizuj aplikację. Spowoduje to otwarcie środowiska publikowania aplikacji. Otwórz kartę uprawnienia i rozwiń sekcję linki, aby wyświetlić linki do aplikacji i całą jej zawartość. Możesz użyć tych linków spoza usługi Power BI, aby uzyskać bezpośredni dostęp do aplikacji i jej zawartości.

Zrzut ekranu przedstawiający wyróżnione linki do publikowania aplikacji w usłudze Power BI.

W przypadku raportów i pulpitów nawigacyjnych, które nie są częścią aplikacji, należy wyodrębnić potrzebne identyfikatory obiektów z adresu URL elementu. W tym celu przejdź do usługa Power BI, przejdź do elementu, do którego chcesz utworzyć łącze, i poszukaj wartości potrzebnych w adresie URL widocznym na pasku adresu przeglądarki.

W przykładach pokazano, gdzie można znaleźć potrzebne identyfikatory w adresach URL elementów, z których chcesz się połączyć.

  • Aby znaleźć 36-znakowy identyfikator obiektu pulpitu nawigacyjnego, przejdź do określonego pulpitu nawigacyjnego, do którego chcesz połączyć się w usługa Power BI i znajdź identyfikator obiektu pulpitu nawigacyjnego oraz inne wymagane identyfikatory w wskazanych miejscach:

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

  • Aby znaleźć 36-znakowy identyfikator obiektu raportu, przejdź do określonego raportu, do którego chcesz połączyć się w usługa Power BI i znajdź niezbędne identyfikatory, jak pokazano. Ten przykład zawiera odwołanie do określonej strony raportu i określoną zakładkę.

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

  • Aby połączyć się z elementem w obszarze roboczym innym niż Mój obszar roboczy, należy wyodrębnić identyfikator obiektu grupy. W tym przykładzie pokazano raport z obszaru roboczego innego niż Mój obszar roboczy.

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

Format linku opisany w tej sekcji zawiera linki do określonej lokalizacji w aplikacjach mobilnych usługi Power BI na wszystkich platformach mobilnych: iOS, Android i Windows. Ten format linku otwiera lokalizację bezpośrednio, bez żadnego przekierowania zaangażowanego w metodę opisaną w poprzedniej sekcji. Ten format można otworzyć tylko na urządzeniach przenośnych z zainstalowaną aplikacją mobilną Power BI.

Linki tego formatu mogą wskazywać bezpośrednio na pulpity nawigacyjne, kafelki i raporty. Miejsce docelowe linku głębokiego określa jego format. Wykonaj następujące kroki, aby utworzyć linki głębokie do różnych lokalizacji.

  • Otwieranie aplikacji mobilnej Power BI

    Użyj tego linku, aby otworzyć aplikację mobilną Power BI na dowolnym urządzeniu:

    mspbi://app/

  • Otwieranie określonego pulpitu nawigacyjnego

    Ten link otwiera aplikację mobilną Power BI do określonego pulpitu nawigacyjnego:

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

    Aby uzyskać 36-znakowy identyfikator obiektu pulpitu nawigacyjnego, przejdź do określonego pulpitu nawigacyjnego w usługa Power BI i wyodrębnij go z adresu URL. Na przykład identyfikator obiektu pulpitu nawigacyjnego jest wyróżniony w następującym adresie URL z usługa Power BI:

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

    Jeśli pulpit nawigacyjny nie znajduje się w obszarze Mój obszar roboczy, należy również dodać identyfikator obiektu grupy przed identyfikatorem pulpitu nawigacyjnego lub po nim. Wyświetlony link bezpośredni zawiera parametr identyfikatora obiektu grupy dodany po identyfikatorze obiektu pulpitu nawigacyjnego:

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

    Zanotuj &ersand (&) między dwoma parametrami.

  • Otwieranie określonego kafelka w fokusie

    Ten link otwiera określony kafelek w trybie koncentracji uwagi w aplikacji mobilnej Power BI:

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

    Aby znaleźć 36-znakowe identyfikatory obiektów pulpitu nawigacyjnego i kafelka, przejdź do określonego pulpitu nawigacyjnego w usługa Power BI i otwórz kafelek w trybie koncentracji uwagi. W tym przykładzie wyróżniono identyfikatory pulpitu nawigacyjnego i kafelka.

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

    Aby otworzyć ten kafelek bezpośrednio, link będzie następujący:

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

    Zanotuj &ersand (&) między dwoma parametrami.

    Jeśli pulpit nawigacyjny nie znajduje się w obszarze Mój obszar roboczy, dodaj parametr GroupObjectId, na przykład &GroupObjectId=<36-character-group-id>

  • Otwieranie określonego raportu

    Ten link otwiera określony raport w aplikacji mobilnej Power BI:

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

    Aby znaleźć 36-znakowy identyfikator obiektu raportu, przejdź do określonego raportu w usługa Power BI. Poniższy adres URL z usługa Power BI ilustruje identyfikator raportu, który należy wyodrębnić.

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

    Jeśli raport nie znajduje się w obszarze Mój obszar roboczy, musisz dodać element &GroupObjectId=<36-znak-identyfikator-grupy> , a także przed identyfikatorem raportu lub po nim. Na przykład w tym przypadku link bezpośredni będzie następujący:

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

    Zanotuj &ersand (&) między dwoma parametrami.

  • Otwieranie określonej strony raportu

    Ten link otwiera określoną stronę raportu w aplikacji mobilnej Power BI:

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

    Strona raportu nosi nazwę ReportSection, po której następuje liczba. Ponownie, aby znaleźć potrzebne wartości, otwórz raport w usługa Power BI, przejdź do określonej strony raportu i wyodrębnij potrzebne wartości z adresu URL. Na przykład wyróżnione sekcje tego adresu URL reprezentują wartości, które należy otworzyć na określonej stronie raportu:

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

  • Otwórz w trybie pełnoekranowym (tylko dla urządzeń z systemem Windows)

    W przypadku urządzeń z systemem Windows można również dodać parametr openFullScreen , aby otworzyć określony raport w trybie pełnoekranowym. Poniższy przykład otwiera stronę raportu w trybie pełnoekranowym:

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

  • Dodaj kontekst (opcjonalnie)

    Do ciągu można również dodać kontekst. Następnie, jeśli musisz się z nami skontaktować, możemy użyć tego kontekstu, aby przefiltrować nasze dane, aby znaleźć, co jest istotne dla Twojej aplikacji. Aby dodać kontekst, dodaj parametr context=<app-name> do linku:

    Na przykład w poniższym przykładzie przedstawiono link zawierający parametr kontekstu:

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

W aplikacjach mobilnych power BI linki w usłudze Power BI działają tak samo jak w usługa Power BI.

Jeśli chcesz dodać link do raportu, który wskazuje inny element usługi Power BI, możesz skopiować adres URL tego elementu z paska adresu przeglądarki. Aby uzyskać więcej informacji, zobacz Dodawanie hiperlinku do pola tekstowego w raporcie.

Rozważania i ograniczenia

Linki bezpośrednie do raportów z parametrem bookmarkGuid są obsługiwane w aplikacjach mobilnych tylko wtedy, gdy wartość parametru bookmarkGuid ma standardowy 36-znakowy format GUID. Linki, w których wartość parametru bookmarkGuid ma format BookmarkXXXXXXXXXXXXXXXXXXXXX NIE są obsługiwane.

Powiązana zawartość

Twoja opinia pomaga nam zdecydować, co wdrożyć w przyszłości, więc nie zapomnij głosować na inne funkcje, które chcesz zobaczyć w aplikacjach mobilnych usługi Power BI.