Ligar à ligação dos Utilizadores do Office 365 a partir do PowerAppsConnect to Office 365 Users connection from PowerApps

Utilizadores do Office 365

Os Utilizadores do Office 365 permitem-lhe aceder aos perfis dos utilizadores na sua organização com a sua conta do Office 365.Office 365 Users lets you access user profiles in your organization using your Office 365 account. Pode efetuar várias ações, como obter o seu perfil, um perfil de utilizador, um gestor do utilizador ou relatórios diretos.You can perform various actions such as get your profile, a user's profile, a user's manager or direct reports.

Pode apresentar estas informações numa etiqueta na sua aplicação.You can display this information in a label on your app. Pode apresentar uma função, várias funções ou mesmo combinar funções diferentes.You can display one function, multiple functions, or even combine different functions. Por exemplo, pode criar uma expressão que combina o Nome de Utilizador e o Número de Telefone e, em seguida, apresentar estas informações na sua aplicação.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-lhe como adicionar Utilizadores do Office 365 como uma ligação, adicionar Utilizadores do Office 365 como uma origem de dados para a sua aplicação e utilizar dados de tabela num controlo de 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.

 

What you need to get started

Adicionar uma ligaçãoAdd a connection

  1. Adicione uma ligação de dados e selecione Utilizadores do Office 365:Add a data connection and select Office 365 Users:

    Ligar ao Office 365

  2. Selecione Ligar e se lhe for pedido para iniciar sessão, introduza a sua conta profissional.Select Connect, and if prompted to sign in, enter your work account.

A ligação de Utilizadores do Office 365 foi criada e adicionada à sua aplicação.The Office 365 Users connection has been created and added to your app. Agora está pronta a ser utilizada.Now, it's ready to be used.

Utilize a ligação na sua aplicaçãoUse the connection in your app

Mostra informações sobre o utilizador atualShow information about the current user

  1. No menu Inserir, selecione EtiquetaOn the Insert menu, select Label
  2. Na barra de função, defina a propriedade Texto com qualquer uma das seguintes fórmulas: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

A etiqueta mostra as informações que introduziu sobre o utilizador atual.The label shows the information that you entered about the current user.

Mostrar informações sobre outro utilizadorShow information about another user

  1. No menu Inserir, selecione Texto e, em seguida, selecione Introdução de texto.On the Insert menu, select Text, and then select Text input. Mude o nome para InfoAbout:Rename it InfoAbout:

    Mudar o nome do controlo

  2. Em InfoAbout, escreva ou cole um endereço de e-mail de um utilizador na sua organização.In InfoAbout, type or paste an email address of a user in your organization. Por exemplo, escreva oSeuNome@aSuaEmpresa.com.For example, type in yourName@yourCompany.com.
  3. Adicione uma Etiqueta (Menu Inserir)e defina a propriedade Text como 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 utilizador: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 gestor de outro utilizador: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

A etiqueta mostra as informações que introduziu sobre o utilizador que especificou ou o gestor desse utilizador.The label shows the information that you entered about the user you specified or that user's manager.

Atenção: se estiver a desenvolver uma aplicação com base numa entidade no Common Data Service, pode especificar um utilizador com base no ID, em vez do endereço de e-mail.Note: 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, pode criar automaticamente uma aplicação, adicionar um ecrã que contém um controlo de Etiqueta e definir a propriedade Text do controlo como 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 criar um contacto e selecionar esse contacto no ecrã de procura da aplicação, o controlo de Etiqueta irá mostrar o seu nome a apresentar.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 relatórios diretos de outro utilizadorShow the direct reports of another user

  1. Adicione um controlo Introdução de texto (Menu Inserir > Texto) e mude o nome para InfoAbout.Add a Text input control (Insert menu > Text), and rename it InfoAbout.
  2. Em InfoAbout, introduza o endereço de e-mail de um utilizador na sua organização.In InfoAbout, enter the email address of a user in your organization. Por exemplo, introduza oNomeDoSeuGestor@aSuaEmpresa.comFor example, enter yourManagersName@yourCompany.com
  3. Adicione uma galeria Com texto (Menu Inserir > Galeria) e defina a respetiva propriedadeItens com a seguinte fórmula: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 relatórios diretos do utilizador que introduziu.The gallery shows information about the direct reports of the user you entered.

    Com a galeria selecionada, o painel do lado direito apresenta 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 estes valores.The gallery is updated to show these values.


    ATENÇÃO A primeira caixa é um controlo de imagem.NOTE The first box is actually an image control. Se não tiver uma imagem, pode eliminar o controlo de imagem e adicionar uma etiqueta em vez daquele.If you don't have an image, you can delete the image control, and add a label in its place. Adicionar e configurar os controlos é um bom recurso.Add and configure controls is a good resource.

Pesquisar utilizadoresSearch for users

  1. Adicione um controlo Introdução de texto (Menu Inserir > Texto) e mude o nome para SearchTerm.Add a Text input control (Insert menu > Text), and rename it SearchTerm. Introduza um nome a procurar.Enter a name to search. Por exemplo, introduza o seu nome próprio.For example, enter your first name.
  2. Adicione uma galeria Com texto (Menu Inserir > Galeria) e defina a respetiva propriedadeItens com a seguinte fórmula: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 utilizadores cujos nomes contêm o texto de pesquisa que introduziu.The gallery shows users whose name contains the search text you entered.

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

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

    A segunda e terceira etiquetas na galeria são atualizadas.The second and third labels in the gallery are updated.

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

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

Nome da FunçãoFunction Name DescriçãoDescription
MyProfileMyProfile Obtém o perfil do utilizador atualRetrieves the profile for the current user
UserProfileUserProfile Obtém um perfil de utilizador específicoRetrieves a specific user profile
GestorManager Obtém o perfil de utilizador do gestor do utilizador especificadoRetrieves user profile for the manager of the specified user
DirectReportsDirectReports Devolve os relatórios diretos do utilizador especificadoReturns the direct reports for the specified user
SearchUserSearchUser Obtém os resultados de pesquisa dos perfis de utilizadorRetrieves search results of user profiles

MyProfileMyProfile

Obter o meu perfil: obtém o perfil do utilizador atual.Get my profile: Retrieves the profile for the current user.

Propriedades de entradaInput properties

Nenhum.None.

Propriedades de saídaOutput properties

Nome da PropriedadeProperty Name TipoType DescriçãoDescription
DepartamentoDepartment cadeiastring Departamento do utilizador.Department of the user.
DisplayNameDisplayName cadeiastring Nome a apresentar do utilizador.Display name of user.
GivenNameGivenName cadeiastring Nome dado do utilizador.Given name of user.
IdId cadeiastring ID do utilizadorUser id
JobTitleJobTitle cadeiastring Cargo do utilizador.Job Title of the user.
CorreioMail cadeiastring ID do e-mail do utilizador.Email id of user.
MailNicknameMailNickname cadeiastring Alcunha do utilizador.Nickname of user.
ApelidoSurname cadeiastring Apelido do utilizador.Surname of user.
TelephoneNumberTelephoneNumber cadeiastring Número de telefone do utilizador.Telephone number of user.
UserPrincipalNameUserPrincipalName cadeiastring Nome Principal do Utilizador.User Principal Name.
AccountEnabledAccountEnabled booleanoboolean Sinalizador ativado para conta.Account enabled flag.

UserProfileUserProfile

Obter perfil do utilizador: obtém um perfil de utilizador específico.Get user profile: Retrieves a specific user profile.

Propriedades de entradaInput properties

NomeName Tipo de DadosData Type NecessárioRequired DescriçãoDescription
IdId cadeiastring simyes ID do nome ou e-mail principal do utilizadorUser principal name or email id

Propriedades de saídaOutput properties

Nome da PropriedadeProperty Name TipoType DescriçãoDescription
DepartamentoDepartment cadeiastring Departamento do utilizador.Department of the user.
DisplayNameDisplayName cadeiastring Nome a apresentar do utilizador.Display name of user.
GivenNameGivenName cadeiastring Nome dado do utilizador.Given name of user.
IdId cadeiastring ID do utilizadorUser id
JobTitleJobTitle cadeiastring Cargo do utilizador.Job Title of the user.
CorreioMail cadeiastring ID do e-mail do utilizador.Email id of user.
MailNicknameMailNickname cadeiastring Alcunha do utilizador.Nickname of user.
ApelidoSurname cadeiastring Apelido do utilizador.Surname of user.
TelephoneNumberTelephoneNumber cadeiastring Número de telefone do utilizador.Telephone number of user.
UserPrincipalNameUserPrincipalName cadeiastring Nome Principal do Utilizador.User Principal Name.
AccountEnabledAccountEnabled booleanoboolean Sinalizador ativado para conta.Account enabled flag.

GestorManager

Obter gestor: obtém o perfil de utilizador do gestor do utilizador especificadoGet manager: Retrieves user profile for the manager of the specified user

Propriedades de entradaInput properties

NomeName Tipo de DadosData Type NecessárioRequired DescriçãoDescription
IdId cadeiastring simyes ID do nome ou e-mail principal do utilizadorUser principal name or email id

Propriedades de saídaOutput properties

Nome da PropriedadeProperty Name TipoType DescriçãoDescription
DepartamentoDepartment cadeiastring Departamento do utilizador.Department of the user.
DisplayNameDisplayName cadeiastring Nome a apresentar do utilizador.Display name of user.
GivenNameGivenName cadeiastring Nome dado do utilizador.Given name of user.
IdId cadeiastring ID do utilizadorUser id
JobTitleJobTitle cadeiastring Cargo do utilizador.Job Title of the user.
CorreioMail cadeiastring ID do e-mail do utilizador.Email id of user.
MailNicknameMailNickname cadeiastring Alcunha do utilizador.Nickname of user.
ApelidoSurname cadeiastring Apelido do utilizador.Surname of user.
TelephoneNumberTelephoneNumber cadeiastring Número de telefone do utilizador.Telephone number of user.
UserPrincipalNameUserPrincipalName cadeiastring Nome Principal do Utilizador.User Principal Name.
AccountEnabledAccountEnabled booleanoboolean Sinalizador ativado para conta.Account enabled flag.

DirectReportsDirectReports

Obter relatórios diretos: obtém relatórios diretosGet direct reports: Get direct reports

Propriedades de entradaInput properties

NomeName Tipo de DadosData Type NecessárioRequired DescriçãoDescription
IdId cadeiastring simyes ID do nome ou e-mail principal do utilizadorUser principal name or email id

Propriedades de saídaOutput properties

Nome da PropriedadeProperty Name TipoType DescriçãoDescription
DepartamentoDepartment cadeiastring Departamento do utilizador.Department of the user.
DisplayNameDisplayName cadeiastring Nome a apresentar do utilizador.Display name of user.
GivenNameGivenName cadeiastring Nome dado do utilizador.Given name of user.
IdId cadeiastring ID do utilizadorUser id
JobTitleJobTitle cadeiastring Cargo do utilizador.Job Title of the user.
CorreioMail cadeiastring ID do e-mail do utilizador.Email id of user.
MailNicknameMailNickname cadeiastring Alcunha do utilizador.Nickname of user.
ApelidoSurname cadeiastring Apelido do utilizador.Surname of user.
TelephoneNumberTelephoneNumber cadeiastring Número de telefone do utilizador.Telephone number of user.
UserPrincipalNameUserPrincipalName cadeiastring Nome Principal do Utilizador.User Principal Name.
AccountEnabledAccountEnabled booleanoboolean Sinalizador ativado para conta.Account enabled flag.

SearchUserSearchUser

Pesquisar utilizadores: obtém os resultados de pesquisa dos perfis de utilizadorSearch for users: Retrieves search results of user profiles

Propriedades de entradaInput properties

NomeName Tipo de DadosData Type NecessárioRequired DescriçãoDescription
searchTermsearchTerm cadeiastring nãono Cadeia de pesquisa.Search string. Aplica-se a: nome a apresentar, nome dado, apelido, correio, alcunha do correio e nome principal do utilizadorApplies 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
DepartamentoDepartment cadeiastring Departamento do utilizador.Department of the user.
DisplayNameDisplayName cadeiastring Nome a apresentar do utilizador.Display name of user.
GivenNameGivenName cadeiastring Nome dado do utilizador.Given name of user.
IdId cadeiastring ID do utilizadorUser id
JobTitleJobTitle cadeiastring Cargo do utilizador.Job Title of the user.
CorreioMail cadeiastring ID do e-mail do utilizador.Email id of user.
MailNicknameMailNickname cadeiastring Alcunha do utilizador.Nickname of user.
ApelidoSurname cadeiastring Apelido do utilizador.Surname of user.
TelephoneNumberTelephoneNumber cadeiastring Número de telefone do utilizador.Telephone number of user.
UserPrincipalNameUserPrincipalName cadeiastring Nome Principal do Utilizador.User Principal Name.
AccountEnabledAccountEnabled booleanoboolean Sinalizador ativado para conta.Account enabled flag.