Ir para o conteúdo

Gerenciar regras no Jitterbit App Builder

Introdução

As regras são gerenciadas na página Regras. Para abri-la, selecione App Workbench > Regras:

Página de regras

A partir daqui, você pode fazer o seguinte:

Ver regras

Quando você abre a página Regras, a aba Todas as Regras é selecionada por padrão. Isso mostra todas as regras para o aplicativo atual e a fonte de dados do aplicativo selecionado. As outras abas são as seguintes:

  • Por Tabela: Ver ou criar regras com base nas tabelas da fonte de dados selecionada.
  • Com Alcance: Ver regras com base nas regras de alcance para as tabelas da fonte de dados selecionada.

As duas próximas abas enfatizam a estreita relação entre regras e eventos:

  • Todos os Eventos: Mostrar todos os eventos para o aplicativo atual.
  • Eventos em Segundo Plano: Mostrar todos os eventos em segundo plano para o aplicativo atual.

Dica

Quando você tiver um grande número de regras em seu aplicativo, use a barra de pesquisa para procurar regras, clique no ícone Aplicar Filtro para filtrar o conteúdo da tabela ou clique em um cabeçalho de coluna Nome, Alvo, Tipo ou Alterado Em para classificar a tabela por essa coluna.

Criar uma regra

Para criar uma regra, clique no botão + Regra na seção Regras. Isso abre a página Construtor de Regras:

Construtor de regras

Para continuar, siga estas etapas:

  1. No campo Nome, insira um nome para sua regra.
  2. (Opcional) No campo Ajuda Técnica, insira uma descrição para a regra. Este texto é visível apenas para desenvolvedores de aplicativos.
  3. Clique no menu Finalidade, em seguida, selecione uma das opções de finalidade. Dependendo da sua escolha, configurações adicionais são exibidas. As opções disponíveis estão mostradas na tabela a seguir:

    Categoria Finalidade Fonte de Dados Fonte de Dados de Destino Alvo Camada de Destino Ação Tipo de Gráfico Método de Entrega
    Básico Objeto de Negócio
    CRUD
    Validação
    Visibilidade
    Relatório Calendário
    Gráfico
    Gantt
    Mapa
    Gráfico de Rede
    Relatório
    Pivot
    Caso Limite Chamada de API
    Notificação
    Padrão
    Lista
    Migração
    Alcance
    Subconsulta
    Webhook
    Validação XP
    XP CRUD
  4. Clique no botão Criar.

  5. Use o construtor de regras visual para adicionar as tabelas e colunas necessárias para sua regra.
  6. Quando terminar, clique no botão Validar para verificar a regra.

Editar uma regra

Para editar uma regra, siga estas etapas:

  1. Clique no ícone Editar ao lado da regra que você deseja editar. A página Construtor de Regras será aberta.
  2. Edite a regra. O layout e os controles são os mesmos que ao criar uma regra. As alterações na regra são efetivas imediatamente.
  3. (Opcional) Clique no botão Validar para verificar a regra antes de fechar a página.

Construtor de regras visual

Quando você cria ou edita uma regra, a página Construtor de Regras se divide em duas regiões: uma onde você define o nome e o propósito da regra; a outra, composta por um conjunto de abas, onde você define a própria regra. A aba padrão é a aba Tabelas (também conhecida como Construtor de Regras Visual).

A aba Tabelas é uma tela onde você interage com representações gráficas das tabelas, colunas, junções e outras regras que formam a regra que você está trabalhando. Dependendo do propósito da regra, uma tabela pode ser adicionada automaticamente à tela.

Você pode interagir com as imagens na tela das seguintes maneiras:

  • Clique e segure o rótulo de uma tabela para movê-la pela tela.
  • Use os controles de visualização e para aumentar ou diminuir o zoom da visualização da tela.
  • Arraste e solte colunas de uma tabela para outra para criar junções. Estas aparecem na aba Junções.
  • Clique no botão + Tabelas para adicionar tabelas à regra.
  • Clique no botão + Coluna para adicionar uma coluna à regra.
  • Clique no ícone Remover para remover uma tabela da regra.
  • Clique na barra de título da tabela para abrir uma página pop-up onde você pode fazer o seguinte:
    • Definir a ordem da tabela na consulta.
    • Selecionar uma tabela diferente.
    • Definir o alias usado para referenciar a tabela nas consultas.
    • Selecionar todas as colunas.
    • Editar a tabela na página Definição da Tabela.
    • Ver os resultados da consulta na tabela.

Os guias restantes têm as seguintes funções:

  • Guia Colunas: Uma lista de colunas usadas pela regra.
  • Guia Onde: Uma lista de cláusulas SQL where usadas pela regra.
  • Junções: Uma lista de junções de tabelas usadas pela regra.
  • SQL: A instrução SQL que forma a regra.
  • Resultados: O resultado da execução da instrução SQL. Clique no ícone Salvar como CSV para baixar os resultados como um arquivo .csv.

Excluir uma regra

Para excluir uma regra, clique no ícone Excluir ao lado da regra que você deseja excluir e, em seguida, clique no botão Prosseguir para confirmar.

Propósito da regra

O que uma regra pode fazer e como ela é configurada depende de seu propósito. Ao criar uma regra, você deve selecionar um dos seguintes propósitos. Esta seção descreve cada um.

Chamada de API

Chamar um endpoint de API. Selecione esta regra para limitar os resultados alvo apenas a endpoints de API REST.

Objeto de negócio

Qualquer número de eventos ou subconsultas de regra, usados principalmente para construir a camada de UI de um aplicativo. Fonte e Lista são dois exemplos comuns de objetos de negócio:

  • Fonte: Mostra todas as linhas e colunas de uma tabela na camada de dados. Referencia uma tabela e não deve incluir filtros. Objetos de fonte são frequentemente usados quando você precisa criar uma expressão ou função sobre os dados subjacentes para apresentá-los na camada de UI do aplicativo.

  • Lista: Traduz o valor da chave primária ID para um valor de coluna de título 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 frequentemente apresentam informações na forma de um menu suspenso que um usuário pode selecionar.

Calendário

Lógica de negócios para um calendário na camada de UI. Os atributos são definidos no nível da regra através dos seguintes valores de Tipo de Uso:

  • Cor
  • Descrição
  • Fim
  • Ordenar
  • Início

Chart

Lógica de negócios para um gráfico na camada de UI. Os atributos são definidos no nível da regra através dos seguintes valores de Tipo de Uso:

  • Categoria
  • Cor
  • Sinalizador
  • Objeto de Opções JSON
  • Ordenar
  • Valor

CRUD

Atualizar, excluir ou inserir dados. A ação selecionada define como a regra impacta os registros da tabela de destino.

As regras CRUD são executadas na camada de lógica de negócios e fazem com que todas as ações e validações na tabela ou objeto que você está modificando sejam executadas. (Use uma regra XP CRUD quando quiser usar CRUD entre duas fontes de dados diferentes.)

Default

Use uma regra padrão para melhorar a experiência do usuário definindo valores padrão em campos nos níveis de dados, negócios ou UI. Um exemplo comum é definir um campo de data para um novo registro adicionado com a data de hoje.

Gantt

Lógica de negócios para um gráfico de Gantt na camada de UI. Os atributos são definidos no nível da regra através dos seguintes valores de Tipo de Uso:

  • Cor
  • Dependência
  • Fim
  • Objeto de Opções JSON
  • Tarefa Pai
  • Ordenar
  • Início
  • Tarefa
  • Grupo de Tarefas

List

Preencher listas selecionadas na camada de UI. As regras de lista não têm ações ou validações associadas. Os atributos são definidos no nível da regra através dos seguintes valores de Tipo de Uso:

  • Chave
  • Título
  • Subtítulo

Map

Lógica de negócios para um mapa na camada de UI. Os atributos são definidos no nível da regra através dos seguintes valores de Tipo de Uso:

  • Categoria
  • Cor
  • Objeto de Opções JSON
  • Valor

Migration

Uma regra de migração é executada quando uma versão é instalada em um novo servidor. Seu uso principal é para mover aplicativos do desenvolvimento para QA e do QA para ambientes de produção. As regras são adicionadas aos passos de gerenciamento de mudanças executados ao publicar um LP em um novo ambiente. Quando uma regra de migração é executada, o App Builder tira uma captura da regra e a incorpora no conjunto de mudanças. A regra de migração é excluída após a execução.

Gráfico de rede

Lógica de negócios para um gráfico de rede na camada de interface do usuário.

Notificação

Envie uma mensagem para um usuário. As mensagens podem ser enviadas por email, notificações push, SMS (mensagens de texto) ou alertas no aplicativo App Builder. As notificações suportam anexos de qualquer tipo de arquivo.

Tabela dinâmica

Exiba uma tabela dinâmica (conjunto de dados achatado). As regras de tabela dinâmica resumem dados relacionados que se estendem por várias linhas e os apresentam em uma única linha. Essa saída ajuda a chamar a atenção para informações úteis.

Alcance

Use uma regra de alcance para restringir o acesso de um usuário a dados em páginas sem restringir o acesso às próprias páginas.

Relatório

Use para configurar lógica de negócios sem eventos associados. Este tipo de regra é destinado a diferentes requisitos de relatório na camada de interface do usuário (por exemplo, para um gráfico, painel de grade ou tabela dinâmica).

Subconsulta

Regras de subconsulta são regras que podem residir dentro de outras regras de negócios. Subconsultas por si só não são expostas à camada de interface do usuário do aplicativo e não suportam eventos de lógica de negócios. Elas são tipicamente usadas para ajustar dados, realizar lógica mais complexa ou para cálculos em dados.

Dica

Ao projetar subconsultas, mantenha a lógica o mais simples e plana possível.

Validação

Regras de validação protegem a integridade dos dados. Por exemplo, você pode usá-las para impor lógica de negócios na entrada manual. Se uma regra CRUD for definida, as validações também são executadas quando essa regra CRUD é acionada. As mensagens de validação exibidas aos usuários são configuráveis e podem usar substituição dinâmica para melhorar a experiência do usuário.

Leitura adicional

Dicas de validação

Visibilidade

Determine o estado de um controle na camada de interface do usuário: quais controles estão ocultos, são obrigatórios ou estão disponíveis para edição. Regras de visibilidade simplificam o design da página e melhoram a experiência do usuário. (Essa regra só pode ser configurada para um painel de formulário.)

Webhook

Permite que um sistema separado invoque um evento de callback personalizado do App Builder. Um webhook é um callback HTTP definido pelo usuário que é tipicamente 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, o App Builder responde de acordo, invocando o evento especificado.

XP CRUD

Executa uma regra CRUD em fontes de dados. Regras do tipo XP são projetadas para permitir que a lógica seja executada em diferentes fontes de dados.

XP validation

Executa uma regra de validação em fontes de dados. Regras do tipo XP são projetadas para permitir que a lógica seja executada em diferentes fontes de dados.

Additional settings

Quando você seleciona um propósito de regra, uma ou mais das seguintes configurações adicionais são exibidas.

Action

As opções de ação são as seguintes:

  • Cram: Semelhante a inserir, mas não falha se uma chave primária já existir. Um novo registro é criado apenas se a PK não existir na fonte de dados. Registros de chave duplicada são ignorados.
  • Delete: Exclui um registro existente na tabela de destino.
  • Insert: Cria um novo registro na tabela de destino.
  • Update: Modifica um registro existente na tabela de destino.

Chart Type

Para o propósito da regra de gráfico, os seguintes tipos de gráfico estão disponíveis:

  • 3D Bar
  • 3D Column
  • 3D Donut
  • 3D Pie
  • Area
  • Bar
  • Bubble
  • Column
  • Funnel
  • Line
  • Marimekko
  • Mixed
  • Percentage Area
  • Pie
  • Pyramid
  • Semi Circle Donut
  • Spline
  • Stacked Area
  • Stacked Bar
  • Stacked Column

Delivery Method

Os métodos de entrega para uma regra de notificação são os seguintes:

  • App Builder Alert
  • Email
  • Push Notification
  • Text Message

Source Data Source

A fonte de dados que aciona a regra.

Fonte de Dados de Destino

A fonte de dados de destino é a fonte de dados onde o destino está.

Destino

O destino é aquilo que é afetado pela regra.

Camada de Destino

As opções da camada de destino são as seguintes:

  • Camada de Dados: Selecione para escolher um destino na camada de dados.
  • Camada de Lógica: Selecione para escolher um destino na camada de lógica.