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

Материал из DOF
Перейти к: навигация, поиск
(Дополнительные методы:)
м (Дополнительные методы:)
Строка 79: Строка 79:
 
# получаем масив состыкованных КТ и событий.
 
# получаем масив состыкованных КТ и событий.
 
# формируем новый массив состыкованных КТ и событий, в котором индексы заменены на метки времени.
 
# формируем новый массив состыкованных КТ и событий, в котором индексы заменены на метки времени.
#* получаем метку времени при помощи [[#get_date()|get_date()]].
+
#* получаем метку времени при помощи get_date().
 
#* если метку времени не получили, переходим к следующему элементу,
 
#* если метку времени не получили, переходим к следующему элементу,
 
#* если метка времени не уникальна, делаем ее уникальной.
 
#* если метка времени не уникальна, делаем ее уникальной.
 
#* записываем получившуюся метку времени, как ключ массива.
 
#* записываем получившуюся метку времени, как ключ массива.
 
# соритуем массив по ключам в порядке возрастания.
 
# соритуем массив по ключам в порядке возрастания.
# возвращаем результат.
+
# возвращаем результат.
  
 
===Планы:===
 
===Планы:===

Версия 15:23, 12 августа 2009

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

plans - темы в учебном плане и контрольные точки внутри учебной дисциплины/предмета, предусмотренные учебным планом курса.

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

  • linkid - связь с учебным периодом, учебной программой, дисциплиной или учебным процессом
  • linktype - тип связи (ages, programmitems, cstreams)
  • parentid - id родительской контрольной точки, если она наследовалась от стандартной темы в плане (модификация или дубль), либо id основной контрольной точки, если оценка является "дополнительной" (статус "дополнительная" - при этом тема не отображается в плане отдельной строкой, а только в подробной информации про основную тему, если основная тема наследуется, то и все дополнительные наследуются), по умолчанию - 0
  • name - название контрольной точки или темы занятия
  • reldate - относительная дата сдачи в секундах от начала учебного процесса, периода.
  • reldldate - относительная дата последнего срока сдачи в секундах от начала учебного процесса, периода. Может совпадать с reldate.
  • scale - диапазон или перечисленные через запятую возможные оценки, пустая строка если оценка не предусмотрена
  • type - тип события (очный урок/лекция, дистанционный урок/лекция, семинар, лабораторная работа, практическая работа, контрольная работа, промежуточная атестация)
  • typesync - тип синхронизации (выставление вручную, синхронизация с moodle)
  • mdlinstance - id задания в moodle для синхронизации
  • status - список статусов указан в одноименном плагине рабочих процессов plans

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

get_checkpoints()

Получает список контрольных точек напрямую связанных с одним объектом привязки. Сортируются по относительной дате. Данный метод возвращает только контрольные точки, напрямую привязанные к объекту, его не следует использовать для отображения полного учебно-тематического плана!

Аргументы:

  • $id(int) - id элемента, к которому привязана контрольная точка.
  • $type(string) - тип элемента, к которому привязана контрольная точка. (ages, programmitems, cstreams).
  • $status(string) - статус контрольной точки, по умолчанию - действующая(active).

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

  • (array) массив объектов из таблицы.
  • (bool) false если контрольные точки не найдены.

Структура работы:

  • формируем SQL-запрос и возвращаем список КТ:
    • если указывается статус - КТ с указанным статусом,
    • если статус указывается null - КТ с любим статусом,
    • если статус не указывается - КТ со статусом active.

get_checkpoints_for_cstreams()

Получает список контрольных точек актуальных для данного учебного процесса (включая контрольные точки дисциплины и периода, с которыми связан данный учебный процесс). Сортируются по абсолютной дате, которая вычисляется как дата старта учебного процесса + относительная дата точек, привязанных к учебному процессу или точек, привязанных к дисциплине, или как дата начала учебного периода + относительная дата точек, привязанных к учебному периоду.

Аргументы:

  • $csid - id учебного процесса.

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

  • (array) массив объектов из таблицы.
  • (bool) false если контрольные точки не найдены.

Структура работы:

  • формируем SQL-запрос:
    • по данному id находим учебный процесс.
    • формируем условие выборки.
    • по id периода из учебного находим учебный период.
      • если период существует, добавляем его в условие выборки и формируем дополнительную колонку содержащюю абсолютную дату для каждой КТ,
      • если периода нет, формируем дополнительную колонку без учета периода.
  • возвращаем список КТ по SQL-запросу.

get_date()

Получает метку времени контрольной точки или соответствующего события. Приватный метод.

Аргументы:

  • $pe() - объект контрольной точки.

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

  • (int) время контрольной точки.
  • (bool) false если ни одной метки времени найдено не было.

Структура работы:

  • если у КТ есть событие, возвращаем метку времени события.
  • если у КТ события нет, то вернем метку времени по абсолютной дате (дата старта типа элемента + относительная дата точки)
  • если у КТ нет элемента по типу связи или у элемента нет даты старта, то метку времени вернуть нельзя.

sort_checkpoints_and_events()

Получает список объединенных контрольных точек и событий отсортированных по дате события или контрольной точки.

Аргументы:

  • $id(int) - id элемента, к которому привязана контрольная точка.
  • $type(string) - тип элемента, к которому привязана контрольная точка. (ages, programmitems, cstreams).
  • $status(string) - статус контрольной точки, по умолчанию - действующая(active).

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

  • (array) массив объектов из таблицы.

Структура работы:

  1. находим необходимые контрольные точки.
  2. получаем масив состыкованных КТ и событий.
  3. формируем новый массив состыкованных КТ и событий, в котором индексы заменены на метки времени.
    • получаем метку времени при помощи get_date().
    • если метку времени не получили, переходим к следующему элементу,
    • если метка времени не уникальна, делаем ее уникальной.
    • записываем получившуюся метку времени, как ключ массива.
  4. соритуем массив по ключам в порядке возрастания.
  5. возвращаем результат.

Планы: