Разработка:storages/ages — различия между версиями

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

Версия 13:53, 28 августа 2009

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


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

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

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

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

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

Планы:

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

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