Plantilla de pantalla de personas en aplicaciones de lienzo

Artículo
03/16/2023

En una aplicación de lienzo, agregue una pantalla de personas que permita a los usuarios buscar personas dentro de sus organizaciones. Los usuarios pueden buscar, seleccionar y agregar personas a una colección. Puede cambiar qué tipos de datos aparecen en la galería de resultados de búsqueda, usar las selecciones de personas para enviar un correo electrónico y realizar otras personalizaciones.

También puede agregar otras pantallas basadas en plantillas que muestran datos diferentes de Office 365, como el correo electrónico, el calendario de un usuario y la disponibilidad de las personas que los usuarios quieran invitar a una reunión.

Esta descripción general le enseña:

Cómo usar la pantalla de personas predeterminada.
Cómo modificar la pantalla.
Cómo integrar la pantalla en una aplicación.

Para una inmersión más profunda en la funcionalidad predeterminada de esta pantalla, consulte la referencia de pantalla de personas.

Requisito previo

Familiaridad con cómo agregar y configurar pantallas y otros controles a medida que crea una aplicación en Power Apps.

Funcionalidad predeterminada

Para agregar una pantalla de personas desde una plantilla:

Inicie sesión en Power Apps, y luego cree una aplicación o abra una aplicación existente en Power Apps Studio.

Este tema muestra una aplicación de teléfono, pero los mismos conceptos se aplican a una aplicación de tableta.
En la pestaña Inicio de la cinta, seleccione Nueva pantalla > Personas.

Por defecto, la pantalla se parece a esto:
Para comenzar a buscar usuarios, seleccione el cuadro de entrada de texto en la parte superior y comience a escribir el nombre de un compañero de trabajo. Los resultados de la búsqueda aparecen debajo del cuadro de entrada de texto:
Cuando selecciona personas en los resultados de búsqueda, se agregan a la colección MyPeople. El valor de entrada de la barra de búsqueda se restablece, revelando la colección de personas que ha seleccionado:

Modificar la pantalla

Puede modificar la funcionalidad predeterminada de esta pantalla mostrando diferentes datos para personas.

Si desea modificar más la pantalla, use la referencia de pantalla de personas como guía.

Mostrar datos diferentes para personas

Esta pantalla usa la operación Office365Users.SearchUser para buscar usuarios en su organización. Proporciona campos adicionales para cada evento más allá de lo que aparece en el control UserBrowseGallery. Agregar o cambiar campos en la galería es un proceso simple:

En el control UserBrowseGallery, seleccione una etiqueta para modificar (o agregue una y manténgala seleccionada).
Con su propiedad Text seleccionada, en la barra de fórmulas, reemplace el contenido con ThisItem.

IntelliSense muestra una lista de campos que puede seleccionar.
Seleccione el campo que desee.

La propiedad Text se actualiza a ThisItem.{FieldSelection}.

Integrar la pantalla en una aplicación

La pantalla de personas es un poderoso paquete de controles por derecho propio, pero generalmente funciona mejor como parte de una aplicación más grande y versátil. Puede integrar esta pantalla en una aplicación más grande de varias maneras, incluyendo usando la lista de personas en memoria caché.

Usar la lista de personas almacenadas en caché

La pantalla de personas almacena en caché sus selecciones de personas en la colección My People. Si su situación comercial requiere una búsqueda de personas, deberá saber cómo usar esta colección. Aquí se explica paso a paso cómo conectar esta pantalla a una pantalla de correo electrónico rudimentaria y enviar correos electrónicos a los usuarios en la colección MyPeople. También obtendrá información sobre cómo funciona la pantalla de correo electrónico.

Agregue el origen de datos Office 365 Outlook a su aplicación seleccionando la pestaña Ver, seleccionando Orígenes de datos > Añadir origen de datos y buscando el conector Office 365 de Outlook. Puede que tenga que seleccionar Nueva conexión para encontrarlo.
Después de insertar la pantalla de personas, inserte una nueva pantalla en blanco. Dentro de esa pantalla, agregue un icono de flecha hacia atrás, dos cuadros de entrada de texto y un icono de envío.
Cambie el nombre de la pantalla a EmailScreen, el icono de flecha hacia atrás a BackIcon, un cuadro de entrada de texto a SubjectLine, el otro a MessageBody y el icono a SendIcon.
Establezca la propiedad OnSelect de BackIcon a Back().
Establezca la propiedad OnSelect de SendIcon en esta fórmula:
```
Office365.SendEmailV2( 
    Concat( MyPeople, UserPrincipalName & ";" ), 
    SubjectLine.Text, 
    MessageBody.Text 
)
```
Aquí, está utilizando el conector de Outlook para enviar un correo electrónico. Se pasa Concat(MyPeople, UserPrincipalName & ";") como la lista de destinatarios. Esta fórmula concatena todas las direcciones de correo electrónico en la colección MyPeople en una sola cadena con punto y coma separándolos. Esto no es diferente de escribir una cadena de direcciones de correo electrónico separadas por punto y coma en la línea "Para" de su cliente de correo electrónico favorito.
- Está pasando SubjectLine.Text como el asunto del mensaje, y MessageBody.Text como el cuerpo del mensaje.
En la pantalla de personas, en la esquina superior derecha, inserte el icono Correo. Cambie el color del icono al que prefiera.
Establezca la propiedad OnSelect de SendIcon en Navigate( EmailScreen, None ).

Ahora tiene una aplicación de dos pantallas en la que puede seleccionar usuarios, redactar un mensaje de correo electrónico y luego enviarlo. No dude en probarlo, pero tenga cuidado, porque la aplicación envía correos electrónicos a todos los que agrega a la colección MyPeople.

Pasos siguientes

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).

Compartir a través de