Conectar-se ao Usuários do Office 365 a partir do Power Apps

Usuários do Office 365.

O Usuários do Office 365 permite acessar perfis de usuário em sua organização usando sua conta do Office 365. Você pode executar várias ações, como obter seu perfil, o perfil de um usuário, o gerente ou os subordinados diretos de um usuário.

Você pode exibir essas informações em um rótulo do aplicativo. Você pode exibir uma função, várias funções ou até mesmo combinar funções diferentes. Por exemplo, você pode criar uma expressão que combine o nome de usuário e o número de telefone e, em seguida, exibir essas informações em seu aplicativo.

Este artigo mostra como adicionar usuários do Office 365 como uma conexão, adicionar usuários do Office 365 como uma fonte de dados para seu aplicativo e usar dados de tabela em um controle de galeria.

Pré-requisitos

Adicionar uma conexão

  1. Adicione uma conexão de dados e selecione Usuários do Office 365:

    Conecte-se ao Office 365.

  2. Selecione Conectar e, se for solicitado que você entre, insira sua conta corporativa.

A conexão do Usuários do Office 365 foi criada e adicionada ao seu aplicativo. Agora, ele está pronto para ser usado.

Usar a conexão em seu aplicativo

Mostrar informações sobre o usuário atual

  1. No menu Inserir, selecione Rótulo

  2. Na barra de funções, defina sua propriedade Text como qualquer uma das fórmulas a seguir:

    Office365Users.MyProfile().City
    Office365Users.MyProfile().CompanyName
    Office365Users.MyProfile().Country
    Office365Users.MyProfile().Department
    Office365Users.MyProfile().DisplayName
    Office365Users.MyProfile().GivenName
    Office365Users.MyProfile().Id
    Office365Users.MyProfile().JobTitle
    Office365Users.MyProfile().Mail
    Office365Users.MyProfile().MailNickname
    Office365Users.MyProfile().mobilePhone
    Office365Users.MyProfile().OfficeLocation
    Office365Users.MyProfile().PostalCode
    Office365Users.MyProfile().Surname
    Office365Users.MyProfile().TelephoneNumber
    Office365Users.MyProfile().UserPrincipalName
    Office365Users.MyProfile().AccountEnabled

O rótulo mostra as informações inseridas sobre o usuário atual.

Mostrar informações sobre outro usuário

  1. No menu Inserir, selecione Texto e, em seguida, Entrada de texto. Renomeie-o como InfoAbout:

    Renomeie o controle.

  2. Em InfoAbout, digite ou cole o endereço de email de um usuário em sua organização. Por exemplo, digite yourName@yourCompany.com.

  3. Adicione um Rótulo (menu Inserir) e defina sua propriedade Text como uma das seguintes fórmulas:

    • Para mostrar informações sobre outro usuário:

      Office365Users.UserProfile(InfoAbout.Text).City
      Office365Users.UserProfile(InfoAbout.Text).CompanyName
      Office365Users.UserProfile(InfoAbout.Text).Country
      Office365Users.UserProfile(InfoAbout.Text).Department
      Office365Users.UserProfile(InfoAbout.Text).DisplayName
      Office365Users.UserProfile(InfoAbout.Text).GivenName
      Office365Users.UserProfile(InfoAbout.Text).Id
      Office365Users.UserProfile(InfoAbout.Text).JobTitle
      Office365Users.UserProfile(InfoAbout.Text).Mail
      Office365Users.UserProfile(InfoAbout.Text).MailNickname
      Office365Users.UserProfile(InfoAbout.Text).mobilePhone
      Office365Users.UserProfile(InfoAbout.Text).OfficeLocation
      Office365Users.UserProfile(InfoAbout.Text).PostalCode
      Office365Users.UserProfile(InfoAbout.Text).Surname
      Office365Users.UserProfile(InfoAbout.Text).TelephoneNumber
      Office365Users.UserProfile(InfoAbout.Text).UserPrincipalName
      Office365Users.UserProfile(InfoAbout.Text).AccountEnabled
      Office365Users.UserProfile(InfoAbout.Text).BusinessPhones

    • Para mostrar informações sobre o gerente de outro usuário:

      Office365Users.Manager(InfoAbout.Text).City
      Office365Users.Manager(InfoAbout.Text).CompanyName
      Office365Users.Manager(InfoAbout.Text).Country
      Office365Users.Manager(InfoAbout.Text).Department
      Office365Users.Manager(InfoAbout.Text).DisplayName
      Office365Users.Manager(InfoAbout.Text).GivenName
      Office365Users.Manager(InfoAbout.Text).Id
      Office365Users.Manager(InfoAbout.Text).JobTitle
      Office365Users.Manager(InfoAbout.Text).Mail
      Office365Users.Manager(InfoAbout.Text).MailNickname
      Office365Users.Manager(InfoAbout.Text).mobilePhone
      Office365Users.Manager(InfoAbout.Text).OfficeLocation
      Office365Users.Manager(InfoAbout.Text).PostalCode
      Office365Users.Manager(InfoAbout.Text).Surname
      Office365Users.Manager(InfoAbout.Text).TelephoneNumber
      Office365Users.Manager(InfoAbout.Text).UserPrincipalName
      Office365Users.Manager(InfoAbout.Text).AccountEnabled
      Office365Users.Manager(InfoAbout.Text).BusinessPhones

O rótulo mostra as informações inseridas sobre o usuário especificado ou o gerente do usuário.

Observação

Se você estiver desenvolvendo um aplicativo com base em uma tabela no Microsoft Dataverse, poderá especificar um usuário com base na ID em vez do endereço de email.

Por exemplo, você pode criar um aplicativo automaticamente, adicionar uma tela que contém um controle Rótulo e definir a propriedade Text do controle com esta fórmula:
Office365Users.UserProfile(BrowseGallery1.Selected.CreatedByUser).DisplayName

Se você criar um contato e selecioná-lo na tela de procura do aplicativo, o controle Rótulo mostrará seu nome de exibição.

Mostrar os subordinados diretos de outro usuário

  1. Adicione um controle Entrada de texto (menu Inserir > Texto) e renomeie-o como InfoAbout.

  2. Em InfoAbout, insira o endereço de email de um usuário em sua organização. Por exemplo, insira yourManagersName@yourCompany.com

  3. Adicione uma galeria Com texto (menu Inserir > Galeria) e defina sua propriedade Items como a fórmula a seguir:

    Office365Users.DirectReports(InfoAbout.Text)

    A galeria mostra informações sobre os subordinados diretos do usuário que você inseriu.

    Com a galeria selecionada, o painel direito mostra opções para essa galeria.

  4. Na segunda lista, selecione JobTitle. Na terceira lista, selecione DisplayName. A galeria é atualizada para mostrar esses valores.

Observação

A primeira caixa é, na verdade, um controle de imagem. Se você não tiver uma imagem, poderá excluir o controle de imagem e adicionar um rótulo em seu lugar. Adicionar e configurar controles é um bom recurso.

Pesquisar usuários

  1. Adicionar um controle Entrada de texto (Inserir menu > Entrada de texto).

  2. Selecione Inserir > Galeria vertical.

  3. Altere o layout da galeria vertical para Título, subtítulo e corpo.

  4. Selecione o ícone de seta da primeira linha dentro da galeria e exclua-o.

  5. Atualize a fórmula da galeria vertical para o seguinte.

    Office365Users.SearchUserV2({searchTerm:TextInput1.Text,top:5}).value
    

    Na fórmula acima, o termo de pesquisa faz referência ao texto inserido no controle Entrada de texto ("TextInput1" neste exemplo); e os resultados da pesquisa são limitados aos primeiros 5.

  6. Atualize os campos da galeria vertical para que mostrem DisplayName no título da galeria, JobTitle na legenda e Departamento no corpo.

    Campos de galeria selecionados.

  7. Reproduza o aplicativo e digite o texto dentro da caixa de entrada de texto. Conforme você insere o texto, os resultados mudam com base nas alterações da string de entrada.

    Exemplo de pesquisa.

Exibir as funções disponíveis

Essa conexão inclui as seguintes funções:

Nome da Função Descrição
DirectReports Retorna os subordinados diretos do usuário especificado.
Manager Recupera o perfil do usuário para o gerente do usuário especificado.
MyProfile Recupera o perfil do usuário atual.
SearchUser Recupera resultados da pesquisa de perfis de usuário.
UserProfile Recupera um perfil do usuário específico.

MyProfile

Obter meu perfil: recupera o perfil do usuário atual.

Propriedades de entrada

Nenhum.

Propriedades de saída

Nome da Propriedade Tipo Descrição
City cadeia de caracteres Cidade do usuário.
CompanyName cadeia de caracteres Empresa do usuário.
Country cadeia de caracteres País do usuário.
Department cadeia de caracteres Departamento do usuário.
DisplayName cadeia de caracteres Nome de exibição do usuário.
GivenName cadeia de caracteres Nome fornecido do usuário.
Id cadeia de caracteres ID do usuário.
JobTitle cadeia de caracteres Cargo do usuário.
Mail cadeia de caracteres ID do email do usuário.
MailNickname cadeia de caracteres Apelido do usuário.
mobilePhone cadeia de caracteres Celular do usuário.
OfficeLocation cadeia de caracteres Local do escritório do usuário.
PostalCode cadeia de caracteres CEP do usuário.
Surname cadeia de caracteres Sobrenome do usuário.
TelephoneNumber cadeia de caracteres Número de telefone do usuário.
UserPrincipalName cadeia de caracteres Nome UPN.
AccountEnabled booliano Sinalizador de conta habilitada.
BusinessPhones cadeia de caracteres Números de telefone da empresa do usuário.

UserProfile

Obter perfil do usuário: recupera um perfil do usuário específico.

Propriedades de entrada

Nome Tipo de Dados Obrigatória Descrição
Id cadeia de caracteres sim ID de email ou nome UPN.

Propriedades de saída

Nome da Propriedade Tipo Descrição
City cadeia de caracteres Cidade do usuário.
CompanyName cadeia de caracteres Empresa do usuário.
Country cadeia de caracteres País do usuário.
Department cadeia de caracteres Departamento do usuário.
DisplayName cadeia de caracteres Nome de exibição do usuário.
GivenName cadeia de caracteres Nome fornecido do usuário.
Id cadeia de caracteres ID do usuário.
JobTitle cadeia de caracteres Cargo do usuário.
Mail cadeia de caracteres ID do email do usuário.
MailNickname cadeia de caracteres Apelido do usuário.
Surname cadeia de caracteres Sobrenome do usuário.
TelephoneNumber cadeia de caracteres Número de telefone do usuário.
UserPrincipalName cadeia de caracteres Nome UPN.
AccountEnabled booliano Sinalizador de conta habilitada.
BusinessPhones cadeia de caracteres Números de telefone da empresa do usuário.

Manager

Obter gerente: recupera o perfil do usuário para o gerente do usuário especificado.

Propriedades de entrada

Nome Tipo de Dados Obrigatória Descrição
Id cadeia de caracteres sim ID de email ou nome UPN.

Propriedades de saída

Nome da Propriedade Tipo Descrição
City cadeia de caracteres Cidade do usuário.
CompanyName cadeia de caracteres Empresa do usuário.
Country cadeia de caracteres País do usuário.
Department cadeia de caracteres Departamento do usuário.
DisplayName cadeia de caracteres Nome de exibição do usuário.
GivenName cadeia de caracteres Nome fornecido do usuário.
Id cadeia de caracteres ID do usuário.
JobTitle cadeia de caracteres Cargo do usuário.
Mail cadeia de caracteres ID do email do usuário.
MailNickname cadeia de caracteres Apelido do usuário.
mobilePhone cadeia de caracteres Celular do usuário.
OfficeLocation cadeia de caracteres Local do escritório do usuário.
PostalCode cadeia de caracteres CEP do usuário.
Surname cadeia de caracteres Sobrenome do usuário.
TelephoneNumber cadeia de caracteres Número de telefone do usuário.
UserPrincipalName cadeia de caracteres Nome UPN.
AccountEnabled booliano Sinalizador de conta habilitada.
BusinessPhones cadeia de caracteres Números de telefone da empresa do usuário.

DirectReports

Obter subordinados diretos: obter subordinados diretos.

Propriedades de entrada

Nome Tipo de Dados Obrigatória Descrição
Id cadeia de caracteres sim ID de email ou nome UPN.

Propriedades de saída

Nome da Propriedade Tipo Descrição
City cadeia de caracteres Cidade do usuário.
CompanyName cadeia de caracteres Empresa do usuário.
Country cadeia de caracteres País do usuário.
Department cadeia de caracteres Departamento do usuário.
DisplayName cadeia de caracteres Nome de exibição do usuário.
GivenName cadeia de caracteres Nome fornecido do usuário.
Id cadeia de caracteres ID do usuário.
JobTitle cadeia de caracteres Cargo do usuário.
Mail cadeia de caracteres ID do email do usuário.
MailNickname cadeia de caracteres Apelido do usuário.
mobilePhone cadeia de caracteres Celular do usuário.
OfficeLocation cadeia de caracteres Local do escritório do usuário.
PostalCode cadeia de caracteres CEP do usuário.
Surname cadeia de caracteres Sobrenome do usuário.
TelephoneNumber cadeia de caracteres Número de telefone do usuário.
UserPrincipalName cadeia de caracteres Nome UPN.
AccountEnabled booliano Sinalizador de conta habilitada.
BusinessPhones cadeia de caracteres Números de telefone da empresa do usuário.

SearchUser

Pesquisar usuários: recupera resultados da pesquisa de perfis de usuário.

Propriedades de entrada

Nome Tipo de Dados Obrigatória Descrição
searchTerm cadeia de caracteres não Cadeia de caracteres de pesquisa. Aplica-se a: nome de exibição, nome, sobrenome, email, apelido de email e nome UPN.

Propriedades de saída

Nome da Propriedade Tipo Descrição
City cadeia de caracteres Cidade do usuário.
CompanyName cadeia de caracteres Empresa do usuário.
Country cadeia de caracteres País do usuário.
Department cadeia de caracteres Departamento do usuário.
DisplayName cadeia de caracteres Nome de exibição do usuário.
GivenName cadeia de caracteres Nome fornecido do usuário.
Id cadeia de caracteres ID do usuário.
JobTitle cadeia de caracteres Cargo do usuário.
Mail cadeia de caracteres ID do email do usuário.
MailNickname cadeia de caracteres Apelido do usuário.
mobilePhone cadeia de caracteres Celular do usuário.
OfficeLocation cadeia de caracteres Local do escritório do usuário.
PostalCode cadeia de caracteres CEP do usuário.
Surname cadeia de caracteres Sobrenome do usuário.
TelephoneNumber cadeia de caracteres Número de telefone do usuário.
UserPrincipalName cadeia de caracteres Nome UPN.
AccountEnabled booliano Sinalizador de conta habilitada.
BusinessPhones string Números de telefone da empresa do usuário.

Confira também

Observação

Você pode nos falar mais sobre suas preferências de idioma para documentação? Faça uma pesquisa rápida. (Observe que esta pesquisa está em inglês)

A pesquisa levará cerca de sete minutos. Nenhum dado pessoal é coletado (política de privacidade).