Objeto Host no Power Apps

Aplica-se a: Aplicações de tela Aplicações condicionadas 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 Sistema anfitrião é semelhante ao objeto da Aplicação e cada aplicação tem 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.

Nota

Atualmente, o objeto host só está disponível em páginas personalizadas e aplicações de tela.

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

Nota

Se estiver a executar o Power Apps numa aplicação nativa ou a utilizar a caraterística de encapsulamento no Power Apps, a aplicação é apresentada através de um controlo de browser, o que fornece uma cadeia de agente de utilizador.

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:

Valor
Janelas
Mac OS
iOS
Android
Linux
...

Nota

Não utilize o OSType para alterar a experiência ou funcionalidade da aplicação com base no sistema operativo reportado.

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.

Nota

Em cenários incorporados, como o Power Apps no Power BI, a propriedade SessionID devolve o ID de sessão do Power Apps subjacente e não o ID de sessão do Power BI.

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.

Nota

Tal como SessionID, em cenários incorporados como o Power Apps no Power BI, o ID de inquilino é o inquilino utilizado para a autenticação de sessão do Power Apps.

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.

Nota

A propriedade Versão é sempre uma cadeia vazia quando trabalha no Power Apps Studio.

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.

Nota

Mesmo que uma aplicação de tela não funcione sem conectividade de rede, a propriedade OfflineEnabled permanece verdadeira nas aplicações de tela do Power Apps Studio que foram ativadas para utilização offline.

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 quando trabalha no 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)