1.5. get_pl_subj_grid / сетка приема Расписаний с отметками занято/не занято

# > Общий раздел (Russian/Russia) > 01. REST сервер ( API для Медиалога ) > Документация > 5. Методы / Конечные точки / Endpoint > 1. Методы расписания > 1.5. get_pl_subj_grid / сетка приема Расписаний с отметками занято/не занято

Описание

1.5. сетка приема Расписаний с отметками занято/не занято

EndPoint - GET_pl_subj_grid
Method - GET

Описание.

Возвращает список ячеек рабочего времени, в сетке указанного в параметре расписания, за промежуток дат указанный в параметрах.

  1. На каждую дату приходится множество ячеек.
  2. Берется полный период работы в дне.
  3. Для размера ячейки берется интервал, указанный в настройках расписания, — это может быть 30, 20 или 10 минут и т.д.
  4. Период работы разбивается с указанным интервалом.
  5. Потом на него накладываются записанные пациенты и спец.резервирование времени, при этом, если ячейка 30 минут, а записанный пациент занимает например 20 минут, то от ячейки останется остаток 10 минут, как в примере.

Так же может быть ситуация, когда записанный пациент занимает 1,5 ячейки, и любые другие вариации, остатки так же будут видны как в примере.

Информация возвращаемая запросом, теряет актуальность, т.к. указанная свободная ячейка может быть уже через некоторое время занята, регистраторами клиник или другими пользователями сайта.

При этом если Методами "записи в расписание" в такую свободную ячейку будет сделана попытка записать на прием. API вернет ошибку.

Информация для администратора МИС.
Для работы этого метода требуется заполнение таблицы кэша см. файл Описание раздел 5. Хранимые процедуры и функции, используемые в работе сервера.

Рекомендации

В запросе можно указать промежуток дат от текущей, до даты "текущая+30дней" или "текущая+40дней" в зависимости от того какой промежуток указан в процедуре заполнения кэша
Но лучше не делать сразу большой промежуток. т.к. запрос сильно нагружает СУБД МИС, и долго обрабатывается.
Рекомендуется делать запросы по 7-10 дней

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

Название параметра Тип данных Описание обязательный параметр
pl_subj_id integer ID расписания
да
d1 string Дата начала периода
да
d2 string Дата окончания периода
да

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

Название параметра Тип данных Описание
date string Дата в расписании, в формате ГГГГ-ММ-ДД
time_start string Время начала ячейки приема, в формате ЧЧ:ММ
time_end string Время окончания ячейки приема, в формате ЧЧ:ММ
duree integer Длительность ячейки приема в минутах
dt_start string ДатаВремя начала ячейки приема аналог полей date+time_start, в формате ГГГГ-ММ-ДДtЧЧ:ММ
color integer Цвет ячейки приема отображаемый в МИС, RGB в десятичном виде
busy integer Ячейка занята/записать нельзя=1 , ячейка свободна/можно записать=0

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

http://127.0.0.1:45670/GET_pl_subj_grid/?pl_subj_id=1&d1=2021-10-27&d2=2021-11-05

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

[{
	"date": "2021-10-28",
	"time_start": "13:00",
	"time_end": "13:30",
	"duree": 30,
	"dt_start": "2021-10-28t13:00",
	"color": -1,
	"busy": 0
}, {
	"date": "2021-10-28",
	"time_start": "13:30",
	"time_end": "13:50",
	"duree": 20,
	"dt_start": "2021-10-28t13:30",
	"color": 16777088,
	"busy": 1
}, {
	"date": "2021-10-28",
	"time_start": "13:50",
	"time_end": "14:00",
	"duree": 10,
	"dt_start": "2021-10-28t13:50",
	"color": -1,
	"busy": 0
},	
	....
]
Создан: Соловей Евгений 30.01.24 5:24; Изменен: Соловей Евгений 30.01.24 6:21
Эта страница является подготовленной к печати версией файла "1.5. get_pl_subj_grid / сетка приема Расписаний с отметками занято/не занято".
Подготовлено с помощью Project Kaiser - программы для управления проектами и задачами
Пользователь:Guest