Definir regras de negócios – Apresentação
As regras de negócios são lógica declarativa e validação associadas a uma tabela do Dataverse sem escrever código.
Com regras de negócios você pode:
Definir o valor em uma coluna.
Alterar o nível de requisito de uma coluna.
Validar dados e mostrar mensagens de erro.
Alterar as propriedades de uma coluna em um formulário de aplicativo baseado em modelo.
Oferecer uma recomendação ao usuário em um formulário de aplicativo baseado em modelo.
A lógica definida por uma regra de negócios pode ser aplicada no lado do cliente em um formulário de aplicativo baseado em modelo e/ou no lado do servidor quando uma linha do Dataverse é criada ou atualizada. No lado do cliente significa que a regra é aplicada imediatamente no aplicativo quando um usuário altera um campo. No lado do servidor significa quando a linha é salva e a lógica é executada durante a transação, antes que os dados sejam salvos no banco de dados.
Como uma regra de negócios pode operar no lado do servidor, as condições e as ações na regra se aplicam a dados do Dataverse alterados por aplicativos baseados em modelo, aplicativos de tela, sites do Power Pages, fluxos da nuvem do Power Automate ou APIs do Dataverse.
Para determinar onde uma regra de negócios opera, você deve especificar seu escopo.
Escopo
O escopo de uma regra de negócios define quando a lógica dessa regra é aplicada.
| Escopo | Aplica-se a |
|---|---|
| Entity(Table) | Todos os formulários principais baseados em modelo no lado do cliente e alterações de dados no lado do servidor. Esse é o padrão ao criar uma nova regra de negócios. |
| Todos os formulários | Todos os formulários principais baseados em modelo e o formulário de criação rápida |
| Específico do formulário | Somente o formulário principal específico baseado em modelo |
Dica
Para usar uma regra de negócios com um aplicativo de tela, defina o escopo como Entidade.
Regras de negócios e formulários de aplicativos baseados em modelo
As regras de negócios foram originalmente desenvolvidas para substituir o JavaScript simples em formulários de aplicativos baseados em modelo. É um requisito comum manipular propriedades e colunas de valores no formulário em runtime com base nos valores inseridos ou selecionados pelo usuário em outras colunas.
Em formulários de aplicativos baseados em modelo, as regras de negócios podem:
Mostrar ou ocultar uma coluna
Tornar a coluna editável ou somente leitura
Alterar o nível de requisito de uma coluna
Oferecer uma recomendação ao usuário
Definir ou limpar o valor em uma coluna
Importante
As regras de negócios só podem executar ações nas colunas da tabela do formulário e não podem alterar as propriedades de seções ou guias.
Essas ações são executadas quando:
O formulário é aberto.
Quando o valor de uma coluna referenciada pela regra é alterado.
Observação
As regras de negócios não são aplicadas no evento salvar do formulário.
Devo usar uma regra de negócios ou scripts no lado do cliente com JavaScript?
JavaScript pode ser usado em formulários de aplicativos baseados em modelo para executar muitas das ações que as regras de negócios podem realizar, mas você pode conseguir muito mais com scripts do lado do cliente:
O JavaScript tem acesso total para manipular todos os tipos de controles de formulário, inclusive guias, seções e subgrades. As ações nas regras de negócios são limitadas apenas às colunas da tabela.
As regras de negócios só podem acessar as colunas no formulário/tabela e não podem acessar as linhas em relacionamentos um para muitos ou muitos para um. Com scripts do lado do cliente, você pode usar a API Web para acessar linhas nesses relacionamentos.
As regras de negócios são limitadas em suas fórmulas à simples adição, subtração, divisão ou multiplicação de duas colunas.
As recomendações estão disponíveis apenas em regras de negócios.
Regras de negócios no lado do servidor
Quando o escopo da regra de negócios é definido como Entidade, as condições da regra são avaliadas quando a linha é salva. A lógica é executada durante o estágio de pré-operação da transação do banco de dados. Uma regra de negócios que mostre uma mensagem de erro impedirá o salvamento e a reversão da transação do banco de dados.
Observação
As ações que se aplicam apenas a aplicativos baseados em modelo serão ignoradas quando a regra for executada no servidor.