Função User

  • Artigo

Aplica-se a: Aplicativos de tela

Retorna informações sobre o usuário atual.

Description

A função User retorna um registro de informações sobre o usuário atual:

Propriedade Descrição
User().Email Endereço de email do usuário atual. A função User().Email retorna o UPN do usuário e não o endereço de email SMTP.
User().EntraObjectId ID do Objeto do Microsoft Entra do usuário atual, útil para chamar APIs que usam esse valor. Este é um valor GUID e é exclusivo para cada usuário.
User().FullName Nome completo do usuário atual, incluindo nome e sobrenome.
User().Image Imagem do usuário atual. Isso será a URL da imagem do formulário "blob:identifier". Defina a propriedade Image do controle Image para este valor para exibir a imagem no aplicativo.

Nota

As informações retornadas são para o usuário atual do Power Apps. Ela será compatível com as informações de "Conta" exibidas nos players do Power Apps e no Studio, que podem ser encontrados fora de todos os aplicativos criados. Isso pode não corresponder às informações do usuário atual no Office 365 ou outros serviços.

Nota

Se você tiver publicado seu aplicativo com uma função User antes de março de 2020, descobrirá que ele, de forma intermitente, não recuperará fotos. Os problemas foram corrigidos na versão mais recente de março de 2020. Para aproveitar a implementação atualizada, basta reabrir o aplicativo, salvá-lo e publicá-lo novamente.

Sintaxe

User()

Exemplos

O usuário atual do Power Apps tem as seguintes informações:

  • Nome completo: "John Doe"
  • Endereço de email: "john.doe@contoso.com"
  • Id do Objeto Entra: a90c6800-e58c-4495-81f7-55819b56fe2a(GUID)
  • Imagem: Ícone de imagem.
Fórmula Descrição Result
User() Registro de todas as informações do usuário atual do Power Apps. { FullName: "John Doe", Email: "john.doe@contoso.com", Imagem: "blob:1234...5678", EntraObjectId: a90c6800‑e58c‑4495‑81f7‑55819b56fe2a }
User().Email O endereço de email do usuário atual do Power Apps. "john.doe@contoso.com"
User().FullName O nome completo do usuário atual do Power Apps. "John Doe"
User().EntraObjectId ID do Objeto do Microsoft Entra do usuário atual. a90c6800-e58c-4495-81f7-55819b56fe2a (GUID)
User().Image O URL da imagem do usuário atual do Power Apps. Defina a propriedade Image do controle Image para este valor para exibir a imagem no aplicativo. "blob:1234...5678"

Com ImageControl.Image:
Ícone de imagem 1.