Personalizar a barra de comando usando o estruturador de comandos

Artigo
12/11/2024

Este artigo orienta-o ao longo da criação e edição de comandos modernos utilizando o estruturador de comandos e o Power Fx.

Abra o estruturador de aplicações

Ou crie uma nova aplicação condicionada por modelo usando o moderno estruturador de aplicações ou abra uma aplicação condicionada por modelo existente usando o estruturador de aplicações.

Crie uma aplicação condicionada por modelo nova usando o estruturador de aplicações

Iniciar sessão no Power Apps.
No painel de navegação esquerdo, selecione Soluções. Se o item não estiver no painel lateral, selecione ...Mais e, em seguida, selecione o item pretendido.
Abra ou crie uma solução para conter a nova aplicação condicionada por modelo.
Selecione Nova>Aplicação>Aplicação condicionada por modelo.
Introduza um Nome para a sua aplicação e, em seguida, selecione Criar. Mais informações: Criar a primeira aplicação condicionada por modelo

Abra uma aplicação condicionada por modelo existente usando o estruturador de aplicações

Iniciar sessão no Power Apps
No painel de navegação esquerdo, selecione Soluções. Se o item não estiver no painel lateral, selecione ...Mais e, em seguida, selecione o item pretendido.
Abra a solução que contém a aplicação condicionada por modelo existente.
Selecione a aplicação condicionada por modelo e, em seguida, selecione ...>Editar para abrir o estruturador de aplicações moderno.

Criar ou editar comandos modernos

Uma vez que se encontra no estruturador de aplicações, use o estruturador de comandos para personalizar as suas barras de comando.

Nota

Atualmente, o estruturador de comandos só pode ser acesso através do estruturador de aplicações moderno ou das soluções para comandos existentes.
Atualmente, os comandos clássicos não podem ser editados dentro do estruturador de comandos.

Editar a barra de comandos

Abra o estruturador de comandos para editar uma barra de comando

Selecione qualquer tabela da área Páginas no estruturador de aplicações.
Selecione ... e, em seguida, selecione Editar barra de comandos.
Selecione a localização da barra de comandos desejada e, em seguida, selecione Editar. Mais informações: Localizações da barra de comandos

Criar um novo comando

Ao contrário dos comandos clássicos, os comandos modernos são exibidos apenas dentro da aplicação que está a editar. Isto impede a transferência de comandos indesejados para outras aplicações, e garante um melhor desempenho de runtime.

Na primeira vez que o estruturador de comandos é aberto para uma aplicação, é mostrado um aviso para utilizar apenas JavaScript ou Power Fx. Selecionar Power Fx também lhe permite utilizar JavaScript, se pretender. Selecionar Power Fx no diálogo cria uma biblioteca de componentes de comando para armazenar fórmulas Power Fx.

Abra o estruturador de comandos para editar uma barra de comando e, em seguida, selecione Novo>Comando.
No painel direito, introduza ou selecione a partir das seguintes opções:
- Etiqueta (opcional). Introduza uma etiqueta que aparece no botão de comando.
- Ícone. Selecionar um ícone para o botão de comando. Pode escolher entre quaisquer ícones do sistema ou ficheiros SVG de recursos Web. Para carregar o seu próprio ícone, escolha o Recurso Web e, em seguida, carregue um ficheiro com formato SVG. Em seguida, selecione Guardar e Publicar o recurso Web. Para obter mais informações sobre como criar um recurso Web para a imagem de ícone que deseja, vá a criar ou editar recursos Web de aplicações condicionadas por modelos para expandir uma aplicação.
- Ação. Selecione um dos seguintes:
  - Executar fórmula. Introduza a fórmula Power Fx para executar a ação de comando. Mais informações: Utilizar o Power Fx para ações e visibilidade
  - JavaScript. Forneça a biblioteca JavaScript e o comando para executar a ação de comando. Mais informações: Use o JavaScript para ações
- Visibilidade. Selecione para Mostrar o botão de comando ou Mostrar com a condição da fórmula.
- Título da descrição. Opcionalmente, introduza um título da descrição. O título aparece ao utilizador quando este passa com o rato sobre o comando.
- Descrição da sugestão. Opcionalmente, introduza uma descrição da dica. A descrição aparece ao utilizador por baixo do título da descrição quando este passa com o rato sobre o comando.
- Texto de acessibilidade. Opcionalmente, introduza o texto que será lido pelos leitores do ecrã.
- Número da encomenda. A encomenda que o comando é apresentada em runtime relativamente a outros comandos dentro da mesma barra de comando.
Arraste e largue o comando para a localização desejada. Pode organizar comandos modernos entre comandos clássicos.
Selecione Guardar e publicar para que o comando fique disponível para os utilizadores da aplicação.
Selecione Executar para executar aplicação e testar as alterações.

Nota

A publicação de fórmulas do Power Fx na biblioteca de componentes de comandos pode demorar alguns minutos. Esta operação de fundo poderá ainda estar em curso após o estruturador de comandos concluir o pedido e desbloquear o estruturador.

Utilizar o Power Fx para ações e visibilidade

Pode utilizar o Power Fx para ambas as ações (o que acontece quando o botão de comando é selecionado) bem como a visibilidade (lógica para controlar quando o botão está visível). O Power Fx não é suportado em comandos clássicos.

Repare que o comando da aplicação condicionada por modelo tem uma experiência de barra de fórmula que é semelhante às aplicações de tela. Para trabalhar com dados do Dataverse, pode utilizar fórmulas do Power Fx tal como faria nas aplicações de tela. Mais informações: Utilizar o Power Fx com comandos

Nota

O Dataverse é atualmente a única origem de dados suportada com comandos em aplicações condicionadas por modelos.
Não é possível adicionar atualmente tabelas adicionais como origens de dados diretamente do estruturador de comandos. No entanto, pode abrir a biblioteca de componentes de comando no estúdio de tela e adicionar tabelas adicionais como origens de dados e depois usá-las dentro do estruturador de comandos.
Nem todas as funções disponíveis dentro de aplicações de tela são suportadas atualmente para comandos de aplicações condicionadas por modelos. Além disso, introduzimos algumas novas funções específicas aos comandos de aplicações condicionadas por modelos.
Para ver mais limitações com comandos modernos, aceda a Limitações conhecidas de comandos modernos.

Utilizar o JavaScript para ações

O JavaScript é suportado com comandos clássicos e modernos. No entanto, é mais simples criar comandos e associar o seu JavaScript usando o estruturador de comandos moderno.

Para a Ação selecionar Executar o JavaScript.
Selecione Adicionar biblioteca ou selecione outra da lista. A lista é preenchida com quaisquer bibliotecas em utilização pela barra de comandos atual.
Selecione Adicionar e procurar os recursos Web existentes do JavaScript ou pode adicionar os seus.
Introduza o Nome da função. Por exemplo, selecione a biblioteca Main_system_library.js e, em seguida, selecione esta função: XrmCore.Commands.Open.opennewrecord.
Adicione parâmetros para passar à sua função. Para mais informações sobre os parâmetros disponíveis, aceda a Valores de grelha.