Personalizar a barra de comando usando o estruturador de comandos

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

Crie um novo aplicativo controlado por modelo usando o designer de aplicativo moderno ou Abra um aplicativo controlado por modelo existente usando o designer de aplicativo.

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

1. Faça login Power Apps .

2. 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 desejado.

3. Abra ou crie uma solução para conter a nova aplicação condicionada por modelo.

4. Selecione Novo>aplicativo controlado por modelo de aplicativo>.

5. Introduza um Nome para a sua aplicação e, em seguida, selecione Criar. Para obter mais informações: Crie seu primeiro aplicativo orientado por modelo

   

Abra um aplicativo controlado por modelo existente usando o designer de aplicativo

1. Iniciar sessão em Power Apps
2. 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 desejado.
3. Abra a solução que contém a aplicação condicionada por modelo existente.
4. Selecione o aplicativo controlado por modelo e, em seguida, selecione ...>Edite para abrir o designer de aplicativo 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

1. Selecione qualquer tabela na área Páginas no designer de aplicativos.

2. Selecione ... e, em seguida, selecione Editar barra de comandos.

   

3. Selecione o local da barra de comandos desejado e, em seguida, selecione Editar. Para obter mais informações: Locais 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.

A primeira vez que o designer de comandos é aberto para um aplicativo, um prompt para usar apenas JavaScript ou Power Fx é exibido. Selecionar Power Fx também lhe permite utilizar JavaScript, se pretender. A seleção Power Fx na caixa de diálogo cria uma biblioteca de componentes de comando para armazenar Power Fx fórmulas.

1. Abra o designer de comandos para editar uma barra de comandos e selecione Novo>Comando.

2. No painel direito, introduza ou selecione a partir das seguintes opções:

   • Rótulo (opcional). Insira um rótulo exibido no botão de comando.

   • Ícone. Selecionar 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, em seguida, carregue um arquivo em formato SVG . Em seguida, selecione Salvar e publicar o recurso da Web. Para obter mais informações sobre como criar um recurso da Web para a imagem de ícone desejada, vá para Criar ou editar recursos da Web de aplicativo controlado por modelo para estender um aplicativo.

   • Ação. Selecione um dos seguintes:

     • Executar fórmula. Introduza a fórmula Power Fx para executar a ação de comando. Para obter mais informações: Uso Power Fx para ações e visibilidade
     • JavaScript. Forneça a biblioteca JavaScript e o comando para executar a ação de comando. Para obter mais informações: Usar JavaScript para ações

   • Visibilidade. Selecione se deseja Mostrar o botão de comando ou Mostrar na condição da fórmula.

   • Título da dica de ferramenta. Opcionalmente, insira um título de dica de ferramenta. O título aparece ao utilizador quando este passa com o rato sobre o comando.

   • Descrição da dica de ferramenta. Opcionalmente, insira uma descrição de dica de ferramenta. 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, insira o texto que será lido pelos leitores de tela.

   • Número da encomenda. A ordem em que o comando é exibido em tempo de execução em relação a outros comandos dentro da mesma barra de comandos.

3. Arraste e largue o comando para a localização desejada. Pode organizar comandos modernos entre comandos clássicos.

4. Selecione Salvar e Publicar para disponibilizar o comando para os usuários do aplicativo.

5. Selecione Reproduzir para executar a 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. Essa operação em segundo plano ainda pode estar em andamento depois que o designer de comandos concluir a solicitação e desbloquear o designer.

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). Power Fx não é suportado em comandos clássicos.

Vai notar 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 Dataverse dados, você pode usar Power Fx fórmulas da mesma forma que faria em aplicativos de tela. Para obter mais informações: Usando 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, você pode abrir o comando biblioteca de componentes no canvas studio e adicionar tabelas adicionais como fontes de dados e, em seguida, usá-las dentro do designer de comando.
• 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 obter mais limitações com comandos modernos, vá para Moderno comandando limitações conhecidas.

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.

1. Para a Ação , selecione Executar JavaScript.

2. Selecione Adicionar biblioteca ou selecione outra na lista. A lista é preenchida com quaisquer bibliotecas em utilização pela barra de comandos atual.

   

3. Selecione Adicionar e pesquise recursos da Web JavaScript existentes ou você pode adicionar os seus próprios.

   

4. Insira o nome dafunção. Por exemplo, selecione a Main_system_library.js biblioteca e chame esta função: XrmCore.Commands.Open.opennewrecord.

5. Adicione parâmetros para passar à sua função.

   

Nota

Não há suporte para o uso de chamar várias bibliotecas JavaScript ou chamar várias funções a partir de um único comando.

Consulte também

Visão geral de comandos modernos