Разработка:storages/cpgrades - История изменений

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

2018-09-13T09:51:11Z

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

Alex: убраны категории, добавляемые шаблоном

2012-10-24T17:15:32Z

убраны категории, добавляемые шаблоном

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

2010-11-10T09:00:30Z

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

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

2010-11-09T12:59:10Z

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

Ilya: Добавлено описание событий и проставлены категории

2010-02-16T14:15:35Z

Добавлено описание событий и проставлены категории

Ilya: /* Дополнительные методы: */ описано какие id из каких таблиц надо брать, добавлены ссылки

2010-01-13T19:22:27Z

‎Дополнительные методы:: описано какие id из каких таблиц надо брать, добавлены ссылки

Ilya: /* Подробный формат полей в таблице: */ описано какие id из каких таблиц берутся, добавленны ссылки

2010-01-13T19:16:41Z

‎Подробный формат полей в таблице:: описано какие id из каких таблиц берутся, добавленны ссылки

Alex в 14:10, 12 октября 2009

2009-10-12T14:10:21Z

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

2009-08-11T12:13:53Z

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

Yumeneco: /* Дополнительные методы: */ Добавлены описания методов

2009-08-06T13:55:07Z

‎Дополнительные методы:: Добавлены описания методов

@@ Строка 17: / Строка 17: @@
 * teacherid - id сотрудника по справочнику [[Разработка:storages/persons | persons ]], вручную (если не синхронизация) выставившего отметку
 * status - статус оценки (черновик (tmp), поставлена (put), удалена (delete) )
 ====Комментарии====

← Предыдущая		Версия 17:15, 24 октября 2012
Строка 150:		Строка 150:
	\|Генерируется каждый раз при удалении записи из таблицы cpgrades.		\|Генерируется каждый раз при удалении записи из таблицы cpgrades.
	\|}		\|}
−
−	~~[[Категория:Разработка]]~~
−	~~[[Категория:Плагины_storages]]~~

@@ Строка 85: / Строка 85: @@
 # возвращаем результат.
-=====''get_all_grade_student($cpid)'''====
 Получает все оценки одного студента по подписке на дисциплину вместе с информацией из плана.

@@ Строка 23: / Строка 23: @@
 ===Дополнительные методы:===
-'''save_grade_student()'''
+===='''save_grade_student($obj)'''====
 Сохраняет отметку студента. (в перспективе, когда будет реализован справочник с историей изменения отметок - вызов функции протоколирования)
@@ Строка 31: / Строка 31: @@
 ''Возвращаемые значения:''
 * (int) id вставленной записи, если запись вставляется.
-* (bool) true, если запись обновляется.
+* (bool) - true, если запись обновляется и false, если операции не удались.
 ''Структура работы:''
 # находим запись в таблице БД по данным из обьекта:
@@ Строка 38: / Строка 37: @@
 #* если не найдена или статус не черновой - запысываем в таблицу БД и возвращаем результат.
 '''save_grade_students()'''
 Cохраняет отметки всех студентов.
@@ Строка 45: / Строка 45: @@
 * $obj(object) - запись в таблицу БД (объект, в котором имеются свойства date(дата), planid(id плана), teacherid(id учителя) и grades - массив записей, где ключ - id персоны, значения - оценка, подписка на учибный процесс и статус оценки).
 ''Возвращаемые значения:''
-* (bool) true, если все записи успешно обновильсь/вставились.
+* (bool) true, если все записи успешно обновильсь/вставились, и false, во всех остальных случаях.
 ''Структура работы:''
 # обновляем/вставляем все записи в БД.
@@ Строка 54: / Строка 53: @@
 # возвращаем результат.
 '''get_grade_student_cpassed()'''
 Получает последнюю по дате оценку студента по id-подписки и id контрольной точки
@@ Строка 63: / Строка 63: @@
 ''Возвращаемые значения:''
 * (object) запись из таблицы БД - последняя по дате оценка студента.
-* (bool) false если ни одной оценки не найдено.
+* (bool) - false, если ни одной оценки не найдено.
 ''Структура работы:''
 # находим все оценки студента отсортированных по дате в порядке убывания.
 # возвращаем первую стоящюю в списке оценку.
-Получает последнюю по дате оценку студента по id студента, id учебного потока и id контрольной точки
+===='''get_grade_student($stid, $csid, $plid)'''====
 ''Аргументы:''
@@ Строка 78: / Строка 79: @@
 ''Возвращаемые значения:''
 * (object) запись из таблицы БД - последняя по дате оценка студента.
-* (bool) false если ни одной оценки не найдено.
+* (bool) - false, если ни одной оценки не найдено.
 ''Структура работы:''
 # по id учебного потока и id студента находим подписку студента на учебный поток.
@@ Строка 84: / Строка 85: @@
 # возвращаем результат.
-'''get_all_grade_student()'''
+=====''get_all_grade_student($cpid)'''====
 Получает все оценки одного студента по подписке на дисциплину вместе с информацией из плана.
@@ Строка 91: / Строка 92: @@
 * $cpid(int) - id подписки на дисциплину в таблице [[Разработка:storages/cpassed | cpassed ]].
 ''Возвращаемые значения:''
-* (array) список оценок вместе c планом.
+* (array) - список оценок вместе c планом.
-* (bool) false если ни одной оценки не найдено.
+* (bool) - false, если ни одной оценки не найдено.
 ''Структура работы:''
 # находим все оценки студента по подписке.

← Предыдущая		Версия 14:15, 16 февраля 2010
Строка 105:		Строка 105:
	====Дополнительные методы:====		====Дополнительные методы:====
	* Получить историю изменения оценок по id подписки и id контрольной точки		* Получить историю изменения оценок по id подписки и id контрольной точки
		+	===События===
		+	В этом разделе описан список всех событий, которые генерируются, перехватываются и обрабатываются этим плагином.
		+	====Перехватываемые события====
		+	{\| border="1"
		+	\|+ Таблица событий, которые перехватывает этот плагин
		+	! Тип плагина
		+	! Код плагина
		+	! Код события
		+	! Доп. данные
		+	! Пояснение
		+	\|-
		+	\|colspan=5 align=center \| ''Этот плагин не перехватывает никаких событий''
		+	\|}
		+	====Генерируемые события====
		+	{\| border="1"
		+	\|+ Таблица событий, которые генерирует этот плагин
		+	! Тип плагина
		+	! Код плагина
		+	! Код события
		+	! Доп. данные
		+	! Пояснение
		+	\|-
		+	\|storage
		+	\|cpgrades
		+	\|insert
		+	\|Массив, содержащий в поле "new" объект с данными для вставки в таблицу.
		+	''Пример:'' array('new' => $dataobject)
		+	\|Генерируется каждый раз при вставке новой записи в таблицу cpgrades.
		+	\|-
		+	\|storage
		+	\|cpgrades
		+	\|update
		+	\|Массив, содержащий в поле "new" обновленный объект, и в поле "old" объект со старыми данными, до обновления записи.
		+	''Пример:'' array('old' => $dataobject_old, 'new' => $dataobject_new)
		+	\|Генерируется каждый раз при обновлении записи в таблице cpgrades.
		+	\|-
		+	\|storage
		+	\|cpgrades
		+	\|delete
		+	\|Массив, содержащий в поле "old" объект с данными, которые удаляются из таблицы
		+	''Пример:'' array('old' => $dataobject)
		+	\|Генерируется каждый раз при удалении записи из таблицы cpgrades.
		+	\|}
		+
		+	[[Категория:Разработка]]
		+	[[Категория:Плагины_storages]]

@@ Строка 59: / Строка 59: @@
 ''Аргументы:''
-* $cpid(int) - id подписки.
+* $cpid(int) - id подписки в таблице [[Разработка:storages/cpassed | cpassed ]].
-* $plid(int) - id контрольной точки.
+* $plid(int) - id контрольной точки в таблице [[Разработка:storages/plans | plans ]].
 ''Возвращаемые значения:''
 * (object) запись из таблицы БД - последняя по дате оценка студента.
@@ Строка 73: / Строка 73: @@
 ''Аргументы:''
-* $stid(int) - id студента.
+* $stid(int) - id студента в таблице [[Разработка:storages/persons | persons ]].
-* $cpid(int) - id учебного потока.
+* $cpid(int) - id учебного потока в таблице [[Разработка:storages/cstreams | cstreams ]].
-* $plid(int) - id контрольной точки.
+* $plid(int) - id контрольной точки в таблице [[Разработка:storages/plans | plans ]].
 ''Возвращаемые значения:''
 * (object) запись из таблицы БД - последняя по дате оценка студента.
@@ Строка 89: / Строка 89: @@
 ''Аргументы:''
-* $cpid(int) - id подписки.
+* $cpid(int) - id подписки на дисциплину в таблице [[Разработка:storages/cpassed | cpassed ]].
 ''Возвращаемые значения:''
 * (array) список оценок вместе c планом.
@@ Строка 98: / Строка 98: @@
 #* создаем новый объек со свойствами:
 #** grade - оценка студента
-#** plan - контрольная точка (информация из плана)
+#** plan - контрольная точка (информация из учебного плана, таблица [[Разработка:storages/plans | plans ]])
 #* записываем объект в массив
 # возвращаем созданный массив

@@ Строка 7: / Строка 7: @@
 ====Подробный формат полей в таблице:====
-* cpassedid - подписка на дисциплину (связь с personid студента осуществляется через id подписки)
+* cpassedid - подписка на дисциплину в таблице [[Разработка:storages/cpassed | cpassed ]] (связь с personid студента осуществляется через id подписки)
-* planid - контрольная точка или тема в плане, за которую получена оценка
+* planid - контрольная точка или тема в плане (таблица [[Разработка:storages/plans | plans ]]), за которую получена оценка
 * grade - полученная оценка
 * date - дата получения оценки
@@ Строка 14: / Строка 14: @@
 * typesync - тип синхронизации (выставление вручную, синхронизация с moodle)
 * mdlinstance - id задания в moodle, с которым выполнялась синхронизация
-* orderid - id приказа, в соответствии с которым была выставлена эта оценка
+* orderid - id приказа в таблице [[Разработка:storages/orders | orders ]], в соответствии с которым была выставлена эта оценка
-* teacherid - id сотрудника по справочнику persons, вручную (если не синхронизация) выставившего отметку
+* teacherid - id сотрудника по справочнику [[Разработка:storages/persons | persons ]], вручную (если не синхронизация) выставившего отметку
 * status - статус оценки (черновик (tmp), поставлена (put), удалена (delete) )

← Предыдущая		Версия 14:10, 12 октября 2009
Строка 1:		Строка 1:
		+	{{Infobox_Plugin
		+	\| name = cpgrades
		+	\| type = storages
		+	}}
	===Таблица в базе данных===		===Таблица в базе данных===
	''cpgrades'' - оценки по контрольным точкам внутри дисциплины. Контрольные точки могут быть как локальными (внутри учебной дисциплины), так и глобальными - на все учебное заведение (четверти в школе или промежуточные аттестации).		''cpgrades'' - оценки по контрольным точкам внутри дисциплины. Контрольные точки могут быть как локальными (внутри учебной дисциплины), так и глобальными - на все учебное заведение (четверти в школе или промежуточные аттестации).

@@ Строка 18: / Строка 18: @@
 ===Дополнительные методы:===
-====Планируются:====
+'''save_grade_student()'''
 * Получить историю изменения оценок по id подписки и id контрольной точки

@@ Строка 18: / Строка 18: @@
 ===Дополнительные методы:===
-* Получить оценку студента по id-подписки и id контрольной точки (возвращается последняя по дате оценка)
+* '''get_grade_student_cpassed'''($cpid, $plid) - получить оценку студента по id-подписки и id контрольной точки (возвращается последняя по дате оценка).
-* Получить все оценки (одного студента) по подписке на дисциплину вместе с информацией из плана
+* '''get_all_grade_student'''($cpid) - получить все оценки (одного студента) по подписке на дисциплину вместе с информацией из плана. По id подписки на учебный поток находит все оценки студента и для каждой оценки создает объект со свойствами grade - оценка студента и plan - информация из плана. Возвращает массив этих самых объектов.
-* Получить оценку студента по id студента, id предмето-класса (учебного потока) и id контрольной точки (возвращается последняя по дате оценка)
+* '''get_grade_student'''($stid, $csid, $plid) - получить оценку студента по id студента, id предмето-класса (учебного потока) и id контрольной точки (возвращается последняя по дате оценка).
-* Сохранить (добавить/обновить) отметку студента (в перспективе, когда будет реализован справочник с историей изменения отметок - вызов функции протоколирования)
+* '''save_grade_student'''($obj) - сохранить (добавить/обновить) отметку студента (в перспективе, когда будет реализован справочник с историей изменения отметок - вызов функции протоколирования). Обновляет запись в базе данных если оценка с данной подпиской на учебный процесс и с данным планом из объекта уже существует и при этом является черновой(status=tmp) и записывает ее, если такой записи не обнаружено.
-* Сохранить (добавить/обновить) отметки всех студентов
+* '''save_grade_students'''($obj) - сохранить (добавить/обновить) отметки всех студентов. Входными данными является объект, в котором имеются свойства date(дата), planid(id плана), teacherid(id учителя) и grades - массив записей, где ключ - id персоны, значения - оценка, подписка на учибный процесс и статус оценки. Перебирая данный массив создает обьект для сохранения в БД данных отдельно по каждому ученику и сохраняет успользуя предыдущую функцию.
 ====Планируются:====
 * Получить историю изменения оценок по id подписки и id контрольной точки