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

Polikarpov в 11:44, 14 января 2015

2015-01-14T11:44:02Z

Yumeneco в 10:22, 25 февраля 2014

2014-02-25T10:22:31Z

Yumeneco: переименовал «Разработка:sync/courseenrolments» в «Разработка:sync/courseenrolment»

2014-02-25T10:21:02Z

переименовал «Разработка:sync/courseenrolments» в «Разработка:sync/courseenrolment»

Nickkang в 08:44, 26 апреля 2011

2011-04-26T08:44:14Z

Nickkang в 07:56, 26 апреля 2011

2011-04-26T07:56:47Z

Nickkang: Добавлены методы синхронизации оценок

2011-04-21T12:54:15Z

Добавлены методы синхронизации оценок

Ilya: API

2010-05-12T18:57:55Z

API

Alex: изменены методы подписки/отписки

2010-04-30T18:45:28Z

изменены методы подписки/отписки

Alex: описание плагина

2010-04-30T16:55:31Z

описание плагина

Alex: Создаем новый плагин

2010-04-30T16:36:48Z

Создаем новый плагин

Новая страница

← Предыдущая		Версия 11:44, 14 января 2015
Строка 149:		Строка 149:
	* ''Условия запуска (нюансы, логика запуска)''		* ''Условия запуска (нюансы, логика запуска)''
	** Запускатся если в конфигурационном файле задана переменная, активирующая синхронизацию и если пониженная нагрузка системы в данный момент, иначе вернет true.		** Запускатся если в конфигурационном файле задана переменная, активирующая синхронизацию и если пониженная нагрузка системы в данный момент, иначе вернет true.
		+
		+	==Перехватываемые события==
		+	{\| border="1"
		+	\|+ Таблица событий, которые перехватывает этот плагин
		+	! Тип плагина
		+	! Код плагина
		+	! Код события
		+	! Пояснение
		+	\|-
		+	\| workflow
		+	\| cpassed
		+	\| cpassed_active
		+	\| Событие смены статуса на активный
		+	\|-
		+	\| workflow
		+	\| cpassed
		+	\| cpassed_not_active
		+	\| Событие смены статуса с активного на любой другой
		+	\|-
		+	\| workflow
		+	\| cstreams
		+	\| cstreams_active
		+	\| Событие смены статуса на активный
		+	\|-
		+	\| workflow
		+	\| cstreams
		+	\| cstreams_passive
		+	\| Событие смены статуса с любого на неактивный
		+	\|-
		+	\| workflow
		+	\| cstreams
		+	\| cstreams_not_active
		+	\| Событие смены статуса с активного на любой другой
		+	\|-
		+	\| storage
		+	\| cpassed
		+	\| insert
		+	\| Событие добавления записи в справочник
		+	\|-
		+	\| storage
		+	\| cpassed
		+	\| delete
		+	\| Событие удаления записи из справочника
		+	\|-
		+	\| storage
		+	\| cstreams
		+	\| insert
		+	\| Событие добавления записи в справочник
		+	\|-
		+	\| storage
		+	\| cstreams
		+	\| update
		+	\| Событие обновления записи в справочнике
		+	\|-
		+	\| storage
		+	\| cstreams
		+	\| delete
		+	\| Событие удаления записи из справочника
		+	\|}

@@ Строка 1: / Строка 1: @@
 {{Infobox_Plugin
-| name = courseenrolments
+| name = courseenrolment
 | type = sync
 }}

← Предыдущая		Версия 08:44, 26 апреля 2011
Строка 141:		Строка 141:
	* ''Возвращаемое значение:''		* ''Возвращаемое значение:''
	** на данный момент не предусмотрено возвращаемого значения		** на данный момент не предусмотрено возвращаемого значения
		+
		+	== Cron ==
		+	* ''Периодичность запуска''
		+	** Значение берется из конфигурационного файла (стоит учитывать, что это происходит только при установке или обновлении плагина)
		+	* ''Что выполняется''
		+	** sync_grades()
		+	* ''Условия запуска (нюансы, логика запуска)''
		+	** Запускатся если в конфигурационном файле задана переменная, активирующая синхронизацию и если пониженная нагрузка системы в данный момент, иначе вернет true.

@@ Строка 51: / Строка 51: @@
 === sync_grades() ===
 * ''Краткое описание:''
-** Синхронизирует оценки деканата и moodle (запускается кроном)
+Синхронизирует оценки деканата и moodle (запускается кроном)
 * ''Логика работы:''
 ** Выбирает указанное в кофиге кол-во активных самых давно синхронизированных cstream`ов (отсортированных по дате последней синхронизации в порядке возрастания)
@@ Строка 62: / Строка 62: @@
 === sync_cstream() ===
 * ''Краткое описание:''
-** Синхронизирует оценки деканата и moodle по конкретному cstream`у
+Синхронизирует оценки деканата и moodle по конкретному cstream`у
 * ''Логика работы:''
 ** Смотрит в дисциплине из таблицы programmitems (связанной с cstream`ом) флаг gradesyncenabled. Если false, то не синхронизируем
@@ Строка 88: / Строка 88: @@
 ** false в случае ошибки
 ** null - если нет оценки пока

← Предыдущая		Версия 12:54, 21 апреля 2011
Строка 35:		Строка 35:
	* $mdlgroupid - id группы в курсе, куда будет записываться пользователь		* $mdlgroupid - id группы в курсе, куда будет записываться пользователь
	* $mdluserid - id пользователя в moodle		* $mdluserid - id пользователя в moodle
		+
		+
		+	=== get_cfg() ===
		+	* ''Краткое описание:''
		+	Позволяет обращаться к конфигурационному файлу данного плагина.
		+	* ''Логика работы:''
		+	** Для работы требуется переменная класса для хранения массива параметров из файла, т.е. обращение в файл производится только при первой попытке.
		+	** Ищет конфигурационный файл (в соответствии с логикой работы dof - $this->dof->plugin_path($this->type(),$this->code(),'/cfg/cfg.php'))
		+	** Возвращает значение по ключу (если ключ не указан, то возвращает весь массив параметров из файла). к примеру return @$mas['a'], т.е. если нет значения, то не генерируется ошибка, а возвращается null.
		+	* ''Аргументы:''
		+	** string[optional] $key=null Ключ в массиве, т.е. искомый параметр. Если параметр не передан, то возвращается весь массив.
		+	* ''Возвращаемое значение:''
		+	** Параметр или null (если конфигурационный файл не найден или если параметр не найден в файле или если он найден и его значение null, это стоит учитывать)
		+
		+	=== sync_grades() ===
		+	* ''Краткое описание:''
		+	** Синхронизирует оценки деканата и moodle (запускается кроном)
		+	* ''Логика работы:''
		+	** Выбирает указанное в кофиге кол-во активных самых давно синхронизированных cstream`ов (отсортированных по дате последней синхронизации в порядке возрастания)
		+	** вернет false, если нет параметра в конфиге
		+	** запускает sync_cstream()
		+	* ''Аргументы:''
		+	* ''Возвращаемое значение:''
		+	** bool успешность. Если в конфиге не найдено количество cstream`ов, синхронизируемых за раз, то false. Так же false в случае, если произошла ошибка синхронизации хоть одного cstream`а
		+
		+	=== sync_cstream() ===
		+	* ''Краткое описание:''
		+	** Синхронизирует оценки деканата и moodle по конкретному cstream`у
		+	* ''Логика работы:''
		+	** Смотрит в дисциплине из таблицы programmitems (связанной с cstream`ом) флаг gradesyncenabled. Если false, то не синхронизируем
		+	** Выбирает все активные cpassed`ы для данного cstream`а
		+	** получает оценку с помощью метода get_scale_grade
		+	** Формирует и исполняет ведомость (с помощью класса, который находится в папке плагина в файле order_itog_grades.php), которая проставляет оценку в cpassed.
		+	** В зависимости от оценки и параметров дисциплины incjournwithoutgrade и incjournwithunsatisfgrade может не исполнить ведомость. Если передан параметр closing то в любом случае исполняет ведомость.
		+	* ''Аргументы:''
		+	** int $cstreamid id cstream
		+	** bool $closing[optional] = false Если закрываем cstream (т.е. закрываем не здесь, но значит все cpassed надо обязательно проставить)
		+	* ''Возвращаемое значение:''
		+	** bool
		+
		+	=== get_scale_grade() ===
		+	* ''Краткое описание:''
		+	получает оценку для указанного cpassed`а из таблиц moodle
		+	* ''Логика работы:''
		+	** Ищет итоговую оценку курса в таблице grade_grades, id которого указан в cpassed`е. Если в дисциплине указан altgradeitem, то берет оценку из нее, т.е. из записи из grade_items с указанным id (пока для этого варианта не работает приведение оценки к шкале дисциплины ЭД)
		+	** С помощью метода bring_grade_to_scale оценку в шкалу для данной дисциплины деканата
		+	* ''Аргументы:''
		+	** int\|object $cpassed id cpassed`а или сам объект
		+	** int\|object[optional] $pitem id programmitem`а или сам объект
		+	* ''Возвращаемое значение:''
		+	** Приведенная к шкале оценка
		+	** false в случае ошибки
		+	** null - если нет оценки пока

← Предыдущая	Версия 10:21, 25 февраля 2014
(нет различий)

← Предыдущая		Версия 18:57, 12 мая 2010
Строка 10:		Строка 10:

	Подписка, отписка и включение в группу происходит с использованием плагина modlibs/ama (modlib('ama')->course($mcourse)->role()->enrol(), modlib('ama')->course($mcourse)->role()->unenrol(), modlib('ama')->course($mcourse)->group($mgroup)->add_member($muser),		Подписка, отписка и включение в группу происходит с использованием плагина modlibs/ama (modlib('ama')->course($mcourse)->role()->enrol(), modlib('ama')->course($mcourse)->role()->unenrol(), modlib('ama')->course($mcourse)->group($mgroup)->add_member($muser),
		+	== API ==
		+	=== enrol_to_course() ===
		+	Записывает пользователя на курс.
		+	* возвращаемое значение: (bool)
		+	** true если пользователя удалось подписать
		+	** false если произошла ошибка
		+	* $mdlcourseid - id курса в Moodle на который подписывается пользователь
		+	* $mdluserid - id пользователя в moodle
		+	* $mdlgroupid[optional] - id группы, в которую будет записан пользователь или null, если пользователь не будет записан в группу
		+	* @param int $mdlroleid[optional] - id роли прльзователя в курсе (из таблицы moodle). Роль по умолчанию - ученик.
		+	* @param int $timeend[optional] - время окончания обучения на курсе в формете unixtime (при наступлении этой даты пользователь булет отписан с курса)
		+	* @param bool $hidden[optional] - записать пользователя в скрытом режиме (он не будет отображаться в списке пользователей для учеников и учителей курса)
		+	=== unenrol_from_course() ===
		+	Отписывает пользователя из курса
		+	* возвращаемое значение: (bool)
		+	** true если пользователя удалось отписать
		+	** false если произошла ошибка
		+	* $mdlcourseid - id курса в Moodle с которого отписывается пользователь
		+	* $mdluserid - id пользователя в moodle
		+	=== add_to_group() ===
		+	Записывает пользователя в группу moodle
		+	* возвращаемое значение: (bool)
		+	* $mdlcourseid - id курса в Moodle в котором находится группа
		+	* $mdlgroupid - id группы в курсе, куда будет записываться пользователь
		+	* $mdluserid - id пользователя в moodle

← Предыдущая		Версия 18:45, 30 апреля 2010
Строка 9:		Строка 9:
	* Отписка от курса Moodle (вызывается из рабочего процесса cpassed при выводе подписки из статуса active).		* Отписка от курса Moodle (вызывается из рабочего процесса cpassed при выводе подписки из статуса active).

−	Подписка и ~~отписка~~ происходит с использованием плагина modlibs/ama (modlib('ama')->course($mcourse)->role()->enrol(~~$muser~~), modlib('ama')->course($mcourse)->role()->~~unassign~~(~~$muser~~), modlib('ama')->course($mcourse)->group($mgroup)->add_member($muser),	+	Подписка, отписка и включение в группу происходит с использованием плагина modlibs/ama (modlib('ama')->course($mcourse)->role()->enrol(), modlib('ama')->course($mcourse)->role()->unenrol(), modlib('ama')->course($mcourse)->group($mgroup)->add_member($muser),

← Предыдущая		Версия 16:55, 30 апреля 2010
Строка 3:		Строка 3:
	\| type = sync		\| type = sync
	}}		}}
		+
		+	Синхронизация подписок на учебные потоки с подписками на курсы Moodle.
		+
		+	* Подписка на курс Moodle (вызывается из рабочего процесса cpassed при переводе объекта cpassed в статус "active", в случае, если для ученика существует пользователь Moodle, а для дисциплины задан курс Moodle). При этом, если для потока задана группа moodle, она тоже передается и при подписке происходит включение в эту группу.
		+	* Отписка от курса Moodle (вызывается из рабочего процесса cpassed при выводе подписки из статуса active).
		+
		+	Подписка и отписка происходит с использованием плагина modlibs/ama (modlib('ama')->course($mcourse)->role()->enrol($muser), modlib('ama')->course($mcourse)->role()->unassign($muser), modlib('ama')->course($mcourse)->group($mgroup)->add_member($muser),