Compartilhar via


User Função

Aplica-se a: Aplicativos de tela Do Dataverse functions Power Pages

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

Description

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

Propriedade Description
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(). Imagem 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ê publicou seu aplicativo com uma User função antes de março de 2020, poderá descobrir que ele, intermitentemente, 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 de entrada: aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb(GUID)
  • Imagem: Ícone de imagem.
Fórmula Description 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. aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb (GUIA)
User(). Imagem 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.