Objeto Host no Power Apps

Aplica-se a: Aplicativos de tela Aplicativos controlados por modelo

O objeto Host no Power Apps fornece informações sobre o anfitrião atual que está a executar a aplicação.

Descrição

O objeto Sistema anfitrião fornece informações sobre o dispositivo do sistema anfitrião, o sistema operativo e o leitor que está a executar uma aplicação. O host é semelhante ao objeto App e todos os aplicativos têm acesso a essas informações.

Uma das melhores utilizações do Sistema anfitrião é depurar uma aplicação que não está a funcionar corretamente num dispositivo específico ou com um browser específico. Utilize as propriedades de texto deste objeto para apresentar informações na IU da aplicação com um controlo de Etiqueta de texto ou registe as informações numa tabela da base de dados ou no Application Insights.

É possível utilizar o Sistema anfitrião para personalizar uma aplicação para um dispositivo ou browser específico. Isto é perigoso, uma vez que o Power Apps foi concebido para ser executado numa vasta gama de plataformas de hardware e software e a sua lógica baseada no Sistema anfitrião pode não contabilizar todas e irão mudando ao longo do tempo. A melhor abordagem é utilizar informações mais abstratas e que não estão ligadas a hardware e software específicos. Por exemplo, utilize a propriedade Tamanho do controlo Ecrã para personalizar um ecrã para mostrar menos ou reorganizar informações quando estiver em execução num dispositivo mais pequeno, como um telefone.

Para aceder ao objeto Sistema anfitrião no Power Apps Studio, expanda o objeto Aplicação no topo do painel Vista de árvore e, em seguida, selecione Sistema anfitrião. Neste exemplo, o objeto Host não tem propriedades que aceitem fórmulas.

Propriedade BrowserUserAgent

A propriedade de texto BrowserUserAgent contém a cadeia de agente de utilizador completa que o browser utiliza para se identificar ao executar a aplicação.

Por exemplo, uma cadeia de agente de utilizador de browser poderá ser:

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

Propriedade OSType

A propriedade OSType fornece o nome do sistema operativo em que a aplicação está em execução. OSType é determinado a partir da cadeia de agente de utilizador enviada pelo browser para o Power Apps. Seguem-se exemplos de valores comuns para OSType:

O texto OSType pode ser utilizado em qualquer fórmula, tal como mostrá-lo na propriedade de texto de uma etiqueta:

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

Propriedade SessionID

A propriedade SessionID devolve o GUID que identifica a sessão atual. Inclua estas informações quando reportar problemas ao seu administrador.

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

Propriedade TenantID

A propriedade TenantID fornece o identificador exclusivo global (GUID) que especifica o inquilino do Microsoft Entra associado ao utilizador autenticado atualmente.

Label1.Text: Host.TenantID

Propriedade Versão

A propriedade Versão fornece a identificação e o número de versão do leitor do Power Apps. À semelhança do BrowserUserAgent, pode devolver mais de um número de versão, separado por espaços.

Label1.Text: Host.Version

Propriedade OfflineEnabled

A propriedade OfflineEnabled fornece o modo de runtime da aplicação no leitor do Power Apps. Para aplicações que não estão ativadas para offline, a propriedade é sempre false. Para aplicações ativadas para offline , a propriedade é false na Web, mas true em iOS, Android e Windows.

Label1.Text: Host.OfflineEnabled

Exemplos

1. Crie uma nova aplicação de tela.
2. Adicione um controlo Etiqueta de texto e defina a respetiva propriedade Text como "Host.BrowserUserAgent: " & Host.BrowserUserAgent.
3. Adicione um controlo Etiqueta de texto e defina a respetiva propriedade Text como "Host.OSType: " & Host.OSType.
4. Adicione um controlo Etiqueta de texto e defina a respetiva propriedade Text como "Host.SessionID: " & Host.SessionID.
5. Adicione um controlo Etiqueta de texto e defina a respetiva propriedade Text como "Host.TenantID: " & Host.TenantID.
6. Adicione um controlo Etiqueta de texto e defina a respetiva propriedade Text como "Host.Version: " & Host.Version.
7. Adicione um controlo Etiqueta de texto e defina a respetiva propriedade Text como "Host.OfflineEnabled: " & Host.OfflineEnabled.

Execute a aplicação em diferentes dispositivos e com browsers diferentes e verá resultados semelhantes aos de baixo.

Power Apps Studio no Windows com o browser Edge

Host.Version está sempre em branco ao trabalhar 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: 

Power Apps nativo do leitor móvel em 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)

Leitor web do Power Apps no Windows com o browser 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)

Leitor web do Power Apps em iOS com o browser 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)