Разработка:storages/ages — различия между версиями
(→create_period_for_department($deptid, $datebegin, $dateend, $numweeks, $name, $previousid=null)) |
(→create_period_for_department($deptid, $datebegin, $dateend, $numweeks, $name, $previousid=null)) |
||
Строка 61: | Строка 61: | ||
''Аргументы:'' | ''Аргументы:'' | ||
* $deptid(int) - id учебного подразделения. | * $deptid(int) - id учебного подразделения. | ||
− | * $datebegin(int) - время начала периода в формате [ http://ru.wikipedia.org/wiki/UNIX-время | + | * $datebegin(int) - время начала периода в формате [ http://ru.wikipedia.org/wiki/UNIX-время unixtime ]. |
− | * $dateend(int) - время окончания периода в формате [ http://ru.wikipedia.org/wiki/UNIX-время | + | * $dateend(int) - время окончания периода в формате [ http://ru.wikipedia.org/wiki/UNIX-время unixtime ]. |
* $numweeks(int) - количество недель в учебном периоде. | * $numweeks(int) - количество недель в учебном периоде. | ||
* $name(string) - название учебного периода. | * $name(string) - название учебного периода. |
Версия 14:18, 8 ноября 2010
Плагин | |
Название | ages |
Тип | storages |
Содержание
- 1 Таблица в базе данных
- 2 Дополнительные методы:
- 2.1 get_department_ages($departmentid, $status='active')
- 2.2 get_next_ageid($ageid, $agenum)
- 2.3 get_previous_ageid($ageid, $agenum)
- 2.4 create_period_for_department($deptid, $datebegin, $dateend, $numweeks, $name, $previousid=null)
- 2.5 get_numberof_ages()
- 2.6 get_ages_by_idrange()
- 2.7 get_agenum_byageid()
- 3 Планы:
- 4 События
Таблица в базе данных
ages - учебные периоды (учебный год в школе, семестр в ВУЗе). Каждый учебный поток и итоговая отметка по курсу принадлежат какому-то одному учебному периоду.
Подробный формат полей в таблице:
- name - название учебного периода
- begindate - дата и время начала по UTC
- enddate - дата и время окончания по UTC
- eduweeks - количество учебных недель/циклов (каждая соответствует одному циклу в расписании) продолжительности курса, которые помещаются в этом учебном периоде.
- departmentid - структурное подразделение в таблице departments , объявившее учебный период
- previousid - предыдущий учебный период
- status - список статусов указан в одноименном плагине рабочих процессов ages
Дополнительные методы:
- + Получить список текущих учебных периодов для структурного подразделения. Возвращает массив объектов. По умолчанию - все периоды в статусе "идет учебный процесс". Если второй параметр null - возвращаются все периоды, если строка - периоды в этом статусе, если массив - все периоды в таких статусах. Для удобства нужно сделать заготовку, которая принимает такой параметр и имя sql-колонки и возвращает соответствующий фрагмент sql-запроса - и поместить ее защищенным методом в storage_base.
- + Получить id учебного периода, являющегося x по счету после периода с заданным id. При этом x=1 - это сам исходный период (период для "первого класса), x=2 - это период, для которого период x=1 был предыдущим. Метод возвращает id или false, если однозначно установить id периода не удалось.
- Создать период для структурного подразделения: получает параметры "структурное подразделение", "дата начала", "дата конца", "количество учебных недель", "название", "предыдущий период" - по умолчанию 0. Не указывать предыдущий период допускается только если для этого структурного подразделения еще не было создано периодов. Если для периода уже есть один "последующий период", то больше его указывать в качестве "предыдущего" нельзя. Метод возвращает id созданного периода или false.
get_department_ages($departmentid, $status='active')
находит список всех или в указанном статусе учебных периодов структурного подразделения
Аргументы:
- $departmentid(int) - id учебного подразделения в таблице departments.
- $status(string) - статус учебного периода, или null если нужны периоды с любым статусом, по умолчанию 'active'.
Возвращаемые значения
- array - массив объектов из таблицы ages.
- bool false - если ничего не найдено.
get_next_ageid($ageid, $agenum)
находит один из дочерних учебных периодов
Аргументы:
- $ageid(int) - id учебного периода в таблице ages
- $agenum(int) - сколько периодов вперед отсчитать относительно переданного ageid. При этом переданный id считается первым.
Возвращаемые значения
- int - id периода
- bool false - если установить id не удалось
get_previous_ageid($ageid, $agenum)
находит предшествующий указанному в ageid учебный период
Аргументы:
- $ageid(int) - id учебного периода в таблице ages
- $agenum(int) - сколько периодов назад отсчитать относительно переданного ageid. При этом переданный ageid считается последним.
Возвращаемые значения
- int - id периода или
- bool false - если установить id не удалось
create_period_for_department($deptid, $datebegin, $dateend, $numweeks, $name, $previousid=null)
создаёт период для структурного подразделения
Аргументы:
- $deptid(int) - id учебного подразделения.
- $datebegin(int) - время начала периода в формате [ http://ru.wikipedia.org/wiki/UNIX-время unixtime ].
- $dateend(int) - время окончания периода в формате [ http://ru.wikipedia.org/wiki/UNIX-время unixtime ].
- $numweeks(int) - количество недель в учебном периоде.
- $name(string) - название учебного периода.
- $previosid(int) - id предыдущего учебного периода или null, если нет предыдущего периода, по умолчанию null.
Возвращает
- int - id созданного периода.
- bool false - если период создать нельзя.
get_numberof_ages()
находит количество периодов
Аргументы:
- $select - критерии отбора записей
Возвращает
- int количество найденных записей
get_ages_by_idrange()
получаеть список записей по диапазону id
Аргументы:
- $minid - минимальный id
- $maxid - максимальный id
Возвращает
- array|bool
get_agenum_byageid()
находит порядковый номер периода, считая от заданного периода
Аргументы:
- $startageid - id периода на котором нужно остановить поиск
- $currentageid - id периода, порядковый номер которого нам надо узнать
- $maxagenum - максимально возможный номер agenum
Возвращает
- mixed int - agenum
- bool false - если не находит
Планы:
Надо реализовать удаление периода так: если к периоду ничего не привязано (потоки, подразделения и т.п.), то его можно удалять. Иначе - нельзя.
События
В этом разделе описан список всех событий, которые генерируются, перехватываются и обрабатываются этим плагином.
Перехватываемые события
Тип плагина | Код плагина | Код события | Доп. данные | Пояснение |
---|---|---|---|---|
Этот плагин не перехватывает никаких событий |
Генерируемые события
Тип плагина | Код плагина | Код события | Доп. данные | Пояснение |
---|---|---|---|---|
storage | ages | insert | Массив, содержащий в поле "new" объект с данными для вставки в таблицу.
Пример: array('new' => $dataobject) |
Генерируется каждый раз при вставке новой записи в таблицу ages. |
storage | ages | update | Массив, содержащий в поле "new" обновленный объект, и в поле "old" объект со старыми данными, до обновления записи.
Пример: array('old' => $dataobject_old, 'new' => $dataobject_new) |
Генерируется каждый раз при обновлении записи в таблице ages. |
storage | ages | delete | Массив, содержащий в поле "old" объект с данными, которые удаляются из таблицы
Пример: array('old' => $dataobject) |
Генерируется каждый раз при удалении записи из таблицы ages. |