Udostępnij przez


Używanie łączy bezpośrednich 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ą bezpośredniego linki 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 entitylist w aplikacji mobilnej Power Apps, używając adresów URL bezpośrednich linków z innych aplikacji. Gdy śledzisz łącze z aplikacji zewnętrznej, element docelowy otwiera się w aplikacji Power Apps Mobile

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 korzystać z tej funkcji, na urządzeniu przenośnym musi być zainstalowana aplikacja Power Apps Mobile na telefony lub tablety.

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.

Linki bezpośrednie do aplikacji mobilnej Power Apps powinny zaczynać się od następujących słów:

ms-apps://<org-url>_<app-id>?tenantId=<tenant-id>&environmentId=<environment-id>&appLogicalName=<appLogicalName>&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&environmentId=g67tfyufhkjfg&appLogicalName=cr12_e567

Parametr Opis Wymagane
<aplikacja docelowa>
  • ms-dynamicsxrm -> Dynamics 365 na telefony
  • ms-apps-fs -> Usługi Serwisowe
  • ms-apps —> Power Apps
  • ms-mobile-apps -> opakowane natywne aplikacje mobilne
Tak
<adres URL organizacji> Łączy się z prawidłowym adresem URL organizacji. Tak
<identyfikator aplikacji> Otwiera poprawny moduł aplikacji. Tak
tenantId=<tenand-id> Łączy się z prawidłowym dzierżawcą. Tak
*environmentId=<identyfikator-środowiska> Unikatowo identyfikuje środowisko w obrębie dzierżawcy. Tak
*appLogicalName=<app-logical-name> Unikatowa nazwa aplikacji. Aby uzyskać więcej informacji na temat znajdowania tej unikatowej nazwy aplikacji w nowoczesnym studio, zobacz Zarządzanie ustawieniami aplikacji opartymi na modelu w projektancie aplikacji i w edytorze klasycznym, zobacz Zarządzanie właściwościami aplikacji opartymi na modelu w projektancie aplikacji (wersja klasyczna) 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
autoLoginUpn=<e-mail> Automatycznie wypełnia adres e-mail i wyzwala logowanie.

Uwaga: ten parametr zostanie zignorowany, jeśli użytkownik jest już zalogowany do aplikacji.
Nie
forceOfflineDataSync=true Zapewnia, że synchronizacja danych jest wyzwalana, dzięki czemu są dostępne wszystkie najnowsze dane. Nie

* Zagadnienia dotyczące

  • Identyfikator środowiska i appLogicalName są obowiązkowe dla wszystkich nowych linków bezpośrednich.
  • Istniejące linki głębokie bez identyfikatora środowiska lub appLogicalName będą działać wolniej do grudnia 2025 r., po czym nie będą obsługiwane.
  • Zaktualizuj wszystkie istniejące linki głębokie, aby uwzględnić identyfikator środowiska i nazwę appLogicalName, aby zwiększyć wydajność i skrócić czas oczekiwania.

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

Parametr Opis 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> Wyznacza konkretny rekord, do którego należy przejść; Jeśli pole pozostanie puste, zostanie otwarty utworzony formularz dla 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 Opis 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>&environmentId=<environment-id>&restartApp=true

Parametr Opis Wymagane
<identyfikator aplikacji> Otwiera poprawny moduł aplikacji. Tak
tenantId=<tenantId> Łączy się z prawidłowym dzierżawcą. Tak
*environmentId=<identyfikator-środowiska> Unikatowo identyfikuje środowisko w obrębie dzierżawcy. Tak
restartApp=true Uruchamia ponownie aplikację canvas. 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.

Uwaga: ten parametr zostanie zignorowany, jeśli użytkownik jest już zalogowany do aplikacji.
Nie

* Zagadnienia dotyczące

  • Identyfikator środowiska jest wymagany dla wszystkich nowych linków bezpośrednich.

  • Istniejące linki głębokie bez identyfikatora środowiska będą działać wolniej niż w grudniu 2025 r., po czym nie będą obsługiwane.

  • Zaktualizuj wszystkie istniejące linki głębokie, aby uwzględnić identyfikator środowiska, aby poprawić wydajność i skrócić czas oczekiwania.

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

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

Ważne

Adres URL głębokiego linku dla opakowanej aplikacji działa tylko wtedy, gdy jedna opakowana aplikacja jest zainstalowana na urządzeniu mobilnym. Nie działa, jeśli zainstalowano więcej niż jedną opakowaną aplikację.

Parametr Opis Wymagane
<identyfikator aplikacji> 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.

Uwaga: ten parametr zostanie zignorowany, jeśli użytkownik jest już zalogowany do aplikacji.
Nie

Rozwiązywanie problemów

Linki głębokie mogą być otwierane w przeglądarce w zależności od zasad organizacyjnych firmy i ustawień urządzenia użytkownika. Narzędzia do zarządzania urządzeniami mobilnymi (MDM) i systemy operacyjne urządzeń mają różne opcje i ustawienia wpływające na obsługę głębokich linków. Jeśli linki głębokie otwierają się w przeglądarce zamiast bezpośrednio w aplikacji mobilnej Power Apps, upewnij się, że zasady zarządzania urządzeniami przenośnymi i ustawienia urządzenia są odpowiednio skonfigurowane.

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

Zobacz także

Nadchodzące ważne zmiany (wycofania) w aplikacjach kanwy