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

Agadzhanyan в 07:24, 2 марта 2018

2018-03-02T07:24:45Z

Agadzhanyan: /* Events */

2018-03-02T07:12:45Z

‎Events

Agadzhanyan: /* API */

2018-03-02T07:11:43Z

‎API

Polikarpov в 14:37, 28 декабря 2015

2015-12-28T14:37:09Z

Polikarpov в 12:21, 17 декабря 2015

2015-12-17T12:21:35Z

Johnleft: добавлен infobox

2009-10-23T10:53:21Z

добавлен infobox

Yumeneco в 08:15, 5 октября 2009

2009-10-05T08:15:56Z

Yumeneco: Новая: == Отделы == Этот интерфейс позволяет просматривать и редактировать информацию о структурных подразде...

2009-10-05T07:59:33Z

Новая: == Отделы == Этот интерфейс позволяет просматривать и редактировать информацию о структурных подразде...

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

== Отделы ==
Этот интерфейс позволяет просматривать и редактировать информацию о структурных подразделениях.
=== Список отделов ===
Программы выводятся списком, каждая строчка в котором отображает информацию о структурном подразделении. В левом верхнем углу экрана содержится ссылка на создание подразделения.

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

Если у пользователя есть право редактировать подразделения, то в последней строке таблицы с информацией вместо иконки просмотра появляется иконка редактирования, нажатие на которую отправляет пользователя на страницу редактирования учебной программы.

Также, если указать дополнительный параметр leaddepid - id подразделения, страница выведет список всех дочерних подразделений указанного подразделения.

=== Создание и редактирование ===
Это действие доступно только для пользователей с правом редактирования подразделения.

'''Назначение полей:'''
* ''Название'' - название подразделения. Обязательное поле.
* ''Кодовое название'' - код подразделения, обязательное поле. Не может быть создано двух подразделений с одинаковым кодом.
* ''Руководитель'' - научный руководитель структурного подразделения. По умолчанию не указан. Выбирается из списка существующих персон.
* ''Вышестоящий отдел'' - какому подразделению подчиняется данное подразделение. По умолчанию стоит самое первое созданное подразделение. Выбирается из списка существующих подразделений. Может принимать значение - нет (штатная ситуация). Обязательное поле.
* ''Часовой пояс'' - в какой временной зоне находится подразделение. Необходимо для правильного расчета времени при составлении рассписания и др. Выбирается по шкале универсального координированного времени, UTC. По умолчанию время сервера (GMT+5). Обязательное поле.

Также имеет дополнительные поля адреса, которые скрыты. Если данные поля активны, то на подразделение создается/редактируется его адрес.

'''При создании/редактировании подразделения'''
* Поле "код предмета" должно быть уникальным и содержать латинские буквы и числа
'''При создании/редактировании адреса подразделения'''
* Индекс должен быть числовым.
* Если указывается улица, то необходимо указать ее тип.

=== Карточка отдела ===

Выводит всю информацию о структурном подразделении. Имеет те же поля, что и в форме создания/редактирования включая адрес подразделения. Также выводит список всех дочерних подразделения данного позразделения в древовидной структуре.

=== Планы ===
* Добавить колонку "дочерние отделы". И в ней ссылка на список дочерних подразделений.
* Добавить под названием родительского подразделения ссылки "перейти на уровень вверх" и "перейти на верхний уровень".
* Выводить в табличку всю древовидную структуру дочрних подразделений, а не только один уровень.

@@ Строка 28: / Строка 28: @@
 Выводит всю информацию о структурном подразделении. Также выводит список всех дочерних подразделения данного подразделения в древовидной структуре.
 == API ==
@@ Строка 87: / Строка 121: @@
 ''Возвращаемые значения:''
 * (array) - Массив для добавления в select список

@@ Строка 92: / Строка 92: @@
 === Получение ссылки на объект ===
-'plugintype' => 'im',
+* 'plugintype' => 'im'
-'plugincode' => 'obj'
+* 'plugincode' => 'obj'
-'eventcode'  => 'get_object_url'
+* 'eventcode'  => 'get_object_url'
-* Возвращается ссылка на объект
+Возвращается ссылка на объект
 === Добавление подразделения ===
-'plugintype' => 'storage',
+* 'plugintype' => 'storage'
-'plugincode' => 'departments'
+* 'plugincode' => 'departments'
-'eventcode'  => 'insert'
+* 'eventcode'  => 'insert'
-* Сбрасывается кеш списка подразделений
+Сбрасывается кеш списка подразделений
 === Добавление подразделения ===
-'plugintype' => 'storage',
+* 'plugintype' => 'storage'
-'plugincode' => 'departments'
+* 'plugincode' => 'departments'
-'eventcode'  => 'update'
+* 'eventcode'  => 'update'
-* Сбрасывается кеш списка подразделений
+Сбрасывается кеш списка подразделений

← Предыдущая		Версия 07:11, 2 марта 2018
Строка 72:		Строка 72:
	''Возвращаемые значения:''		''Возвращаемые значения:''
	* (string) - HTML-строка со ссылкой на подразделение или пустая строка в случае ошибки		* (string) - HTML-строка со ссылкой на подразделение или пустая строка в случае ошибки
		+
		+	===== get_departments_select_options($parentdep = 0, $options = []) =====
		+	Возвращает список доступных подразделений для отображения в селекте.
		+	Метод является рекурсивным и кеширует список подразделений.
		+	Кеш сбрасывается при любом CrUD действии для актуализации данных.
		+
		+	''Параметры:''
		+	* (int)$parentdep - Подразделение, от которого начинается сбор массива
		+	* (array)$options - Массив опций сбора данных
		+	['delimiter'] - Разделитель для уровней иерархии. По - умолчанию '-'
		+	['statuses'] - Массив статусов в виде ['status1', 'status2']. По-умолчанию - actual метастатус
		+	['access_callback'] - Функция дополнительной проверки прав доступа к подразделению
		+
		+	''Возвращаемые значения:''
		+	* (array) - Массив для добавления в select список
		+
		+	== Events ==
		+	Список отлавливаемых событий
		+
		+	=== Получение ссылки на объект ===
		+	'plugintype' => 'im',
		+	'plugincode' => 'obj'
		+	'eventcode' => 'get_object_url'
		+
		+	* Возвращается ссылка на объект
		+
		+	=== Добавление подразделения ===
		+	'plugintype' => 'storage',
		+	'plugincode' => 'departments'
		+	'eventcode' => 'insert'
		+
		+	* Сбрасывается кеш списка подразделений
		+
		+	=== Добавление подразделения ===
		+	'plugintype' => 'storage',
		+	'plugincode' => 'departments'
		+	'eventcode' => 'update'
		+
		+	* Сбрасывается кеш списка подразделений

@@ Строка 8: / Строка 8: @@
 === Список подразделений ===
-Интерфейс позволяет увидеть только подразделения текущего местонахождения пользователя( само подразделение и его прямые потомки ).
+=== Форма сохранения подразделения ===
-=== Сохранение подразделения ===
+Форма сохранения подразделения приспособлена под включение на любую страницу системы и работает с системой потока сообщений Деканата.
 '''Назначение полей:'''
 * ''Название'' - Название подразделения. Обязательное поле.
-* ''Кодовое название'' - Код подразделения. Уникальное поле. Автоматически генерируется для новых подразделений, если не указано вручную.
+* ''Код подразделения'' - Обязательное поле. Уникальное поле. Автоматически генерируется для новых подразделений, если не указано вручную(транслитерация первых 10 символов названия и  добавление случайного номера).
-* ''Руководитель'' - Руководитель структурного подразделения. По умолчанию не указан. Выбирается из списка существующих персон. Несет исключительно информационную цель. Пользователь не получает никаких прав, став Руководителем.
+* ''Руководитель'' - Необязательное поле. Руководитель структурного подразделения. По-умолчанию не указан. Выбирается из списка существующих персон и несет исключительно информационную цель. Пользователь не получает никаких прав, став Руководителем.
-* ''Вышестоящий отдел'' - Какому подразделению подчиняется данное подразделение. По умолчанию стоит подразделение текущего местоположения пользователя. Выбирается из списка существующих подразделений. Обязательное поле.
+* ''Вышестоящий отдел'' - Обязательное поле. Какому подразделению подчиняется данное подразделение. По умолчанию стоит подразделение текущего местоположения пользователя. Выбирается из списка существующих подразделений.
-* ''Часовой пояс'' - в какой временной зоне находится подразделение. Необходимо для правильного расчета времени при составлении рассписания и др. Выбирается по шкале универсального координированного времени, UTC. По умолчанию время сервера (GMT+5). Обязательное поле.
+* ''Часовой пояс'' - Обязательное поле. Временная зона подразделения. Необходимо для правильного расчета времени при составлении расписания и др. действий в системе. Выбирается по шкале универсального координированного времени, UTC. По умолчанию время сервера.
 === Карточка отдела ===
-Выводит всю информацию о структурном подразделении. Имеет те же поля, что и в форме создания/редактирования включая адрес подразделения. Также выводит список всех дочерних подразделения данного позразделения в древовидной структуре.
+Выводит всю информацию о структурном подразделении. Также выводит список всех дочерних подразделения данного подразделения в древовидной структуре.
-=== Планы ===
+Методы интерфейса подразделений
 ===== get_listing() =====
@@ Строка 46: / Строка 43: @@
 * (array) массив записей из базы, или false в случае ошибки
-===== showlist() =====
+=====showlist($list, $addvars, $options = [])=====
-Возвращает html-код списка подразделений.
+Возвращает HTML-код таблицы подразделений
 ''Параметры:''
-* $list - массив записей из таблицы [[Разработка:storages/departments|departments]] для отображения.
+* (array) $list - Массив подразделений из справочника [[Разработка:storages/departments|departments]].
 ''Возвращаемые значения:''
-* (string) - html-код или false в случае ошибки
+* (string) -  HTML-код таблицы подразделений
 ===== show_id() =====
-Возвращает html-код отображения информации об одном подразделении
+Возвращает HTML-код отображения информации об одном подразделении
 ''Параметры:''
@@ Строка 62: / Строка 61: @@
 ''Возвращаемые значения:''
-* (string) - html-код или false в случае ошибки
+* (string) - HTML-код или false в случае ошибки

@@ Строка 3: / Строка 3: @@
 | type = im
 }}
-== Отделы ==
-Этот интерфейс позволяет просматривать и редактировать информацию о структурных подразделениях.
+== Подразделения ==
-=== Список отделов ===
+Интерфейс позволяет производить действия с подразделениями системы. Подразделения - отдельные элементы Деканата, которые позволяют разграничить работу с контингентом, установить собственные настройки плагинов и права пользователей. Под подразделениями можно понимать такие элементы, как Институты и их Филиалы, Факультеты и Отделы.
 Подразделения выводятся списком, каждая строчка в котором отображает информацию о структурном подразделении. В левом верхнем углу экрана содержится ссылка на создание подразделения.
-Пользователь попадает на эту страницу, только если у него есть право просматривать данные своего подразделения (в этом случае необходимо указать дополнительный параметр - id подразделения), либо имеет право видеть все подразделения.
+В зависимости от уровня прав, которыми располагает пользователь, становятся доступны функции создания, удаления и редактирования.
-Если у пользователя есть право редактировать подразделения, то в последней строке таблицы с информацией вместо иконки просмотра появляется иконка редактирования, нажатие на которую отправляет пользователя на страницу редактирования учебной программы.
+Интерфейс позволяет увидеть только подразделения текущего местонахождения пользователя( само подразделение и его прямые потомки ).
-Также, если указать дополнительный параметр leaddepid - id подразделения, страница выведет список всех дочерних подразделений указанного подразделения.
+=== Сохранение подразделения ===
 Это действие доступно только для пользователей с правом редактирования.
 '''Назначение полей:'''
-* ''Название'' - название подразделения. Обязательное поле.
+* ''Название'' - Название подразделения. Обязательное поле.
-* ''Кодовое название'' - код подразделения, обязательное поле. Не может быть создано двух подразделений с одинаковым кодом.
+* ''Кодовое название'' - Код подразделения. Уникальное поле. Автоматически генерируется для новых подразделений, если не указано вручную.
-* ''Руководитель'' - научный руководитель структурного подразделения. По умолчанию не указан. Выбирается из списка существующих персон.
+* ''Руководитель'' - Руководитель структурного подразделения. По умолчанию не указан. Выбирается из списка существующих персон. Несет исключительно информационную цель. Пользователь не получает никаких прав, став Руководителем.
-* ''Вышестоящий отдел'' - какому подразделению подчиняется данное подразделение. По умолчанию стоит самое первое созданное подразделение. Выбирается из списка существующих подразделений. Может принимать значение - нет (штатная ситуация). Обязательное поле.
+* ''Вышестоящий отдел'' - Какому подразделению подчиняется данное подразделение. По умолчанию стоит подразделение текущего местоположения пользователя. Выбирается из списка существующих подразделений. Обязательное поле.
 * ''Часовой пояс'' - в какой временной зоне находится подразделение. Необходимо для правильного расчета времени при составлении рассписания и др. Выбирается по шкале универсального координированного времени, UTC. По умолчанию время сервера (GMT+5). Обязательное поле.
 === Карточка отдела ===
@@ Строка 54: / Строка 45: @@
 ''Возвращаемые значения:''
 * (array) массив записей из базы, или false в случае ошибки
 ===== showlist() =====

← Предыдущая		Версия 10:53, 23 октября 2009
Строка 1:		Строка 1:
		+	{{Infobox_Plugin
		+	\| name = departments
		+	\| type = im
		+	}}
	== Отделы ==		== Отделы ==
	Этот интерфейс позволяет просматривать и редактировать информацию о структурных подразделениях.		Этот интерфейс позволяет просматривать и редактировать информацию о структурных подразделениях.

@@ Строка 2: / Строка 2: @@
 Этот интерфейс позволяет просматривать и редактировать информацию о структурных подразделениях.
 === Список отделов ===
-Программы выводятся списком, каждая строчка в котором отображает информацию о структурном подразделении. В левом верхнем углу экрана содержится ссылка на создание подразделения.
+Подразделения выводятся списком, каждая строчка в котором отображает информацию о структурном подразделении. В левом верхнем углу экрана содержится ссылка на создание подразделения.
 Пользователь попадает на эту страницу, только если у него есть право просматривать данные своего подразделения (в этом случае необходимо указать дополнительный параметр - id подразделения), либо имеет право видеть все подразделения.
@@ Строка 38: / Строка 38: @@
 * Добавить под названием родительского подразделения ссылки "перейти на уровень вверх" и "перейти на верхний уровень".
 * Выводить в табличку всю древовидную структуру дочрних подразделений, а не только один уровень.