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ą.
Obsługiwane precyzyjne łącza w aplikacji mobilnej Power Apps
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>&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=aaaabbbb-0000-cccc-1111-dddd2222eeee
| Parametr | Podpis | Wymagane |
|---|---|---|
| <targeted-app> |
|
Tak |
| <org-url> | Łączy się z prawidłowym adresem URL organizacji. | Tak |
| <app-id> | Otwiera poprawny moduł aplikacji. | Tak |
| tenantId=<tenand-id> | Łączy się z prawidłowym dzierżawcą. | Tak |
| appType=AppModule | Wskazuje, że aplikacja docelowa jest aplikacją opartą na modelu. | Tak |
| restartApp=true | Restartuje aplikację opartą na modelu. Wymagane do zapewnienia, że parametry są przekazywane, gdy aplikacja jest już otwarta. | Nie. |
| forceOfflineDataSync=true | Zapewnia, że synchronizacja danych jest wyzwalana, dzięki czemu są dostępne wszystkie najnowsze dane. | Nie. |
W przypadku otwierania formularza entityrecord lub tworzenia nowego entityrecord należy użyć następujących parametrów:
| Parametr | Podpis | Wymagane |
|---|---|---|
| etn=<entity-logical-name> | Określa, do której tabeli należy przejść. | Tak |
| pagetype=entityrecord | Mówi o tym, że cel jest formularzem. | Tak |
| id=<record-id> | Wskazuje, do którego konkretnego rekordu należy przejść; jeśli pozostawisz pole puste, otworzy się formularz tworzenia tabeli. | Tak |
| 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. |
Nie. |
Jeśli łącze przechodzi do widoku entitylist, dodaj następujące parametry:
| Parametr | Podpis | Wymagane |
|---|---|---|
| etn=<entity-logical-name> | Określa, do której tabeli należy przejść. | Tak |
| pagetype=entitylist | Wskazuje, że przechodzimy do widoku. | Tak |
| viewid=<view-id> | Określa, który widok należy otworzyć. | Nie. |
| Viewtype= <1039 jeśli widok systemowy, 4230 jeśli widok osobisty> | Wskazuje, czy widok docelowy jest widokiem systemowym, czy osobistym. | Nie. |
Obsługiwane parametry adresów URL dla aplikacji kanwy
ms-apps:///providers/Microsoft.PowerApps/apps/<appID>?tenantId=<tenantId>&restartApp=true
| Parametr | Podpis | Wymagane |
|---|---|---|
| <app-id> | Otwiera poprawny moduł aplikacji. | Tak |
| tenantId=<tenantId> | Łączy się z prawidłowym dzierżawcą. | Tak |
| restartApp=true | Restartuje aplikację opartą na modelu. Wymagane do zapewnienia, że parametry są przekazywane, gdy aplikacja jest już otwarta. | Nie. |
| autoLoginUpn=<e-mail> | Automatycznie wypełnia adres e-mail i wyzwala logowanie. | Nie. |
Obsługiwane parametry adresów URL dla opakowanej natywnej aplikacji mobilnej
ms-mobile-apps:///providers/Microsoft.PowerApps/apps/<appID>?tenantId=<tenantId>&restartApp=true
| Parametr | Podpis | Wymagane |
|---|---|---|
| <app-id> | Otwiera poprawny moduł aplikacji. | Tak |
| tenantId=<tenantId> | Łączy się z prawidłowym dzierżawcą. | Tak |
| restartApp=true | Restartuje aplikację opartą na modelu. Wymagane do zapewnienia, że parametry są przekazywane, gdy aplikacja jest już otwarta. | Nie. |
| autoLoginUpn=<e-mail> | Automatycznie wypełnia adres e-mail i wyzwala logowanie. | Nie. |
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.