Histórico da Página

...

03. Utilização de filtros

A seguir veremos como será a utilização dos filtros nas consultas a partir da JURSXB onde podemos utilizar das seguintes formas:

...

1. Consulta da JURSXB - Consulta padrão
   1. Nessa etapa estaremos criando a consulta que o campo customizado executará.
   2. Esse filtro está disponível apenas para funções compiladas, incluindo customizações.
   3. Exemplo de consulta JURSXB considerando o filtro de campos:
      
   4. Observações: 
      
      1. Após criar / editar a consulta padrão, é necessário vincular ao campo que executará a consulta.
2. Função com filtro de campos
   1. Nessa etapa estaremos tratando do filtro que será executado ao consultar o campo.
   2. Seguindo a mesma regra da etapa anterior, precisamos criar a função que executará o filtro.
   3. A partir disso o usuário pode criar a condição SQL desejada.
   4. Importante: O retorno dessa função deve ser uma condição SQL, sem a necessidade do AND no início

   5. Exemplo de função e retorno:

      Bloco de código
      language java theme RDark linenumbers true
      //------------------------------------------------------------------- /*/{Protheus.doc} CT1JUR_NW Função montagem da query que será usada para filtrar os registros da consulta padrão @return cQuery - Condição da Query sem AND no início /*/ //--------------------------------------------------------------------   User Function CT1JUR_NW() Local cQuery := "" Local c_Ccusto := IIF(Empty(M->NSZ_CCUSTO),NSZ->NSZ_CCUSTO,M->NSZ_CCUSTO)   cQuery := "CT1_RES = '" + c_Ccusto +"' AND CT1_BLOQ <> '1' AND CT1_NORMAL <> '2'" Return cQuery

   6. Observações:

      1. A função deve ser a mesma que foi inserida na consulta, na etapa anterior.
      2. A função deve retornar uma condição SQL sem o AND no início.
      3. Essa função deve estar compilada no ambiente.
3. Exemplo de uso:
   1. Quando for realizada a pesquisa por meio do campo de consulta, será executado a condição retornada da função que o usuário definiu na consulta padrão.
      
   2. Importante: Essa funcionalidade não contempla a atualização de filtros em tempo real pelo formulário, para utilizar os dados do formulário é necessário configurar a consulta padrão citada na seção 06.

...