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

Endpoint: GET {hostname}/ldm-digital-archive-service/api/v1/da/files/{id}/volumes

Метод позволяет получить описание томов дела по заданным фильтрам.

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

  1. Верификация входящего сообщения. В запросе передаются фильтры, параметры пагинации и сортировки.
  2. Осуществляется получение описания значения атрибута справочника, «id» которого равно «da_document_appraisal_type_id» из параметров запроса для определения значения атрибута «da_system_code». Для получения используется метод GET /api/v1/items/{id} сервиса dh-documents-service.
  3. Осуществляется получение контента коллекции (дела) Осуществляется получение записи, параметр «collection_id» которого равен значению «id» из таблицы «dh_collection_content».
  4. Для каждой записи, полученной на этапе 3, выполняется запрос для получения описания объекта «id», равного «content_id» в контенте «dh_collections» для записи, найденной на этапе 3.
  5. Выполняется отбор тома дела из перечня, полученного на этапе 4, для которого в атрибуте «fr_file_section_storage_type» указано значение справочника «Способы хранения», где «fr_system_code» равно «da_system_code» из этапа 2.
  6. В ответе сервис возвращает ответ 200 OK и массив DhCollectionDto.

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

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

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

curl -X 'GET' \
  'https://editor-next.swagger.io/api/v1/da/files/40c6b51-57b2-4e00-8277-73781676ebf7/volumes?page=0&size=20' \
  -H 'accept: text/plain'