Criar uma regra de negócios para uma tabela

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.

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 aplicativos de canvas e aplicativos 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 neste momento. As ações a seguir não estão disponíveis nos aplicativos Canvas:

• Mostrar ou ocultar colunas
• Habilitar ou desabilitar colunas
• Criar recomendações de negócios com base no 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 (múltipla seleção)
• Arquivo
• Linguagem

Criar uma regra de negócios

1. 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.

2. Abra a tabela para a qual você deseja criar a regra de negócios (por exemplo, abra a tabela Conta ) e selecione Regras comerciais.

3. Selecione Adicionar regra de negócios.

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

   Gorjeta

   Se você deseja modificar uma regra de negócios existente, deve desativá-la para poder modificar.

4. Adicione uma descrição, se desejar, na caixa descrição no canto superior esquerdo da janela.

5. Defina o escopo, de acordo com o seguinte:

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

   Gorjeta

   Se estiver criando um aplicativo do Canvas, utilize "tabela" como o escopo.

6. 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 designer.

      

   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, escolha 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 deseja adicionar a nova regra como um operador lógico AND (E) ou OR (OU).

      

   4. Quando terminar de definir propriedades para a condição, selecione Aplicar.

7. Adicione ações. Para adicionar uma ação:

   1. Arraste um dos componentes de ação da guia Componentes para o sinal de mais ao lado do componente Condição. Arraste a ação para um sinal de adição próximo a uma marca de seleção se desejar que a regra de negócios execute essa ação quando a condição for atendida, ou para um sinal de adição próximo a um x se desejar que a regra de negócios execute essa ação se a condição nã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.

8. 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 o sinal de mais ao lado de um componente Condição. Arraste o componente Recomendação para um sinal de adição próximo a uma marca de seleção, se quiser que a regra de negócios execute essa ação quando a condição for atendida, ou para um sinal de adição próximo a um x, se quiser que a regra de negócios execute essa ação quando a condição nã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 adiciona, por padrão, uma única açã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.

9. Para validar a regra de negócios, selecione Validar na barra de ações.

10. Para salvar a regra de negócios, selecione Salvar na barra de ações.

11. Para ativar as regras de negócios, selecione-as na janela Gerenciador de Soluções, e selecione Ativar. Você não pode ativar a regra de negócio na janela do designer.

    Gorjeta

    Aqui estão algumas dicas para ter em mente à medida que você trabalha em regras de negócios 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 desejar compartilhar a regra de negócios com um membro da equipe e obter comentários.
    • Use o minimapa para navegar rápido a partes diferentes do processo. Isso é útil quando você tem um processo complicado que sai da tela.
    • Ao adicionar condições, ações e recomendações de negócios à sua regra empresarial, o Dataverse cria o código para a regra empresarial na parte inferior da janela do designer. 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.

1. 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.
2. Abra a tabela Tarefa e selecione a área Regras de negócios.
3. Selecione Adicionar regra de negócios.
4. 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 do que [Criado em + 30])
5. Selecione Aplicar.
6. Selecione Adicionar>Adicionar Mostrar mensagem de erro.
7. 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!
8. Selecione Aplicar.
9. Selecione Salvar.

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

Caso sua organização tenha mais de um idioma disponível, convém localizar qualquer mensagem de erro que você tenha configurado. 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 problemas comuns que podem ocorrer ao usar regras de negócios.

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, pois o campo mencionado não está incluído no formulário.

1. Abra o gerenciador de soluções. Expanda a entidade que você deseja e depois selecione Formulários.

2. Abra o formulário que deseja e depois, no designer de formulários, selecione Regras de Negócios.

3. No designer de formulários, abra a regra de negócios.

4. No designer de regras de negócios, selecione cada condição e ação para verificar todos os campos referenciados em cada condição e ação.

   

5. 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.

   

Fuso horário UTC para colunas DateOnly

Quando você configura regras de negócios com as colunas DateOnly, as datas estão no fuso horário UTC por padrão, independentemente do fuso horário definido pelo usuário. Isso pode gerar resultados inesperados se você espera que os valores DateOnly se alinhem com as configurações de hora local.

Tratamento sugerido: definição independente de fuso horário – Para tornar as DateOnly colunas independentes de fusos horários e exibir as datas em paridade com o que foi configurado na regra de negócios, como UTC, por exemplo, você pode habilitar a definição Independente de Fuso Horário. Para obter mais informações sobre como definir configurações de tratamento de data, vá para Especificar o comportamento de uma coluna de data e hora.

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 dispositivos 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.

Ver também

Aplicar lógica de negócios no Microsoft Dataverse