Folha de Dicas de Regras de Negócios

Introdução

Esta página fornece uma visão geral de alto nível das diferentes Regras de Negócios disponíveis em App Builder, o que são e por que você os usa.

Chamada de API

Chamada de API é um tipo de regra disponível em App Builder para uso ao chamar um endpoint de API. Selecionar esta regra limitará os resultados do Target somente aos endpoints da API REST.

Objeto de Negócios

Objeto de Negócios é o tipo de Regra de Negócios mais frequentemente usado em App Builder aplicações. Este tipo de regra permite que você use Eventos e vincule lógica simples ou complexa por meio de ações e validações. Objetos de Negócios são usados principalmente para construir a Camada de IU em um aplicativo. Objetos de Negócios podem usar Subconsultas como parte de sua lógica.

Source e List são dois exemplos comuns de Objetos de Negócios:

Source: Mostra todas as linhas e colunas de uma tabela na Camada de Dados. Faz referência a uma tabela e não deve incluir nenhum filtro. Objetos de Origem são frequentemente usados quando você precisa criar uma expressão ou função nos dados subjacentes para apresentá-los na Camada de IU do aplicativo.
List: Traduz o valor do ID da chave primária para um valor de coluna Title amigável ao usuário. Objetos de Lista podem ser usados quando você deseja exibir dados para o usuário final que podem não estar disponíveis na tabela. Objetos de Lista geralmente apresentam informações na forma de um menu suspenso que um usuário pode selecionar.

Calendário

As Regras de Negócios do Calendário são usadas para criar a lógica de negócios para um Calendário que será exibido na Camada da IU. O benefício de criar uma regra com o tipo Calendário é que você pode configurar e organizar quaisquer atributos de Calendário necessários no nível da regra definindo Tipo de Uso.

Valores do Tipo de Uso:

Color
Description
End
Sort
Start

Gráfico

Regras de negócios de gráfico são usadas para criar a lógica de negócios para um gráfico que será exibido na camada de interface do usuário no aplicativo. O benefício de criar uma regra com o tipo de gráfico é que você pode configurar e organizar quaisquer atributos de gráfico necessários no nível da regra definindo Tipo de uso.

Valores de tipo de uso:

Category
Color
Flag
JSON Options Object
Sort
Value

CRUD

Regras CRUD são usadas quando você quer Atualizar, Excluir ou Inserir dados em um aplicativo. As Ações associadas que você seleciona ao configurar (Cram, Delete, Insert, Update) definem como a regra impacta os registros da tabela de destino. As regras de negócios CRUD são criadas e definidas na camada de lógica de negócios.

As regras da camada de negócios CRUD executarão sua regra na camada de lógica de negócios, o que significa que farão com que todas as ações e validações na tabela ou objeto que você está modificando sejam executadas.

As regras de CRUD XP significam CRUD de plataforma cruzada e são usadas quando você deseja usar CRUD entre duas fontes de dados diferentes.

A ação precisa ser definida para uma regra CRUD, dependendo do que você deseja alcançar

Update - modificar registros existentes na tabela Target
Delete - exclui registros existentes na tabela Target
Insert - cria novos registros na tabela Target
Cram - semelhante a Insert, mas não falhará se uma chave primária já existir. O que significa que ele só criará um novo registro se a PK não existir na fonte de dados e pulará quaisquer registros de chave duplicados encontrados.

Padrão

Objetos Padrão são usados para informações padrão que aparecem em um campo na Camada de IU em um aplicativo e também podem ser usados nas Camadas de Dados e Lógica de Negócios. O objetivo das Regras Padrão é economizar tempo do Usuário e fornecer uma melhor experiência do Usuário. Um exemplo comum é padronizar um campo de Data para um novo registro adicionado hoje.

Gantt

Gantt Regras de Negócios são usadas para criar a lógica de negócios para um Gráfico de Gantt que será exibido na Camada de IU. O benefício de criar uma regra com o tipo Gantt é que você pode configurar e organizar quaisquer atributos necessários do Gráfico de Gantt no nível da regra definindo Tipo de Uso.

Valores do Tipo de Uso:

Color
Dependency
End
JSON Options Object
Parent Task
Sort
Start
Task
Task Group

Lista

List Regras de Negócios são usadas para preencher listas selecionadas da Camada de IU em um aplicativo. Regras de Lista não têm nenhuma Ação ou Validação associada. O benefício de criar uma regra com o tipo Lista é que você pode configurar e organizar quaisquer atributos de Lista no nível da regra definindo Tipo de Uso.

Valores de Tipo de Uso:

Key
Title
Subtitle

Mapa

Map Regras de Negócios são usadas para criar a lógica de negócios para um Mapa que será exibido na Camada de IU. O benefício de criar uma regra com o tipo Mapa é que você pode configurar e organizar quaisquer atributos de Mapa no nível da regra definindo Tipo de Uso.

Valores de Tipo de Uso:

Category
Color
JSON Options Object
Value

Migração

migração.png

Regras de migração são executadas quando uma versão é instalada em um novo servidor. Elas são definidas como uma regra CRUD e executadas no ambiente de desenvolvimento. As regras de migração permitem que um usuário modifique o banco de dados usando as ações Atualizar, Inserir, Excluir ou Cram. Essas regras são adicionadas às etapas de gerenciamento de alterações que são executadas em ordem ao publicar um LP em App Builder para um novo ambiente. Quando uma regra de migração é executada, App Builder tira um snapshot da regra e a incorpora no Changeset. A Regra de Migração é excluída após Executá-la como uma Regra de Migração. Essas regras são usadas principalmente ao mover aplicativos do Desenvolvimento para o QA e para a Produção.

Gráfico de Rede

Gráfico de rede Regras de negócios são usadas para criar a lógica de negócios para exibir um gráfico de rede na camada de IU de um aplicativo. O benefício de usar esse tipo de regra é que ele tem Tipos de uso de coluna associados apropriados para o gráfico de rede. Quando você usa isso na camada de IU, os valores serão padronizados com base nos Tipos de uso.

Notificação

Uma Notificação Regra de Negócios permite App Builder para enviar uma mensagem a um usuário. As mensagens podem ser enviadas por Email, notificações push, mensagens de texto ou App Builder alertas (notificações no aplicativo). As notificações suportam anexos de arquivos de qualquer tipo.

Pivô

Regras Pivot são usadas para exibir uma Tabela Dinâmica em um aplicativo. Esse tipo de regra permite que você achate uma tabela de conjunto de dados. Regras Pivot resumem dados relacionados que abrangem várias linhas e os apresentam em uma única linha. Essa saída ajuda a chamar a atenção para informações úteis.

Relatório

Relatório Regras de Negócios permitem que você configure a lógica de negócios sem quaisquer Eventos associados. Este tipo de regra é destinado a diferentes requisitos de relatório na Camada de IU, por exemplo, pode ser usado para um Gráfico ou Painel de Grade ou Pivot.

Alcançar

Reach Regras de Negócios permitem que você restrinja dados aos quais certos Usuários têm acesso em um aplicativo. Os usuários poderão navegar para as mesmas páginas, mas os dados exibidos em cada página serão personalizados para mostrar apenas os dados aos quais o Usuário individual tem acesso. Você pode usar o Reach, por exemplo, se quiser fornecer a um Usuário de Vendas acesso apenas aos dados de acordo com sua Região atribuída.

Subconsulta

Subconsultas são Regras de Negócios que residem em outras Regras de Negócios, como Objetos de Negócios. Subconsultas por si só não são expostas à Camada de IU do aplicativo e não oferecem suporte a Eventos de Lógica de Negócios. Elas são normalmente usadas para ajustar dados, executar lógica e/ou cálculos mais complexos em dados. Ao projetar Subconsultas, tente manter a lógica o mais plana e simples possível.

Validação

Validações são usadas para proteger a integridade dos dados. Elas podem ser executadas em dados inseridos manualmente e evitar que um Usuário adicione registros que violem a Lógica de Negócios (por exemplo, registros duplicados). Regras de Validação também podem ser usadas na Camada de Lógica de Negócios. Se uma Regra CRUD for definida como Camada de Negócios, as Validações também serão executadas quando essa Regra CRUD for executada.
As mensagens de validação apresentadas aos Usuários são configuráveis e podem aproveitar a substituição dinâmica para melhorar a experiência do Usuário.

Visibilidade

Visibilidade Regras de Negócios determinam o estado de um controle na Camada de IU, ou seja, quais controles estão ocultos, são obrigatórios ou estão disponíveis para edição. O valor agregado de uma Regra de Visibilidade é simplificar o design da página e a experiência do Usuário. Essas regras de tipo só podem ser configuradas para um painel de Formulário.

Gancho de Rede

Um Webhook é usado para permitir que qualquer sistema invoque eventos de retorno de chamada personalizados em App Builder. Um Webhook é um callback HTTP definido pelo usuário e é normalmente acionado por um Evento. Se um Webhook estiver sendo usado na forma de um Email ou mensagem de texto, dependendo da resposta do Usuário, App Builder responderá adequadamente invocando o Evento especificado.

XP CRUD

Uma regra XP CRUD é usada para criar e executar uma regra CRUD em fontes de dados. As regras do tipo XP são projetadas para permitir que a lógica seja executada em diferentes fontes de dados.

Validação XP

Uma XP Validation Rule é usada para criar e executar regras de validação em fontes de dados. As regras do tipo XP são projetadas para permitir que a lógica seja executada em diferentes fontes de dados.