Partage via

Objet Host dans Power Apps

  • Article

S’applique à : Applications canevas  Applications pilotées par modèle

L’objet Host dans Power Apps fournit des informations sur l’hôte actuel qui exécute l’application.

Description

L’objet Host fournit des informations sur l’appareil hôte, le système d’exploitation et le lecteur qui exécute une application. L’hôte est similaire à l’objet App et chaque application a accès à ces informations.

L’une des meilleures utilisations de Host consiste à déboguer une application qui ne fonctionne pas correctement sur un appareil spécifique ou avec un navigateur spécifique. Utilisez les propriétés de texte de cet objet pour afficher des informations dans l’interface utilisateur de l’application avec un contrôle Étiquette de texte ou enregistrer les informations dans une table de base de données ou dans Application Insights.

Il est tentant d’utiliser Host pour adapter une application à un appareil ou un navigateur spécifique. Ceci est dangereux car Power Apps est conçu pour être exécuté sur un large éventail de plateformes matérielles et logicielles et votre logique basée sur Host peut ne pas les prendre toutes en compte et elles évoluent avec le temps. La meilleure approche consiste à utiliser des informations plus abstraites et non liées à du matériel et des logiciels spécifiques. Par exemple, utilisez la propriété Size du contrôle Screen pour personnaliser un écran pour afficher moins ou réorganiser les informations lors de l’exécution sur un appareil plus petit comme un téléphone.

Pour accéder à l’objet Host dans Power Apps Studio, développez l’objet App en haut du volet Arborescence, puis sélectionnez Host. Dans cet exemple, l’objet Host n’a aucune propriété qui accepte les formules.

Objet Host dans le volet Arborescence.

Note

L’objet Host n’est actuellement disponible que dans les pages personnalisées et les applications canevas.

Propriété BrowserUserAgent

La propriété de texte BrowserUserAgent contient la chaîne complète de l’agent utilisateur que le navigateur utilise pour s’identifier lors de l’exécution de l’application.

Par exemple, une chaîne de l’agent utilisateur du navigateur peut être :

  • Mozilla/5.0 (Windows NT 10.0 ; Win64 ; x64)
  • AppleWebKit/537.36 (KHTML, comme Gecko)
  • Chrome/109.0.0.0 Safari/537.36 Edg/109.0.1518.78

Note

Si vous exécutez Power Apps dans une application native ou si vous utilisez la fonctionnalité wrap dans Power Apps, l’application est présentée via un contrôle du navigateur, qui fournit une chaîne d’agent utilisateur.

Propriété OSType

La propriété OSType fournit le nom du système d’exploitation où l’application est en cours d’exécution. La fonction OSType est déterminée à partir de la chaîne de l’agent utilisateur envoyée par le navigateur à Power Apps. Voici des exemples de valeurs courantes pour OSType :

active
Fenêtres
Mac OS
iOS
Android
Linux
...

Note

N’utilisez pas OSType pour modifier l’expérience ou la fonctionnalité de votre application en fonction du système d’exploitation indiqué.

Le texte OSType peut être utilisé dans une formule, par exemple pour l’afficher dans la propriété de texte d’une étiquette :

Label1.Text: "You're running " & Host.OSType

Propriété SessionID

La propriété SessionID renvoie le GUID qui identifie la session actuelle. Incluez ces informations lorsque vous signalez des problèmes à votre administrateur.

Note

Dans les scénarios intégrés tels que Power Apps dans Power BI, la propriété SessionID renvoie l’ID de session Power Apps sous-jacent, et non l’ID de session Power BI.

Label1.Text: $"Provide session ID { Host.SessionID } to your administrator."

Propriété TenantID

La propriété TenantID fournit l’identificateur global unique (GUID) qui spécifie le locataire Microsoft Entra associé à l’utilisateur actuellement authentifié.

Note

Semblable à SessionID, dans les scénarios intégrés tels que Power Apps dans Power BI, l’ID de locataire est le locataire utilisé pour l’authentification de la session Power Apps.

Label1.Text: Host.TenantID

Propriété Version

La propriété Version fournit le numéro d’identification et de version du lecteur Power Apps. Similaire à NavigateurUserAgent, plusieurs numéros de version peuvent être renvoyés, séparés par des espaces.

Note

La propriété Version est toujours une chaîne vide lorsque vous travaillez dans Power Apps Studio.

Label1.Text: Host.Version

Propriété OfflineEnabled

La propriété OfflineEnabled fournit le mode d’exécution de l’application dans le lecteur Power Apps. Pour les applications qui ne sont pas activées pour le mode hors connexion, la propriété a toujours la valeur false. Pour les applications qui sont activées pour le mode hors connexion, la propriété a la valeur false sur le web, mais la valeur true sur iOS, Android et Windows.

Note

Même si une application canevas ne fonctionne pas sans connectivité réseau, la propriété OfflineEnabled conserve la valeur true dans Power Apps Studio pour les applications canevas qui ont été activées pour l’utilisation hors connexion.

Label1.Text: Host.OfflineEnabled

Exemples

  1. Créez une application canevas.
  2. Ajoutez un contrôle Étiquette de texte et définissez la propriété Text sur "Host.BrowserUserAgent: " & Host.BrowserUserAgent.
  3. Ajoutez un contrôle Étiquette de texte et définissez la propriété Text sur "Host.OSType: " & Host.OSType.
  4. Ajoutez un contrôle Étiquette de texte et définissez la propriété Text sur "Host.SessionID: " & Host.SessionID.
  5. Ajoutez un contrôle Étiquette de texte et définissez la propriété Text sur "Host.TenantID: " & Host.TenantID.
  6. Ajoutez un contrôle Étiquette de texte et définissez la propriété Text sur "Host.Version: " & Host.Version.
  7. Ajoutez un contrôle Étiquette de texte et définissez la propriété Text sur "Host.OfflineEnabled: " & Host.OfflineEnabled.

Exécutez votre application sur différents appareils et avec différents navigateurs et vous verrez des résultats similaires à ceux indiqués ci-dessous.

Power Apps Studio sous Windows avec le navigateur Edge

Host.Version est toujours vide lorsque vous travaillez dans Power Apps Studio.

Host.BrowserUserAgent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/116.0.0.0 Safari/537.36 Edg/116.0.1938.76
Host.OSType: Windows
Host.SessionID: ee2eed1a-8455-4e68-a433-a709302d0c71
Host.TenantID: 5da56e5c-97b6-468f-a448-a6e432c48269
Host.Version:

Lecteur mobile natif Power Apps sous iOS

Host.BrowserUserAgent: Mozilla/5.0 (iPhone; CPU iPhone OS 16_6_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148 PowerApps/e1c23ff9-4822-4e75-a003-01c91407a4d2
Host.OSType: Windows
Host.SessionID: 3ebec22f-ee2e-412a-b3eb-45d97db34863
Host.TenantID: 5da56e5c-97b6-468f-a448-a6e432c48269
Host.Version: PowerApps-Native/3.23084.8(iOS)

Lecteur Web Power Apps sous Windows avec le navigateur Firefox

Host.BrowserUserAgent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:109.0) Gecko/20100101 Firefox/117.0
Host.OSType: Windows
Host.SessionID: 283309a4-d88b-4b2a-88de-73b47d1b62d0
Host.TenantID: 5da56e5c-97b6-468f-a448-a6e432c48269
Host.Version: PowerApps-Web/3.23084.6(Windows)

Lecteur Web Power Apps sous iOS avec le navigateur Safari

Host.BrowserUserAgent: Mozilla/5.0 (iPhone; CPU iPhone OS 16_6_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.6 Mobile/15E148 Safari/604.1
Host.OSType: iOS
Host.SessionID: a09a946d-ce71-4c1f-bd35-519c79849c8d
Host.TenantID: 5da56e5c-97b6-468f-a448-a6e432c48269
Host.Version: PowerApps-Web/3.23084.6(iOS)