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

Материал из DOF
Перейти к: навигация, поиск
(Подробный формат полей в таблице:)
(Дополнительные методы:)
Строка 14: Строка 14:
  
 
===Дополнительные методы:===
 
===Дополнительные методы:===
'''get_first_learning_data()'''  
+
 
 +
 
 +
===='''get_first_learning_data($programmsbcid)''' ====
  
 
Получить первую запись на момент начала обучения
 
Получить первую запись на момент начала обучения
  
 
''Аргументы:''  
 
''Аргументы:''  
* $programmsbcid - id подписки ученика на учебную программу (таблица [[Разработка:storages/programmsbcs|programmsbcs]])
+
* $programmsbcid - id подписки ученика на учебную программу (таблица [[Разработка:storages/programmsbcs|programmsbcs]]), по которой запрашивается история
 +
''Возвращаемое значение:''
 +
* (mix) object|bool - объект из таблицы [[Разработка:storages/learninghistory|learninghistory]], или false
  
'''get_actual_learning_data()'''  
+
===='''get_actual_learning_data($programmsbcid)'''====
  
Получить текущую информацию об учебных подписках и периодах  
+
Получение текущую информацию об учебных подписках и периодах  
  
 
''Аргументы:''  
 
''Аргументы:''  
* $programmsbcid - id подписки ученика на учебную программу (таблица [[Разработка:storages/programmsbcs|programmsbcs]])
+
* $programmsbcid - id подписки ученика на учебную программу (таблица [[Разработка:storages/programmsbcs|programmsbcs]]), по которой запрашивается история
 +
''Возвращаемое значение:''
 +
* (mix) object|bool - объект из таблицы [[Разработка:storages/learninghistory|learninghistory]], или false
  
'''get_history()'''  
+
===='''get_history(get_history($programmsbcid, $timefrom=null, $timeto=null))'''====
  
Получить историю изменений подписок по времени
+
Получение истории изменения подписок по времени
  
 
''Аргументы:''  
 
''Аргументы:''  
 
* $programmsbcid - id подписки ученика на учебную программу (таблица [[Разработка:storages/programmsbcs|programmsbcs]]), по которой запрашивается история  
 
* $programmsbcid - id подписки ученика на учебную программу (таблица [[Разработка:storages/programmsbcs|programmsbcs]]), по которой запрашивается история  
* $timefrom - начало временного периода, за который запрашивается история изменения подписок (если указано)
+
* $timefrom - начало временного периода, за который запрашивается история изменения подписок, по умолчанию null
* $timeto - конец временного периода, за который запрашивается история изменения подписок (если указано)
+
* $timeto - конец временного периода, за который запрашивается история изменения подписок, по умолчанию null
 +
''Возвращаемое значение:''
 +
* (mix) object|bool - объект из таблицы [[Разработка:storages/learninghistory|learninghistory]], или false
  
'''get_subscribe_ages()'''
+
===='''get_subscribe_ages($programmsbcid)'''====
  
Получить историю изменений подписок без дубликатов
+
Выводит все учебные периоды, в которых проходила указанная учебная программа(без повторений)
  
 
''Аргументы:''
 
''Аргументы:''
 
* $programmsbcid - id подписки ученика на учебную программу (таблица [[Разработка:storages/programmsbcs|programmsbcs]]), по которой запрашивается история
 
* $programmsbcid - id подписки ученика на учебную программу (таблица [[Разработка:storages/programmsbcs|programmsbcs]]), по которой запрашивается история
 +
''Возвращаемое значение:''
 +
* array - массив записей из таблицы [[Разработка:storages/learninghistory|learninghistory]]
 +
 
===Планы:===
 
===Планы:===
  

Версия 14:43, 10 ноября 2010

Плагин
Название 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), по которой запрашивается история

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

Планы:

События

В этом разделе описан список всех событий, которые генерируются, перехватываются и обрабатываются этим плагином.

Перехватываемые события

Таблица событий, которые перехватывает этот плагин
Тип плагина Код плагина Код события Доп. данные Пояснение
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.