Conéctese á conexión de Usuarios de Office 365 desde Power Apps
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
- Acceso a Power Apps
- Engadir a conexión
- Crear unha aplicación a partir dun modelo, datos ou desde cero
Engadir unha conexión
Engada unha conexión de datos e seleccione Usuarios de Office 365:
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
No menú Inserir, seleccione Etiqueta
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
A etiqueta mostra a información que introduciu sobre o usuario actual.
Amosar información sobre outro usuario
No menú Inserir, seleccione Texto e, a seguir, seleccione Entrada de texto. Cámbielle o nome a InfoAbout:
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.
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).BusinessPhonesPara 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á a desenvolver unha aplicación baseada nunha táboa en Microsoft Dataverse, pode especificar un usuario en función do ID no canto 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
Engada un control de Entrada de texto (menú Inserir > Texto) e cambie o nome a InfoAbout.
En InfoAbout, escriba o enderezo de correo electrónico dun usuario na súa organización. Por exemplo, escriba yourManagersName@yourCompany.com
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.
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
Engada un control de Entrada de texto (menú Inserir > Entrada de texto).
Seleccione Inserir > Galería vertical.
Cambie o deseño da galería vertical a Título, subtítulo e corpo.
Seleccione a icona de frecha da primeira frecha dentro da galería e elimínea.
Actualice a fórmula de galería vertical ao seguinte.
Office365Users.SearchUserV2({searchTerm:TextInput1.Text,top:5}).valueNa fórmula anterior, o termo de busca fai referencia ao texto introducido no control de entrada de texto ("TextInput1" neste exemplo); e os resultados da busca están limitados aos 5 primeiros.
Actualice os campos verticais da galería para mostrar DisplayName no título da galería, JobTitle no subtítulo e Departamento no corpo.
Xogue á aplicación e introduza texto dentro da caixa de entrada de texto. A medida que introduce texto, os resultados cambian en función dos cambios na cadea de entrada.
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
- Vexa todas as conexións dispoñibles
- Obteña información sobre como engadir conexións ás súas aplicacións.
Nota
Pode indicarnos as súas preferencias para o idioma da documentación? Realice unha enquisa breve. (teña en conta que esa enquisa está en inglés)
Esta enquisa durará sete minutos aproximadamente. Non se recompilarán datos persoais (declaración de privacidade).
Comentarios
Proximamente: Ao longo de 2024, retiraremos gradualmente GitHub Issues como mecanismo de comentarios sobre o contido e substituirémolo por un novo sistema de comentarios. Para obter máis información, consulte: https://aka.ms/ContentUserFeedback.
Enviar e ver os comentarios