Używanie głębokich łączy z aplikacją mobilną Power Apps

Głębokie łącza umożliwiają użytkownikom przechodzenie od jednej aplikacji do innej na komputerach i urządzeniach przenośnych. Proste przykłady obejmują łączenie za pomocą głębokiego łącza aplikacji mobilnej z Facebook w celu zalogowania, adresu e-mail z aplikacją poczty e-mail w celu komponowania wiadomości, lub witryny sieci web ze sklepem aplikacji, aby pobrać powiązaną aplikację mobilną.

Możesz otworzyć widok entityrecord lub widok entitylist w aplikacji mobilnej Power Apps, używając głębokiego linku URL z innych aplikacji. Gdy śledzisz łącze z aplikacji zewnętrznej, element docelowy otwiera się w aplikacji mobilnej Power Apps

Jeśli zalogowałeś się już do wystąpienia w aplikacji, rekord docelowy jest wyświetlany, gdy śledzisz łącze z aplikacji zewnętrznej. W przeciwnym razie zobaczysz monit o zalogowanie się do swojego wystąpienia w aplikacji mobilnej; po zalogowaniu zostanie wyświetlony element docelowy. Aby móc korzystać z tej funkcji, musisz mieć aplikację mobilną Power Apps zainstalowaną na swoim urządzeniu przenośnym.

Obsługiwane parametry adresów URL dla aplikacji opartej na modelu

Do komponowania adresu URL użyj następujących parametrów obsługi aplikacji i ciągu zapytania.

Głębokie linki do aplikacji mobilnej Power Apps powinny zaczynać się od następujących słów:

ms-apps://<org-url>_<app-id>?tenantId=<tenant-id>&isShortcut=true&appType=AppModule&openApp=true&restartApp=true&forceOfflineDataSync=true

Ważne

Adres URL organizacji nie może zawierać https://. Poniżej przedstawiono przykład linku głębokiego aplikacji opartej na modelu:
ms-apps://contoso.onmicrosoft.com_e6429eba-2204-40e8-b9dd-fc74791ff2c2?tenantId=219f9bd4-8c16-4dfa-b87e-f4a33764f1dd

Parametr opis
<targeted-app>
  • ms-dynamicsxrm -> Dynamics 365 na telefony
  • ms-apps-fs -> Field Service
  • ms-apps -> Power Apps
  • ms-mobile-apps -> opakowane natywne aplikacje mobilne
<org-url> Łączy się z prawidłowym adresem URL organizacji.
<app-id> Otwiera poprawny moduł aplikacji.
tenantId Łączy się z prawidłowym dzierżawcą.
forceOfflineDataSync Zapewnia, że synchronizacja danych jest wyzwalana, dzięki czemu są dostępne wszystkie najnowsze dane.

W przypadku otwierania formularza entityrecord lub tworzenia nowego entityrecord należy użyć następujących parametrów:

Parametr opis
etn=<entity-logical-name> Określa, do której tabeli należy przejść.
pagetype=entityrecord Mówi o tym, że cel jest formularzem.
extraqs=<form-id> Wskazuje, który formularz ma zostać otwarty dla entityrecord; jeśli nie zostanie określony, zostanie otwarty formularz domyślny. Parametr extraqs może być także używany do domyślnych wartości pól.
id=<record-id> Wskazuje, do którego konkretnego rekordu należy przejść; jeśli pozostawisz pole puste, otworzy się formularz tworzenia tabeli.

Jeśli łącze przechodzi do widoku entitylist, dodaj następujące parametry:

Parametr opis
etn=<entity-logical-name> Określa, do której tabeli należy przejść.
pagetype=entitylist Wskazuje, że przechodzimy do widoku.
viewid=<view-id> Określa, który widok należy otworzyć.
Viewtype= <1039 jeśli widok systemowy, 4230 jeśli widok osobisty> Określa, czy przechodzimy do widoku systemowego czy osobistego.

Obsługiwane parametry adresów URL dla aplikacji kanwy

ms-apps:///providers/Microsoft.PowerApps/apps/<appID>?tenantId=<tenantId>&restartApp=true

Parametr opis
<app-id> Otwiera poprawny moduł aplikacji.
<tenantId> Łączy się z prawidłowym dzierżawcą.
restartApp=true Ponownie uruchamia aplikację kanwy, co jest wymagane do zapewnienia, że parametry będą przekazywane, gdy aplikacja jest już otwarta.
autoLoginUpn=<e-mail> Automatycznie wypełnia adres e-mail i wyzwala logowanie.

Obsługiwane parametry adresów URL dla opakowanej natywnej aplikacji mobilnej

ms-mobile-apps:///providers/Microsoft.PowerApps/apps/<appID>?tenantId=<tenantId>&restartApp=true

Parametr opis
<app-id> Otwiera poprawny moduł aplikacji.
<tenantId> Łączy się z prawidłowym dzierżawcą.
restartApp=true Ponownie uruchamia aplikację kanwy, aby zapewnić, że parametry będą przekazywane, gdy aplikacja jest już otwarta.
autoLoginUpn=<e-mail> Automatycznie wypełnia adres e-mail i wyzwala logowanie.

Rozwiązywanie problemów

Głębokie linki mogą być otwierane w przeglądarce, zależnie od zasad organizacyjnych firmy i ustawień urządzenia użytkownika. Narzędzia do zarządzania urządzeniami mobilnymi (MDM) i systemy operacyjne urządzeń przenośnych mają różne opcje i ustawienia, które mają wpływ na sposób obsługi głębokich linków. Jeśli głębokie linki otwierają się w przeglądarce, a nie bezpośrednio w aplikacji mobilnej Power Apps należy się upewnić, że zasady MDM i ustawienia urządzenia użytkownika są odpowiednio skonfigurowane.

Na niektórych urządzeniach z systemem Android przykładowo przejdź do Ustawienia > Aplikacje > Power Apps > Otwarte domyślnie i dodaj apps.powerapps.com, aby głębokie linki otwierały się bezpośrednio w aplikacji mobilnej Power Apps.