2.1.6 Параметр criteries
В этом параметре содержатся критерии выборки объектов из базы данных. В зависимости от типа запроса эти данные могут располагаться:
- Только параметрах запроса GET.
Параметр представляет собой объект в формате JSON, содержащий критерии запроса и выражение для поиска по соответствующему критерию.
Формат:
|
{“Имя критерия”:”Запрос”[ “Имя критерия”:”Запрос”[,…]]}
|
При использовании критериев выборки в ответе появляется свойство «$TotalRecords», содержащее целое число всех записей, которые найдены с использованием данных критериев.
Например, необходимо найти документ с номером Л-1. Параметр criteries будет выглядеть так:
|
{"Rc.RegNum":"Л-1"}
|
С учетом URL encode запрос будет таким:
|
<адрес сервера>/CoreHost/OData/DOC_RC?criteries=%7B"Rc.Regnum"%3A"Л-1"%7D
|
Соответственно результат:
|
{"OData.metadata":"../$metadata#DOC_RC","$inlinecount":1,"$TotalRecords":1,"value":[{"ISN_DOC":4363,"KIND_DOC":3,"DUE_DOCGROUP":"0.2U9.2UX.",
"DOC_DATE":"2012-04-27T00:00:00","ORDER_NUM":0,
"FREE_NUM":"Л-1","ANNOTAT":"Об аренде","CONSISTS":"6","SPECIMEN":"1","DUE_CARD_REG":"0."
…}]}
|