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.
Liens profonds pris en charge dans l’application mobile Power Apps
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> |
|
| <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.