Ligue-se à conexão dos Usuários do Office 365 por meio do PowerAppsConnect to Office 365 Users connection from PowerApps

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.Office 365 Users lets you access user profiles in your organization using your Office 365 account. 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.You can perform various actions such as get your profile, a user's profile, a user's manager or direct reports.

Você pode exibir essas informações em um rótulo do aplicativo.You can display this information in a label on your app. Você pode exibir uma função, várias funções ou até mesmo combinar funções diferentes.You can display one function, multiple functions, or even combine different functions. 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.For example, you can create an expression that combines the User Name and Phone Number, and then display this information in your app.

Este tópico mostra como adicionar os Usuários do Office 365 como uma conexão, adicioná-los como uma fonte de dados ao seu aplicativo e usar dados de tabela em um controle da galeria.This topic shows you how to add Office 365 Users as a connection, add Office 365 Users as a data source to your app, and use table data in a gallery control.

Pré-requisitosPrerequisites

Adicionar um conexãoAdd a connection

  1. Adicione uma conexão de dados e selecione Usuários do Office 365:Add a data connection and select Office 365 Users:

    Conectar ao Office 365

  2. Selecione Conectar e, se for solicitado que você entre, insira sua conta corporativa.Select Connect, and if prompted to sign in, enter your work account.

A conexão o Usuários do Office 365 foi criada e adicionada ao seu aplicativo.The Office 365 Users connection has been created and added to your app. Agora, ele está pronto para ser usado.Now, it's ready to be used.

Usar a conexão em seu aplicativoUse the connection in your app

Mostrar informações sobre o usuário atualShow information about the current user

  1. No menu Inserir, selecione RótuloOn the Insert menu, select Label
  2. Na barra de função, defina sua propriedade Text para qualquer uma das fórmulas a seguir:In the function bar, set its Text property to any of the following formulas:

    Office365Users.MyProfile().Department
    Office365Users.MyProfile().DisplayName
    Office365Users.MyProfile().GivenName
    Office365Users.MyProfile().Id
    Office365Users.MyProfile().JobTitle
    Office365Users.MyProfile().Mail
    Office365Users.MyProfile().MailNickname
    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.The label shows the information that you entered about the current user.

Mostrar informações sobre outro usuárioShow information about another user

  1. No menu Inserir, selecione Text e, em seguida, selecione Text input.On the Insert menu, select Text, and then select Text input. Renomeie-a como InfoAbout:Rename it InfoAbout:

    Renomear controle

  2. Em InfoAbout, digite ou cole o endereço de email de um usuário em sua organização.In InfoAbout, type or paste an email address of a user in your organization. Por exemplo, digite yourName@yourCompany.com.For example, type in yourName@yourCompany.com.
  3. Adicione um Rótulo (menu Inserir) e defina sua propriedade Text com uma das seguintes fórmulas:Add a Label (Insert menu), and set its Text property to any of the following formulas:

    • Para mostrar informações sobre outro usuário:To show information about another user:

      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).Surname
      Office365Users.UserProfile(InfoAbout.Text).TelephoneNumber
      Office365Users.UserProfile(InfoAbout.Text).UserPrincipalName
      Office365Users.UserProfile(InfoAbout.Text).AccountEnabled

    • Para mostrar informações sobre o gerenciador de outro usuário:To show information about another user's manager:

      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).Surname
      Office365Users.Manager(InfoAbout.Text).TelephoneNumber
      Office365Users.Manager(InfoAbout.Text).UserPrincipalName
      Office365Users.Manager(InfoAbout.Text).AccountEnabled

O rótulo mostra as informações inseridas sobre o usuário especificado ou o gerenciador do usuário.The label shows the information that you entered about the user you specified or that user's manager.

Observação

Se você estiver desenvolvendo um aplicativo com base em uma entidade no Common Data Service, poderá especificar um usuário com base na ID em vez do endereço de email.If you're developing an app based on an entity in the Common Data Service, you can specify a user based on ID instead of email address.

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:For example, you can create an app automatically, add a screen that contains a Label control, and set the control's Text property to this formula:
Office365Users.UserProfile(BrowseGallery1.Selected.CreatedByUser).DisplayNameOffice365Users.UserProfile(BrowseGallery1.Selected.CreatedByUser).DisplayName

Se você criar um contato e selecioná-lo na tela Procurar do aplicativo, o controle Rótulo mostrará o nome de exibição.If you create a contact and select that contact in the browse screen of the app, the Label control will show your display name.

Mostrar os subordinados diretos de outro usuárioShow the direct reports of another user

  1. Adicione um controle de Entrada de texto (menu Inserir > Text) e renomeie-a como InfoAbout.Add a Text input control (Insert menu > Text), and rename it InfoAbout.
  2. Em InfoAbout, insira o endereço de email de um usuário em sua organização.In InfoAbout, enter the email address of a user in your organization. Por exemplo, insira yourManagersName@yourCompany.comFor example, enter yourManagersName@yourCompany.com
  3. Adicione uma galeria Com texto (menu Inserir > Galeria) e defina sua propriedade Items para a fórmula a seguir:Add a With text gallery (Insert menu > Gallery), and set its Items property to the following formula:

    Office365Users.DirectReports(InfoAbout.Text)

    A galeria mostra informações sobre os subordinados diretos do usuário que você inseriu.The gallery shows information about the direct reports of the user you entered.

    Com a galeria selecionada, o painel direito mostra opções para essa galeria.With the gallery selected, the right-hand pane shows options for that gallery.

  4. Na segunda lista, selecione JobTitle.In the second list, select JobTitle. Na terceira lista, selecione DisplayName.In the third list, select DisplayName. A Galeria é atualizada para mostrar esses valores.The gallery is updated to show these values.

Observação

A primeira caixa é, na verdade, um controle de imagem.The first box is actually an image control. Se você não tiver uma imagem, poderá excluir o controle de imagem e adicionar um rótulo em seu lugar.If you don't have an image, you can delete the image control, and add a label in its place. Adicionar e configurar controles é um bom recurso.Add and configure controls is a good resource.

Pesquisar usuáriosSearch for users

  1. Adicione um controle de Entrada de texto (menu Inserir > Text) e renomeie-a como SearchTerm.Add a Text input control (Insert menu > Text), and rename it SearchTerm. Insira um nome pelo qual pesquisar.Enter a name to search. Por exemplo, digite seu nome.For example, enter your first name.
  2. Adicione uma galeria Com texto (menu Inserir > Galeria) e defina sua propriedade Items para a fórmula a seguir:Add a With text gallery (Insert menu > Gallery), and set its Items property to the following formula:

    Office365Users.SearchUser({searchTerm: SearchTerm.Text})

    A galeria mostra os usuários cujo nome contém o texto de pesquisa que você inseriu.The gallery shows users whose name contains the search text you entered.

    Com a galeria selecionada, o painel direito mostra opções para essa galeria.With the gallery selected, the right-hand pane shows options for that gallery.

  3. Na segunda lista, selecione Mail.In the second list, select Mail. Na terceira lista, selecione DisplayName.In the third list, select DisplayName.

    O segundo e terceiro rótulos na galeria são atualizados.The second and third labels in the gallery are updated.

Exibir as funções disponíveisView the available functions

Essa conexão inclui as seguintes funções:This connection includes the following functions:

Nome da FunçãoFunction Name DescriçãoDescription
MyProfileMyProfile Recupera o perfil do usuário atualRetrieves the profile for the current user
UserProfileUserProfile Recupera um perfil do usuário específicoRetrieves a specific user profile
ManagerManager Recupera o perfil do usuário para o gerente do usuário especificadoRetrieves user profile for the manager of the specified user
DirectReportsDirectReports Retorna os subordinados diretos do usuário especificadoReturns the direct reports for the specified user
SearchUserSearchUser Recupera resultados da pesquisa de perfis de usuárioRetrieves search results of user profiles

MyProfileMyProfile

Obter meu perfil: recupera o perfil do usuário atual.Get my profile: Retrieves the profile for the current user.

Propriedades de entradaInput properties

Nenhuma.None.

Propriedades de saídaOutput properties

Nome da PropriedadeProperty Name TipoType DescriçãoDescription
DepartmentDepartment cadeia de caracteresstring Departamento do usuário.Department of the user.
DisplayNameDisplayName cadeia de caracteresstring Nome de exibição do usuário.Display name of user.
GivenNameGivenName cadeia de caracteresstring Nome fornecido do usuário.Given name of user.
IDId cadeia de caracteresstring ID de usuárioUser id
JobTitleJobTitle cadeia de caracteresstring Cargo do usuário.Job Title of the user.
EmailMail cadeia de caracteresstring ID do email do usuário.Email id of user.
MailNicknameMailNickname cadeia de caracteresstring Apelido do usuário.Nickname of user.
SurnameSurname cadeia de caracteresstring Sobrenome do usuário.Surname of user.
TelephoneNumberTelephoneNumber cadeia de caracteresstring Número de telefone do usuário.Telephone number of user.
UserPrincipalNameUserPrincipalName cadeia de caracteresstring Nome UPN.User Principal Name.
AccountEnabledAccountEnabled boolianoboolean Sinalizador de conta habilitada.Account enabled flag.

UserProfileUserProfile

Obter perfil do usuário: recupera um perfil do usuário específico.Get user profile: Retrieves a specific user profile.

Propriedades de entradaInput properties

NomeName Tipo de DadosData Type ObrigatórioRequired DescriçãoDescription
IDId cadeia de caracteresstring simyes ID de email ou nome UPNUser principal name or email id

Propriedades de saídaOutput properties

Nome da PropriedadeProperty Name TipoType DescriçãoDescription
DepartmentDepartment cadeia de caracteresstring Departamento do usuário.Department of the user.
DisplayNameDisplayName cadeia de caracteresstring Nome de exibição do usuário.Display name of user.
GivenNameGivenName cadeia de caracteresstring Nome fornecido do usuário.Given name of user.
IDId cadeia de caracteresstring ID de usuárioUser id
JobTitleJobTitle cadeia de caracteresstring Cargo do usuário.Job Title of the user.
EmailMail cadeia de caracteresstring ID do email do usuário.Email id of user.
MailNicknameMailNickname cadeia de caracteresstring Apelido do usuário.Nickname of user.
SurnameSurname cadeia de caracteresstring Sobrenome do usuário.Surname of user.
TelephoneNumberTelephoneNumber cadeia de caracteresstring Número de telefone do usuário.Telephone number of user.
UserPrincipalNameUserPrincipalName cadeia de caracteresstring Nome UPN.User Principal Name.
AccountEnabledAccountEnabled boolianoboolean Sinalizador de conta habilitada.Account enabled flag.

GerenteManager

Obter gerente: recupera o perfil do usuário para o gerente do usuário especificadoGet manager: Retrieves user profile for the manager of the specified user

Propriedades de entradaInput properties

NomeName Tipo de DadosData Type ObrigatórioRequired DescriçãoDescription
IDId cadeia de caracteresstring simyes ID de email ou nome UPNUser principal name or email id

Propriedades de saídaOutput properties

Nome da PropriedadeProperty Name TipoType DescriçãoDescription
DepartmentDepartment cadeia de caracteresstring Departamento do usuário.Department of the user.
DisplayNameDisplayName cadeia de caracteresstring Nome de exibição do usuário.Display name of user.
GivenNameGivenName cadeia de caracteresstring Nome fornecido do usuário.Given name of user.
IDId cadeia de caracteresstring ID de usuárioUser id
JobTitleJobTitle cadeia de caracteresstring Cargo do usuário.Job Title of the user.
EmailMail cadeia de caracteresstring ID do email do usuário.Email id of user.
MailNicknameMailNickname cadeia de caracteresstring Apelido do usuário.Nickname of user.
SurnameSurname cadeia de caracteresstring Sobrenome do usuário.Surname of user.
TelephoneNumberTelephoneNumber cadeia de caracteresstring Número de telefone do usuário.Telephone number of user.
UserPrincipalNameUserPrincipalName cadeia de caracteresstring Nome UPN.User Principal Name.
AccountEnabledAccountEnabled boolianoboolean Sinalizador de conta habilitada.Account enabled flag.

DirectReportsDirectReports

Obter subordinados diretos: obter subordinados diretosGet direct reports: Get direct reports

Propriedades de entradaInput properties

NomeName Tipo de DadosData Type ObrigatórioRequired DescriçãoDescription
IDId cadeia de caracteresstring simyes ID de email ou nome UPNUser principal name or email id

Propriedades de saídaOutput properties

Nome da PropriedadeProperty Name TipoType DescriçãoDescription
DepartmentDepartment cadeia de caracteresstring Departamento do usuário.Department of the user.
DisplayNameDisplayName cadeia de caracteresstring Nome de exibição do usuário.Display name of user.
GivenNameGivenName cadeia de caracteresstring Nome fornecido do usuário.Given name of user.
IDId cadeia de caracteresstring ID de usuárioUser id
JobTitleJobTitle cadeia de caracteresstring Cargo do usuário.Job Title of the user.
EmailMail cadeia de caracteresstring ID do email do usuário.Email id of user.
MailNicknameMailNickname cadeia de caracteresstring Apelido do usuário.Nickname of user.
SurnameSurname cadeia de caracteresstring Sobrenome do usuário.Surname of user.
TelephoneNumberTelephoneNumber cadeia de caracteresstring Número de telefone do usuário.Telephone number of user.
UserPrincipalNameUserPrincipalName cadeia de caracteresstring Nome UPN.User Principal Name.
AccountEnabledAccountEnabled boolianoboolean Sinalizador de conta habilitada.Account enabled flag.

SearchUserSearchUser

Pesquisar usuários: recupera resultados da pesquisa de perfis de usuárioSearch for users: Retrieves search results of user profiles

Propriedades de entradaInput properties

NomeName Tipo de DadosData Type ObrigatórioRequired DescriçãoDescription
searchTermsearchTerm cadeia de caracteresstring nãono Cadeia de caracteres de pesquisa.Search string. Aplica-se a: nome de exibição, nome, sobrenome, email, apelido de email e nome UPNApplies to: display name, given name, surname, mail, mail nickname, and user principal name

Propriedades de saídaOutput properties

Nome da PropriedadeProperty Name TipoType DescriçãoDescription
DepartmentDepartment cadeia de caracteresstring Departamento do usuário.Department of the user.
DisplayNameDisplayName cadeia de caracteresstring Nome de exibição do usuário.Display name of user.
GivenNameGivenName cadeia de caracteresstring Nome fornecido do usuário.Given name of user.
IDId cadeia de caracteresstring ID de usuárioUser id
JobTitleJobTitle cadeia de caracteresstring Cargo do usuário.Job Title of the user.
EmailMail cadeia de caracteresstring ID do email do usuário.Email id of user.
MailNicknameMailNickname cadeia de caracteresstring Apelido do usuário.Nickname of user.
SurnameSurname cadeia de caracteresstring Sobrenome do usuário.Surname of user.
TelephoneNumberTelephoneNumber cadeia de caracteresstring Número de telefone do usuário.Telephone number of user.
UserPrincipalNameUserPrincipalName cadeia de caracteresstring Nome UPN.User Principal Name.
AccountEnabledAccountEnabled boolianoboolean Sinalizador de conta habilitada.Account enabled flag.