Conectar-se ao Usuários do Office 365 a partir do Power Apps
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
- Acesso a Power Apps
- Adicionar a conexão
- Crie um aplicativo direto de um modelo, com dados ou do zero
Adicionar uma conexão
Adicione uma conexão de dados e selecione Usuários do Office 365:
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
No menu Inserir, selecione Rótulo
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
No menu Inserir, selecione Texto e, em seguida, Entrada de texto. Renomeie-o como InfoAbout:
Em InfoAbout, digite ou cole o endereço de email de um usuário em sua organização. Por exemplo, digite yourName@yourCompany.com.
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).BusinessPhonesPara 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
Adicione um controle Entrada de texto (menu Inserir > Texto) e renomeie-o como InfoAbout.
Em InfoAbout, insira o endereço de email de um usuário em sua organização. Por exemplo, insira yourManagersName@yourCompany.com
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.
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
Adicionar um controle Entrada de texto (Inserir menu > Entrada de texto).
Selecione Inserir > Galeria vertical.
Altere o layout da galeria vertical para Título, subtítulo e corpo.
Selecione o ícone de seta da primeira linha dentro da galeria e exclua-o.
Atualize a fórmula da galeria vertical para o seguinte.
Office365Users.SearchUserV2({searchTerm:TextInput1.Text,top:5}).valueNa 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.
Atualize os campos da galeria vertical para que mostrem DisplayName no título da galeria, JobTitle na legenda e Departamento no corpo.
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.
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/região 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. |
| 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/região 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. |
| 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/região 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. |
| 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/região 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. |
| 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/região 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. |
| 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
- Veja todas as conexões disponíveis.
- Saiba como adicionar conexões a seus aplicativos.
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).