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

Материал из DOF
Перейти к: навигация, поиск
(create_period_for_department($deptid, $datebegin, $dateend, $numweeks, $name, $previousid=null))
(Дополнительные методы:)
Строка 32: Строка 32:
 
* array - массив объектов из таблицы ages.
 
* array - массив объектов из таблицы ages.
 
* bool false - если ничего не найдено.
 
* bool false - если ничего не найдено.
 +
  
 
===='''get_next_ageid($ageid, $agenum)'''====
 
===='''get_next_ageid($ageid, $agenum)'''====
Строка 43: Строка 44:
 
* int - id периода
 
* int - id периода
 
* bool false - если установить id не удалось
 
* bool false - если установить id не удалось
 +
  
 
===='''get_previous_ageid($ageid, $agenum)'''====
 
===='''get_previous_ageid($ageid, $agenum)'''====
Строка 54: Строка 56:
 
* int - id периода или
 
* int - id периода или
 
* bool false - если установить id не удалось
 
* bool false - если установить id не удалось
 +
  
 
===='''create_period_for_department($deptid, $datebegin, $dateend, $numweeks, $name, $previousid=null)'''====
 
===='''create_period_for_department($deptid, $datebegin, $dateend, $numweeks, $name, $previousid=null)'''====
Строка 69: Строка 72:
 
* int - id созданного периода.
 
* int - id созданного периода.
 
* bool false - если период создать нельзя.
 
* bool false - если период создать нельзя.
 +
  
 
===='''get_numberof_ages()'''====
 
===='''get_numberof_ages()'''====

Версия 14:19, 8 ноября 2010

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


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

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) - время начала периода в формате unixtime.
  • $dateend(int) - время окончания периода в формате 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.