Folha de Referências 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 no Vinyl, o que são e por que você as usa.
Chamada de API¶
API Call é um tipo de regra disponível no Vinyl para uso ao chamar um endpoint de API. A seleção desta regra limitará os resultados do Target apenas aos endpoints da API REST.
Objeto de Negócios¶
Objeto de Negócios é o tipo de Regra de Negócios usado com mais frequência em aplicações Vinyl. Este tipo de regra permite usar eventos e vincular lógica simples ou complexa por meio de ações e validações. Business Objects são usados principalmente para construir a camada UI em um aplicativo. Business Objects podem usar subconsultas como parte de sua lógica.
Source
e List
Existem dois exemplos comuns de Business Objects:
-
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 UI do aplicativo. -
List
: Traduz o valor do ID da chave primária em um valor de coluna de título amigável. Listar objetos pode ser usado quando você deseja exibir dados para o usuário final que podem não estar disponíveis na tabela. Os objetos de lista geralmente apresentam informações na forma de um menu suspenso que um usuário pode selecionar.
Calendário¶
Calendário As regras de negócios são usadas para criar a lógica de negócios para um calendário que será exibido na camada de UI. A vantagem de criar uma regra com o tipo Calendário é que você pode configurar e organizar quaisquer atributos necessários do Calendário no nível da regra definindo Tipo de uso.
Valores de tipo de uso:
Color
Description
End
Sort
Start
Gráfico¶
Gráfico As regras de negócios são usadas para criar a lógica de negócios para um gráfico que será exibido na camada de UI do aplicativo. A vantagem de criar uma regra com 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ê deseja 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 Target. As regras de negócios CRUD são criadas e definidas na camada de lógica de negócios.
Camada de negócios CRUD As regras executarão sua regra na camada de lógica de negócios, o que significa que fará com que todas as ações e validações na tabela ou objeto que você está modificando sejam executadas.
XP CRUD Regras significam CRUD de plataforma cruzada e são usadas quando você deseja usar CRUD entre duas fontes de dados diferentes.
É necessário definir uma ação para uma regra CRUD, dependendo do que você deseja alcançar
Update
- modificar registros existentes na tabela TargetDelete
- exclui registros existentes na tabela TargetInsert
- cria novos registros na tabela TargetCram
- semelhante a Insert, mas não falhará se já existir uma chave primária. O que significa que só criará um novo registro se o PK não existir na fonte de dados e ignorará 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 UI de 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 proporcionar uma melhor experiência ao Usuário. Um exemplo comum é padronizar um campo Data para um novo registro adicionado hoje.
Gantt¶
Gantt As 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 UI. A vantagem 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 de tipo de uso:
Color
Dependency
End
JSON Options Object
Parent Task
Sort
Start
Task
Task Group
Lista¶
Lista As regras de negócios são usadas para preencher listas de seleção da camada de UI em um aplicativo. As regras de lista não possuem ações ou validações associadas. A vantagem 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¶
Mapa As regras de negócios são usadas para criar a lógica de negócios para um mapa que será exibido na camada de UI. A vantagem de criar uma regra com tipo de 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 As regras são executadas quando uma versão é instalada em um novo servidor. Eles são definidos como uma regra CRUD e executados 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. Estas regras são adicionadas às etapas do Change Management que são executadas em ordem ao publicar um LP em Vinyl em um novo ambiente. Quando uma regra de migração é executada, o Vinyl tira um instantâneo da regra e a incorpora no conjunto de alterações. A Regra de Migração é excluída após ser executada como Regra de Migração. Essas regras são usadas principalmente ao mover aplicativos do desenvolvimento para o controle de qualidade e para a produção.
Gráfico de Rede¶
Gráfico de rede As 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 UI de um aplicativo. A vantagem de usar esse tipo de regra é que ele possui tipos de uso de coluna associados apropriados para o Network Graph. Quando você usa isso na camada da interface do usuário, os valores serão padronizados com base nos tipos de uso.
Notificação¶
Uma regra comercial de Notificação permite que o Vinyl envie uma mensagem a um usuário. As mensagens podem ser enviadas por Email, notificações push, mensagens de texto ou alertas de Vinyl (notificações no aplicativo). As notificações suportam anexos de qualquer tipo de arquivo.
Pivô¶
Pivot As regras são usadas para exibir uma tabela dinâmica em um aplicativo. Esse tipo de regra permite nivelar uma tabela de conjunto de dados. As regras dinâmicas resumem dados relacionados que se estendem por várias linhas e os apresentam em uma única linha. Esta saída ajuda a chamar a atenção para informações úteis.
Relatório¶
Relatório As regras de negócios permitem configurar a lógica de negócios sem quaisquer eventos associados. Este tipo de regra destina-se a diferentes requisitos de relatório na camada de UI, por exemplo, pode ser usado para um gráfico, painel de grade ou pivô.
Alcançar¶
Reach As regras de negócios permitem restringir dados aos quais determinados 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ê poderia usar o Reach, por exemplo, se quisesse fornecer a um usuário de vendas acesso apenas aos dados de acordo com a 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. As subconsultas por si só não são expostas à camada de UI do aplicativo e não oferecem suporte a eventos de lógica de negócios. Eles normalmente são usados para ajustar dados, realizar lógicas 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. Eles podem ser executados em dados inseridos manualmente e impedir que um usuário adicione registros que violem a lógica de negócios (por exemplo, registros duplicados). As 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 a 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 As regras de negócios determinam o estado de um controle na camada de UI, ou seja, quais controles estão ocultos, obrigatórios ou 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. Esses tipos de regras só podem ser configurados para um painel Formulário.
Webhook¶
Um Webhook é usado para permitir que qualquer sistema invoque eventos de retorno de chamada personalizados no Vinyl. Um Webhook é um retorno de chamada HTTP definido pelo usuário e normalmente é acionado por um Evento. Se um Webhook estiver sendo usado na forma de Email ou mensagem de texto, dependendo da resposta do usuário, o Vinyl responderá adequadamente invocando o Evento especificado.
XP Bruto¶
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 regra de validação XP é 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.