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

Материал из DOF
Перейти к: навигация, поиск
(Дополнительные методы:)
(Дополнительные методы:)
Строка 14: Строка 14:
  
 
===Дополнительные методы:===
 
===Дополнительные методы:===
* '''get_teacher_cstream'''($id, $status = 'go') - получить список учебных процессов у данного преподавателя (второй параметр - статус, по умолчанию - "идет").
 
* '''get_department_cstream'''($id, $status = 'go') - получить список учебных процессов у данного подразделения (второй параметр - статус, по умолчанию - "идет").
 
* '''get_age_cstream'''($id, $status = 'go') - получить список учебных процессов для данного учебного периода (второй параметр - статус, по умолчанию - "идет").
 
* '''get_programmitem_cstream'''($id, $status = 'go') - получить список учебных процессов по данной дисциплине (второй параметр - статус, по умолчанию - "идет").
 
* '''get_agroup_cstream'''($id) - получить список учебных процессов для академической группы.
 
  
====Планируются:====
+
'''get_teacher_cstream()'''
 +
 
 +
Получает список учебных процессов у данного преподавателя.
 +
 
 +
''Аргументы:''
 +
* $id(int) - id преподавателя.
 +
* $status(string) - статус потока, по умолчанию - идет(go).
 +
''Возвращаемые значения:''
 +
* (array) массив процессов.
 +
* (bool) false если процессы не найдены.
 +
''Структура работы:''
 +
* формируем SQL-запрос и возвращаем список процессов:
 +
** если указывается статус - прцессы с указанным статусом,
 +
** если статус указывается null - процессы с любим статусом,
 +
** если статус не указывается - процессы со статусом go.
 +
 
 +
'''get_department_cstream()'''
 +
 
 +
Получает список учебных процессов у данного подразделения.
 +
 
 +
''Аргументы:''
 +
* $id(int) - id подразделения.
 +
* $status(string) - статус потока, по умолчанию - идет(go).
 +
''Возвращаемые значения:''
 +
* (array) массив процессов.
 +
* (bool) false если процессы не найдены.
 +
''Структура работы:''
 +
* формируем SQL-запрос и возвращаем список процессов:
 +
** если указывается статус - прцессы с указанным статусом,
 +
** если статус указывается null - процессы с любим статусом,
 +
** если статус не указывается - процессы со статусом go.
 +
 
 +
'''get_age_cstream()'''
 +
 
 +
Получает список учебных процессов для данного учебного периода.
 +
 
 +
''Аргументы:''
 +
* $id(int) - id учебного периода.
 +
* $status(string) - статус потока, по умолчанию - идет(go).
 +
''Возвращаемые значения:''
 +
* (array) массив процессов.
 +
* (bool) false если процессы не найдены.
 +
''Структура работы:''
 +
* формируем SQL-запрос и возвращаем список процессов:
 +
** если указывается статус - прцессы с указанным статусом,
 +
** если статус указывается null - процессы с любим статусом,
 +
** если статус не указывается - процессы со статусом go.
 +
 
 +
'''get_programmitem_cstream()'''
 +
 
 +
Получает список учебных процессов по данной дисциплине.
 +
 
 +
''Аргументы:''
 +
* $id(int) - id дисциплины.
 +
* $status(string) - статус потока, по умолчанию - идет(go).
 +
''Возвращаемые значения:''
 +
* (array) массив процессов.
 +
* (bool) false если процессы не найдены.
 +
''Структура работы:''
 +
* формируем SQL-запрос и возвращаем список процессов:
 +
** если указывается статус - прцессы с указанным статусом,
 +
** если статус указывается null - процессы с любим статусом,
 +
** если статус не указывается - процессы со статусом go.
 +
 
 +
'''get_agroup_cstream'''
 +
 
 +
Получает список учебных процессов для академической группы.
 +
 
 +
''Аргументы:''
 +
* $id(int) - id академической группы.
 +
''Возвращаемые значения:''
 +
* (array) массив процессов.
 +
* (bool) false если процессы не найдены.
 +
 
 +
===Планы:===
 +
====Дополнительные методы:====
 
* Получить список учебных процессов для данного ученика с учетом персональной подписки и академических групп (второй параметр - статус, по умолчанию - "идет").
 
* Получить список учебных процессов для данного ученика с учетом персональной подписки и академических групп (второй параметр - статус, по умолчанию - "идет").

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

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

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

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

  • ageid - учебный период
  • programmitemid - дисциплина
  • teacherid - id преподавателя по таблице persons
  • departmentid - подразделение, которому принадлежит учебный процесс
  • mdlgroup - id группы moodle, соответствующей учебному потоку
  • eduweaks - количество учебных недель/циклов (каждая соответствует одному циклу в расписании) продолжительности курса, по-умолчанию берется из programmitems, если там не указано - из ages. Нужны для подсчета часов при составлении расписания.
  • begindate - дата и время, когда учебный процесс был впервые переведен в состояние "идет обучение" по UTC
  • enddate - дата и время окончания по UTC, когда учебный процесс был в последний раз выведен из состояния "идет обучения"
  • status - список статусов указан в одноименном плагине рабочих процессов cstreams

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

get_teacher_cstream()

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

Аргументы:

  • $id(int) - id преподавателя.
  • $status(string) - статус потока, по умолчанию - идет(go).

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

  • (array) массив процессов.
  • (bool) false если процессы не найдены.

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

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

get_department_cstream()

Получает список учебных процессов у данного подразделения.

Аргументы:

  • $id(int) - id подразделения.
  • $status(string) - статус потока, по умолчанию - идет(go).

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

  • (array) массив процессов.
  • (bool) false если процессы не найдены.

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

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

get_age_cstream()

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

Аргументы:

  • $id(int) - id учебного периода.
  • $status(string) - статус потока, по умолчанию - идет(go).

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

  • (array) массив процессов.
  • (bool) false если процессы не найдены.

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

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

get_programmitem_cstream()

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

Аргументы:

  • $id(int) - id дисциплины.
  • $status(string) - статус потока, по умолчанию - идет(go).

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

  • (array) массив процессов.
  • (bool) false если процессы не найдены.

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

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

get_agroup_cstream

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

Аргументы:

  • $id(int) - id академической группы.

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

  • (array) массив процессов.
  • (bool) false если процессы не найдены.

Планы:

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

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