Personalizar la barra de comandos usando el diseñador de comandos

Artículo
10/16/2024

Este artículo lo guía a través de la creación y edición de comandos modernos con el diseñador de comandos y Power Fx.

Abra el diseñador de aplicaciones

O bien Cree una nueva aplicación basada en modelos usando el diseñador de aplicaciones moderno o abra una aplicación basada en modelos existente usando el diseñador de aplicaciones.

Crear una nueva aplicación basada en modelos con el diseñador de aplicaciones moderno

Iniciar sesión Power Apps .
En el panel de navegación izquierdo, seleccione Soluciones. Si el elemento no está en el panel lateral, Seleccionar …Más y luego Seleccionar el elemento que desea.
Abra o cree una solución que contenga la nueva aplicación basada en modelo.
Seleccionar Nueva>Aplicación>Aplicación basada en modelos.
Ingrese un Nombre para su aplicación y luego Seleccionar Crear. Más información: Cree su primera aplicación basada en modelos

Abra una aplicación basada en modelos existente utilizando el diseñador de aplicaciones

Iniciar sesión Power Apps
En el panel de navegación izquierdo, seleccione Soluciones. Si el elemento no está en el panel lateral, Seleccionar …Más y luego Seleccionar el elemento que desea.
Abra la solución que contiene la aplicación basada en modelo existente.
Seleccionar la aplicación basada en modelos y luego Seleccionar ...>Editar para abrir el diseñador de aplicaciones moderno.

Crear o editar comandos modernos

Una vez que esté en el diseñador de aplicaciones, use el diseñador de comandos para personalizar sus barras de comandos.

Nota

Actualmente, solo se puede acceder al diseñador de comandos a través del diseñador de aplicaciones moderno o dentro de soluciones para comandos existentes.
Actualmente, los comandos clásicos no se pueden editar dentro del diseñador de comandos.

Editar la barra de comandos

Abra el diseñador de comandos para editar una barra de comandos

Seleccionar cualquier tabla del área Páginas en el diseñador de aplicaciones.
Seleccionar ..., y luego Seleccionar Barra de comandos Editar.
Seleccionar la ubicación de la barra de comandos que desea y luego Seleccionar Editar. Más información: Ubicaciones de la barra de comandos

Crear un nuevo comando

A diferencia de los comandos clásicos, los comandos modernos solo se muestran dentro de la aplicación que está editando. Esto evita la transferencia de comandos no deseados a otras aplicaciones y mejora el rendimiento del tiempo de ejecución.

La primera vez que se abre el diseñador de comandos para una aplicación, se muestra un mensaje que solicita usar solo JavaScript o Power Fx . Seleccionar Power Fx también le permite usar JavaScript si lo desea. Al seleccionar Power Fx en el cuadro de diálogo, se crea un comando biblioteca de componentes para almacenar Power Fx fórmulas.

Abra el diseñador de comandos para editar una barra de comandos y luego Seleccionar Nuevo>Comando.
En el panel derecho, introduzca o seleccione entre las siguientes opciones:
- Etiqueta (opcional). Introduzca una etiqueta que se muestre en el botón de comando.
- Icono. Seleccione un icono para el botón de comando. Puede elegir entre cualquier ícono del sistema o archivo SVG de recursos web. Para cargar su propio ícono, seleccione Recurso web y luego cargue un archivo en formato SVG . Luego, Seleccionar Guarde y Publique el recurso web. Para obtener más información sobre cómo crear un recurso web para la imagen de icono que desea, vaya a Crear o editar recursos web de aplicaciones basadas en modelos para ampliar una aplicación.
- Acción. Seleccione uno de los siguientes:
  - Ejecutar fórmula. Introduzca la fórmula de Power Fx para ejecutar la acción del comando. Más información: Uso Power Fx para acciones y visibilidad
  - JavaScript. Proporcione la biblioteca de JavaScript y el comando para ejecutar la acción del comando. Más información: Usar JavaScript para acciones
- Visibilidad. Seleccionar si se debe Mostrar el botón de comando o Mostrar la condición de la fórmula.
- Título de la información sobre herramientas. Opcionalmente, ingrese un título para la información sobre herramientas. El título le aparece al usuario cuando pasa el ratón sobre el comando.
- Descripción de la información sobre herramientas. Opcionalmente, ingrese una descripción de la información sobre herramientas. La descripción aparece al usuario bajo el título de la información sobre herramientas cuando pasa el ratón sobre el comando.
- Texto de accesibilidad. Opcionalmente, ingrese el texto que leerán los lectores de pantalla.
- Número de pedido. El orden en que se muestra el comando en tiempo de ejecución en relación con otros comandos dentro de la misma barra de comandos.
Arrastre y suelte el comando a la ubicación deseada. Puede organizar comandos modernos entre comandos clásicos.
Seleccionar Guardar y publicar para que el comando esté disponible para los usuarios de la aplicación.
Seleccionar Reproducir para ejecutar la aplicación y probar los cambios

Nota

La publicación de fórmulas de Power Fx puede tardar unos minutos en publicar la biblioteca de componentes de comandos. Es posible que esta operación en segundo plano aún esté en curso después de que el diseñador de comandos haya completado la solicitud y desbloqueado el diseñador.

Usar Power Fx para acciones y visibilidad

Puede usar Power Fx para ambas acciones (lo que sucede cuando se selecciona el botón de comando) así como para la visibilidad (lógica para controlar cuándo el botón está visible). Power Fx No es compatible con los comandos clásicos.

Notará que el comando de la aplicación basada en modelo tiene una experiencia de barra de fórmulas que es similar a las aplicaciones de lienzo. Para trabajar con datos, puedes usar fórmulas tal como lo harías en las aplicaciones de lienzo. Dataverse Power Fx Más información: Uso Power Fx con comandos

Nota

Dataverse es actualmente el único origen de datos compatible con comandos en aplicaciones basadas en modelos.
Actualmente, no puede agregar tablas adicionales como fuentes de datos directamente desde el diseñador de comandos. Sin embargo, puede abrir el comando biblioteca de componentes en Canvas Studio y agregar tablas adicionales como fuentes de datos y luego usarlas dentro del diseñador de comandos.
Actualmente, no todas las funciones disponibles en las aplicaciones de lienzo son compatibles con los comandos de aplicaciones controladas por modelos. Además, hemos introducido algunas funciones nuevas específicas para los comandos de aplicaciones controladas por modelos.
Para conocer más limitaciones con los comandos modernos, vaya a Limitaciones conocidas de los comandos modernos.

Usar JavaScript para acciones

JavaScript es compatible con comandos clásicos y modernos. Sin embargo, es más sencillo crear comandos y asociar su JavaScript utilizando el diseñador de comandos moderno.

Para la Acción Seleccionar Ejecutar JavaScript.
Seleccionar Agregar biblioteca o Seleccionar otra de la lista. La lista se completa con las bibliotecas que utilizan la barra de comandos actual.
Seleccionar Agregue y busque recursos web de JavaScript existentes o puede agregar los suyos propios.
Introduzca el nombre de la función. Por ejemplo, Seleccionar la Main_system_library.js biblioteca luego llama a esta función: XrmCore.Commands.Open.opennewrecord.
Agregue parámetros para pasar a su función.