Метод «Получить список дел для раздела номенклатуры»

Endpoint: GET {hostname}/ldm-file-register-service/api/v1/sections/{id}/files

Метод позволяет для указанного раздела получить входящие в него дела.

Сценарий выполнения:

  1. Верификация входящего сообщения. В запросе передаются параметры пагинации и сортировки.
  2. Осуществляется поиск раздела номенклатуры в таблице «dh_items», где значение параметра «id» равно {id}.
  3. Осуществляется получение дел, связанных c разделом номенклатуры, и получение записей в таблице «dh_relations», где значение параметра «class_name» равно «fr_relation_section_files» и «source_object_id» равно id записи, полученной на этапе 2.
  4. Для каждой записи, полученной на этапе 3, осуществляется получение описания объекта приемника. Для этого используется метод GET /api/v1/collections/{collectionId}, где в качестве {collectionId} передается значение параметра «targetObjectId» из найденной связи.
  5. Сервис возвращает ответ <200 OK> и массив DhCollectionDto или пустой массив.

Маппинг параметров запроса «Получить список дел для раздела номенклатуры»

Входящие параметры Тип данных Способ передачи параметров Требования к заполнению
id string($uuid) Path Идентификатор раздела (Id)
page integer($int32) Query Номер страницы, нумерация начинается с 0. Значение согласно описанию в зависимости от потребностей клиента
size integer($int32) Query Количество возвращаемых записей для одной страницы. По умолчанию установлено значение «20». Значение согласно описанию в зависимости от потребностей клиента
sort array[string] Query Параметр сортировки. Значение согласно описанию в зависимости от потребностей клиента

Пример запроса:

curl -X 'GET' \
  'https://editor-next.swagger.io/api/v1/sections/3fa85f64-5717-4562-b3fc-2c963f66afa6/files?page=0&size=20' \
  -H 'accept: text/plain'