Блог

Использование расписаний и REST API

В данной статье расскажем о календарных планах, расписаниях и об использовании бизнес-платформы внешними приложениями.

Производственный календарь РФ на 2025 год и официальные ресурсы с программными интерфейсами.

Когда-то был портал открытых данных РФ - data.gov.ru, где можно было по API получить расписание производственного календаря РФ и на основании этих данных определить рабочий и не рабочий день. К сожалению, ресурс долгое время на реконструкции.
В интернете встречаются открытые проекты, которые необходимо развернуть на собственных ресурсах, а также готовые решения, которые поддерживают энтузиасты. Последние, к сожалению, могут опаздывать с обновлениями, устаревать или вовсе перестают работать.
Еще одним вариантом являются корпоративные бизнес-платформы, которые могут содержать расписание с учетом производственного календаря РФ. Рассмотрим их подробнее.

Бизнес-платформы, корпоративные расписания и REST API

Для расчета соблюдения соглашений об уровне обслуживания (SLA), автоназначений и заданий по расписанию (например генерация отчета), в бизнес-платформах реализованы Расписания (Календарные планы).
Расписания могут быть:

  • Статические: фиксированные события, такие как корпоративное событие, встреча, напоминание или рабочий день.
  • Циклические: события, которые повторяются, например, нерабочие дни в связи с государственными праздниками.
  • Плавающие: события, которые зависят от определенных условий, например, "каждый последний вторник каждого второго года".
Расписания могут исключать другие расписания. Например, по расписанию рабочих дней, все будние дни – рабочие дни, за исключением расписания праздничных выходных.
Для работы с расписаниями в бизнес-платформах предусмотрены функции проверки даты и времени относительно расписания и часового пояса.
Имея доступ к API платформы, внешние приложения могут получать информацию о расписаниях и использовать функции для проверки даты и времени.

Проверка даты и времени в корпоративном расписании платформы DBVIM используя REST API

В платформе имеются стандартные расписания, а также расписания из пакетов локализаций. Например, для русской локализации, имеются утвержденные правительством РФ производственные календари.
Производственные календари или связанные с ними расписания можно использовать в различных бизнес-процессах, таких как расчёт соглашений об уровне обслуживания (SLA), проверка вводимых значений, инициализация процессов и формирование отчетов.
Часто внешним приложениям необходимо определить, попадает ли дата и время в расписание. Для этого в платформе предусмотрена функция проверки, которая позволяет отправить запрос через REST API и получить ответ о том, попадает ли дата в указанное расписание. Более подробную информацию можно найти в документации по расписаниям.
Статьи