Vínculo implícito e explícito no Jitterbit App Builder

O vínculo é como o App Builder conecta regras a contextos de dados específicos; ele determina como uma regra interage com objetos de dados subjacentes. Existem vínculos explícitos e implícitos:

Vínculo explícito: Isso acontece quando um desenvolvedor mapeia manualmente colunas de origem para colunas de destino dentro da interface do usuário. Esse mapeamento direto é necessário ao registrar regras para notificações, migração e CRUD. Por exemplo, ao configurar um evento, é preciso definir explicitamente esses vínculos para garantir que a ação ou validação associada tenha como alvo os dados corretos.
Vínculo implícito: Este é um processo automatizado onde o App Builder assume o contexto da linha "atual" sendo processada. Nesses cenários, o sistema substitui automaticamente a primeira instância de uma tabela de destino na regra pelo registro ativo com o qual o usuário está interagindo. Isso é usado principalmente para regras padrão e muitas regras de validação, onde a lógica está inerentemente ligada ao registro que está sendo visualizado ou editado.

Propósitos das regras e métodos de vínculo

A tabela a seguir descreve como diferentes propósitos de regras interagem com o vínculo. A coluna "Propósito" reflete os rótulos encontrados na interface do usuário atual do App Builder.

Propósito	Tipo de Vínculo	Colunas de Destino	Comentários
Notificação	Explícito		Usado para alertar usuários. Campos de destino que terminam em `()` podem ter várias colunas como alvo.
Controle	Implícito	Metadados	Controla o comportamento da interface do usuário (`0` = oculto, `1` = obrigatório, `2` = opcional). Chaves primárias geralmente não são alvo.
CRUD	Explícito	Dados	Regras CRUD são vinculadas explicitamente por meio de vínculos de ação. Criar, atualizar ou excluir registros requer mapeamento direto para garantir a integridade dos dados.
Padrão	Implícito	Dados	Preenche automaticamente os campos. Se uma regra retornar muitas linhas, verifique se a tabela de armazenamento está corretamente referenciada na cláusula FROM.
Visibilidade	Variável	Estado da UI	A visibilidade pode ser configurada por meio de três tipos: Estática, Regra ou Plugin. A maioria das implementações modernas utiliza regras de visibilidade em vez do método de coluna estática mais antigo.
Validação	Ambos		Embora o mapeamento explícito possa ser usado, a maioria das regras de validação utiliza vínculo implícito para verificar o estado da linha atual.

Contexto de Aplicação e UI

Ao configurar eventos ou vinculações de ações, a vinculação explícita é tipicamente aplicada através da tela de edição de uma página, na camada de UI. Nesta captura de tela, uma página contendo quatro painéis está sendo editada. Observe como o painel selecionado, chamado Informações de Envio, está vinculado a outro painel na mesma página, Pedidos. A vinculação pode ser controlada através do botão destacado com o ícone de corrente .

Em contraste, registrar regras de padrão ou visibilidade requer navegar até a camada de Lógica de Negócios. A captura de tela abaixo mostra uma regra de validação sendo registrada em um objeto de negócios. Note o campo Vinculação destacado.

Campo de vinculação

Importante

O local de registro para padrões mudou nas versões recentes, e essas configurações não são mais gerenciadas na mesma área que as versões anteriores.

Como a vinculação implícita funciona

Ao construir uma regra com vinculação implícita, a primeira instância da tabela ou objeto de dados alvo na regra é substituída pela linha ativa. Para que isso funcione como pretendido, a cláusula FROM na sua regra deve ser a tabela de armazenamento real.

Por exemplo, se você estiver definindo um OrderDetails.UnitPrice com base no preço de um Produto, o sistema substituirá a referência OrderDetails em seu SQL pelo ID específico do registro que está sendo tratado atualmente. Isso permite que a regra busque dinamicamente o preço correto para aquele pedido específico sem mapeamento manual para cada campo.