Ir para o conteúdo

Regras padrão no Jitterbit App Builder

As regras Padrão são uma finalidade de regra usada para preencher automaticamente um ou mais campos com um valor. Por exemplo, uma regra Padrão pode definir um campo Data para a data de hoje, ou definir um campo Preço com base em um valor procurado em uma tabela relacionada.

Um exemplo completo com valores de demonstração para criar uma regra Padrão e registrá-la em um painel pode ser encontrado na seção Regras padrão de Introdução ao App Builder - Lição 7: Mais sobre regras.

Criar uma regra Padrão

  1. Em App Workbench > Rules, clique em + Rule. O Rule Builder abre.

  2. Seguindo as convenções de nomenclatura do App Builder, insira um nome para a regra, usando o padrão NomeDaTabela (Padrão NomeColuna).

  3. No campo Purpose, role para localizar a opção Default em Edge Case e selecione-a.

    Finalidade da regra padrão

  4. No campo Target, selecione a tabela ou objeto de negócio ao qual os valores padrão devem se aplicar. Veja Direcionar uma tabela ou um objeto de negócio abaixo para decidir qual usar.

  5. Clique em Create. O App Builder levará alguns momentos para criar a regra.

  6. Na aba Columns, adicione a lógica que determina o valor padrão para cada coluna que deseja padronizar. Por exemplo, clique em + Column e insira a expressão Now() para padronizar um campo de data para a data e hora atual usando a função de banco de dados Now(), ou adicione uma tabela relacionada na aba Tables e selecione uma de suas colunas para procurar um valor nela.

  7. Clique em Results no painel Rule para confirmar que a regra retorna o valor esperado.

Direcionar uma tabela ou um objeto de negócio

Uma regra Padrão deve direcionar sua tabela base ou um objeto de negócio construído nessa mesma tabela. Essa escolha determina seu comportamento:

  • Quando o destino é uma tabela: Uma regra Padrão que direciona uma tabela só pode padronizar colunas físicas, não colunas calculadas, mas se aplica a todos os objetos de negócio construídos nessa tabela. Por exemplo, uma regra Padrão direcionada à tabela Order poderia padronizar Quantity para 1 e Price para 5. Se um objeto de negócio construído em Order tiver uma coluna calculada como LineTotal (Quantity*Price), essa coluna exibirá NULL até que o registro seja salvo, pois o banco de dados só a calcula quando os valores padronizados são gravados.

  • Quando o destino é um objeto de negócio: Uma regra Padrão que direciona um objeto de negócio, como Order (Source), pode padronizar colunas físicas e colunas calculadas em memória, e seus valores calculados são recalculados em tempo real na interface enquanto o usuário altera campos relacionados, mesmo antes de salvar o registro. Por exemplo, se Quantity é padronizado para 1, Price é padronizado para 5, e uma coluna LineTotal calculada (Quantity*Price) é padronizada junto com eles, LineTotal exibe inicialmente 5. Alterar Quantity para 2 antes de salvar recalcula imediatamente LineTotal para 10. Após salvar, alterar Quantity novamente para 3 recalcula LineTotal para 15.

Um objeto de negócio aplica os valores de uma regra Padrão apenas para as colunas que seleciona. Se uma regra Padrão registrada em uma tabela direciona uma coluna que um objeto de negócio construído nessa tabela não seleciona, o padrão não será aplicado ao inserir por meio desse objeto de negócio, e o App Builder exibe um aviso. Para garantir que os padrões sejam aplicados, adicione as colunas ausentes ao objeto de negócio, ou direcione o objeto de negócio em vez da tabela e registre a regra nele.

Nota

Uma regra Padrão que direciona uma tabela pode ser registrada nessa tabela ou em qualquer objeto de negócio construído nela. Uma regra Padrão que direciona um objeto de negócio específico só pode ser registrada nesse mesmo objeto de negócio, não na tabela subjacente ou em um objeto de negócio diferente construído na mesma tabela. Em todos os casos, o alvo da regra e tudo em que ela é registrada devem estar relacionados; por exemplo, uma regra Padrão para dados Order não pode ser registrada na tabela Customer ou em um objeto de negócio Customer.

Registrar uma regra de Padrão

Uma regra de Padrão não tem efeito até ser registrada, seja na tabela que ela atinge ou em um painel construído sobre o objeto de negócio que ela atinge.

Em uma tabela

Registrar uma regra de Padrão em sua tabela a aplica a todo objeto de negócio construído naquela tabela:

  1. Em App Workbench > Tabelas, localize e selecione a tabela.

  2. Clique em Mais > Padrões. A caixa de diálogo Padrões é aberta.

  3. Clique em Registrar. A caixa de diálogo Padrão é aberta.

  4. No campo Tipo, selecione Regra.

  5. No campo Regra, selecione a regra de Padrão que você criou.

  6. No campo Vínculo, selecione um tipo de vínculo. Consulte Vínculo abaixo para mais informações.

  7. Clique em Salvar.

Em um painel

Registrar uma regra de Padrão em um painel a aplica apenas dentro daquele painel:

  1. Navegue até o painel onde você quer registrar a regra, de uma das duas maneiras:

    • Na visualização do aplicativo, navegue até a página contendo o painel e abra o Live Designer clicando no ícone de hambúrguer no canto superior direito e selecionando Live Designer.

    • Em App Workbench, abra a aba Páginas e selecione a página contendo o painel.

  2. Se você estiver no Live Designer, selecione o painel na visualização para preencher o designer com suas opções e clique em Mais > Padrões. Se você estiver no App Workbench, selecione o painel em Layout de Painel da Página e clique em Mais > Padrões. A caixa de diálogo Padrões é aberta:

    Caixa de diálogo Padrões

  3. Clique em Registrar. A caixa de diálogo Padrão é aberta:

    Caixa de diálogo Padrão

  4. No campo Tipo, selecione Regra.

  5. No campo Regra, selecione a regra de Padrão que você criou.

  6. No campo Vínculo, selecione um tipo de vínculo. Consulte Vínculo abaixo para mais informações.

  7. (Opcional) No campo Ordem, insira um número para determinar em que ordem a regra será executada, caso o painel tenha mais de uma regra registrada nele. Se o painel tiver apenas uma regra, o valor padrão é 10.

  8. Deixe a caixa de seleção Ativo marcada para aplicar a regra. Se você quer desativá-la sem excluí-la, desmarque esta caixa de seleção.

  9. Clique em Salvar.

Atualize a página. Para testar se a regra de Padrão está funcionando, crie um novo registro naquela tabela ou painel. O campo deve ser preenchido automaticamente.

Vínculo

O vínculo de uma regra de Padrão determina qual dado do registro existente é usado para calcular o valor padrão:

  • Vínculo implícito usa a chave primária do registro em memória, então sempre corresponde a exatamente um registro.

  • Vínculo explícito corresponde a uma coluna diferente da chave primária, como uma chave estrangeira. Por exemplo, você pode vincular explicitamente um padrão de Frete ao IDRemetente selecionado em um painel Pedido, de modo que o Frete seja padronizado com base em qual remetente o usuário seleciona.

Aviso

Um vínculo explícito deve ser configurado para que sua regra retorne exatamente um registro para um determinado conjunto de critérios de vínculo, ou App Builder lança um erro "muitas linhas". Se você encontrar este erro, tente adicionar uma cláusula DISTINCT à regra; se isso não reduzir os resultados para um registro, reformule a consulta da regra para que o faça.

Consulte Vínculo implícito e explícito para mais informações.

Quando as regras de Padrão são executadas

  • Em um evento Novo (quando um registro é criado pela primeira vez), App Builder executa a lógica de padrão completa antes de inserir o registro no banco de dados, inicializando colunas físicas para cada regra de Padrão e colunas calculadas para regras que atingem um objeto de negócio.

  • Em um evento de Atualização (quando um registro existente é editado), o App Builder não reaplica os valores de coluna iniciais de uma regra de Padrão, portanto não sobrescreverá um valor que o usuário já tenha alterado. No entanto, colunas calculadas de padrões que direcionam um objeto de negócio ainda recalculam sempre que um campo do qual dependem é alterado, antes e depois que o registro é salvo pela primeira vez. Padrões explicitamente vinculados se comportam da mesma forma: são executados novamente sempre que seu campo vinculado é alterado, independentemente de o registro já ter sido salvo.