Структуры.GetObjectsByCriteria
Материал из Hivext Wiki
Метод GetObjectsByCriteria
Общая информация
| Параметр | Значение |
|---|---|
| Описание | Получение объектов по заданным критериям. |
| Адрес метода | http://api.hivext.ru/1.0/data/base/{protocol}/getobjectsbycriteria |
| Кодирование | urlEncoding |
| Метод сервиса | Структуры |
Параметры
| Имя параметра | Тип | Описание |
|---|---|---|
| Входящие параметры | ||
| appid | string | [*] Идентификатор приложения. |
| session | string | [*] Идентификатор пользователя. |
| type | string | [*] Имя типа данных. |
| criteria | string | [*] Критерии выборки. Смотреть команды HiveQL процессора. |
| from | int | Индекс с которого вернутся объекты (по умолчанию равен 0). |
| count | int | Количество объектов (по умолчанию равно общему числу объектов найденных по критерию). |
| join | string | Названия свойств комплексных типов. По умолчанию свойства с комплексными типами используют lazy загрузку, т.е. содержат индекс (ссылку) на объект, а не сам объект. Если требуется вернуть объект полностью, в параметре join указывается имя свойства, для которого нужно вернуть полноценный объект. Для полноценной выборки нескольких свойств можно использовать перечисление через запятую (field1, field2, ...). Для полноценной выборки с глубокой иерархией используется указание дерева свойств с разделителем точка (field1.subfield1, field2.subfield1.subsubfield1, ...). |
| Возвращаемые параметры | ||
| result | int |
|
| error | string | Описание ошибки, если она произошла. |
| objects | array |
Массив свойств и значений объектов в формате JSON. objects = [ { id : 1, свойство : значение, ... }, { id : 2, свойство : значение, ... }, ... ] |
