Compartir a través de

Objeto Host en Power Apps

  • Artículo

Se aplica a: Aplicaciones de Canvas Aplicaciones basadas en modelos

El objeto Host en Power Apps proporciona información sobre el host actual que ejecuta la aplicación.

Description

El objeto Host proporciona información sobre el dispositivo host, el sistema operativo y el reproductor que ejecuta una aplicación. El host es similar al objeto App y cada aplicación tiene acceso a esta información.

Uno de los mejores usos de Host es depurar una aplicación que no funciona correctamente en un dispositivo específico o con un navegador específico. Utilice las propiedades de texto de este objeto para mostrar información en la interfaz de usuario de la aplicación con un control Etiqueta de texto o registre la información en una tabla de base de datos o en Application Insights.

Es tentador utilizar Host para adaptar una aplicación a un dispositivo o navegador específico. Esto es peligroso ya que Power Apps está diseñado para ejecutarse en un amplio espectro de plataformas de hardware y software y su lógica Host puede que no los tenga en cuenta todos y cambiarán con el tiempo. El mejor enfoque es utilizar información más abstracta y no vinculada a hardware y software específicos. Por ejemplo, utilice la propiedad Size del control Screen para personalizar una pantalla para mostrar menos o reorganizar información cuando se ejecuta en un dispositivo más pequeño, como un teléfono.

Para acceder al objeto Host en Power Apps Studio, expanda el objeto Aplicación en la parte superior del panel de Vista de árbol y luego seleccione Host. En este ejemplo, el objeto Host no tiene ninguna propiedad que acepte fórmulas.

El objeto Host en el panel de Vista de árbol.

Nota

Actualmente, el objeto host solo está disponible en páginas personalizadas y aplicaciones de lienzo.

Propiedad BrowserUserAgent

La propiedad de texto BrowserUserAgent contiene la cadena de agente de usuario completa que el navegador usa para identificarse cuando ejecuta la aplicación.

Por ejemplo, una cadena de agente de usuario del navegador podría ser:

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

Nota

Si estás ejecutando Power Apps en una aplicación nativa o usando la función encapsular en Power Apps, la aplicación se presenta a través de un control del navegador, que proporciona una cadena de agente de usuario.

Propiedad OSType

La propiedad OSType proporciona el nombre del sistema operativo en el que se ejecuta la aplicación. OSType se determina a partir de la cadena de agente de usuario enviada por el navegador a Power Apps. Los siguientes son ejemplos de valores comunes para OSType:

valor
Ventanas
Mac OS
iOS
Android
Linux
...

Nota

No use OSType para cambiar la experiencia o funcionalidad de su aplicación según el sistema operativo informado.

El texto de OSType se puede usar en cualquier fórmula, como mostrarlo en la propiedad de texto de una etiqueta:

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

Propiedad SessionID

La propiedad SessionID devuelve el GUID que identifica la sesión actual. Incluya esta información cuando informe problemas a su Administrador.

Nota

En escenarios incrustados como Power Apps en Power BI, la propiedad SessionID devuelve el ID de sesión de Power Apps subyacente, no el ID de sesión de Power BI.

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

Propiedad TenantID

La propiedad TenantID proporciona el identificador único global (GUID) que especifica el inquilino de Microsoft Entra asociado con el usuario autenticado actualmente.

Nota

Similar a SessionID, en escenarios incrustados como Power Apps en Power BI, el ID de arrendatario es el arrendatario utilizado para la autenticación de sesión de Power Apps.

Label1.Text: Host.TenantID

Propiedad Version

La propiedad Version proporciona la identificación y el número de versión del reproductor de Power Apps. Similar a BrowserUserAgent, se puede devolver más de un número de versión, separado por espacios.

Nota

La propiedad Version es siempre una cadena vacía cuando se trabaja en Power Apps Studio.

Label1.Text: Host.Version

Propiedad OfflineEnabled

La propiedad OfflineEnabled proporciona el modo de ejecución de la aplicación en el reproductor de Power Apps. Para las aplicaciones que no están habilitadas para funcionar sin conexión, la propiedad siempre es falsa. Para aplicaciones que son habilitadas para sin conexión, la propiedad es falso en la web, pero verdadero en iOS, Android y Windows.

Nota

Incluso si una aplicación de lienzo no funciona sin conectividad de red, la propiedad OfflineEnabled sigue siendo válida en Power Apps Studio para las aplicaciones de lienzo que se han habilitado para su uso sin conexión. .

Label1.Text: Host.OfflineEnabled

Ejemplos

  1. Crear una nueva aplicación de lienzo.
  2. Agregue un control Etiqueta de texto y establezca la propiedad Text a "Host.BrowserUserAgent: " & Host.BrowserUserAgent.
  3. Agregue un control Etiqueta de texto y establezca la propiedad Text a "Host.OSType: " & Host.OSType.
  4. Agregue un control Etiqueta de texto y establezca la propiedad Text a "Host.SessionID: " & Host.SessionID.
  5. Agregue un control Etiqueta de texto y establezca la propiedad Text a "Host.TenantID: " & Host.TenantID.
  6. Agregue un control Etiqueta de texto y establezca la propiedad Text a "Host.Version: " & Host.Version.
  7. Agregue un control Etiqueta de texto y establezca la propiedad Text a "Host.OfflineEnabled: " & Host.OfflineEnabled.

Ejecute su aplicación en diferentes dispositivos y con diferentes navegadores y verá resultados similares a los siguientes.

Power Apps Studio en Windows con el navegador Edge

Host.Version siempre está en blanco cuando se trabaja en 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óvil nativo en 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 en Windows con navegador 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: aaaabbbb-0000-cccc-1111-dddd2222eeee
Host.Version: PowerApps-Web/3.23084.6(Windows)

Power Apps reproductor web en iOS con 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)