Criar uma regra de negócios para uma tabela

Artigo
12/04/2023

Você pode criar regras de negócios e recomendações para aplicar lógica e validações sem escrever código ou criar plug-in. As regras de negócios fornecem uma interface simples para implementar e manter regras comumente usadas e em constante mudança.

Importante

As regras de negócios definidas para uma tabela se aplicarão a apps de tela e apps controlados por modelo se a tabela for usada no app. Nem todas as ações de regra comercial estão disponíveis nos apps de tela no momento. Mais informações: Diferenças entre apps de tela e controlados por modelo

Em um aplicativo baseado em modelo, nem todas as ações de regra de negócios estão disponíveis para grades editáveis. Nas páginas de exibição baseadas em tabela, não é possível criar recomendações. As subgrades editáveis não oferecem suporte a regras de negócios. As regras de negócios não funcionarão com outros tipos de controles de conjunto de dados.

Para definir uma regra de negócios que se aplique a um formulário em um app controlado por modelo, consulte Criar regras de negócios para aplicar a lógica a um formulário de app controlado por modelo.

Combinando condições e ações, é possível fazer qualquer uma das ações a seguir com regras de negócios:

Definir valores de coluna
Limpar valores de coluna
Definir níveis de requisitos de coluna
Mostrar ou ocultar colunas
Habilitar ou desabilitar colunas
Validar dados e mostrar mensagens de erro
Criar recomendações de negócios com base em business intelligence.

Diferenças entre apps de tela e controlados por modelo

Os formulários em aplicativos baseados em modelos podem usar todas as ações disponíveis nas regras de negócios, no entanto, nem todas as ações de regras de negócios estão disponíveis para aplicativos de tela no momento. As ações a seguir não estão disponíveis nos aplicativos de tela:

Mostrar ou ocultar colunas
Habilitar ou desabilitar colunas
Criar recomendações de negócios com base em business intelligence.

Suporte ao tipo de coluna com regras de negócios

As regras de negócios funcionam com a maioria dos tipos de coluna, incluindo texto, número, escolha, data, pesquisa, proprietário e imagem. No entanto, as regras de negócios não funcionam com os seguintes tipos de coluna:

Escolhas (seleção de múltipla)
Arquivo
Linguagem

Criar uma regra de negócios

Entre no Power Apps e, no painel de navegação à esquerda, selecione Tabelas. Se o item não estiver no painel lateral, selecione …Mais e selecione o item desejado.
Abra a tabela para a qual você deseja criar a regra empresarial (por exemplo, abra a tabela Conta), e selecione a guia Regras de Negócios.
Selecione Adicionar regra de negócios.

A janela do designer de regra de negócios será aberta com uma única condição já criada para você. Cada regra começa com uma condição. A regra empresarial leva uma ou mais ações com base nessa condição.

Dica

Se você deseja modificar uma regra de negócios existente, deve desativá-la para poder modificar.
Adicione uma descrição, se desejar, na caixa descrição no canto superior esquerdo da janela.

Defina o escopo, de acordo com o seguinte:

Se você selecionar esse item...	O escopo será definido como...
Entidade	Formulários e servidor do aplicativo baseado em modelo
Todos os Formulários	Formulários do aplicativo baseado em modelo
Formulário específico (Formulário de Conta, por exemplo)	Apenas esse formulário do aplicativo baseado em modelo

Dica

Se estiver criando um aplicativo de tela, utilize tabela como o escopo.

Adicione condições. Para adicionar mais condições à sua regra de negócios:
1. Arraste o componente Condição da guia Componentes para um sinal de mais no criador.
2. Para definir propriedades para a condição, selecione o componente Condição na janela de criação e, depois, defina as propriedades na guia Propriedades à direita da tela. Ao definir as propriedades, o Microsoft Dataverse cria uma expressão na parte inferior da guia Propriedades.
3. Para adicionar uma cláusula adicional (uma E ou OU) à condição, selecione Novo na guia Propriedades para criar uma nova regra, e definir as propriedades para aquela regra. Na coluna Lógica de regra, você pode especificar se adiciona a nova regra como um E ou OU.
4. Quando terminar de definir propriedades para a condição, selecione Aplicar.
Adicione ações. Para adicionar uma ação:
1. Arraste um dos componentes de ação da guia Componentes para um sinal de mais próximo ao componente Condição. Arraste a ação para o sinal de adição juntamente com uma marca de seleção se quiser que a regra do para executar essa ação se a condição for atendida, ou um sinal de adição de um lado a x se desejar que a regra do para executar essa ação não se a condição for atendida.
2. Para definir propriedades da ação, selecione o componente Ação na janela de criação e defina as propriedades na guia Propriedades.
3. Quando terminar de definir as propriedades, selecione Aplicar.
Adicione uma recomendação de negócios (somente aplicativos baseados em modelo). Para adicionar uma recomendação de negócios:
1. Arraste o componente Recomendação da guia Componentes para um sinal de mais próximo ao componente Condição. Arraste o componente Recomendação no sinal de adição juntamente com uma marca de seleção se quiser que a regra do para executar essa ação se a condição for atendida, ou um sinal de adição de um lado a x se desejar que a regra do para executar essa ação não se a condição for atendida.
2. Para definir propriedades para a recomendação, selecione o componente Recomendação na janela de criação, e então defina as propriedades na guia Propriedades.
3. Para adicionar mais ações à recomendação, arraste-as para a guia Componentes, e defina as propriedades para cada ação na guia Propriedades.
  
  Observação
  
  Quando você cria uma recomendação, o Dataverse adicionar uma ação única, por padrão. Para ver todas ações em uma recomendação, selecione Detalhes no componente Recomendação.
4. Quando terminar de definir as propriedades, selecione Aplicar.
Para validar a regra de negócios, selecione Validar na barra de ações.
Para salvar a regra de negócios, selecione Salvar na barra de ações.
Para ativar as regras de negócios, selecione-as na janela Gerenciador de Soluções, e selecione Ativar. Não será possível ativar a regra da janela de criação.
Dica

Aqui estão algumas dicas pra se ter em mente à medida que você trabalha nas regras empresariais na janela do designer:
- Para tirar um instantâneo de tudo que esteja na janela Regra de Negócios, selecione Instantâneo na barra de ações. Isso será útil, por exemplo, se deseja compartilhar e ter comentários sobre a regra empresarial para uma membro da equipe.
- Use o minimapa para navegar rápido a partes diferentes do processo. Isso é útil quando você tem um processo complicado que rola ao longo da tela.
- Durante a adição de condições, Ações e recomendações empresariais para sua regra empresarial, Dataverse cria o código para a regra empresarial na parte de baixo da janela de criação. Este código é somente leitura.

Exemplo: criar uma regra de negócios para tarefas com mais de 30 dias

Este exemplo de regra de negócios cria uma condição que aciona uma mensagem no campo de descrição da tarefa quando uma tarefa tem mais de 30 dias.

Entre no Power Apps e, no painel de navegação à esquerda, selecione Tabelas. Se o item não estiver no painel lateral, selecione …Mais e selecione o item desejado.
Abra a tabela Tarefa e selecione a área Regras de negócios.
Selecione Adicionar regra de negócios.
Selecione Nova Condição na tela do fluxo do processo empresarial e insira ou selecione as seguintes propriedades:
- Nome de exibição: a tarefa tem mais de 30 dias
- Entidade: Tarefa
- Regra 1
  - Fonte: Entidade
  - Campo: Criado em
  - Operador: +
  - Tipo: Valor
  - Dias: 30
- Expressão de Condição (criado automaticamente): (Criado em é maior que [Criado em + 30])
Selecione Aplicar.
Selecione Adicionar > Adicionar Mostrar mensagem de erro.
Na guia Mostrar propriedades da mensagem de erro, insira as seguintes propriedades:
- Nome de exibição: a tarefa tem mais de 30 dias
- Entidade: Tarefa
- Mensagem de erro:
  - Campo: Descrição
  - Mensagem: Esta tarefa tem mais de 30 dias!
Selecione Aplicar.
Selecione Salvar.

Localize as mensagens de erro usadas em regras de negócios

Se você tiver mais de um idioma provisionados para sua organização, será possível localizar qualquer mensagem de erro definida. Sempre que você define uma mensagem, uma etiqueta é gerada pelo sistema. Se você exportar traduções em sua organização, é possível adicionar versões traduzidas de mensagens e importar as etiquetas de volta para o Dataverse, de forma que as pessoas que usam idiomas diferentes do idioma base possam ver as mensagens traduzidas.

Problemas comuns

Esta seção descreve os problemas comuns que podem ocorrer ao usar regras comerciais.

Atributos compostos não compatíveis com aplicativos da Interface Unificada

Ações ou condições que usam Atributos compostos não são compatíveis com aplicativos baseados em Interface Unificada. Como alternativa, você pode usar ações ou condições nos atributos que compõem os atributos compostos. Por exemplo, em vez de usar o atributo Nome Completo (fullname), você pode usar os atributos Nome (firstname) e Sobrenome (lastname).

Um grande número de regras de negócios em uma única tabela afeta o desempenho

Regras de negócios novas ou existentes em uma tabela podem degradar o desempenho quando as regras são ativadas. Atualmente, o Power Platform dá suporte a até 150 regras de negócios para uma única tabela. Além de 150 regras de negócios, pode haver degradação do desempenho. Esse limite inclui regras de negócios do lado do cliente (JavaScript) e do lado do servidor (XAML gerado como plugins síncronos). Para evitar problemas de desempenho no Dataverse, é recomendável não criar mais de 150 regras de negócios para uma única tabela.

Sua regra de negócios não está sendo acionada para um formulário?

Uma regra de negócios não pode ser executada porque o campo referenciado na regra de negócios não está incluído com o formulário.

Abra o gerenciador de soluções. Expanda a entidade que você deseja e depois selecione Formulários.
Abra o formulário que deseja e depois, no designer de formulários, selecione Regras de Negócios.
No designer de formulários, abra a regra de negócios.
No designer regra de negócios, selecione cada condição e ação para verificar todos os campos referenciados em cada condição e ação.
Verifique se cada campo referenciado na regra de negócios também está incluída no formulário. Se não, adicione o campo ausente ao formulário.

Perguntas frequentes

As regras de negócios podem desbloquear campos em um formulário somente leitura?

Sim, uma regra de negócios pode desbloquear campos e editar ações em um formulário somente leitura.

Como faço para solucionar problemas de uma regra de negócios que não está funcionando?

Consulte Sua regra de negócios não está acionando um formulário? neste artigo.

As regras de negócios reagem às alterações feitas por um script onLoad?

Não, elas serão executadas antes que um script onload seja executado.

Quando eu atualizo uma regra de negócios, ela é executada em todos os registros existentes?

Não. As regras de negócios são executadas nos clientes. Por exemplo, elas são executadas quando um formulário é aberto por um usuário e quando o valor de um campo é alterado nesse formulário aberto. Elas não são executadas dentro do Dataverse.

Confira também

Aplicar lógica de negócios no Microsoft Dataverse

Observação

Você pode nos falar mais sobre suas preferências de idioma para documentação? Faça uma pesquisa rápida. (Observe que esta pesquisa está em inglês)

A pesquisa levará cerca de sete minutos. Nenhum dado pessoal é coletado (política de privacidade).