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. Puede realizar diversas acciones, como obtener su perfil, el perfil de un usuario o el administrador y los subordinados directos de un usuario.

Puede mostrar esta información en un cuadro de texto en la aplicación. Puede mostrar una función, varias funciones o incluso combinar funciones diferentes. 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.

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.

 

Lo que necesita para empezar

Agregar una conexión

  1. Agregue una conexión de datos y seleccione Usuarios de Office 365:

    Conexión a Office 365

  2. Seleccione Connect (Conectar) y, si se pide que inicie sesión, escriba su cuenta profesional.

La conexión de Usuarios de Office 365 se ha creado y agregado a la aplicación. Ahora, está lista para utilizarse.

Uso de la conexión en la aplicación

Mostrar información sobre el usuario actual

  1. En el menú Insert (Insertar), seleccione Text box (Cuadro de texto).
  2. En la barra de funciones, establezca su propiedad Text en cualquiera de las siguientes 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

El cuadro de texto muestra la información que ha especificado sobre el usuario actual.

Mostrar información sobre otro usuario

  1. En el menú Insert (Insertar), seleccione Text (Texto) y luego seleccione Text input (Entrada de texto). Cambie su nombre por 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. Por ejemplo, escriba yourName@yourCompany.com.

  3. Agregue un cuadro de texto (menú Insert [Insertar]) y establezca su propiedad Text en alguna de las siguientes fórmulas:

    • Para mostrar información sobre otro usuario:

      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:

      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

El cuadro de texto muestra la información que ha escrito sobre el usuario especificado o sobre el administrador de ese usuario.

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.

Por ejemplo, puede crear una aplicación automáticamente, agregar una pantalla que contenga un control Cuadro de texto y establecer la propiedad Text del control en esta fórmula:
Office365Users.UserProfile(BrowseGallery1.Selected.CreatedByUser).DisplayName

Si crea un contacto y selecciona dicho contacto en la pantalla de exploración de la aplicación, el control Cuadro de texto mostrará el nombre para mostrar.

Mostrar los subordinados directos de otro usuario

  1. Agregue un control Entrada de texto (menú Insert [Insertar] > Text [Texto]) y cambie su nombre por InfoAbout.

  2. En InfoAbout, escriba la dirección de correo electrónico de un usuario de su organización. Por ejemplo, escriba 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:

    Office365Users.DirectReports(InfoAbout.Text)

    La galería muestra información sobre los subordinados directos del usuario especificado.

    Con la galería seleccionada, el panel derecho muestra opciones para esa galería.

  4. En la segunda lista, seleccione JobTitle. En la tercera lista, seleccione DisplayName. La galería se actualiza para mostrar estos valores.


    NOTA El primer cuadro es en realidad un control de imagen. Si no tiene una imagen, puede eliminar el control de imagen y agregar un cuadro de texto en su lugar. Agregar y configurar controles es un buen recurso.

Búsqueda de usuarios

  1. Agregue un control Entrada de texto (menú Insert [Insertar] > Text [Texto]) y cambie su nombre por SearchTerm. Escriba un nombre para buscar. Por ejemplo, escriba su nombre.

  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:

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

    La galería muestra los usuarios cuyo nombre contiene el texto de búsqueda que ha escrito.

    Con la galería seleccionada, el panel derecho muestra opciones para esa galería.

  3. En la segunda lista, seleccione Mail. En la tercera lista, seleccione DisplayName.

    Los cuadros de texto segundo y tercero de la galería se actualizan.

Visualización de las funciones disponibles

Esta conexión incluye las siguientes funciones:

Nombre de la función Descripción
MyProfile Recupera el perfil del usuario actual.
UserProfile Recupera un perfil de usuario específico.
Manager Recupera el perfil de usuario del administrador del usuario especificado.
DirectReports Devuelve los subordinados directos del usuario especificado.
SearchUser Recupera los resultados de búsqueda de los perfiles de usuario.

MyProfile

Obtener mi perfil: recupera el perfil del usuario actual.

Propiedades de entrada

Ninguna

Propiedades de salida

Nombre de la propiedad Tipo Descripción
Departamento string Departamento del usuario.
DisplayName string Nombre para mostrar del usuario.
GivenName string Nombre dado del usuario.
Identificador string Id. de usuario
JobTitle string Puesto del usuario.
Correo string Id. de correo electrónico del usuario.
MailNickname string Alias del usuario.
Apellido string Apellido del usuario.
TelephoneNumber string Número de teléfono del usuario.
UserPrincipalName string Nombre principal de usuario.
AccountEnabled boolean Marca de cuenta habilitada.

UserProfile

Obtener perfil de usuario: recupera un perfil de usuario específico.

Propiedades de entrada

Nombre Tipo de datos Requerido Descripción
Identificador string yes Nombre principal de usuario o id. de correo electrónico.

Propiedades de salida

Nombre de la propiedad Tipo Descripción
Departamento string Departamento del usuario.
DisplayName string Nombre para mostrar del usuario.
GivenName string Nombre dado del usuario.
Identificador string Id. de usuario
JobTitle string Puesto del usuario.
Correo string Id. de correo electrónico del usuario.
MailNickname string Alias del usuario.
Apellido string Apellido del usuario.
TelephoneNumber string Número de teléfono del usuario.
UserPrincipalName string Nombre principal de usuario.
AccountEnabled boolean Marca de cuenta habilitada.

Manager

Obtener administrador: recupera el perfil de usuario del administrador del usuario especificado.

Propiedades de entrada

Nombre Tipo de datos Requerido Descripción
Identificador string yes Nombre principal de usuario o id. de correo electrónico.

Propiedades de salida

Nombre de la propiedad Tipo Descripción
Departamento string Departamento del usuario.
DisplayName string Nombre para mostrar del usuario.
GivenName string Nombre dado del usuario.
Identificador string Id. de usuario
JobTitle string Puesto del usuario.
Correo string Id. de correo electrónico del usuario.
MailNickname string Alias del usuario.
Apellido string Apellido del usuario.
TelephoneNumber string Número de teléfono del usuario.
UserPrincipalName string Nombre principal de usuario.
AccountEnabled boolean Marca de cuenta habilitada.

DirectReports

Obtener subordinados directos: obtiene los subordinados directos.

Propiedades de entrada

Nombre Tipo de datos Requerido Descripción
Identificador string yes Nombre principal de usuario o id. de correo electrónico.

Propiedades de salida

Nombre de la propiedad Tipo Descripción
Departamento string Departamento del usuario.
DisplayName string Nombre para mostrar del usuario.
GivenName string Nombre dado del usuario.
Identificador string Id. de usuario
JobTitle string Puesto del usuario.
Correo string Id. de correo electrónico del usuario.
MailNickname string Alias del usuario.
Apellido string Apellido del usuario.
TelephoneNumber string Número de teléfono del usuario.
UserPrincipalName string Nombre principal de usuario.
AccountEnabled boolean Marca de cuenta habilitada.

SearchUser

Buscar usuarios: recupera los resultados de búsqueda de los perfiles de usuario.

Propiedades de entrada

Nombre Tipo de datos Requerido Descripción
searchTerm string no Cadena de búsqueda. Se aplica a: nombre para mostrar, nombre dado, apellido, correo electrónico, alias de correo electrónico y nombre principal de usuario

Propiedades de salida

Nombre de la propiedad Tipo Descripción
Departamento string Departamento del usuario.
DisplayName string Nombre para mostrar del usuario.
GivenName string Nombre dado del usuario.
Identificador string Id. de usuario
JobTitle string Puesto del usuario.
Correo string Id. de correo electrónico del usuario.
MailNickname string Alias del usuario.
Apellido string Apellido del usuario.
TelephoneNumber string Número de teléfono del usuario.
UserPrincipalName string Nombre principal de usuario.
AccountEnabled boolean Marca de cuenta habilitada.

Vínculos útiles