ER_JURJUR002-95_Consultas_F3

Informações Gerais

Objetivo

Melhorar a utilização das consultas de campos do módulo SIGAJURI, permitindo a busca pelas colunas listas e sem a necessidade de escolha de índice, uso de acentuação, caracteres especiais ou maiúsculo/minúsculo.

Definição da Regra de Negócio

Atualmente, quando o usuário abre a consulta padrão de algum campo, ele precisa escolher o índice que deseja utilizar para fazer a pesquisa. Após escolher o índice, ainda sim, o termo pesquisado precisa ser bem próximo do que existe na base, respeitando caracteres especiais e caracteres maiúsculos/minúsculos. Isso dificulta a localização de registros. (Protótipo 01).

Este requisito tem como objetivo substituir as principais consultas padrão do módulo SIGAJURI para consultas específicas. Para estas consultas serão implementadas as seguintes funcionalidades:

• Pesquisa "especial" em qualquer campo que estiver no Grid sem se preocupar qual índice da tabela deve ser utilizado.
• A pesquisa não considerará caracteres especiais, maiúsculos, minúsculos ou acentuação.
• Customização dos campos que devem aparecer no grid.
• Opção por mostrar ou não os botões de visualização/Inclusão de novos registros a partir da tela de consulta. (Protótipo 02)
• Melhoria de performance nas consultas que utilizam tabelas com grande quantidade de dados.

A consulta deverá ser apresentada como no protótipo 03.

Serão alteradas as principais consultas dos seguintes cadastros:

• Assuntos Jurídicos
• Envolvidos
• Instâncias
• Unidades
• Andamentos
• Follow-ups
• Garantias
• Objetos

Lista de campos com consultas do tipo SX5 que serão alterados neste requisito:

Lista de campos com consultas do tipo padrão que serão alterados:

Assuntos Jurídicos

Envolvidos

Instâncias

Unidades

Objetos

Andamentos

Follow-ups

Garantias

Lista de campos que serão alterados que possuem consultas específicas:

Detalhamento técnico

Neste requisito serão alteradas as consultas específicas que já existem e as consultas padrão citadas acima serão convertidas para consultas específicas. Só serão alterados os campos que hoje referenciam consultas a tabelas SX5. Será utilizada a função JurF3SXB para exibir a janela das consultas específicas.

Criar a rotina JURSXB que será chamada por todas as rotinas e utilizará a rotina JURF3SXB para exibir a janela na tela.

Alterações na função JurF3SXB

Para que este requisito seja implementado, será preciso realizar as seguintes alterações na função JURF3SXB:

• Criar um botão para inclusão de novos itens (Criar parâmetro para que seja possível alterar o comportamento via dicionário (SXB))
• Alteração do componente da janela de MSDIALOG para FWDialogModal para que a janela fique igual a da consulta padrão.
• Criação de parâmetro para utilizar filtros ADVPL.
• Adequação da rotina para não seja necessário informar um fonte para visualizar ou incluir as informações dos registros a partir da janela da consulta padrão.
• Algumas consultas específicas, como a JURRST já possuem uma query complexa montada. Para que estas consultas possam utilizar a nova interface, a função JURF3SXB vai ter que ser alterada para receber um SQL pronto, ao invés de montar o SQL a partir dos campos recebidos.

Funcionamento da rotina JURSXB

A rotina deverá receber os parâmetros abaixo:

• Alias (Tabela)
• Nome da consulta SXB que está sendo chamada
• Campos que devem ser exibidos no Grid
• Variável lógica que indica se o botão Visualizar deve ser exibido
• Variável lógica que indica se o botão Incluir deve ser exibido
• Filtro ADVPL que deve ser aplicado no grid da consulta padrão

Fluxo da rotina JURSXB:

• Consultas do tipo SX5
  • Quando o parâmetro que informa o alias da tabela usada tiver apenas dois caracteres, assumir que a rotina utiliza dados da tabela SX5.
    • Não permitir que seja exibido o botão de inclusão de novos itens
    • Assumir que os campos que precisam ser exibidos são: "X5_CHAVE", "X5_DESC".
    • Assumir que o filtro que deve ser realizado na SX5 é X5_TABELA = <NOMESXB>
• Consultas que eram do tipo padrão
  • Quando o parâmetro que informa o alias da tabela usada tiver mais que dois caracteres, assumir que a rotina utiliza dados de uma tabela comum.
    • Avaliar se existe um ponto de entrada com o nome o alias da consulta no SXB.
      • Ex: U_JURCTO
      • Se existir tal ponto de entrada, o mesmo deve ser chamado, passando como parâmetro o array de campos, as variáveis lógicas que indicam se os botões de inclusão/visualização de registros e o filtro que deve ser aplicado na consulta.
      • Através deste ponto de entrada será permitido que o cliente customize os campos que devem ser exibidos, o filtro aplicado e a exibição dos botões de inclusão / visualização de registros, caso não seja possível via SXB.
    • Avaliar filtros enviados via parâmetro
      • Tratar os filtros para transformar a parte ADVPL para expressões SQL que possam ser utilizadas pelo componente.
      • Algumas funções que possuem filtro de linha a linha deverão ser alteradas para retornar o filtro como uma string. Veja a relação delas no item "Funções de filtro".

Após avaliar os fluxos acima, as funções devem chamar a função JURF3SXB que irá por fim, exibir a janela com as informações da consulta de acordo com as configurações escolhidas.

Funções de filtro

Algumas funções, que tratam registro a registro, ou seja, não possuem os caracteres "@#", deverão ser alteradas para retornar o filtro como string ao invés de verdadeiro ou falso para cada registro. Deve ser analisado se as consultas podem ser alteradas ou se novas funções devem ser criadas. Avaliar e atualizar o uso das funções nas consultas que estão listadas na seção de dicionário deste documento.

São elas:

Funções de consultas específicas existentes

Algumas funções que já são utilizadas em consultas específicas hoje, deverão ser atualizadas para usar a interface da nova da função JURF3SXB.

Abaixo a lista das funções que devem ser atualizadas:

Consultas padrão que possuem mais de uma tabela para exibição de campos

Atualmente, existem algumas consultas padrão que usam no grid campos de mais de uma tabela. Para atualizar estas consultas, ao mudar para consultas específicas, não será possível utilizar o padrão na JURSXB. Então, será necessário criar uma função para cada consulta. Abaixo a lista de funções que deverão ser criadas:

Tabelas Utilizadas

• NSZ - Assuntos Jurídicos
• NTA - Follow-ups
• NT2 - Garantias
• NT4 - Andamentos
• NT9 - Envolvidos
• NUQ - Instâncias
• NYJ - Unidades
• NSY - Objetos
  
   

  
  
  

Protótipo de Tela

Protótipo 01

Protótipo 02

 Protótipo 03

 Protótipo 04

Dicionário de Dados

Arquivo: NT2 - Garantias

Arquivo: NSZ - Assuntos Jurídicos

Arquivo: NT9 - Envolvidos

Arquivo: NUQ - Instâncias

Arquivo: NYJ - Unidades

Arquivo: NSY - Objetos

Consulta Padrão

Consulta: JUR05