Personalizar a barra de comandos co deseñador de comandos

Artigo
01/11/2024

Este artigo guíao para crear e editar comandos modernos usando o deseñador de comandos e Power Fx.

Abrir o deseñador de aplicacións

Cree unha nova aplicación baseada en modelos usando o deseñador de aplicacións moderno ou Abra unha aplicación existente baseada en modelos usando o deseñador de aplicacións moderno.

Crear unha nova aplicación xerada por modelos utilizando o deseñador de aplicacións moderno

Inicie sesión en Power Apps.
No panel de navegación esquerdo, seleccione Solucións. Se o elemento non está no panel lateral, seleccione …Máis e, a seguir, seleccione o elemento que desexe.
Abre ou crea unha solución para conter a nova aplicación baseada en modelos.
Seleccione Nova > Aplicación > Aplicación baseada en modelos.
Escriba un nome para a aplicación e seleccione Crear. Máis información: Crear unha aplicación baseada en modelos que teña unha páxina de táboa de contas

Abrir unha aplicación xerada por modelos existente utilizando o deseñador de aplicacións moderno

Inicie sesión en Power Apps
No panel de navegación esquerdo, seleccione Solucións. Se o elemento non está no panel lateral, seleccione …Máis e, a seguir, seleccione o elemento que desexe.
Abre a solución que contén a aplicación baseada en modelos existente.
Seleccione a aplicación baseada en modelos e logo seleccione ... > Editar para abrir o deseñador de aplicacións moderno.

Crear ou editar comandos modernos

Unha vez que estea no deseñador de aplicacións, use o deseñador de comandos para personalizar as barras de comandos.

Nota

Actualmente, ao deseñador de comandos só se pode acceder a través do deseñador de aplicacións moderno ou en solucións para comandos existentes.
Actualmente, os comandos clásicos non se poden editar dentro do deseñador de comandos.

Editar a barra de comandos

Abrir o deseñador de comandos para editar unha barra de comandos

Seleccione calquera táboa da área de Páxinas no deseñador de aplicacións.
Seleccione ... e logo seleccione Editar barra de comandos.
Seleccione a localización da barra de comandos que desexa e logo seleccione Editar. Máis información: Localizacións da barra de comandos

Crear un novo comando

A diferenza dos comandos clásicos, os comandos modernos só se amosan na aplicación que está editando. Isto evita a transferencia de comandos non desexada a outras aplicacións, así como un mellor rendemento no tempo de execución.

A primeira vez que se abre o deseñador de comandos para unha aplicación, móstrase unha solicitude para usar JavaScript só ou Power Fx. Seleccionar Power Fx tamén permite usar JavaScript se o desexa. Seleccionar Power Fx no diálogo creará unha biblioteca de compoñentes de comandos para almacenar fórmulas de Power Fx.

Abra o deseñador de comandos para editar unha barra de comandos e, a continuación, seleccione + Novo comando.
No panel dereito, introduza ou seleccione unha das seguintes opcións:
- Etiqueta (opcional). Insira unha etiqueta que se amosará no botón de comando.
- Icona. Escolla unha icona para o botón de comando. Pode escoller entre calquera icona do sistema ou ficheiro SVG de recursos web. Para cargar a súa propia icona, elixa Recurso web e despois cargue un ficheiro de formato SVG. A seguir, seleccione Gardar e Publicar o recurso web. Para obter máis información sobre como crear un recurso web para a imaxe da icona que desexa, visite Crear ou editar recursos web de aplicacións baseadas en modelos para ampliar unha aplicación.
- Acción. Seleccione un dos seguintes:
  - Executar fórmula. Introduza a fórmula de Power Fx para executar a acción de comando. Máis información: Usar Power Fx para accións e visibilidade
  - JavaScript. Proporcione a biblioteca de JavaScript e o comando para executar a acción de comando. Máis información: Usar JavaScript para accións
- Visibilidade. Seleccione se quere Amosar o botón de comando ou Mostrar coa condición da fórmula.
- Título da información sobre ferramentas (opcional). Escriba un título da información sobre ferramentas. O título aparece ao usuario cando pasa o rato sobre o comando.
- Descrición da información sobre ferramentas (opcional). Escribir unha descrición da información sobre ferramentas. A descrición aparece ao usuario debaixo do título da información sobre ferramentas cando pasa o rato sobre o comando.
- Texto de accesibilidade (opcional). Insira o texto que lerán os lectores de pantalla.
- Número de pedido. A orde que amosará o comando en tempo de execución en relación con outros comandos da mesma barra de comandos.
Arrastre e solte o comando na localización desexada. Pode organizar comandos modernos entre os comandos clásicos.
Seleccione Gardar e publicar para que o comando estea dispoñible para os usuarios da aplicación.
Seleccione Reproducir para executar a aplicación e probar os cambios

Nota

Publicar fórmulas de Power Fx pode tardar uns minutos en publicar a biblioteca de compoñentes de comandos. É posible que esta operación en segundo plano aínda estea en curso despois de que o deseñador de comandos complete a solicitude e desbloquee o deseñador.

Usar Power Fx para accións e visibilidade

Pode usar Power Fx para as accións (que pasa cando se selecciona o botón de comando), así como para a visibilidade (lóxica para controlar cando o botón é visible). Power Fx non está admitido nos comandos clásicos.

Notará que o comando da aplicación baseada en modelos ten unha experiencia de barra de fórmulas similar ás aplicacións de lenzo. Por traballar con datos de Dataverse pode usar fórmulas de Power Fx como faría nas aplicacións de lenzo. Máis información: Usar Power Fx con comandos

Nota

Dataverse actualmente é a única orixe de datos compatible con comandos en aplicacións baseadas en modelos.
Non pode engadir táboas adicionais como orixes de datos directamente desde o deseñador de comandos. Non obstante, pode abrir a biblioteca de compoñentes de comando no estudo de lenzos e engadir táboas adicionais como orixes de datos e despois utilizalos dentro do deseñador de comandos.
Actualmente non todas as funcións dispoñibles nas aplicacións de lenzo son compatibles cos comandos de aplicacións baseadas en modelos. Ademais, introducimos algunhas novas funcións específicas para comandos de aplicacións baseadas en modelos.
Para obter máis limitacións cos comandos modernos, consulte Limitacións coñecidas dos comandos modernos.

Usar JavaScript para as accións

JavaScript é compatible con comandos clásicos e modernos. Non obstante, é máis sinxelo crear comandos e asociar o seu JavaScript co moderno deseñador de comandos.

Para a Acción seleccione Executar JavaScript.
Seleccione Engadir biblioteca ou seleccione outra da lista. A lista énchese coas bibliotecas utilizadas pola barra de comandos actual.
Seleccione Engadir e busque recursos web de JavaScript existentes ou pode engadir os seus.
Escriba o nome de función. Por exemplo, seleccione a biblioteca Main_system_library.js e chame esta función: XrmCore.Commands.Open.opennewrecord.
Engada parámetros para pasar á súa función.