Histórico da Página
Nota | ||
---|---|---|
| ||
Disponível à partir da versão 12.1.8 da linha RM. |
...
Regras para utilização do filtro
Método: GET
...
Para montar o parâmetro "filter" devemos obedecer as seguintes regras:
- O objeto filter deve ser um array.
- O índice 0(zero) desse array deve ser o schema do filtro, o schema segue o mesmo padrão já adotado na lib (CODCOLIGADA =:CODCOLIGADA)
- O índice 0(zero) não aceita comandos : DLL, DML, DCL, TCL (create,alter,truncate,comment,rename,select,insert,update,delete,call,explain plan,lock table,grant,revoke,commit,savepoint,rollback,'," )
- Para cada parâmetro adicionado schema do filtro, deverá ser um novo registro no array com o respectivo valor.
- É extremamente necessário serilizar o filtro em json antes de fazer a chamada.
Para a montagem de um filtro com mais de um parâmetro siga esses passos:
[...] filter = ["NOME_DO_CAMPO_1 = :NOME_DO_PARAMETRO_1 (AND/OR) NOME_DO_CAMPO_2 = :NOME_DO_PARAMETRO_2 (AND/OR) NOME_DO_CAMPO_N = :NOME_DO_PARAMETRO_N", "VALOR_1", "VALOR_2", "VALOR_3"]
Exemplo (Filtro Único)
Método: GET
Parâmetros Utilizados:
- start = 3;
- limit = 2;
- filter = ["CODCOLIGADA =:codcoligada", "1"];
Bloco de código | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
{
"messages": [],
"length": 21,
"data": [
{
"id": "1$_$1$_$01",
"CODFILIAL": 1,
"CODCOLIGADA": 1,
"CODLOC": "01",
"NOME": "RM Suprimentos MTZ",
"NIVELESTOQUE": 1,
"RUA": null,
"NUMERO": null,
"COMPLEMENTO": null,
"BAIRRO": null,
"CODETD": null,
"CIDADE": null,
"CEP": null,
"PAIS": null,
"TELEFONE": null,
"DDD": null,
"FAX": null,
"CONTATO": null,
"EMAIL": null,
"INATIVO": 0,
"IDUNDNEGOCIO": null
},
{
"id": "1$_$1$_$02",
"CODFILIAL": 1,
"CODCOLIGADA": 1,
"CODLOC": "02",
"NOME": "FILIAL BELO HORIZONTE",
"NIVELESTOQUE": 1,
"RUA": null,
"NUMERO": null,
"COMPLEMENTO": null,
"BAIRRO": null,
"CODETD": null,
"CIDADE": null,
"CEP": null,
"PAIS": null,
"TELEFONE": null,
"DDD": null,
"FAX": null,
"CONTATO": null,
"EMAIL": null,
"INATIVO": 0,
"IDUNDNEGOCIO": null
},
{
"id": "1$_$1$_$03",
"CODFILIAL": 1,
"CODCOLIGADA": 1,
"CODLOC": "03",
"NOME": "FILIAL RIO DE JANEIRO",
"NIVELESTOQUE": 1,
"RUA": null,
"NUMERO": null,
"COMPLEMENTO": null,
"BAIRRO": null,
"CODETD": null,
"CIDADE": null,
"CEP": null,
"PAIS": null,
"TELEFONE": null,
"DDD": null,
"FAX": null,
"CONTATO": null,
"EMAIL": null,
"INATIVO": 0,
"IDUNDNEGOCIO": null
},
{
"id": "1$_$1$_$04",
"CODFILIAL": 1,
"CODCOLIGADA": 1,
"CODLOC": "04",
"NOME": "FILIAL SAO PAULO",
"NIVELESTOQUE": 1,
"RUA": null,
"NUMERO": null,
"COMPLEMENTO": null,
"BAIRRO": null,
"CODETD": null,
"CIDADE": null,
"CEP": null,
"PAIS": null,
"TELEFONE": null,
"DDD": null,
"FAX": null,
"CONTATO": null,
"EMAIL": null,
"INATIVO": 0,
"IDUNDNEGOCIO": null
},
{
"id": "1$_$1$_$05",
"CODFILIAL": 1,
"CODCOLIGADA": 1,
"CODLOC": "05",
"NOME": "Empenho de Materia-prima",
"NIVELESTOQUE": 1,
"RUA": null,
"NUMERO": null,
"COMPLEMENTO": null,
"BAIRRO": null,
"CODETD": null,
"CIDADE": null,
"CEP": null,
"PAIS": null,
"TELEFONE": null,
"DDD": null,
"FAX": null,
"CONTATO": null,
"EMAIL": null,
"INATIVO": 0,
"IDUNDNEGOCIO": null
}
]
} |
Exemplo (Filtro com mais de um Parâmetro)
Iremos utilizar o mesmo dataserver (EstLOCData) como exemplo, porém iremos utilizar os seguintes parâmetros:
OBS: Observe que vamos utilizar três filtros, em vez de um, como no exemplo anterior.
Método: GET
Parâmetros Utilzados:
- start = 0;
- limit = 5;
- filter = ["CODCOLIGADA =:codcoligada AND CODLOC =:codloc AND CODFILIAL =:codfilial", "1", "01", "1"]
Bloco de código | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
{
"messages": [],
"length": 1,
"data": [ {
"id": "1$_$1$_$01",
"CODFILIAL": 1,
"CODCOLIGADA": 1,
"CODLOC": "01",
"NOME": "RM Suprimentos MTZ",
"NIVELESTOQUE": 1,
"RUA": null,
"NUMERO": null,
"COMPLEMENTO": null,
"BAIRRO": null,
"CODETD": null,
"CIDADE": null,
"CEP": null,
"PAIS": null,
"TELEFONE": null,
"DDD": null,
"FAX": null,
"CONTATO": null,
"EMAIL": null,
"INATIVO": 0,
"IDUNDNEGOCIO": null
}]
} |
Exemplo (Filtro com Like)
Iremos utilizar o mesmo dataserver (EstLOCData) como exemplo, porém iremos utilizar os seguintes parâmetros:
Método: GET
Parâmetros Utilzados:
- filter = ["NOME LIKE :NOME", "%SAO PAULO%"]
Bloco de código | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
{
"messages": [],
"length": 1,
"data": [
{
"id": "1$_$1$_$04",
"CODFILIAL": 1,
"CODCOLIGADA": 1,
"CODLOC": "04",
"NOME": "FILIAL SAO PAULO",
"NIVELESTOQUE": 1,
"RUA": null,
"NUMERO": null,
"COMPLEMENTO": null,
"BAIRRO": null,
"CODETD": null,
"CIDADE": null,
"CEP": null,
"PAIS": null,
"TELEFONE": null,
"DDD": null,
"FAX": null,
"CONTATO": null,
"EMAIL": null,
"INATIVO": 0,
"IDUNDNEGOCIO": null
}
]
} |
Exemplo (Implementação em Código)
- Adicione os disclaimers que desejar:
- Crie o schema do filtro e adicione os respectivos valores.
- Na chamada do findRecords, o parâmetro filter deve ser serializado em JSON.
3. A segunda opção pode ser substituída por essa: