Administração do sistema

Como utilizar os Query Operators na passagem de parâmetros?

RT.FAQ-13323
Para informar um parâmetro de filtro utilizando os query operators, deve-se utilizar uma convenção explicada a seguir.

Cada filtro é formado por várias partes. O filtro mais simples é composto apenas pelo indicativo de que um determinado campo deve ter um determinado valor:
CAMPO=VALOR

Exemplo:
Filtrar pedidos na situação "M" (manutenção):
SITUACAO=M

Filtros mais complexos, exigirão que seja informado um operador de query. Para tal, deve-se acrescentar a identificação do query operator após o valor informado:
CAMPO=VALOR|OPERADOR

Exemplo:
Filtrar pedidos em situação diferente de "M":
SITUACAO=M|!=

Quando o operador de query exigir que sejam informados outros valores, os mesmos terão ser ser acrescentados após o operador de query:
CAMPO=VALOR1|OPERADOR|VALOR2|VALOR3...

Exemplo:
Situação é C, E ou P
Q_SITUACAO=C|i|E|P

Quando o operador não exige valores, o filtro deverá iniciar com o "|":
CAMPO=|OPERADOR

A tabela abaixo descreve os operadores de query disponíveis:

OperadorNomeQuant. valoresDescriçãoExemploObservações
=igual a 1 O campo deverá ter exatamente o valor informado.SITUACAO=MSituação igual a "M".
!=diferente de 1 O campo deverá ter exatamente o valor informado.SITUACAO=C|!=Situação diferente de "C".
scontém 1 O campo deverá conter as palavras informadas.TEXTO=serviço|sTexto deverá conter a palavra "serviço".
nsnão contém 1 O campo não poderá conter nenhuma das palavras informadas.TEXTO=serviço|nsTexto não poderá conter a palavra "serviço".
<menor que 1 O campo deverá ser menor que o valor informado.VALOR=50|<Valor menor que 50.
<=menor ou igual a 1 O campo deverá ser menor ou igual ao valor informado.
>maior que 1 O campo deverá ser maior que o valor informado.
>=maior ou igual a 1 O campo deverá ser maior ou igual ao valor informado.
bentre 2 O campo deverá estar dentro de uma faixa de valores informados.PRIORIDADE=1|b|5Prioridade entre 1 e 5.
nbfora da faixa 2 O campo deverá estar fora de uma faixa de valores informados.
ié um destes n O campos deverá ter um dos valores informados.SITUACAO=A|i|B|CSituação é A, B ou C.
ninão é nenhum destes n O campos não poderá ser nenhum dos valores informados.
nnão informado 0 O campo deverá ser nulo (não informado).RESPONSAVEL=|nResponsável nulo (não informado).
nninformado 0 O campo deverá estar informado com qualquer valor.
lparecido com 1 O campo deverá ser parecido com o valor que deverá ter os caracteres "%" e/ou "_".
nlnão parecido com 1 O campo não poderá ser parecido com o valor que deverá ter os caracteres "%" e/ou "_".
swinicia com 1 O campo deverá iniciar com a expressão.
ewtermina com 1 O campo deverá terminar com a expressão.

Ver também: