Compartilhar via

Objeto Host no Power Apps

  • Artigo

Aplica-se a: Aplicativos Canvas Aplicativos baseados em modelos

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 App 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.

O objeto Host no painel Vista em árvore.

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 de empacotamento no Power Apps, o aplicativo será apresentado por meio de um controle de navegador, que fornece uma string de agente de 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

  1. Criar um aplicativo de Tela.
  2. Adicione um controle de Rótulo de texto e defina a propriedade Text como "Host.BrowserUserAgent: " & Host.BrowserUserAgent.
  3. Adicione um controle de Rótulo de texto e defina a propriedade Text como "Host.OSType: " & Host.OSType.
  4. Adicione um controle de Rótulo de texto e defina a propriedade Text como "Host.SessionID: " & Host.SessionID.
  5. Adicione um controle de Rótulo de texto e defina a propriedade Text como "Host.TenantID: " & Host.TenantID.
  6. Adicione um controle de Rótulo de texto e defina a propriedade Text como "Host.Version: " & Host.Version.
  7. Adicione um controle de Rótulo de texto e defina a propriedade Text como "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 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:

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