01. DADOS GERAIS

02. SITUAÇÃO/REQUISITO

Foi identificado que, em algumas Consultas Padrão, utilizadas via TJD, os usuários precisam preencher campos auxiliares adicionais em tela (como Banco, Agência e Conta) a partir de dados retornados pela consulta. Porém esses dados são apenas concatenados no label do campo, deixando a visualização poluída e pouco usável.

Atualmente, o cliente configura múltiplos campos de origem (ex.: A2_BANCO, A2_AGENCIA, A2_CONTA) no 3º parâmetro da JURSXB, e o sistema monta um único label com todas as informações, o que dificulta a leitura e não permite preencher automaticamente os campos de destino do cadastro (ex.: NT3__BANCO, NT3__AGENC, NT3__CONTA).

Diante disso, surgiu a necessidade de padronizar uma forma de a Consulta Padrão informar ao TJD quais campos adicionais devem ser retornados, e em quais campos do formulário esses valores deverão ser aplicados, por meio de uma estrutura de De/Para que permita ao endpoint retornar esses dados extras para os Campos Customizados.

03. SOLUÇÃO

Para tanto, implementamos uma nova regra na Consulta Padrão para permitir o retorno de campos adicionais vinculados à consulta, de forma parametrizada, contemplando o cenário em que o TJD consome essas informações para preenchimento automático de campos auxiliares em tela.

Criamos uma nova estrutura de dicionário/tabela (O1K) para registrar o De/Para dos campos, onde passamos a identificar para cada registro: (i) qual é a Consulta Padrão utilizada; (ii) qual é a tela/rotina de destino; e (iii) quais são os campos de origem e de destino que devem participar do mapeamento, garantindo que, quando houver configuração, esses campos sejam incluídos automaticamente no SELECT e retornados no payload da API.

Adaptamos o endpoint responsável pela consulta para que, ao montar o response, retorne os valores mapeados na nova estrutura dentro de um objeto de “extras”, por exemplo: “extras”: { “NT3__AGENC”: “033”, “NT3__CONTA”: “555”, ... }), permitindo que o componente de Campos Customizados aplique o patchValue nesses campos de destino e elimine a dependência da concatenação excessiva de informações no label da consulta.

Estrutura de dicionário e tabela O1K - De\Para de Campos Customizados:

Portanto, para utilização e implementação de gatilhos nos Campos Customizados precisamos, além da tabela acima, de:

1. Uma Consulta Padrão configurada para buscar os campos de origem e seus respectivos valores, conforme segue.

2. Registros na tabela O1K sinalizando o De Para dos campos, conforme segue.

Exemplo de configuração de Consulta Padrão: 

Exemplo de tabela O1K com os respectivos registros:

04. DEMAIS INFORMAÇÕES

• JURSXB() no Totvs Departamento Jurídico - Configurações para consulta específica
• JURSXB() - Configurações para consulta específica
• JUR0093_Campos adicionais no TOTVS Jurídico Departamentos

05. ASSUNTOS RELACIONADOS

• TOTVS Jurídico Departamentos - Despesas
• TOTVS Jurídico Departamentos - Resumo do processo#10.Painel-Despesas