Visão geral de comandos modernos

Os comandos orientam o comportamento do aplicativo principal para aplicativos baseados em modelo. Eles são os botões com os quais os usuários interagem ao reproduzir aplicativos e as ações resultantes executadas quando um botão é selecionado. Cada comando é posicionado em relação a outros comandos e vinculado a um local da barra de comandos no aplicativo.

Em termos gerais, a personalização de comandos se encaixa nas categorias a seguir. Existem vários recursos em cada categoria, que são abordados com mais profundidade em toda a documentação de comando moderna:

• Display. Como o botão aparece e onde está localizado em um aplicativo. Por exemplo, o rótulo, o ícone e os rótulos de acessibilidade do botão, bem como o local e a posição da barra de comandos em uma barra de comandos.
• Action. A lógica que é executada quando um botão é selecionado. Por exemplo, criar e atualizar dados ou interagir com vários controles e páginas dentro do aplicativo.
• Visibilidade. Condições lógicas que especificam quando um botão está visível ou oculto para um usuário. Por exemplo, você pode querer que o botão fique visível para alguns usuários e oculto para outros. Ou talvez o botão deva ficar visível apenas quando determinados critérios dos registros de dados forem atendidos.

Locais da barra de comandos

• Grade principal. Esta barra de comandos é exibida ao usar a navegação à esquerda de um aplicativo para exibir uma lista completa de páginas de registros nesta tabela.

  

• Formulário principal. Esta barra de comandos é exibida nos formulários principais desta tabela. Isso aparece na parte superior do formulário e difere da visualização associada ou da visualização de subgrade que aparecerá em diferentes áreas do formulário.

  

• Exibição de subgrade. Esta barra de comandos é exibida em formulários de outras tabelas que renderizam dados desta tabela em uma subgrade. Por exemplo, o formulário principal da conta tem um controle de subgrade que lista registros de contato relacionados ao registro da conta. Para editar a barra de comandos abaixo, edite a barra de comandos para a tabela de contatos e, depois, a exibição de subgrade.

  

• Exibição associada. Esta barra de comandos é exibida no formulário de uma tabela pai ao exibir os dados relacionados nesta tabela. Por exemplo, no formulário principal de um registro de conta, selecione a guia Relacionado e, depois, selecione uma tabela relacionada como contatos.

  

• Ações rápidas. As ações rápidas estão associadas à localização da grade principal. Para adicionar ou editar comandos para ações rápidas e locais da grade principal, selecione a tabela desejada no designer de aplicativo moderno, edite a barra de comandos e escolha o local da grade principal. Os primeiros cinco comandos, determinados por ordem, também serão mostrados como ações rápidas ao reproduzir o aplicativo.

  

Observação

As localizações da barra de comandos personalizadas com menos frequência não são compatíveis com o designer de comandos. Consulte as seções Barra de comandos global e outras faixas para obter mais informações sobre como personalizar comandos para esses locais.

Tipos de comandos

• Comando. Botão padrão. Executa uma ação quando selecionado. Também pode ser aninhado em grupos dentro de menus suspensos e botões de divisão. Observe que eles eram chamados de flyouts nos comandos clássicos.
• Menu Suspenso. Cria um menu no qual você pode organizar comandos dentro de um grupo.
• Agrupar. Adicione títulos a grupos de comandos anihados em menus suspensos e botões de divisão.
• Botão de Divisão. Semelhante a uma lista suspensa, mas tem um comando primário. Quando o botão de divisão é selecionado, a ação do comando primário é executada. Se a divisa de expansão for selecionada, o comando primário não será executado. Em vez disso, uma lista será expandida para mostrar grupos, submenus e comandos adicionais.

Principais diferenças entre comandos clássicos e modernos

Os comandos clássicos (antes conhecidos como faixa) não eram personalizáveis com pouco código. Com o código, as personalizações de comando eram difíceis, entediantes e sujeitas a erros. Para escalar o comando para pouco código, bem como usar páginas personalizadas para convergir telas e aplicativos baseados em modelo, era vital reinventar e recriar a infraestrutura de comando.

Os comando modernos oferecem muitos recursos novos e são muito mais simples de usar.

Recurso	Clássico	Moderno
Compatível no runtime do aplicativo baseado em modelo	Sim	Sim. Além disso, há suporte ao runtime do Power Fx.
Personalizado usando	Edição manual de XML em arquivos de solução ou usando ferramentas de terceiros. Operações de exportação e importação de solução demoradas necessárias.	Suporte ao designer de comandos, bem como a APIs do Dataverse.
Dá suporte ao Power Fx.	No	Sim. Para ações e visibilidade.
Tempo necessário para personalizar	Lento, sujeito a erros.	Rápido
Desempenho e confiabilidade	Fácil de cometer erros. A personalização ruim e a falta de escopo geralmente afetam o desempenho do aplicativo	O tratamento de erros em linha evita erros. Otimizado para o Power Fx para melhor desempenho em tempo de execução.
Compartilhamento	Segurança baseada em função do Dataverse.	Os comandos não Power Fx usam a segurança baseada em função do Dataverse padrão. Os comandos do Power Fx atualmente exigem que a biblioteca de componentes de comando seja compartilhada, além de ter um direito de acesso apropriado.
Comportamentos de solução e ALM	Camadas de solução inconsistentes e problemáticas, sem presença na interface da solução. Muitos comportamentos de solução padrão não são compatíveis, como patches, segmentação, upgrade de solução, propriedades gerenciadas e muito mais.	Camadas de solução padrão gerenciadas centralmente para vários tipos de objetos de solução dentro do Dataverse. Presente na interface da solução. Todos os comportamentos de solução padrão são compatíveis.
Localização	Não padrão	Padronizado usando traduções de exportação e importação para toda a solução.
Modelo de dados	Complexo. Otimizado para faixas de opções clássicas e contém muitas propriedades que não são mais necessárias.	Simples, otimizado para as barras de comando de aplicativos baseadas em modelos atuais.
Usar JavaScript	Sim	Sim. Agora mais simples. Observação: o mesmo JavaScript pode ser usado para comandos clássicos e modernos.
Personalizar comandos prontos para uso	Sim	Os comandos tornam-se editáveis no designer de comandos uma vez migrados para a estrutura moderna.
Comandos específicos do aplicativo	Não	Sim. O uso do designer de comandos moderno garante que os comandos sejam visíveis apenas no aplicativo selecionado.
Comandos específicos da tabela que serão exibidos em todos os aplicativos que contêm a tabela	Sim	Sim. Requer a modificação da definição appaction dentro do arquivo de solução.
Comandos globais que serão exibidos para todas as tabelas e aplicativos para o local da barra de comandos especificado	Sim	Sim. Requer a modificação da definição appaction dentro do arquivo de solução.
Criar botões de divisão, submenus e grupos	Sim	Sim
Preencher dinamicamente um submenu com código	Sim	Não. Recomendamos criar comandos declarativamente.
Personalizar comandos de cabeçalho de aplicativo global	Sim	Não
Personalizar comandos para outros locais da barra de comando/incomuns ou obsoletos	Sim	Não
Executar um fluxo ou fluxo de trabalho moderno	Usando JavaScript	Usando JavaScript. Também compatível usando uma página personalizada.

Comparação entre regras de visibilidade clássicas e modernas

As regras de visibilidade clássicas geralmente tinham uma regra específica para cada cenário. Com o Power Fx, uma função declarativa substitui muitas regras clássicas. E é muito mais simples de usar.

Observe que as regras de visibilidade clássicas também terão suporte em breve nos comandos modernos. No entanto, o suporte para regras clássicas era necessário para migrar de forma confiável comandos clássicos para comandos modernos, e não há suporte para a personalização de regras clássicas no designer de comandos. Recomendamos que você use o Power Fx daqui para frente.

Caso de uso	Regra clássica	Opções clássicas	Propriedade visível do Power Fx
Mostrar/ocultar com base em valores de dados	CustomRule	Usar JavaScript	!IsBlank(Auto.Selected.Item.Email)
Mostrar/ocultar com base na permissão da tabela	EntityPrivilegeRule	Várias	DataSourceInfo()
Mostrar/ocultar com base na permissão do registro	RecordPrivilegeRule	Várias	RecordInfo()
Referenciar o contexto de controle para tabelas primárias e relacionadas	EntityRule	PrimaryEntity. SelectedEntity	Self.Selected
Referenciar o contexto de controle	EntityRule	Formulário. HomePageGrid. SubGridStandard. SubGridAssociated	Self.Selected
Propriedades de metadados da tabela	EntityPropertyRule		DataSourceInfo()
Mostrar/ocultar com base no estado do formulário. Por exemplo, mostrar para o formulário de criação	FormStateRule	Criar. Existente. ReadOnly. Desabilitado. BulkEdit	Self.Selected.State = FormMode.New
Mostrar quando > 1 registros são selecionados em uma grade	SelectionCountRule		CountRows(Auto.Selected.Items) > 1
Mostrar/ocultar uma tabela relacionada em uma pesquisa polimórfica. Por exemplo, verifique se a pesquisa é um usuário OU uma equipe	CustomRule	PrimaryEntityTypeCode	IsType(), AsType
Propriedades do ambiente de referência (Org)	CustomRule	OrgName. OrgLcid. UserLcid	Não disponível no momento

Perguntas frequentes

• Por que vejo mais comandos no designer do que no meu aplicativo?
  • Há vários motivos. Às vezes, há uma lógica de visibilidade que ocultará o comando ao executar o aplicativo. Outras vezes, esses comandos são injetados dinamicamente por meio de JavaScript personalizado durante o tempo de execução e não são configuráveis.
• Por que vejo comandos duplicados no designer?
  • Este era um padrão comum usado com comandos clássicos. Ambos os comandos não apareceriam em tempo de execução, pois eram controlados por regras de visibilidade. O designer de comando mostrará todos os comandos, independentemente das regras de visibilidade.

Consulte também

Personalizar a barra de comandos usando o designer de comando
Gerenciar comandos em soluções
Limitações conhecidas de comando moderno