Ejercicio: Personalizar la barra de comandos

  • 9 minutos

En este ejercicio, añadirá un botón de barra de comandos al formulario de tabla de solicitud de ayuda. Este botón es visible para las solicitudes de ayuda activas. Al hacer clic, se crea una nueva tarea para la solicitud de ayuda.

Importante

Use un entorno de prueba con Microsoft Dataverse aprovisionado y las aplicaciones de ejemplo habilitadas. Si no dispone de ninguno, puede suscribirse al plan de la comunidad aquí.

Tarea: Preparar el entorno

En esta tarea, creará una solución, una nueva tabla de solicitud de ayuda y una aplicación basada en modelo. Si prefiere omitir esta tarea y usar una solución inicial, continúe con la tarea Importar una solución.

  1. Navegue al Power Apps Maker Portal y asegúrese de que se encuentra en el entorno correcto que tiene habilitadas las aplicaciones de ejemplo.

    Captura de pantalla que muestra el nombre del entorno

  2. Seleccione Soluciones.

  3. Seleccione + Nueva solución.

  4. Introduzca Command Bar como Nombre para mostrar, seleccione CDS Default Publisher como Editor y luego elija Crear.

    Captura de pantalla que muestra las propiedades de la nueva solución

  5. Abra la solución Command Bar que ha creado.

  6. Seleccione + Nueva y Tabla > Tabla (propiedades avanzadas).

  7. Introduzca Help Request como Nombre para mostrar (Help Requests aparecerá automáticamente como Nombre en plural) y expanda Opciones avanzadas.

    Captura de pantalla que muestra el cuadro de diálogo Crear nueva tabla

  8. Baje a la sección Convertir esta tabla en una opción cuando, marque la casilla Crear una nueva actividad y seleccione Guardar.

    Captura de pantalla que muestra la casilla de verificación habilitar tabla para actividad

  9. Expanda la tabla Solicitud de ayuda que creó y seleccione Columnas.

    Captura de pantalla que muestra el botón Columnas de tabla

  10. Abra la columna Razón para el estado.

    Captura de pantalla que muestra la columna Razón para el estado

  11. Seleccione Nueva opción.

    Captura de pantalla que muestra el botón agregar nueva opción

  12. Introduzca Resuelto para la etiqueta y seleccione Guardar.

    Captura de pantalla que muestra una nueva opción agregada a las opciones de razón para el estado

  13. Seleccione Formularios y abra el formulario principal.

    Captura de pantalla que muestra los formularios de la tabla

  14. Arrastre la columna Razón para el estado y suéltela en el encabezado del formulario.

    Captura de pantalla que muestra la columna de razón para el estado que se agrega al encabezado del formulario

  15. Seleccione Guardar y publicar y espere a que se publique el formulario.

  16. Seleccione el botón Atrás.

  17. Seleccione Aplicaciones.

  18. Seleccione + Nueva, Aplicación y Aplicación basada en modelo.

    Captura de pantalla donde se ve el botón Crear nueva aplicación basada en modelo

  19. Introduzca Aplicación Help Request como nombre y después seleccione Crear.

  20. Seleccione el botón Navegación... y luego seleccione Nuevo grupo.

    Captura de pantalla que muestra el grupo de navegación

  21. Vaya al panel de propiedades.

  22. Cambie el título a Solicitudes y el id. a help_requests_group.

    Captura de pantalla con las propiedades del grupo de navegación

  23. A continuación, en el panel de la izquierda del lienzo, en Navegación, seleccione Solicitudes... y Nueva página.

  24. Seleccione Tabla de Dataverse para Tipo de contenido y, luego, Siguiente.

  25. Seleccione Help Request para la tabla y, luego, seleccione Agregar.

    Captura de pantalla con las propiedades de la subárea de navegación

  26. Seleccione la vista Help Requests que acaba de añadir y vaya a la pestaña Configuración en el panel a la derecha del lienzo.

  27. Cambie el id. a help_requests_subarea.

    Captura de pantalla con el valor de id. de help request

  28. Seleccione Guardar y espere a que se guarde la aplicación.

  29. Seleccione Publicar y espere a que se publique la aplicación.

  30. Seleccione el botón Atrás.

    Captura de pantalla con el botón Atrás

  31. Seleccione Publicar todas las personalizaciones y espere a que se complete la publicación.

Tarea: Importar solución

En esta tarea, importará la solución de inicio a su entorno. Solo necesita llevar a cabo esta tarea si no ha completado la tarea de preparación del entorno anterior. Si ha completado la tarea de preparación del entorno, continúe con la tarea "Agregar un botón de comando".

  1. Descargue el archivo de solución CommandBar_1_0_0_1.zip ubicado en GitHub y guárdelo de forma local en su ordenador.

  2. Navegue al Power Apps Maker Portal y asegúrese de que se encuentra en el entorno correcto que tiene habilitadas las aplicaciones de ejemplo.

  3. Seleccione Soluciones.

  4. Seleccione Importar solución.

  5. Seleccione Examinar.

  6. Elija el archivo que ha descargado y seleccione Abrir.

  7. Seleccione Siguiente.

  8. Seleccione Importar y espere a que se complete la importación de la solución.

    Captura de pantalla que muestra el cuadro de diálogo para importar una solución

  9. Debería ver una notificación cuando se complete la importación. Seleccione Publicar todas las personalizaciones y espere a que se complete la publicación.

Tarea: Agregar un botón de comando

En esta tarea, añadirá un nuevo botón de comando al formulario principal de la tabla Help Request.

  1. Abra la solución Command Bar que ha creado o importado.

  2. Seleccione Aplicaciones y abra Help Request App.

    Captura de pantalla que muestra la aplicación Help Request

  3. Seleccione el botón de puntos suspensivos ... en la Vista de Help Request y, luego, seleccione Editar barra de comandos > Editar.

    Captura de pantalla que muestra el botón Editar barra de comandos

  4. Seleccione Formulario principal y después elija Editar.

  5. Seleccione Nuevo y luego seleccione Comando.

    Captura de pantalla que muestra el botón de nuevo comando

  6. Seleccione Power Fx y Continuar. Debe esperar a que Crear una biblioteca de componentes finalice y a que la ventana emergente desaparezca.

  7. Con NuevoComando seleccionado en el lienzo, introduzca Follow Up como Etiqueta, Utilizar icono y Marcador de posición; luego, seleccione Mostrar según la condición de la fórmula para la visibilidad.

    Captura de pantalla que muestra las propiedades de un paso

  8. Introduzca Realizar un seguimiento para el título de información sobre herramientas, descripción de información sobre herramientas y texto de accesibilidad.

  9. Vaya a la barra de fórmulas, seleccione Visible y pegue esta fórmula. Esta fórmula de Power Fx mostrará el botón si la solicitud de ayuda está activa y lo ocultará si se resuelve.

    If(Self.Selected.Item.'Status Reason' =  'Status Reason (Help Requests)'.Active, true, false)

    Captura de pantalla que muestra la fórmula de visibilidad

  10. Seleccione Guardar y publicar.

  11. Espere a que se complete la publicación.

  12. Seleccione Reproducir.

    Captura de pantalla que muestra el botón Reproducir

  13. Seleccione + Nuevo.

  14. Introduzca Prueba para Visibilidad como Nombre y seleccione Guardar.

    Captura de pantalla que muestra el registro de solicitud de ayuda

  15. El botón de comando Realizar un seguimiento debería estar visible. Cambie la razón para el estado a Resuelto.

    Captura de pantalla que muestra el valor de Razón para el estado

  16. Seleccione Guardar.

  17. El botón de comando Realizar un seguimiento ya no debería estar visible.

    Captura de pantalla que muestra la barra de comandos sin el botón de seguimiento

  18. Cambie la razón para el estado a Activo.

  19. Seleccione Guardar.

  20. El botón de comando Realizar un seguimiento debería estar visible de nuevo.

  21. Cierre la pestaña o ventana del navegador de la aplicación.

  22. Ahora debería estar de nuevo en el editor de la barra de comandos. No se vaya de esta página.

Tarea: Agregar una acción de botón

En esta tarea, agregará una fórmula de Power Fx, que creará una nueva tarea que vence en una semana cuando se hace clic en el botón de comando.

  1. Seleccione Abrir biblioteca de componentes.

    Captura de pantalla que muestra el botón Abrir biblioteca de componentes

  2. Seleccione la pestaña Datos y Agregar datos, busque tareas y seleccione la tabla Tareas.

    Captura de pantalla con el cuadro de diálogo Agregar datos

  3. Seleccione Guardar.

  4. Seleccione Publicar

  5. Seleccione Publicar esta versión.

  6. Cierre la pestaña o ventana del navegador de la biblioteca de componentes.

  7. Seleccione Reanudar.

    Captura de pantalla que muestra el currículum editando la ventana emergente de la barra de comandos

  8. Seleccione el botón de comando Realizar un seguimiento agregado.

  9. Vaya a la barra de fórmulas y seleccione OnSelect.

    Captura de pantalla que muestra la acción de selección del botón de seguimiento

  10. Pegue esta fórmula en la barra de fórmulas. Esta fórmula creará una tarea para la solicitud de ayuda actual, establecerá la fecha de vencimiento en una semana a partir del momento en que se haga clic en el botón y mostrará una notificación.

    Patch(Tasks, {Subject: Self.Selected.Item.Name, Regarding: Self.Selected.Item, 'Due Date': DateAdd(Now(),7) }); Notify("Created new task")

    Captura de pantalla que muestra la fórmula del comando de selección

  11. Seleccione Guardar y publicar.

  12. Espere a que se publiquen los cambios.

  13. Seleccione Reproducir.

  14. Abra el registro de solicitud de ayuda Prueba para Visibilidad.

  15. Seleccione el botón Realizar un seguimiento.

    Captura de pantalla que muestra el botón de comando de seguimiento

  16. Ahora debería ver la notificación. Seleccione el botón de contenido adicional Relacionados y luego elija Actividades,

    Captura de pantalla que muestra el botón de actividades

  17. Debería ver la tarea creada. Asegúrese de que la Fecha de vencimiento esté configurada en 7 días a partir de la fecha actual.

    Captura de pantalla que muestra el registro de tarea creado