Objeto Host no Power Apps
Aplica-se a:
Aplicativos de tela Aplicativos baseados em modelo
O objeto Host no Power Apps fornece informações sobre o host atual que está executando o aplicativo.
Description
O objeto Host fornece informações sobre o dispositivo host, o sistema operacional e o player que está executando um aplicativo. Host é semelhante ao objeto Aplicativo e cada aplicativo tem acesso a essas informações.
Um dos melhores usos do Host é depurar um aplicativo que não está funcionando corretamente em um dispositivo ou navegador específico. Use as propriedades de texto desse objeto para exibir informações na IU do aplicativo com um controle Rótulo de texto ou registre as informações em uma tabela de banco de dados ou no Application Insights.
É tentador usar Host para adaptar um aplicativo a um dispositivo ou navegador específico. Isto é perigoso, pois o Power Apps foi projetado para ser executado em um amplo espectro de plataformas de hardware e software e sua lógica básica do Host pode não dar conta de todos elas e elas mudarão com o tempo. A melhor abordagem é usar informações mais abstratas e não vinculadas a hardware e software específicos. Por exemplo, use a propriedade Tamanho do controle de Tela para personalizar uma tela para mostrar menos ou reorganizar informações ao executar em um dispositivo menor, como um telefone.
Para acessar o objeto Host no Power Apps Studio, expanda o objeto do Aplicativo na parte superior do painel Exibição de árvore e selecione Host. Neste exemplo, o objeto Host não tem nenhuma propriedade que aceite fórmulas.
Observação
Atualmente, o objeto host está disponível apenas em páginas personalizadas e aplicativos de tela.
Propriedade BrowserUserAgent
A propriedade de texto BrowserUserAgent contém a cadeia de caracteres completa do agente do usuário que o navegador usa para se identificar ao executar o aplicativo.
Por exemplo, uma string de agente do usuário do navegador pode 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
Observação
Se você estiver executando o Power Apps em um aplicativo nativo ou usando o recurso empacotamento no Power Apps, o aplicativo é apresentado por meio de um controle de navegador, que fornece uma string de agente do usuário.
Propriedade OSType
A propriedade OSType fornece o nome do sistema operacional em que o aplicativo está sendo executado. O OSType é determinado a partir da cadeia de caracteres do agente do usuário enviada pelo navegador para o Power Apps. Veja a seguir exemplos de valores comuns para OSType:
| Valor |
|---|
| Janelas |
| Mac OS |
| iOS |
| Android |
| Linux |
| ... |
Observação
Não use o OSType para alterar a experiência ou funcionalidade do seu aplicativo com base no sistema operacional relatado.
O texto OSType pode ser usado em qualquer fórmula, inclusive para mostrá-lo na propriedade de texto de um rótulo:
Label1.Text: "You're running " & Host.OSType
Propriedade SessionID
A propriedade SessionID retorna o GUID que identifica a sessão atual. Inclua essas informações ao relatar problemas ao administrador.
Observação
Em cenários inseridos, como Power Apps no Power BI, a propriedade SessionID retorna a ID de sessão subjacente do Power Apps, não a 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 locatário do Microsoft Entra (AAD) associado ao usuário autenticado no momento.
Observação
Semelhante a SessionID, em cenários incorporados como Power Apps em Power BI, o ID do locatário é o locatário usado para autenticação de sessão do Power Apps.
Label1.Text: Host.TenantID
Propriedade da versão
A propriedade Versão fornece a identificação e o número da versão do player do Power Apps. Semelhante a BrowserUserAgent, mais de um número de versão poderá ser retornado, separados por espaços.
Observação
A propriedade Version é sempre uma string vazia ao trabalhar no Power Apps Studio.
Label1.Text: Host.Version
Propriedade OfflineEnabled
A propriedade OfflineEnabled fornece o modo de tempo de execução do aplicativo no player do Power Apps. Para aplicativos que não estão habilitados para uso offline, a propriedade é sempre false. Para aplicativos habilitados para offline, a propriedade é falsa na Web, mas verdadeira em iOS, Android e no Windows.
Observação
Mesmo que um aplicativo de tela não funcione sem conectividade de rede, a propriedade OfflineEnabled permanece verdadeira no Power Apps Studio para aplicativos de tela que foram ativados para uso offline.
Label1.Text: Host.OfflineEnabled
Exemplos
- Criar um aplicativo de Tela.
- Adicione um controle de Rótulo de texto e defina a propriedade
Textcomo"Host.BrowserUserAgent: " & Host.BrowserUserAgent. - Adicione um controle de Rótulo de texto e defina a propriedade
Textcomo"Host.OSType: " & Host.OSType. - Adicione um controle de Rótulo de texto e defina a propriedade
Textcomo"Host.SessionID: " & Host.SessionID. - Adicione um controle de Rótulo de texto e defina a propriedade
Textcomo"Host.TenantID: " & Host.TenantID. - Adicione um controle de Rótulo de texto e defina a propriedade
Textcomo"Host.Version: " & Host.Version. - Adicione um controle de Rótulo de texto e defina a propriedade
Textcomo"Host.OfflineEnabled: " & Host.OfflineEnabled.
Execute seu aplicativo em diferentes dispositivos e navegadores diferentes e você verá resultados semelhantes aos abaixo.
Power Apps Studio no Windows com navegador Edge
Host.Version está sempre em branco ao trabalhar 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:
Player móvel nativo do Power Apps no 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)
Player da Web do Power Apps no Windows com o navegador do 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)
Player da Web do Power Apps no iOS com o 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: 5da56e5c-97b6-468f-a448-a6e432c48269
Host.Version: PowerApps-Web/3.23084.6(iOS)
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de