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 uma caixa de texto em seu 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 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.

 

O que você precisa para começar

Adicionar um conexão

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

    Conectar ao Office 365

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

A conexão o 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 Caixa de texto
  2. Na barra de função, defina sua propriedade Text para qualquer uma das fórmulas a seguir:

    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 você inseriu sobre o usuário atual.

Mostrar informações sobre outro usuário

  1. No menu Inserir, selecione Text e, em seguida, selecione Text input. Renomeie-a como InfoAbout:

    Renomear 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 uma Caixa de texto (menu Inserir) defina sua propriedade Text para qualquer uma das fórmulas a seguir:

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

      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:

      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 você inseriu sobre o usuário especificado ou o gerenciador do usuário.

Observação: se você estiver desenvolvendo um aplicativo com base em uma entidade no Common Data Service, você 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 de Caixa de texto e definir a propriedade Text do controle para esta fórmula:
Office365Users.UserProfile(BrowseGallery1.Selected.CreatedByUser).DisplayName

Se você criar um contato e selecioná-lo na tela procurar do aplicativo, o controle Caixa de texto mostrará o seu nome de exibição.

Mostrar os subordinados diretos de outro usuário

  1. Adicione um controle de Entrada de texto (menu Inserir > Text) e renomeie-a 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 para 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 uma caixa de texto em seu lugar. Adicionar e configurar controles é um bom recurso.

Pesquisar usuários

  1. Adicione um controle de Entrada de texto (menu Inserir > Text) e renomeie-a como SearchTerm. Insira um nome pelo qual pesquisar. Por exemplo, digite seu nome.

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

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

    A galeria mostra os usuários cujo nome contém o texto de pesquisa que você inseriu.

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

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

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

Exibir as funções disponíveis

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

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

MyProfile

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

Propriedades de entrada

Nenhuma.

Propriedades de saída

Nome da Propriedade Tipo Descrição
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 de usuário
JobTitle cadeia de caracteres Cargo do usuário.
Email 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.

UserProfile

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

Propriedades de entrada

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

Propriedades de saída

Nome da Propriedade Tipo Descrição
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 de usuário
JobTitle cadeia de caracteres Cargo do usuário.
Email 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.

Gerente

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

Propriedades de entrada

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

Propriedades de saída

Nome da Propriedade Tipo Descrição
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 de usuário
JobTitle cadeia de caracteres Cargo do usuário.
Email 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.

DirectReports

Obter subordinados diretos: obter subordinados diretos

Propriedades de entrada

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

Propriedades de saída

Nome da Propriedade Tipo Descrição
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 de usuário
JobTitle cadeia de caracteres Cargo do usuário.
Email 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.

SearchUser

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

Propriedades de entrada

Nome Tipo de Dados Obrigatório 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
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 de usuário
JobTitle cadeia de caracteres Cargo do usuário.
Email 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.

Links Úteis