Project Kaiser: 3.1. create_studies_zip / подготовить файл ZIP с dicom-архивом

3.1. подготовить файл ZIP с dicom-архивом

EndPoint - create_studies_zip
Method - GET

Описание.

Процесс получения dicom файлов в виде архива zip разбит на 2 этапа

Создание задания на создание архива. Это делается этим методом.
Этот же метод возвращает статус готовности архива.
Получение готового файла метод 3.2.

Преданные параметры определяют одно исследование, сервер проверяет наличие этого запроса файла в очереди на создание архива.
Если такого запроса нет, то он добавляется.

ID пациента, (при методе авторизации пользователя по умолчанию), это логин в basic авторизации.
Если используется другой логин пользователя или авторизация по x-api-key,
то нужно определить Patients_ID методами
0.2. get_patient / данные о пользователе
или
0.4. find_patient_by_fio / поиск пациента по ФИО+ДР+телефон

ID записи/визита и ID dicom исследования берется из результатов метода 0.3. get_visit_list / список посещений, записей в ЭМК

Но в качестве ответа возвращается таблица со всеми заданиями на создание файлов для указанного пациента.
В ней присутствуют поля fl_done/статус запроса файла, str_done/расшифровка статуса

P.S. Удаление архивов, производится в указанное в настройках время суток. Удаляются файлы чей «возраст» в часах превышает количество часов указанное в настройках.

Информация для админа МИС.
Используется хранимая скалярная функция mss_rest_check_access_number для проверки наличия на dicom сервере исследования

Request parameters / параметры запроса

Название параметра	Тип данных	Описание
patients_id	integer	ID пациента
motconsu_id	integer	ID записи/визита
accessnumber	string	ID dicom исследования

Response parameters / параметры ответа

Название параметра	Тип данных	Описание
patients_id	integer	ID пациента
motconsu_id	integer	ID записи/визита
accessnumber	string	ID dicom исследования
dt	string	ДатаВремя создания задания, в формате ГГГГ-ММ-ДД ЧЧ:ММ:СС
exec_time	integer	разница в секундах между dt и текущим моментом запроса СREATE_STUDIES_ZIP
fl_done	integer	флаг готовности архива
str_done	string	готовность

Возможные значения fl_done/str_done

fl_done	str_done	комментарий
0	Добавлено задание	сразу после добавления задания
1	Задание обрабатывается	идет процесс копирования и упаковки
2	Готово	Файл готов и его можно получать методом GET_STUDIES_ZIP

Request examples / пример запроса

http://127.0.0.1:45670/CREATE_STUDIES_ZIP/?patients_ID=100&motconsu_id=274005&accessnumber=CN123456

Response examples / Пример ответа

[{
	"patients_id": 105,
	"motconsu_id": 366,
	"dt": "2021-06-16 12:33:38",
	"accessnumber": "CN5520",
	"exec_time": 221,
	"fl_done": 0,
	"str_done": "Добавлено задание"
}, {
	"patients_id": 105,
	"motconsu_id": 367,
	"dt": "2021-06-16 12:37:19",
	"accessnumber": "CN5522",
	"exec_time": 4107,
	"fl_done": 2,
	"str_done": "Готово"
},
...
]