Выборка записей
Для получения записей по заданному условию, вы можете создать отчет в программе с нужными фильтрами и передать ID отчета в параметр reports_id
.
Второй способ - задать собственные фильтры в параметр filters
. Обратите внимание, в качестве фильтров можно использовать и системные поля, такие как: id
, parent_item_id
, date_added
, date_updated
Пример получения записей из приложения:
<?php
$params = array(
'key' => 'XgDXFsTbNRkMpRq81bBrmRAf56i5oS0oN9bp4jLH',
'username' => 'admin',
'password' => 'admin',
'action' => 'select',
'entity_id' => 34, //ID сущности, из которой будут выбираться записи
'limit' => 0, //Если не указан, выбираются все строки
'select_fields' => '338,388', //ID полей, значения которых будут выбираться
'reports_id' => 370, //ID отчета, фильтры которого будут применяться к выборке
'filters' => array(
'159'=>'2018-05-10,2018-05-16', //Фильтр по дате 'от,до'. Можно указать одно из значений, например '2018-05-10,', а второе оставить пустым.
'157'=>array('value'=>37,'condition'=>'include'), //Фильтр по типу поля список. condition может быть include/exclude
'203' => '>30' //Фильтр по числовому полю
'203' => array('condition'=>'not_empty_value'), //empty_value или not_empty_value - пустое или не пустое значения поля
'158'=>array('value'=>'keywords','condition'=>'search'), //поиск по полю
//В качестве фильтров можно использовать и системные поля, такие как: id, parent_item_id, date_added, date_updated
'id' => '13,14',
)
);
$ch = curl_init('http://localhost/rukovoditel/api/rest.php');
curl_setopt($ch, CURLOPT_HEADER, false);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($params));
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_TIMEOUT, 10);
$result = curl_exec($ch);
curl_close($ch);
if($result)
{
$result = json_decode($result,true);
print_r($result);
}
Поле | Описание |
---|---|
entity_id | ID сущности, из которой будут выбираться записи |
limit | Если не указан, выбираются все строки |
select_fields | ID полей, значения которых будут выбираться. Укажите ID через запятую. Если не указано, выбираются значения из всех полей. |
reports_id | ID отчета, фильтры и сортировка которого будут применяться к выборке. Если не указано, выбираются все записи. |
filters | Не обязательное поле. Дает возможность использовать пользовательские фильтры при выборе записей. |
rows_per_page | Необязательное поле. Используется для разбивки результата по страницам. Введите здесь числовое значение. |
filters | Используется с опцией rows_per_page. Установите текущий номер страницы в ответе. |
При успешном выполнении, возвращает массив записей:
Array
(
[status] => success
[data] => Array
(
[0] => Array
(
[id] => 112
[date_added] => 01/15/2018 10:42
[created_by] => Kharchishin Sergey
[338] => Заявка 6
[388] => Новая
)