Conéctese á conexión de Usuarios de Office 365 desde Power Apps

Usuarios de Office 365

Usuarios de Office 365 permítelle acceder aos perfís de usuario da súa organización mediante a súa conta de Office 365. Pode realizar varias accións como obter o seu perfil, o perfil dun usuario, o xestor dun usuario ou informes directos.

Pode amosar esta información nunha etiqueta da súa aplicación. Podes amosar unha función, varias funcións ou incluso combinar funcións diferentes. Por exemplo, pode crear unha expresión que combina o nome de usuario e o número de teléfono e, a continuación, mostrar esta información na súa aplicación.

Este artigo amosa como engadir Usuarios de Office 365 como conexión, engadir Usuarios de Office 365 como orixe de datos para a súa aplicación e usar datos de táboas nun control de galería.

Requisitos previos

Engadir unha conexión

  1. Engada unha conexión de datos e seleccione Usuarios de Office 365:

    Conectar con Office 365

  2. Seleccione Conectar e, se se lle solicita iniciar sesión, introduza a súa conta de traballo.

Creouse a conexión de Usuarios de Office 365 e engadiuse á súa aplicación. Agora xa está listo para ser empregado.

Usar a conexión na súa aplicación

Amosar información sobre o usuario actual

  1. No menú Inserir, seleccione Etiqueta

  2. Na barra de funcións, estableza a súa propiedade Text en calquera das seguintes fórmulas:

    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
    Office365Users.MyProfile().BusinessPhones

A etiqueta mostra a información que introduciu sobre o usuario actual.

Amosar información sobre outro usuario

  1. No menú Inserir, seleccione Texto e, a seguir, seleccione Entrada de texto. Cámbielle o nome a InfoAbout:

    Cambiar o nome do control

  2. En InfoAbout, escriba ou pegue un enderezo de correo electrónico dun usuario na súa organización. Por exemplo, escriba oseuNome@asúaEmpresa.com.

  3. Engada unha Etiqueta (menú Inserir) e estableza a súa propiedade Text en calquera das fórmulas seguintes:

    • Para amosar información sobre outro usuario:

      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).BusinessPhones

    • Para amosar información sobre o xestor doutro usuario:

      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

A etiqueta mostra a información que introduciu sobre o usuario que especificou ou o xestor dese usuario.

Nota

Se estás a desenvolver unha aplicación baseada nunha entidade en Common Data Service, pode especificar un usuario baseado nun ID en lugar do enderezo de correo electrónico.

Por exemplo, pode crear unha aplicación automaticamente, engadir unha pantalla que conteña un control de Etiqueta e establecer a propiedade Text do control nesta fórmula:
Office365Users.UserProfile(BrowseGallery1.Selected.CreatedByUser).DisplayName

Se crea un contacto e selecciona ese contacto na pantalla de exploración da aplicación, o control Etiqueta mostrará o seu nome de pantalla.

Amosar os empregados directos doutro usuario

  1. Engada un control de Entrada de texto (menú Inserir > Texto) e cambie o nome a InfoAbout.

  2. En InfoAbout, escriba o enderezo de correo electrónico dun usuario na súa organización. Por exemplo, escriba yourManagersName@yourCompany.com

  3. Engada unha galería Con texto (menú Inserir > Galería) e estableza a súa propiedade Items na seguinte fórmula:

    Office365Users.DirectReports(InfoAbout.Text)

    A galería mostra información sobre os empregados directos do usuario que inseriu.

    Coa galería seleccionada, o panel dereito mostra as opcións desa galería.

  4. Na segunda lista, seleccione JobTitle. Na terceira lista, seleccione DisplayName. A galería actualizarase para mostrar estes valores.

Nota

A primeira caixa é realmente un control de imaxe. Se non ten unha imaxe, pode eliminar o control da imaxe e engadir unha etiqueta no seu lugar. Engadir e configurar os controis é un bo recurso.

Buscar usuarios

  1. Engada un control de Entrada de texto (menú Inserir > Texto) e cambie o nome a SearchTerm. Insira un nome para buscar. Por exemplo, introduza o seu nome.

  2. Engada unha galería Con texto (menú Inserir > Galería) e estableza a súa propiedade Items na seguinte fórmula:

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

    A galería mostra aos usuarios cuxo nome contén o texto de busca que introduciu.

    Coa galería seleccionada, o panel dereito mostra as opcións desa galería.

  3. Na segunda lista, seleccione Correo. Na terceira lista, seleccione DisplayName.

    Actualizarase a segunda e a terceira etiqueta da galería.

Ver as funcións dispoñibles

Esta conexión inclúe as seguintes funcións:

Nome da función Descripción
DirectReports Devolve os empregados directos do usuario especificado.
Xestor Recupera o perfil de usuario do director do usuario especificado.
OmeuPerfil Recupera o perfil do usuario actual.
SearchUser Recupera os resultados da busca dos perfís de usuario.
UserProfile Recupera un perfil de usuario específico.

OmeuPerfil

Obter o meu perfil: recupera o perfil do usuario actual.

Propiedades de entrada

Ningún

Propiedades de saída

Nome da propiedade Tipo Descripción
Cidade string Cidade do usuario.
CompanyName string Empresa do usuario.
País string País do usuario.
Departamento string Departamento do usuario.
DisplayName string Nome para mostrar do usuario.
GivenName string Nome propio do usuario.
Identificador string Identificador de usuario.
JobTitle string Cargo do usuario.
Correo string Identificador de correo electrónico do usuario.
MailNickname string Alcume do usuario.
mobilePhone string Teléfono móbil do usuario.
OfficeLocation string Localización da oficina do usuario.
PostalCode string Código postal do usuario.
Apelido string Apelido do usuario.
TelephoneNumber string Número de teléfono do usuario.
UserPrincipalName string Nome principal do usuario.
AccountEnabled boolean Indicador activado para a conta.
BusinessPhones string Números de teléfono da empresa do usuario.

UserProfile

Obter perfil do usuario: recupera un perfil de usuario específico.

Propiedades de entrada

Nome Tipo de datos Requirido Descripción
Identificador string si Nome principal do usuario ou ID de correo electrónico.

Propiedades de saída

Nome da propiedade Tipo Descripción
Cidade string Cidade do usuario.
CompanyName string Empresa do usuario.
País string País do usuario.
Departamento string Departamento do usuario.
DisplayName string Nome para mostrar do usuario.
GivenName string Nome propio do usuario.
Identificador string Identificador de usuario.
JobTitle string Cargo do usuario.
Correo string Identificador de correo electrónico do usuario.
MailNickname string Alcume do usuario.
Apelido string Apelido do usuario.
TelephoneNumber string Número de teléfono do usuario.
UserPrincipalName string Nome principal do usuario.
AccountEnabled boolean Indicador activado para a conta.
BusinessPhones string Números de teléfono da empresa do usuario.

Xestor

Obter xestor: recupera o perfil de usuario do director do usuario especificado.

Propiedades de entrada

Nome Tipo de datos Requirido Descripción
Identificador string si Nome principal do usuario ou ID de correo electrónico.

Propiedades de saída

Nome da propiedade Tipo Descripción
Cidade string Cidade do usuario.
CompanyName string Empresa do usuario.
País string País do usuario.
Departamento string Departamento do usuario.
DisplayName string Nome para mostrar do usuario.
GivenName string Nome propio do usuario.
Identificador string Identificador de usuario.
JobTitle string Cargo do usuario.
Correo string Identificador de correo electrónico do usuario.
MailNickname string Alcume do usuario.
mobilePhone string Teléfono móbil do usuario.
OfficeLocation string Localización da oficina do usuario.
PostalCode string Código postal do usuario.
Apelido string Apelido do usuario.
TelephoneNumber string Número de teléfono do usuario.
UserPrincipalName string Nome principal do usuario.
AccountEnabled boolean Indicador activado para a conta.
BusinessPhones string Números de teléfono da empresa do usuario.

DirectReports

Obter empregados directos: obter empregados directos.

Propiedades de entrada

Nome Tipo de datos Requirido Descripción
Identificador string si Nome principal do usuario ou ID de correo electrónico.

Propiedades de saída

Nome da propiedade Tipo Descripción
Cidade string Cidade do usuario.
CompanyName string Empresa do usuario.
País string País do usuario.
Departamento string Departamento do usuario.
DisplayName string Nome para mostrar do usuario.
GivenName string Nome propio do usuario.
Identificador string Identificador de usuario.
JobTitle string Cargo do usuario.
Correo string Identificador de correo electrónico do usuario.
MailNickname string Alcume do usuario.
mobilePhone string Teléfono móbil do usuario.
OfficeLocation string Localización da oficina do usuario.
PostalCode string Código postal do usuario.
Apelido string Apelido do usuario.
TelephoneNumber string Número de teléfono do usuario.
UserPrincipalName string Nome principal do usuario.
AccountEnabled boolean Indicador activado para a conta.
BusinessPhones string Números de teléfono da empresa do usuario.

SearchUser

Buscar usuarios: recupera os resultados da busca dos perfís de usuario.

Propiedades de entrada

Nome Tipo de datos Requirido Descripción
searchTerm string non Cadea de busca. Aplícase a: nome de visualización, nome propio, apelidos, correo, alcume de correo e nome principal de usuario.

Propiedades de saída

Nome da propiedade Tipo Descripción
Cidade string Cidade do usuario.
CompanyName string Empresa do usuario.
País string País do usuario.
Departamento string Departamento do usuario.
DisplayName string Nome para mostrar do usuario.
GivenName string Nome propio do usuario.
Identificador string Identificador de usuario.
JobTitle string Cargo do usuario.
Correo string Identificador de correo electrónico do usuario.
MailNickname string Alcume do usuario.
mobilePhone string Teléfono móbil do usuario.
OfficeLocation string Localización da oficina do usuario.
PostalCode string Código postal do usuario.
Apelido string Apelido do usuario.
TelephoneNumber string Número de teléfono do usuario.
UserPrincipalName string Nome principal do usuario.
AccountEnabled boolean Indicador activado para a conta.
BusinessPhones cadea Números de teléfono da empresa do usuario.

Consulte tamén