Personalizar a barra de comandos usando o designer de comando

Artigo
10/16/2024

Este artigo orienta você na criação e edição de comandos modernos usando o designer de comandos e o Power Fx.

Abrir o designer de aplicativo

Crie um novo aplicativo baseado em modelo usando o designer de aplicativo moderno ou Abra um aplicativo baseado em modelo existente usando o designer de aplicativo.

Criar um aplicativo baseado em modelo usando o designer de aplicativo

Entrar Power Apps .
No painel de navegação esquerdo, selecione Soluções. Se o item não estiver no painel lateral, Select …Mais e então Select o item desejado.
Abra ou crie uma solução para conter o novo aplicativo baseado em modelo.
Select Novo>aplicativo>aplicativo baseado em modelo.
Insira um Nome para seu aplicativo e depois Select Criar. Mais informações: Crie seu primeiro aplicativo baseado em modelo

Abra um aplicativo baseado em modelo existente usando o designer de aplicativos

Entrar em Power Apps
No painel de navegação esquerdo, selecione Soluções. Se o item não estiver no painel lateral, Select …Mais e então Select o item desejado.
Abra a solução que contém o aplicativo baseado em modelo existente.
Select o aplicativo baseado em modelo e, em seguida, Select ...>Editar para abrir o designer de aplicativo moderno.

Criar ou editar comandos modernos

Quando estiver no designer de aplicativo, use o designer de comando para personalizar suas barras de comando.

Observação

Atualmente, o designer de comando só pode ser acessado por meio do designer de aplicativo moderno ou em soluções para comandos existentes.
Atualmente, os comandos clássicos não podem ser editados no designer de comando.

Editar a barra de comando

Abrir o designer de comando para editar uma barra de comando

Select qualquer tabela da área Páginas no designer de aplicativos.
Select ... e, em seguida, Select Editar barra de comando.
Select a localização da barra de comando desejada e depois Select Editar. Mais informações: Localizações da barra de comando

Criar um comando

Ao contrário dos comandos clássicos, os comandos modernos são exibidos apenas no aplicativo que você estiver editando. Isso evita a transferência de comandos indesejados para outros aplicativos, além de melhorar o desempenho do tempo de execução.

Na primeira vez que o designer de comando é aberto para um aplicativo, um prompt para usar somente JavaScript ou Power Fx é exibido. A seleção de Power Fx também permite que você use o JavaScript, se desejar. Selecionar Power Fx na caixa de diálogo cria um comando biblioteca de componentes para armazenar Power Fx fórmulas.

Abra o designer de comandos para editar uma barra de comandos e, em seguida, Select Novo>Comando.
No painel direito, digite ou selecione uma das seguintes opções:
- Etiqueta (opcional). Insira um rótulo que seja exibido no botão de comando.
- Ícone. Selecione um ícone para o botão de comando. Você pode escolher entre qualquer ícone do sistema ou arquivos SVG de recursos da web. Para carregar seu próprio ícone, escolha Recurso da Web e carregue um arquivo no formato SVG . Em seguida, Select Salve e Publique o recurso da web. Para obter mais informações sobre como criar um recurso da Web para a imagem de ícone desejada, acesse Criar ou editar recursos da Web de aplicativos baseados em modelo para estender um aplicativo.
- Ação. Selecione entre os seguintes itens:
  - Execute a fórmula. Insira a fórmula do Power Fx para executar a ação de comando. Mais informações: Use Power Fx para ações e visibilidade
  - JavaScript. Fornece a biblioteca JavaScript e o comando para executar a ação do comando. Mais informações: Use JavaScript para ações
- Visibilidade. Select se deve Mostrar o botão de comando ou Mostrar uma condição da fórmula.
- Título da dica de ferramenta. Opcionalmente, insira um título para a dica de ferramenta. O título aparece para o usuário quando ele passa o mouse sobre o comando.
- Descrição da dica de ferramenta. Opcionalmente, insira uma descrição de dica de ferramenta. A descrição aparece para o usuário abaixo do título da dica de ferramenta quando ele passa o mouse sobre o comando.
- Texto de acessibilidade. Opcionalmente, insira o texto que será lido pelos leitores de tela.
- Número do pedido. A ordem em que o comando é exibido em tempo de execução em relação a outros comandos na mesma barra de comandos.
Arraste e solte o comando para o local desejado. Você pode organizar comandos modernos entre comandos clássicos.
Select Salvar e publicar para disponibilizar o comando aos usuários do aplicativo.
Select Jogue para executar o aplicativo e testar suas alterações

Observação

A publicação de fórmulas do Power Fx pode levar alguns minutos para publicar a biblioteca de componentes de comando. Esta operação em segundo plano ainda pode estar em andamento após o designer de comando concluir a solicitação e desbloquear o designer.

Usar o Power Fx para ações e visibilidade

Você pode usar o Power Fx para as duas ações (o que acontece quando o botão de comando é selecionado), bem como a visibilidade (lógica para controlar quando o botão estará visível). Power Fx não é suportado em comandos clássicos.

Você notará que o comando do aplicativo baseado em modelo tem uma experiência de barra de fórmula semelhante aos aplicativos de tela. Para trabalhar com Dataverse dados, você pode usar Power Fx fórmulas da mesma forma que faria em aplicativos Canvas. Mais informações: Usando Power Fx com comandos

Observação

O Dataverse é atualmente a única fonte de dados compatível com comandos em aplicativos baseados em modelos.
No momento, não é possível adicionar tabelas adicionais como fontes de dados diretamente do designer de comando. No entanto, você pode abrir o comando biblioteca de componentes no Canvas Studio e adicionar tabelas adicionais como fontes de dados e usá-las no designer de comandos.
Nem todas as funções disponíveis em aplicativos de tela têm suporte atualmente para comandos de aplicativo baseado em modelo. Além disso, apresentamos algumas novas funções específicas para comandos de aplicativo baseado em modelo.
Para mais limitações com comandos modernos, acesse Limitações conhecidas dos comandos modernos.

Usar JavaScript para ações

O JavaScript é compatível com comandos clássicos e modernos. No entanto, é mais simples criar comandos e associar o JavaScript usando o designer de comando moderno.

Para a Ação Select Executar JavaScript.
Select Adicione uma biblioteca ou Select outra da lista. A lista é preenchida com todas as bibliotecas em uso pela barra de comando atual.
Select Adicione e pesquise por recursos web JavaScript existentes ou você pode adicionar os seus próprios.
Digite o Nome da função. Por exemplo, Select a Main_system_library.js biblioteca e então chame esta função: XrmCore.Commands.Open.opennewrecord.
Adicione parâmetros a passar para a função.