Разработка:storages/agroups — различия между версиями
Ilya (обсуждение | вклад) м (→Подробный формат полей в таблице:) |
Ilya (обсуждение | вклад) (→Дополнительные методы:: описано какие id из каких таблиц надо брать, добавлены ссылки) |
||
| Строка 31: | Строка 31: | ||
''Аргументы:'' | ''Аргументы:'' | ||
| − | * $prid(int) - id программы. | + | * $prid(int) - id программы в таблице [[Разработка:storages/programms | programms ]]. |
* $status(string) - статус группы, по умолчанию - обучается(learn). | * $status(string) - статус группы, по умолчанию - обучается(learn). | ||
''Возвращаемые значения:'' | ''Возвращаемые значения:'' | ||
| Строка 47: | Строка 47: | ||
''Аргументы:'' | ''Аргументы:'' | ||
| − | * $dpid(int) - id структурного подразделения. | + | * $dpid(int) - id структурного подразделения в таблице [[Разработка:storages/departments | departments ]]. |
| − | * $prid(int) - id программы, по умолчанию - все(null). | + | * $prid(int) - id программы в таблице [[Разработка:storages/programms | programms ]], по умолчанию - все(null). |
* $status(string) - статус группы, по умолчанию - обучается(learn). | * $status(string) - статус группы, по умолчанию - обучается(learn). | ||
''Возвращаемые значения:'' | ''Возвращаемые значения:'' | ||
| Строка 66: | Строка 66: | ||
''Аргументы:'' | ''Аргументы:'' | ||
| − | * $csid(int) - id учебного процесса. | + | * $csid(int) - id учебного процесса в таблице [[Разработка:storages/cstreams | cstreams ]]. |
''Возвращаемые значения:'' | ''Возвращаемые значения:'' | ||
* (array) список групп. | * (array) список групп. | ||
Версия 22:05, 13 января 2010
| Плагин | |
| Название | agroups |
| Тип | storages |
Содержание
Таблица в базе данных
agroups - классы/академические группы. Связывают контракты на обучение и учебные программы при групповой форме обучения.
Подробный формат полей в таблице:
- name - название академической группы/класса
- code - кодовое обозначение группы (текстовое поле, обязательное, уникальное)
- programmid - id учебной программы в таблице programms , которую реализует академическая группа
- departmentid - отдел в таблице departments , ответственный за группу
- agenum - порядковый номер текущего учебного периода (изменяется приказом по контингенту)
- status - список статусов указан в одноименном плагине рабочих процессов agroups
Дополнительные методы:
search_group_code()
Ищет группы по коду.
Аргументы:
- $code(string) - код группы.
Возвращаемые значения:
- (object) объект группы.
- (bool) false если группа не найдена.
get_group_programm()
Получает все группы, обучающиеся по учебной программе.
Аргументы:
- $prid(int) - id программы в таблице programms .
- $status(string) - статус группы, по умолчанию - обучается(learn).
Возвращаемые значения:
- (array) список групп.
- (bool) false если группы не найдены.
Структура работы:
- формируем SQL-запрос и возвращаем список групп:
- если указывается статус - группы с указанным статусом,
- если статус указывается null - группы с любым статусом,
- если статус не указывается - группы со статусом learn.
get_group_department()
Получает все группы, относящиеся к структурному подразделению.
Аргументы:
- $dpid(int) - id структурного подразделения в таблице departments .
- $prid(int) - id программы в таблице programms , по умолчанию - все(null).
- $status(string) - статус группы, по умолчанию - обучается(learn).
Возвращаемые значения:
- (array) список групп.
- (bool) false если группы не найдены.
Структура работы:
- формируем SQL-запрос и возвращаем список групп:
- если указывается id программы - группы с указанным id,
- если id программы не указывается или указывается как null- группы с любым id.
- если указывается статус - группы с указанным статусом,
- если статус указывается null - группы с любым статусом,
- если статус не указывается - группы со статусом learn.
get_group_cstream
Получает все группы, подписанные на учебный процесс с данным id.
Аргументы:
- $csid(int) - id учебного процесса в таблице cstreams .
Возвращаемые значения:
- (array) список групп.
- (bool) false если группы не найдены.
