Разработка:storages/ages

Плагин
Название	ages
Тип	storages

Таблица в базе данных

ages - учебные периоды (учебный год в школе, семестр в ВУЗе). Каждый учебный поток и итоговая отметка по курсу принадлежат какому-то одному учебному периоду.

Подробный формат полей в таблице:

• name - название учебного периода
• begindate - дата и время начала по UTC
• enddate - дата и время окончания по UTC
• eduweeks - количество учебных недель/циклов (каждая соответствует одному циклу в расписании) продолжительности курса, которые помещаются в этом учебном периоде.
• status - список статусов указан в одноименном плагине рабочих процессов ages
• departmentid - структурное подразделение в таблице departments , объявившее учебный период
• previousid - предыдущий учебный период

Дополнительные методы:

Дополнительные методы:

• + Получить список текущих учебных периодов для структурного подразделения. Возвращает массив объектов. По умолчанию - все периоды в статусе "идет учебный процесс". Если второй параметр null - возвращаются все периоды, если строка - периоды в этом статусе, если массив - все периоды в таких статусах. Для удобства нужно сделать заготовку, которая принимает такой параметр и имя sql-колонки и возвращает соответствующий фрагмент sql-запроса - и поместить ее защищенным методом в storage_base.
• + Получить id учебного периода, являющегося x по счету после периода с заданным id. При этом x=1 - это сам исходный период (период для "первого класса), x=2 - это период, для которого период x=1 был предыдущим. Метод возвращает id или false, если однозначно установить id периода не удалось.
• Создать период для структурного подразделения: получает параметры "структурное подразделение", "дата началы", "дата конца", "количество учебных недель", "название", "предыдущий период" - по умолчанию 0. Не указывать предыдущий период допускается только если для этого структурного подразделения еще не было создано периодов. Если для периода уже есть один "последующий период", то больше его указывать в качестве "предыдущего" нельзя. Метод возвращает id созданного периода или false.

get_agenum_byageid($currentageid, $maxagenum)

находит порядковый номер периода, считая от заданного периода Аргументы

• $startageid - id периода, который считается первым
• $currentageid - id периода, порядковый номер которого надо узнать
• $maxagenum - максимально возможный порядковый номер

Возвращаемые значения

• int порядковый номер периода
• bool false

Планы:

Надо реализовать удаление периода так: если к периоду ничего не привязано (потоки, подразделения и т.п.), то его можно удалять. Иначе - нельзя.