Comparteix a través de

Objecte d'amfitrió a Power Apps

  • Article

S'aplica a: Aplicacions de llenç Aplicacions basades en models

L'objecte Host a Power Apps proporciona informació sobre l'equip actual que executa l'aplicació.

Descripció

L'objecte Host proporciona informació sobre el dispositiu amfitrió, el sistema operatiu i el reproductor que executa una aplicació. L'amfitrió és similar a l'objecte App i totes les aplicacions tenen accés a aquesta informació.

Un dels millors usos de Host és depurar una aplicació que no funciona correctament en un dispositiu específic o amb un navegador específic. Utilitzeu les propietats de text d'aquest objecte per mostrar informació a la interfície d'usuari de l'aplicació amb un control d'etiqueta de text o registrar la informació en una taula de base de dades o a Application Insights.

És temptador utilitzar Host per adaptar una aplicació a un dispositiu o navegador específic. Això és perillós, ja que Power Apps està dissenyat per executar-se en un ampli espectre de plataformes de maquinari i programari i és possible que la vostra lògica basada en l'amfitrió no els tingui en compte tots i canviaran amb el temps. El millor enfocament és utilitzar informació més abstracta i no lligada a maquinari i programari específics. Per exemple, utilitzeu la propietat Mida del control Pantalla per personalitzar una pantalla perquè mostri menys informació o reorganitzi la informació quan s'executa en un dispositiu més petit, com ara un telèfon.

Per accedir a l'objecte Host a Power Apps Studio, expandiu l'objecte App a la part superior de la subfinestra Visualització d'arbre i, a continuació, seleccioneu Host. En aquest exemple, l'objecte Host no té cap propietat que accepti fórmules.

L'objecte Host a la subfinestra Visualització d'arbre.

Nota

Actualment, l'objecte amfitrió només està disponible en pàgines personalitzades i aplicacions de llenç.

Propietat BrowserUserAgent

La propietat text BrowserUserAgent conté la cadena agent d'usuari completa que el navegador utilitza per identificar-se quan s'executa l'aplicació.

Per exemple, una cadena agent d'usuari del navegador pot ser:

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

Nota

Si esteu executant Power Apps en una aplicació nativa o utilitzeu la funció Empaqueta , Power Apps l'aplicació es presenta mitjançant un control del navegador, que proporciona una cadena agent d'usuari.

Propietat OSType

La propietat OSType proporciona el nom del sistema operatiu on s'executa l'aplicació. L'OSType es determina a partir de la cadena agent de l'usuari enviada pel navegador a Power Apps. A continuació es mostren exemples de valors comuns per a OSType:

Valor
Finestres
Mac OS
iOS
Android
Linux
...

Nota

No utilitzis el sistema operatiu per canviar l'experiència o la funcionalitat de l'aplicació en funció del sistema operatiu que s'ha informat.

El text OSType es pot utilitzar en qualsevol fórmula, com ara mostrar-lo a la propietat text d'una etiqueta:

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

Propietat SessionID

La propietat SessionID retorna el GUID que identifica la sessió actual. Incloeu aquesta informació quan informeu de problemes a l'administrador.

Nota

En escenaris incrustats, com ara Power Apps a Power BI, la propietat SessionID retorna l'identificador de sessió subjacent Power Apps , no l'identificador de Power BI sessió.

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

Propietat TenantID

La propietat TenantID proporciona l'identificador únic global (GUID) que especifica l'inquilí Microsoft Entra associat amb l'usuari autenticat actualment.

Nota

De manera similar a SessionID, en escenaris incrustats, com ara Power Apps a Power BI, l'ID d'inquilí és l'inquilí utilitzat per a l'autenticació de la Power Apps sessió.

Label1.Text: Host.TenantID

Propietat de la versió

La propietat Version proporciona la identificació i el número de versió del Power Apps reproductor. De manera similar a BrowserUserAgent, es pot retornar més d'un número de versió, separat per espais.

Nota

La propietat Version sempre és una cadena buida quan es treballa Power Apps Studio.

Label1.Text: Host.Version

Propietat OfflineEnabled

La propietat OfflineEnabled proporciona el mode d'execució de l'aplicació al Power Apps reproductor. Per a les aplicacions que no estan habilitades per a fora de línia, la propietat sempre és falsa. Per a les aplicacions habilitades per a fora de línia , la propietat és falsa al web, però true a i al iOS Android Windows.

Nota

Fins i tot si una aplicació de llenç no funciona sense connectivitat de xarxa, la propietat OfflineEnabled segueix sent certa per a Power Apps Studio les aplicacions de llenç que s'han habilitat per a l'ús fora de línia.

Label1.Text: Host.OfflineEnabled

Exemples

  1. Creeu una aplicació Canvas nova.
  2. Afegiu un control d'etiqueta de text i definiu la Text propietat a "Host.BrowserUserAgent: " & Host.BrowserUserAgent.
  3. Afegiu un control d'etiqueta de text i definiu la Text propietat a "Host.OSType: " & Host.OSType.
  4. Afegiu un control d'etiqueta de text i definiu la Text propietat a "Host.SessionID: " & Host.SessionID.
  5. Afegiu un control d'etiqueta de text i definiu la Text propietat a "Host.TenantID: " & Host.TenantID.
  6. Afegiu un control d'etiqueta de text i definiu la Text propietat a "Host.Version: " & Host.Version.
  7. Afegiu un control d'etiqueta de text i definiu la Text propietat a "Host.OfflineEnabled: " & Host.OfflineEnabled.

Executeu la vostra aplicació en diferents dispositius i amb diferents navegadors i veureu resultats similars als següents.

Power Apps Studio a Windows amb navegador Edge

Host.Version sempre està en blanc quan es treballa 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: aaaabbbb-0000-cccc-1111-dddd2222eeee
Host.Version:

Power Apps Reproductor mòbil natiu a 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: aaaabbbb-0000-cccc-1111-dddd2222eeee
Host.Version: PowerApps-Native/3.23084.8(iOS)

Power Apps reproductor web a Windows amb Firefox navegador

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: aaaabbbb-0000-cccc-1111-dddd2222eeee
Host.Version: PowerApps-Web/3.23084.6(Windows)

Power Apps reproductor web activat iOS amb el navegador 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: aaaabbbb-0000-cccc-1111-dddd2222eeee
Host.Version: PowerApps-Web/3.23084.6(iOS)