Aba Regras do App Workbench no Jitterbit App Builder

Regras é a terceira aba no App Workbench. É a primeira aba que se relaciona com a camada de negócios da sua aplicação e é onde você cria regras de negócios.

A imagem abaixo ilustra a aba Regras de uma aplicação que possui uma regra de negócios configurada:

Na aba Regras, as informações estão divididas em dois painéis:

• A Fontes de Dados do App mostra um menu suspenso com todas as fontes de dados conectadas à aplicação atual. A fonte de dados principal é selecionada por padrão. As regras de negócios mostradas na próxima seção serão aquelas baseadas nas tabelas presentes nessa fonte de dados. Ao lado do menu suspenso, há opções para filtrar a lista de regras:

  • Todas as Regras: Mostra todas as regras de negócios.

  • Por Tabela: Filtra as regras de negócios por tabela.

  • Com Alcance: Mostra apenas as regras de negócios que utilizam alcance.

  • Todos os Eventos: Mostra todas as regras de negócios que têm um evento associado.

  • Eventos em Segundo Plano: Mostra apenas as regras de negócios que têm um evento em segundo plano associado.

• O painel Regras contém:

  • + Regra: Clique para abrir o Construtor de Regras, onde você pode adicionar uma nova regra de negócios.

  • Validação de Regras: Clique para validar as regras atuais.

  • Uma lista de todas as regras de negócios atuais. A lista pode ser filtrada usando o ícone de filtro e a barra de pesquisa permite que você procure uma regra pelo seu nome. Cada linha da lista contém:

    • Um ícone de lixo para excluir a regra de negócios.

    • Nome: O nome da regra de negócios. Deve ser único dentro da fonte de dados selecionada.

    • Alvo: O alvo ou regra que esta regra de negócios referencia.

    • Tipo: Define o tipo ou propósito da regra de negócio.

    • Alterado Em: Mostra quando a modificação mais recente da regra de negócio ocorreu.

    • Eventos: Clique no ícone de pasta para configurar os eventos, ações ou validações associadas à regra de negócio.

    • Resultados: Clique no ícone de tabela para ver uma visão de todos os registros disponíveis na regra de negócio.

    • Funções: Clique no ícone de perfil de usuário para configurar as permissões de Leitura, Inserir, Atualizar e Excluir.

    • Alcance: Indica com um checkmark verde se a regra de negócio utiliza alcance.

    • Status: Indica com um checkmark verde ou vermelho se os resultados foram executados após a edição mais recente da regra de negócio.

    • Clique no ícone de caneta para editar a regra de negócio.

Criar uma regra de negócio

Para criar uma nova regra de negócio na aba Regras do App Workbench, clique no botão + Regra no painel Regras. O Construtor de Regras será aberto em modo de criação:

Insira informações básicas sobre a nova regra de negócio no painel Regra:

• Nome: Insira um nome para a regra de negócio. Deve ser único para cada fonte de dados.

• Propósito: Use o menu suspenso para definir o uso pretendido da regra de negócio. Ao selecionar um propósito, dois novos campos aparecem:

  • Fonte da Fonte de Dados: Selecione a fonte de dados que contém a tabela que você deseja referenciar.

  • Alvo: Selecione a tabela que a regra de negócio deve referenciar.

• Ajuda Técnica: Uma caixa de texto onde você pode inserir informações adicionais para outros desenvolvedores de aplicativos sobre a regra de negócio. Este texto não é visto pelos usuários do aplicativo.

• Criar: Clique para criar a nova regra de negócio. Após clicar, o Construtor de Regras entrará em modo de edição e você poderá editar a nova regra como as existentes.

Editar uma regra de negócios

Para editar uma regra de negócios, localize-a na lista sob o painel Regras e clique no ícone de caneta . O Construtor de Regras será aberto em modo de edição:

O painel Regra apresenta as seguintes opções:

• Resultados: Clique para ver uma visualização de todos os registros disponíveis na regra de negócios.

• + Regra: Clique para adicionar uma nova regra.

• Mais: Clique para ver opções avançadas.

• Você pode ver vários campos em modo de edição que também estão no modo de criação, com estas opções adicionais:

  • Ao lado do campo Alvo, há um ícone . Clique nele para ir à página de Definição da Tabela na camada de dados, onde você pode editar o banco de dados atualmente selecionado no campo Alvo.

  • Eventos: Clique para configurar os eventos, ações ou validações associadas à regra.

  • Papéis: Clique para abrir o diálogo Papéis, onde você pode configurar e manter segurança baseada em papéis ou níveis de permissão para a regra de negócios.

O painel principal exibe várias abas que você pode usar para configurar a regra de negócios:

• Na aba Tabelas, você pode configurar e modificar o relacionamento entre a regra de negócios e suas tabelas.

  • + Tabela: Clique para adicionar uma tabela à regra de negócios. Um diálogo se abre com uma lista de todas as tabelas. Você pode adicionar tabelas da fonte de dados atual ou de outras fontes.

  • + Coluna: Clique para adicionar uma nova coluna. Um diálogo se abre onde você pode selecionar uma função, escolher um alias, entre outras configurações.

  • As colunas da tabela selecionada são listadas. Você pode selecionar ou desmarcar colunas individuais para incluí-las ou excluí-las da regra de negócios.

• Na aba Colunas, há uma visualização detalhada das colunas.

• Na aba Onde, você pode adicionar cláusulas where para filtrar os resultados.

• Na aba Joins, você pode adicionar ou editar joins.

• Na aba SQL, há uma visualização da instrução SQL que está sendo gerada.

• Na aba Resultados, há uma lista dos resultados que estão sendo retornados.

Opções avançadas

Opções de configuração adicionais para a regra de negócios estão disponíveis clicando no botão Mais próximo ao topo do painel Regra. Clique nele para mostrar as seguintes opções avançadas:

• Caso Excepcional: Clique para configurar configurações adicionais e avançadas usando a caixa de diálogo Configurações de Caso Excepcional:

  

  As seguintes opções estão disponíveis para seleção. Clique nas caixas de seleção para ativar e desativar ou clique no menu suspenso para escolher:

  • Limite: Insira um número inteiro para limitar o número de registros retornados.

  • Selecionar Distintos: Ative para fazer a regra retornar apenas valores distintos (ou diferentes).

  • Desativar Resultados Automáticos: Ative para ocultar a visualização rápida em grade dos resultados na parte inferior da tela.

  • Herdar Eventos Automaticamente: Ative para manter eventos sincronizados com a regra de negócios.

  • Versão da Expressão: A versão usada para interpretar as expressões utilizadas nesta regra.

  Os seguintes botões permitem que você configure recursos adicionais:

  • Padrões: Clique para abrir a caixa de diálogo Padrões, onde você pode configurar e manter lógica de padrão dinâmica para controlar a exibição da camada de UI. Quando você faz isso, este botão também se torna disponível no construtor de regras e mostra quantos padrões você está usando atualmente.

  • Alcance: Clique para configurar e usar o recurso de alcance. Quando você faz isso, este botão também se torna disponível no construtor de regras e mostra quantas regras de alcance você está usando atualmente.

  • Resultados Rápidos: Clique para abrir a página Rápido Dinâmico, onde você pode ver os resultados da regra em um formato de grade rápida.

Na seção Permitir Acesso Público, você pode configurar o nível de acesso à sua regra:

• Leitura: Selecione para tornar a regra acessível como um objeto Somente leitura em uma regra CRUD.

• Gravação: Selecione para tornar a regra acessível como um objeto de Gravação em uma regra CRUD.

(Opicional) Insira texto na caixa de texto Ajuda Técnica para ajudar outros desenvolvedores de aplicativos. Este texto não é visto pelos usuários do aplicativo.

• Copiar Regra: Clique para criar uma cópia da regra no aplicativo. Um diálogo se abre onde você pode selecionar opções para copiar os eventos ou papéis da regra.

• Onde Usado: Clique para ver a página Onde Tabela Usada, onde você pode ver uma visão geral de todos os lugares na aplicação atual onde a regra é usada.

• Captura: Clique para tirar uma captura da regra. Mais tarde, você pode restaurar a regra para o estado da captura, mantendo todas as configurações.

• Registro de Alterações: Clique para ver um diálogo contendo uma lista de todas as alterações feitas na regra, incluindo quem fez as alterações e quando.

• Deletar Regra: Clique para deletar a regra. Você será solicitado a confirmar que deseja prosseguir.