Share via


Utiliser des liens profonds avec l’application mobile Power Apps

Les liens profonds permettent aux utilisateurs de passer d’une application à une autre sur les ordinateurs et les appareils mobiles. Des exemples simples incluent une application mobile de liens profonds vers Facebook pour se connecter, une adresse e-mail avec un lien profond vers une application de messagerie pour composer un message, ou un lien profond vers un site Web vers une boutique d’applications pour télécharger une application mobile associée.

Vous pouvez ouvrir une vue entityrecord ou entitylist dans l’application mobile Power Apps en utilisant des URL de liens profonds provenant d’autres applications. Lorsque vous suivez le lien depuis une application externe, l’élément cible s’ouvre dans l’application mobile Power Apps.

Si vous êtes déjà connecté.e à votre instance dans l’application, l’enregistrement cible s’affiche lorsque vous suivez le lien depuis une application externe. Sinon, vous êtes invité.e à vous connecter à votre instance dans l’application mobile ; une fois connecté, l’élément cible s’affiche. L’application mobile Power Apps doit être installée sur votre appareil mobile pour pouvoir utiliser cette fonctionnalité.

Paramètres d’URL pris en charge pour une application pilotée par modèle

Utilisez les paramètres du gestionnaire d’applications et de chaîne de requête suivants pour composer l’URL.

Les liens profonds pour l’application mobile Power Apps doivent commencer par les éléments suivants :

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

Important

org-url ne peut pas contenir https://. Vous trouverez ci-dessous un exemple de lien profond vers une application pilotée par modèle :
ms-apps://contoso.onmicrosoft.com_e6429eba-2204-40e8-b9dd-fc74791ff2c2?tenantId=219f9bd4-8c16-4dfa-b87e-f4a33764f1dd

Paramètre Description
<targeted-app>
  • ms-dynamicsxrm -> Dynamics 365 pour téléphones
  • ms-apps-fs -> Field Service
  • ms-apps -> Power Apps
  • ms-mobile-apps -> applications mobiles natives encapsulées
<org-url> Se connecte à l’URL de l’organisation correcte.
<app-id> Ouvre le module d’application correct.
tenantId Se connecte au client correct.
forceOfflineDataSync Garantit que la synchronisation des données est déclenchée afin que toutes les dernières données soient disponibles.

Si vous ouvrez un formulaire entityrecord ou créez un nouveau entityrecord, utilisez les paramètres suivants :

Paramètre Description
etn=<entity-logical-name> Désigne à quelle table accéder.
pagetype=entityrecord Indique que la cible est un formulaire.
extraqs=<form-id> Désigne le formulaire à ouvrir pour entityrecord ; si non spécifié, le formulaire par défaut s’ouvre. Le paramètre extraqs peut également être utilisé pour les valeurs de champ par défaut.
id=<record-id> Désigne l’enregistrement spécifique ; si laissé vide, le formulaire de création pour la table s’ouvre.

Si le lien va vers une vue entitylist, ajoutez les paramètres suivants :

Paramètre Description
etn=<entity-logical-name> Désigne à quelle table accéder.
pagetype=entitylist Indique que nous allons à une vue.
viewid=<view-id> Désigne la vue à ouvrir.
Viewtype= <1039 si vue système, 4230 si vue personnelle> Désigne si nous allons à une vue système ou à une vue personnelle.

Paramètres d’URL pris en charge pour une application canevas

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

Paramètre Description
<app-id> Ouvre le module d’application correct.
<tenantId> Se connecte au client correct.
restartApp=true Redémarre l’application canevas, nécessaire pour garantir que les paramètres sont transmis lorsque l’application est déjà ouverte.
autoLoginUpn=<e-mail> Remplit automatiquement l’e-mail et active la connexion.

Paramètres d’URL pris en charge pour une application mobile native encapsulée

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

Paramètre Description
<app-id> Ouvre le module d’application correct.
<tenantId> Se connecte au client correct.
restartApp=true Redémarre l’application canevas pour garantir que les paramètres sont transmis lorsque l’application est déjà ouverte.
autoLoginUpn=<e-mail> Remplit automatiquement l’e-mail et active la connexion.

Résolution des problèmes

Les liens profonds peuvent s’ouvrir dans votre navigateur en fonction des politiques organisationnelles de l’entreprise et des paramètres de l’appareil de l’utilisateur. Les outils de gestion des périphériques mobiles (MDM) et les systèmes d’exploitation des appareils ont différentes options et paramètres qui ont un impact sur la façon dont les liens profonds sont gérés. Si les liens profonds s’ouvrent dans un navigateur plutôt que directement dans mobile Power Apps, assurez-vous que vos politiques MDM et les paramètres de votre appareil sont correctement configurés.

À titre d’exemple, sur certains Android appareils, accédez à Paramètres > Applications > Power Apps > Ouvrir par défaut et ajoutez apps.powerapps.com pour que les liens profonds s’ouvrent directement dans mobile Power Apps.