Linha Microsiga Protheus

Árvore de páginas


CONTEÚDO

  1. Visão Geral
  2. Parâmetros da função JURSXB()
  3. Como configurar?
  4. Exemplo de utilização
  5. Utilização de filtros - Totvs Departamentos Jurídicos
  6. Assuntos relacionados


01. Visão Geral

No módulo de Jurídico Departamentos (SIGAJURI), foi criado uma interface personalizável para as telas de consultas padrão, a fim de permitir pesquisa sem diferenciação por acentuação ou caixa alta/baixa. Estas consultas utilizam uma chamada da função JURSXB(). Este documento tem o objetivo de  apresentar que é possível personalizar o comportamento das consultas que usam esta função, caso necessário. Veja a seguir os parâmetros da função.


02. Parâmetros da função JURSXB()

Para utilizar esta função, é necessário configurar alguns parâmetros, como vemos na tabela a seguir:

JURSXB( A, B, C, D, E, F, G , H , I , J )


Parâmetro

Tipo

Descrição

ObrigatórioExemplo
AStringNome da tabela.x"SA2"
BStringNome da consulta específicax"JURSA2"
CArrayCampos que devem ser exibidos na tela da consulta.
{"A2_COD","A2_LOJA","A2_NOME"}
DLógicoDefine se o botão Visualizar será apresentado.
.T.
ELógicoDefine se o botão Incluir será apresentado.
.T.
FStringFiltro (where) que será concatenado na query
""
GStringNome da rotina/fonte que será usado para visualização ou inclusão de registros a partir da consulta padrão.
"MATA020"
HLógicoIndica se a consulta apresentará dados na sua abertura. Caso configure .F. os valores serão retornados somente ao realizar uma busca no campo de pesquisa.
.T.
INuméricoPercentual de redução da view quando é informado o fonte.
0
JLógicoDefine se o botão Alterar será apresentado.
.T.

03. Como configurar?

Para realizar as configurações é necessário acessar o configurador (SIGACFG), conforme apresentado a seguir:


1 - Acesse o módulo do Configurador

No menu acesse Base de Dados > Dicionário > Base de Dados. Em seguida, no menu lateral, selecione o item Consultas Padrão:


2 - Utilize o botão de lupa para buscar a consulta que deseja configurar.


Digite o nome do Alias da consulta padrão e clique no botão Buscar:


3 - Acesse a consulta em modo de Alteração.

Clique no botão Alterar:


Ao acessar a tela da consulta no modo de alteração, clique em Avançar


4 - Configure os parâmetros para a função JURSXB()

No campo Expressão configure os parâmetros de acordo com a necessidade para o campo que utiliza a consulta.



Após realizar as alterações necessárias, clique no botão Finalizar.


IMPORTANTE!

A alteração de uma configuração que é padrão do sistema, ou inclusão de uma nova configuração deve ser realizada com cautela, a fim de não comprometer a consulta dos dados.


04. Exemplo de utilização

A seguir vemos o exemplo de configuração para consulta específica do campo de Comarca (NUQ_CCOMAR), utilizado na rotina de Assuntos Jurídicos.


Expressão: JURSXB( "NQ6", "NQ6" ,{ "NQ6_COD", "NQ6_DESC" } , .T., .T., "@#JU183F3NQ6()", "JURA005", .T., 0, .T.)




Utilizando a Consulta:


05. Utilização de filtros - Totvs Departamentos Jurídicos

A seguir veremos como será a utilização dos filtros nas consultas a partir da JURSXB. A regra a seguir vale para a utilização no portal Totvs Departamentos Jurídico. Para os filtros podemos utilizar as seguintes formas:

  • Filtro por posição do registro na memória
    • Expressão: JURSXB("NT9","JURCST",{"NT9_NOME","NT9_CODENT"},.T.,.T.,"NT9->NT9_CAJURI==NSZ->NSZ_COD")
    • Explicação: O Filtro por posição será convertido para uma condição que irá comparar ao menos dois campos na consulta, realizando o filtro desejado. Importante ressaltar que apenas filtros complementares com a NSZ estão disponíveis.


  • Filtro por função
    • Expressão: JURSXB("CT1","JURFNC",{"CT1_CONTA","CT1_DESC01"},.T.,.T.,"@#U_CT1JUR_NW()")
    • Explicação: O filtro por função executará a função inserida, tal função deverá retornar uma condição que por sua vez será utilizada para complementar a busca pelo registro. Importante ressaltar que é necessário a indicação do @# antes da função.
      Exemplo de retorno de uma função: "       CT1_CLASSE == '2' And CT1_BLOQ <> '1' ".


06. Assuntos relacionados