Разработка:storages/learninghistory
| Плагин | |
| Название | learninghistory |
| Тип | storages |
Таблица в базе данных
learninghistory - таблица хранит историю изменений учебных процессов для каждого ученика.
Подробный формат полей в таблице:
- programmsbcsid - id подписки ученика на учебную программу в таблице programmsbcs.
- ageid - id учебного периода в таблице ages, в котором были пройдены дисциплины данной параллели
- agenum - номер параллели (класс или семестр и т. п.)
- changedate - дата создания записи в формате unixtimestamp
- orderid - id приказа, в результате которого учащийся был записан на данную параллель (таблица orders). Возможно null-значение, если изменения не были связаны ни с каким приказом.
Дополнительные методы:
get_first_learning_data($programmsbcid)
Получить первую запись на момент начала обучения
Аргументы:
- $programmsbcid - id подписки ученика на учебную программу (таблица programmsbcs), по которой запрашивается история
Возвращаемое значение:
- (mix) object|bool - объект из таблицы learninghistory, или false
get_actual_learning_data($programmsbcid)
Получение текущую информацию об учебных подписках и периодах
Аргументы:
- $programmsbcid - id подписки ученика на учебную программу (таблица programmsbcs), по которой запрашивается история
Возвращаемое значение:
- (mix) object|bool - объект из таблицы learninghistory, или false
get_history(get_history($programmsbcid, $timefrom=null, $timeto=null))
Получение истории изменения подписок по времени
Аргументы:
- $programmsbcid - id подписки ученика на учебную программу (таблица programmsbcs), по которой запрашивается история
- $timefrom - начало временного периода, за который запрашивается история изменения подписок, по умолчанию null
- $timeto - конец временного периода, за который запрашивается история изменения подписок, по умолчанию null
Возвращаемое значение:
- (mix) object|bool - объект из таблицы learninghistory, или false
get_subscribe_ages($programmsbcid)
Выводит все учебные периоды, в которых проходила указанная учебная программа(без повторений)
Аргументы:
- $programmsbcid - id подписки ученика на учебную программу (таблица programmsbcs), по которой запрашивается история
Возвращаемое значение:
- array - массив записей из таблицы learninghistory
add($programmsbc)
Добавляет историю изменения учебного процесса для ученика.
Аргументы:
- $programmsbc - id в таблице programmsbcs) или сам объект с таким id
Возвращаемое значение:
- array - массив записей или false
Планы:
События
В этом разделе описан список всех событий, которые генерируются, перехватываются и обрабатываются этим плагином.
Перехватываемые события
| Тип плагина | Код плагина | Код события | Доп. данные | Пояснение |
|---|---|---|---|---|
| storage | programmsbcs | insert | Стандартные | |
| storage | programmsbcs | update | Стандартные | |
| storage | programmsbcs | delete | Стандартные |
Генерируемые события
| Тип плагина | Код плагина | Код события | Доп. данные | Пояснение |
|---|---|---|---|---|
| storage | learninghistory | insert | Массив, содержащий в поле "new" объект с данными для вставки в таблицу.
Пример: array('new' => $dataobject) |
Генерируется каждый раз при вставке новой записи в таблицу learninghistory. |
| storage | learninghistory | update | Массив, содержащий в поле "new" обновленный объект, и в поле "old" объект со старыми данными, до обновления записи.
Пример: array('old' => $dataobject_old, 'new' => $dataobject_new) |
Генерируется каждый раз при обновлении записи в таблице learninghistory. |
| storage | learninghistory | delete | Массив, содержащий в поле "old" объект с данными, которые удаляются из таблицы
Пример: array('old' => $dataobject) |
Генерируется каждый раз при удалении записи из таблицы learninghistory. |
