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. Pode efetuar várias ações, como obter o seu perfil, um perfil de utilizador, um gestor do utilizador ou relatórios diretos.

Pode ver estas informações numa caixa de texto na sua aplicação. Pode apresentar uma função, várias funções ou mesmo combinar funções diferentes. 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.

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.

 

What you need to get started

Adicionar uma ligação

  1. Adicione uma ligação de dados e selecione Utilizadores do Office 365:

    Ligar ao Office 365

  2. Selecione Ligar e se lhe for pedido para iniciar sessão, introduza a sua conta profissional.

A ligação de Utilizadores do Office 365 foi criada e adicionada à sua aplicação. Agora está pronta a ser utilizada.

Utilize a ligação na sua aplicação

Mostra informações sobre o utilizador atual

  1. No menu Inserir, selecione Caixa de texto
  2. Na barra de função, defina a propriedade Texto com qualquer uma das seguintes fórmulas:

    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 caixa de texto mostra as informações que introduziu sobre o utilizador atual.

Mostrar informações sobre outro utilizador

  1. No menu Inserir, selecione Texto e, em seguida, selecione Introdução de texto. Mude o nome para 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. Por exemplo, escreva oSeuNome@aSuaEmpresa.com.

  3. Adicione uma Caixa de texto (Menu Inserir)e defina a propriedade Texto com qualquer uma das seguintes fórmulas:

    • Para mostrar informações sobre outro utilizador:

      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:

      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 caixa de texto mostra as informações que introduziu sobre o utilizador que especificou ou o gestor desse utilizador.

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.

Por exemplo, pode criar automaticamente uma aplicação, adicionar um ecrã que contém um controlo Caixa de texto e definir a propriedade do controlo Texto com esta fórmula:
Office365Users.UserProfile(BrowseGallery1.Selected.CreatedByUser).DisplayName

Se criar um contacto e selecionar esse contacto no ecrã de procura da aplicação, o controlo Caixa de texto irá mostrar o seu nome a apresentar.

Mostrar os relatórios diretos de outro utilizador

  1. Adicione um controlo Introdução de texto (Menu Inserir > Texto) e mude o nome para InfoAbout.

  2. Em InfoAbout, introduza o endereço de e-mail de um utilizador na sua organização. Por exemplo, introduza oNomeDoSeuGestor@aSuaEmpresa.com

  3. Adicione uma galeria Com texto (Menu Inserir > Galeria) e defina a respetiva propriedadeItens com a seguinte fórmula:

    Office365Users.DirectReports(InfoAbout.Text)

    A galeria mostra informações sobre os relatórios diretos do utilizador que introduziu.

    Com a galeria selecionada, o painel do lado direito apresenta opções para essa galeria.

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


    ATENÇÃO A primeira caixa é um controlo de imagem. Se não tiver uma imagem, pode eliminar o controlo de imagem e adicionar uma caixa de texto no seu lugar. Adicionar e configurar os controlos é um bom recurso.

Pesquisar utilizadores

  1. Adicione um controlo Introdução de texto (Menu Inserir > Texto) e mude o nome para SearchTerm. Introduza um nome a procurar. Por exemplo, introduza o seu nome próprio.

  2. Adicione uma galeria Com texto (Menu Inserir > Galeria) e defina a respetiva propriedadeItens com a seguinte fórmula:

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

    A galeria mostra utilizadores cujos nomes contêm o texto de pesquisa que introduziu.

    Com a galeria selecionada, o painel do lado direito apresenta opções para essa galeria.

  3. Na segunda lista, selecione Correio. Na terceira lista, selecione DisplayName.

    A segunda e a terceira caixas de texto na galeria são atualizadas.

Ver as funções disponíveis

Esta ligação inclui as seguintes funções:

Nome da Função Descrição
MyProfile Obtém o perfil do utilizador atual
UserProfile Obtém um perfil de utilizador específico
Gestor Obtém o perfil de utilizador do gestor do utilizador especificado
DirectReports Devolve os relatórios diretos do utilizador especificado
SearchUser Obtém os resultados de pesquisa dos perfis de utilizador

MyProfile

Obter o meu perfil: obtém o perfil do utilizador atual.

Propriedades de entrada

Nenhum.

Propriedades de saída

Nome da Propriedade Tipo Descrição
Departamento cadeia Departamento do utilizador.
DisplayName cadeia Nome a apresentar do utilizador.
GivenName cadeia Nome dado do utilizador.
Id cadeia ID do utilizador
JobTitle cadeia Cargo do utilizador.
Correio cadeia ID do e-mail do utilizador.
MailNickname cadeia Alcunha do utilizador.
Apelido cadeia Apelido do utilizador.
TelephoneNumber cadeia Número de telefone do utilizador.
UserPrincipalName cadeia Nome Principal do Utilizador.
AccountEnabled booleano Sinalizador ativado para conta.

UserProfile

Obter perfil do utilizador: obtém um perfil de utilizador específico.

Propriedades de entrada

Nome Tipo de Dados Necessário Descrição
Id cadeia sim ID do nome ou e-mail principal do utilizador

Propriedades de saída

Nome da Propriedade Tipo Descrição
Departamento cadeia Departamento do utilizador.
DisplayName cadeia Nome a apresentar do utilizador.
GivenName cadeia Nome dado do utilizador.
Id cadeia ID do utilizador
JobTitle cadeia Cargo do utilizador.
Correio cadeia ID do e-mail do utilizador.
MailNickname cadeia Alcunha do utilizador.
Apelido cadeia Apelido do utilizador.
TelephoneNumber cadeia Número de telefone do utilizador.
UserPrincipalName cadeia Nome Principal do Utilizador.
AccountEnabled booleano Sinalizador ativado para conta.

Gestor

Obter gestor: obtém o perfil de utilizador do gestor do utilizador especificado

Propriedades de entrada

Nome Tipo de Dados Necessário Descrição
Id cadeia sim ID do nome ou e-mail principal do utilizador

Propriedades de saída

Nome da Propriedade Tipo Descrição
Departamento cadeia Departamento do utilizador.
DisplayName cadeia Nome a apresentar do utilizador.
GivenName cadeia Nome dado do utilizador.
Id cadeia ID do utilizador
JobTitle cadeia Cargo do utilizador.
Correio cadeia ID do e-mail do utilizador.
MailNickname cadeia Alcunha do utilizador.
Apelido cadeia Apelido do utilizador.
TelephoneNumber cadeia Número de telefone do utilizador.
UserPrincipalName cadeia Nome Principal do Utilizador.
AccountEnabled booleano Sinalizador ativado para conta.

DirectReports

Obter relatórios diretos: obtém relatórios diretos

Propriedades de entrada

Nome Tipo de Dados Necessário Descrição
Id cadeia sim ID do nome ou e-mail principal do utilizador

Propriedades de saída

Nome da Propriedade Tipo Descrição
Departamento cadeia Departamento do utilizador.
DisplayName cadeia Nome a apresentar do utilizador.
GivenName cadeia Nome dado do utilizador.
Id cadeia ID do utilizador
JobTitle cadeia Cargo do utilizador.
Correio cadeia ID do e-mail do utilizador.
MailNickname cadeia Alcunha do utilizador.
Apelido cadeia Apelido do utilizador.
TelephoneNumber cadeia Número de telefone do utilizador.
UserPrincipalName cadeia Nome Principal do Utilizador.
AccountEnabled booleano Sinalizador ativado para conta.

SearchUser

Pesquisar utilizadores: obtém os resultados de pesquisa dos perfis de utilizador

Propriedades de entrada

Nome Tipo de Dados Necessário Descrição
searchTerm cadeia não Cadeia de pesquisa. Aplica-se a: nome a apresentar, nome dado, apelido, correio, alcunha do correio e nome principal do utilizador

Propriedades de saída

Nome da Propriedade Tipo Descrição
Departamento cadeia Departamento do utilizador.
DisplayName cadeia Nome a apresentar do utilizador.
GivenName cadeia Nome dado do utilizador.
Id cadeia ID do utilizador
JobTitle cadeia Cargo do utilizador.
Correio cadeia ID do e-mail do utilizador.
MailNickname cadeia Alcunha do utilizador.
Apelido cadeia Apelido do utilizador.
TelephoneNumber cadeia Número de telefone do utilizador.
UserPrincipalName cadeia Nome Principal do Utilizador.
AccountEnabled booleano Sinalizador ativado para conta.

Ligações úteis