Partager 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>&environmentId=<environment-id>&appLogicalName=<appLogicalName>&appType=AppModule&openApp=true&restartApp=true&forceOfflineDataSync=true

Important

org-url ne peut pas contenir https://. Voici un exemple de lien profond de l’application pilotée par modèle :
ms-apps://contoso.onmicrosoft.com_e6429eba-2204-40e8-b9dd-fc74791ff2c2?tenantId=aaaabbbb-0000-cccc-1111-dddd2222eeee&environmentId=g67tfyufhkjfg&appLogicalName=cr12_e567

Paramètre Description Obligatoire
<application ciblée>
  • ms-dynamicsxrm -> Dynamics 365 pour téléphones
  • ms-apps-fs -> Service sur le Terrain
  • ms-apps -> Power Apps
  • ms-mobile-apps -> applications mobiles natives encapsulées
 Oui
<org-url> Se connecte à l’URL de l’organisation correcte. Oui
<app-id> Ouvre le module d’application correct. Oui
tenantId=<tenant-id> Se connecte au client correct. Oui
*environmentId=<id-environnement> Identifie de manière unique l’environnement au sein d’un locataire. Oui
*appLogicalName=<app-logical-name> Nom unique de l’application. Pour plus d’informations sur la recherche de ce nom unique de l’application dans modern Studio, consultez Gérer les paramètres d’application pilotés par modèle dans le concepteur d’application et pour l’éditeur classique, reportez-vous à Gérer les propriétés de l’application pilotée par modèle dans le concepteur d’applications (classique) Oui
appType=AppModule Indique que l’application ciblée est une application pilotée par modèle. Oui
restartApp=true Redémarre l’application pilotée par modèle. Nécessaire pour s’assurer que les paramètres sont transmis lorsque l’application est déjà ouverte. No
autoLoginUpn=<e-mail> Remplit automatiquement l’e-mail et active la connexion.

Remarque : ce paramètre est ignoré si un utilisateur est déjà connecté à l’application.		 No
forceOfflineDataSync=true Garantit que la synchronisation des données est déclenchée afin que toutes les dernières données soient disponibles. No

* Considérations

  • L’ID d’environnement et appLogicalName sont obligatoires pour tous les nouveaux liens profonds.
  • Les liens profonds existants sans ID d’environnement ou appLogicalName connaîtront des performances plus lentes jusqu’en décembre 2025, après quoi ils ne seront pas pris en charge.
  • Mettez à jour tous les liens profonds existants pour inclure l’ID d’environnement et appLogicalName pour améliorer les performances et réduire le temps d’attente.

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

Paramètre Description Obligatoire
etn=<nom-logique-de-l'entité> Désigne à quelle table accéder. Oui
pagetype=entityrecord Indique que la cible est un formulaire. Oui
id=<identifiant-enregistrement> Désigne l’enregistrement spécifique auquel accéder ; si elle est vide, le formulaire créé pour la table s’ouvre. Oui
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. No

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

Paramètre Description Obligatoire
etn=<nom-logique-de-l'entité> Désigne à quelle table accéder. Oui
pagetype=entitylist Indique que nous allons à une vue. Oui
viewid=<view-id> Désigne la vue à ouvrir. No
Viewtype= <1039 si vue système, 4230 si vue personnelle> Indique si la vue ciblée est une vue système ou une vue personnelle. No

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

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

Paramètre Description Obligatoire
<app-id> Ouvre le module d’application correct. Oui
tenantId=<tenantId> Se connecte au client correct. Oui
*environmentId=<id-environnement> Identifie de manière unique l’environnement au sein d’un locataire. Oui
restartApp=true Redémarre l’application Canvas. Nécessaire pour s’assurer que les paramètres sont transmis lorsque l’application est déjà ouverte. No
autoLoginUpn=<e-mail> Remplit automatiquement l’e-mail et active la connexion.

Remarque : ce paramètre est ignoré si un utilisateur est déjà connecté à l’application.		 No

* Considérations

  • L’ID d’environnement est obligatoire pour tous les nouveaux liens profonds.

  • Les liens profonds existants sans ID d’environnement connaissent des performances plus lentes jusqu’en décembre 2025, après quoi ils ne seront pas pris en charge.

  • Mettez à jour tous les liens profonds existants pour inclure l’ID d’environnement pour améliorer les performances et réduire le temps d’attente.

    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

Important

L’URL de lien profond d’une application encapsulée fonctionne uniquement quand une application encapsulée est installée sur l’appareil mobile. Elle ne fonctionne pas si plusieurs applications encapsulées sont installées.

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

Remarque : ce paramètre est ignoré si un utilisateur est déjà connecté à l’application.		 No

Résolution des problèmes

Les liens profonds peuvent s’ouvrir dans votre navigateur en fonction des stratégies organisationnelles de l’entreprise et des paramètres de l’appareil de l’utilisateur. Les outils de gestion des appareils mobiles (GPM) et les systèmes d’exploitation des appareils disposent de différentes options et paramètres qui affectent la gestion des liens profonds. Si des liens approfondis s’ouvrent dans un navigateur plutôt que directement dans Power Apps mobile, vérifiez que vos stratégies GPM et vos paramètres d’appareil sont correctement configurés.

Par exemple, sur certains appareils Android, accédez à Settings>>Apps Power Apps>Open par défaut et ajoutez apps.powerapps.com pour ouvrir des liens profonds directement dans Power Apps mobile.

Voir aussi

Modifications (obsolescences) importantes à venir dans les applications canevas

  • Last updated on