Conectarse a la conexión de los usuarios de Office 365 desde PowerAppsConnect to Office 365 Users connection from PowerApps

Usuarios de Office 365

Usuarios de Office 365 le permite acceder a los perfiles de usuario de su organización mediante su cuenta de Office 365.Office 365 Users lets you access user profiles in your organization using your Office 365 account. Puede realizar diversas acciones, como obtener su perfil, el perfil de un usuario o el administrador y los subordinados directos de un usuario.You can perform various actions such as get your profile, a user's profile, a user's manager or direct reports.

Puede mostrar esta información en una etiqueta en la aplicación.You can display this information in a label on your app. Puede mostrar una función, varias funciones o incluso combinar funciones diferentes.You can display one function, multiple functions, or even combine different functions. Por ejemplo, puede crear una expresión que combine el nombre de usuario y el número de teléfono y luego mostrar esta información en la aplicación.For example, you can create an expression that combines the User Name and Phone Number, and then display this information in your app.

En este tema se muestra cómo agregar Usuarios de Office 365 como una conexión y como un origen de datos a su aplicación y cómo utilizar datos de tabla en un control de la galería.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.

Requisitos previosPrerequisites

Agregar una conexiónAdd a connection

  1. Agregue una conexión de datos y seleccione Usuarios de Office 365:Add a data connection and select Office 365 Users:

    Conexión a Office 365

  2. Seleccione Connect (Conectar) y, si se pide que inicie sesión, escriba su cuenta profesional.Select Connect, and if prompted to sign in, enter your work account.

La conexión de Usuarios de Office 365 se ha creado y agregado a la aplicación.The Office 365 Users connection has been created and added to your app. Ahora, está lista para utilizarse.Now, it's ready to be used.

Uso de la conexión en la aplicaciónUse the connection in your app

Mostrar información sobre el usuario actualShow information about the current user

  1. En el menú Insertar, seleccione Etiqueta.On the Insert menu, select Label
  2. En la barra de funciones, establezca su propiedad Text en cualquiera de las siguientes 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

La etiqueta muestra la información que ha especificado sobre el usuario actual.The label shows the information that you entered about the current user.

Mostrar información sobre otro usuarioShow information about another user

  1. En el menú Insert (Insertar), seleccione Text (Texto) y luego seleccione Text input (Entrada de texto).On the Insert menu, select Text, and then select Text input. Cambie su nombre por InfoAbout:Rename it InfoAbout:

    Cambiar el nombre del control

  2. En InfoAbout, escriba o pegue una dirección de correo electrónico de un usuario de su organización.In InfoAbout, type or paste an email address of a user in your organization. Por ejemplo, escriba yourName@yourCompany.com.For example, type in yourName@yourCompany.com.
  3. Agregue una etiqueta (menú Insertar) y establezca su propiedad Texto en alguna de las siguientes fórmulas:Add a Label (Insert menu), and set its Text property to any of the following formulas:

    • Para mostrar información sobre otro usuario: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 información sobre el administrador de otro usuario: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

La etiqueta muestra la información que ha escrito sobre el usuario especificado o sobre el administrador de ese usuario.The label shows the information that you entered about the user you specified or that user's manager.

Nota

Si va a desarrollar una aplicación basada en una entidad en Common Data Service, puede especificar un usuario basado en el id. en lugar de la dirección de correo electrónico.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 ejemplo, puede crear una aplicación automáticamente, agregar una pantalla que contenga un control Etiqueta y establecer la propiedad Texto del control en 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

Si crea un contacto y lo selecciona en la pantalla de exploración de la aplicación, el control Etiqueta mostrará su nombre para mostrar.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 los subordinados directos de otro usuarioShow the direct reports of another user

  1. Agregue un control Entrada de texto (menú Insert [Insertar] > Text [Texto]) y cambie su nombre por InfoAbout.Add a Text input control (Insert menu > Text), and rename it InfoAbout.
  2. En InfoAbout, escriba la dirección de correo electrónico de un usuario de su organización.In InfoAbout, enter the email address of a user in your organization. Por ejemplo, escriba yourManagersName@yourCompany.com.For example, enter yourManagersName@yourCompany.com
  3. Agregue una galería With text (Con texto) (menú Insert [Insertar] > Gallery [Galería]) y establezca su propiedad Items en la siguiente fórmula:Add a With text gallery (Insert menu > Gallery), and set its Items property to the following formula:

    Office365Users.DirectReports(InfoAbout.Text)

    La galería muestra información sobre los subordinados directos del usuario especificado.The gallery shows information about the direct reports of the user you entered.

    Con la galería seleccionada, el panel derecho muestra opciones para esa galería.With the gallery selected, the right-hand pane shows options for that gallery.

  4. En la segunda lista, seleccione JobTitle.In the second list, select JobTitle. En la tercera lista, seleccione DisplayName.In the third list, select DisplayName. La galería se actualiza para mostrar estos valores.The gallery is updated to show these values.

Nota

El primer cuadro es en realidad un control de imagen.The first box is actually an image control. Si no tiene ninguna imagen, puede eliminar el control de imagen y agregar una etiqueta en su lugar.If you don't have an image, you can delete the image control, and add a label in its place. Agregar y configurar controles es un buen recurso.Add and configure controls is a good resource.

Búsqueda de usuariosSearch for users

  1. Agregue un control Entrada de texto (menú Insert [Insertar] > Text [Texto]) y cambie su nombre por SearchTerm.Add a Text input control (Insert menu > Text), and rename it SearchTerm. Escriba un nombre para buscar.Enter a name to search. Por ejemplo, escriba su nombre.For example, enter your first name.
  2. Agregue una galería With text (Con texto) (menú Insert [Insertar] > Gallery [Galería]) y establezca su propiedad Items en la siguiente fórmula:Add a With text gallery (Insert menu > Gallery), and set its Items property to the following formula:

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

    La galería muestra los usuarios cuyo nombre contiene el texto de búsqueda que ha escrito.The gallery shows users whose name contains the search text you entered.

    Con la galería seleccionada, el panel derecho muestra opciones para esa galería.With the gallery selected, the right-hand pane shows options for that gallery.

  3. En la segunda lista, seleccione Mail.In the second list, select Mail. En la tercera lista, seleccione DisplayName.In the third list, select DisplayName.

    La segunda y tercera etiqueta de la galería se actualizan.The second and third labels in the gallery are updated.

Visualización de las funciones disponiblesView the available functions

Esta conexión incluye las siguientes funciones:This connection includes the following functions:

Nombre de la funciónFunction Name DescripciónDescription
MyProfileMyProfile Recupera el perfil del usuario actual.Retrieves the profile for the current user
UserProfileUserProfile Recupera un perfil de usuario específico.Retrieves a specific user profile
ManagerManager Recupera el perfil de usuario del administrador del usuario especificado.Retrieves user profile for the manager of the specified user
DirectReportsDirectReports Devuelve los subordinados directos del usuario especificado.Returns the direct reports for the specified user
SearchUserSearchUser Recupera los resultados de búsqueda de los perfiles de usuario.Retrieves search results of user profiles

MyProfileMyProfile

Obtener mi perfil: recupera el perfil del usuario actual.Get my profile: Retrieves the profile for the current user.

Propiedades de entradaInput properties

NingunaNone.

Propiedades de salidaOutput properties

Nombre de la propiedadProperty Name TipoType DescripciónDescription
DepartamentoDepartment stringstring Departamento del usuario.Department of the user.
DisplayNameDisplayName stringstring Nombre para mostrar del usuario.Display name of user.
GivenNameGivenName stringstring Nombre dado del usuario.Given name of user.
IdentificadorId stringstring Id. de usuarioUser id
JobTitleJobTitle stringstring Puesto del usuario.Job Title of the user.
CorreoMail stringstring Id. de correo electrónico del usuario.Email id of user.
MailNicknameMailNickname stringstring Alias del usuario.Nickname of user.
ApellidoSurname stringstring Apellido del usuario.Surname of user.
TelephoneNumberTelephoneNumber stringstring Número de teléfono del usuario.Telephone number of user.
UserPrincipalNameUserPrincipalName stringstring Nombre principal de usuario.User Principal Name.
AccountEnabledAccountEnabled booleanboolean Marca de cuenta habilitada.Account enabled flag.

UserProfileUserProfile

Obtener perfil de usuario: recupera un perfil de usuario específico.Get user profile: Retrieves a specific user profile.

Propiedades de entradaInput properties

NombreName Tipo de datosData Type RequeridoRequired DescripciónDescription
IdentificadorId stringstring yesyes Nombre principal de usuario o id. de correo electrónico.User principal name or email id

Propiedades de salidaOutput properties

Nombre de la propiedadProperty Name TipoType DescripciónDescription
DepartamentoDepartment stringstring Departamento del usuario.Department of the user.
DisplayNameDisplayName stringstring Nombre para mostrar del usuario.Display name of user.
GivenNameGivenName stringstring Nombre dado del usuario.Given name of user.
IdentificadorId stringstring Id. de usuarioUser id
JobTitleJobTitle stringstring Puesto del usuario.Job Title of the user.
CorreoMail stringstring Id. de correo electrónico del usuario.Email id of user.
MailNicknameMailNickname stringstring Alias del usuario.Nickname of user.
ApellidoSurname stringstring Apellido del usuario.Surname of user.
TelephoneNumberTelephoneNumber stringstring Número de teléfono del usuario.Telephone number of user.
UserPrincipalNameUserPrincipalName stringstring Nombre principal de usuario.User Principal Name.
AccountEnabledAccountEnabled booleanboolean Marca de cuenta habilitada.Account enabled flag.

ManagerManager

Obtener administrador: recupera el perfil de usuario del administrador del usuario especificado.Get manager: Retrieves user profile for the manager of the specified user

Propiedades de entradaInput properties

NombreName Tipo de datosData Type RequeridoRequired DescripciónDescription
IdentificadorId stringstring yesyes Nombre principal de usuario o id. de correo electrónico.User principal name or email id

Propiedades de salidaOutput properties

Nombre de la propiedadProperty Name TipoType DescripciónDescription
DepartamentoDepartment stringstring Departamento del usuario.Department of the user.
DisplayNameDisplayName stringstring Nombre para mostrar del usuario.Display name of user.
GivenNameGivenName stringstring Nombre dado del usuario.Given name of user.
IdentificadorId stringstring Id. de usuarioUser id
JobTitleJobTitle stringstring Puesto del usuario.Job Title of the user.
CorreoMail stringstring Id. de correo electrónico del usuario.Email id of user.
MailNicknameMailNickname stringstring Alias del usuario.Nickname of user.
ApellidoSurname stringstring Apellido del usuario.Surname of user.
TelephoneNumberTelephoneNumber stringstring Número de teléfono del usuario.Telephone number of user.
UserPrincipalNameUserPrincipalName stringstring Nombre principal de usuario.User Principal Name.
AccountEnabledAccountEnabled booleanboolean Marca de cuenta habilitada.Account enabled flag.

DirectReportsDirectReports

Obtener subordinados directos: obtiene los subordinados directos.Get direct reports: Get direct reports

Propiedades de entradaInput properties

NombreName Tipo de datosData Type RequeridoRequired DescripciónDescription
IdentificadorId stringstring yesyes Nombre principal de usuario o id. de correo electrónico.User principal name or email id

Propiedades de salidaOutput properties

Nombre de la propiedadProperty Name TipoType DescripciónDescription
DepartamentoDepartment stringstring Departamento del usuario.Department of the user.
DisplayNameDisplayName stringstring Nombre para mostrar del usuario.Display name of user.
GivenNameGivenName stringstring Nombre dado del usuario.Given name of user.
IdentificadorId stringstring Id. de usuarioUser id
JobTitleJobTitle stringstring Puesto del usuario.Job Title of the user.
CorreoMail stringstring Id. de correo electrónico del usuario.Email id of user.
MailNicknameMailNickname stringstring Alias del usuario.Nickname of user.
ApellidoSurname stringstring Apellido del usuario.Surname of user.
TelephoneNumberTelephoneNumber stringstring Número de teléfono del usuario.Telephone number of user.
UserPrincipalNameUserPrincipalName stringstring Nombre principal de usuario.User Principal Name.
AccountEnabledAccountEnabled booleanboolean Marca de cuenta habilitada.Account enabled flag.

SearchUserSearchUser

Buscar usuarios: recupera los resultados de búsqueda de los perfiles de usuario.Search for users: Retrieves search results of user profiles

Propiedades de entradaInput properties

NombreName Tipo de datosData Type RequeridoRequired DescripciónDescription
searchTermsearchTerm stringstring nono Cadena de búsqueda.Search string. Se aplica a: nombre para mostrar, nombre dado, apellido, correo electrónico, alias de correo electrónico y nombre principal de usuarioApplies to: display name, given name, surname, mail, mail nickname, and user principal name

Propiedades de salidaOutput properties

Nombre de la propiedadProperty Name TipoType DescripciónDescription
DepartamentoDepartment stringstring Departamento del usuario.Department of the user.
DisplayNameDisplayName stringstring Nombre para mostrar del usuario.Display name of user.
GivenNameGivenName stringstring Nombre dado del usuario.Given name of user.
IdentificadorId stringstring Id. de usuarioUser id
JobTitleJobTitle stringstring Puesto del usuario.Job Title of the user.
CorreoMail stringstring Id. de correo electrónico del usuario.Email id of user.
MailNicknameMailNickname stringstring Alias del usuario.Nickname of user.
ApellidoSurname stringstring Apellido del usuario.Surname of user.
TelephoneNumberTelephoneNumber stringstring Número de teléfono del usuario.Telephone number of user.
UserPrincipalNameUserPrincipalName stringstring Nombre principal de usuario.User Principal Name.
AccountEnabledAccountEnabled booleanboolean Marca de cuenta habilitada.Account enabled flag.