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

Материал из DOF
Перейти к: навигация, поиск
(Создана страница)
 
 
(не показана 1 промежуточная версия 1 участника)
Строка 13: Строка 13:
  
 
===Дополнительные методы:===
 
===Дополнительные методы:===
 +
 +
===='''get_listing($limitfrom, $limitnum, $conds=null, $countonly=false)'''====
 +
 +
Возвращает список объектов, выбранных из таблицы по критериям, которые переданы в качестве входных параметров.
 +
 +
''Аргументы:''
 +
* integer $limitfrom - порядковый номер записи в общем списке объектов, которая будет первой выведена на экран;
 +
* integer $limitnum - количество объектов, которые показываются на странице;
 +
* array $conds - массив вида имя_поля => значение_поля, в котором передаются параметры выборки, по умолчанию null
 +
* bool $countonly - если true - вернуть только количество записей, по умолчанию false
 +
''Структура работы:''
 +
* Проверяем корректность переданных параметров.
 +
* Формируем фрагмент sql-запроса.
 +
* Если надо только количество записей - возвращаем их.
 +
* Иначе - возвращаем записи из таблицы.
 +
''Возвращаемые значения:''
 +
* integer - количество записей.
 +
* array - массив записей.
  
 
===События===
 
===События===
Строка 57: Строка 75:
 
  |Генерируется каждый раз при удалении записи из таблицы.
 
  |Генерируется каждый раз при удалении записи из таблицы.
 
  |}
 
  |}
 
[[Категория:Разработка]]
 
[[Категория:Плагины_storages]]
 

Текущая версия на 13:17, 30 июня 2014

Плагин
Название positions
Тип storages


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

positions - Список должностей.

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

  • name - название должности
  • code - код должности
  • departmentid - подразделение, которому принадлежит учебный процесс в таблице departments
  • status - список статусов указан в одноименном плагине рабочих процессов positions

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

get_listing($limitfrom, $limitnum, $conds=null, $countonly=false)

Возвращает список объектов, выбранных из таблицы по критериям, которые переданы в качестве входных параметров.

Аргументы:

  • integer $limitfrom - порядковый номер записи в общем списке объектов, которая будет первой выведена на экран;
  • integer $limitnum - количество объектов, которые показываются на странице;
  • array $conds - массив вида имя_поля => значение_поля, в котором передаются параметры выборки, по умолчанию null
  • bool $countonly - если true - вернуть только количество записей, по умолчанию false

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

  • Проверяем корректность переданных параметров.
  • Формируем фрагмент sql-запроса.
  • Если надо только количество записей - возвращаем их.
  • Иначе - возвращаем записи из таблицы.

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

  • integer - количество записей.
  • array - массив записей.

События

В этом разделе описан список всех событий, которые генерируются, перехватываются и обрабатываются этим плагином.

Перехватываемые события

Таблица событий, которые перехватывает этот плагин
Тип плагина Код плагина Код события Доп. данные Пояснение
Этот плагин не перехватывает никаких событий

Генерируемые события

Таблица событий, которые генерирует этот плагин
Тип плагина Код плагина Код события Доп. данные Пояснение
storage positions insert Массив, содержащий в поле "new" объект с данными для вставки в таблицу.

Пример: array('new' => $dataobject)

Генерируется каждый раз при вставке новой записи в таблицу.
storage positions update Массив, содержащий в поле "new" обновленный объект, и в поле "old" объект со старыми данными, до обновления записи.

Пример: array('old' => $dataobject_old, 'new' => $dataobject_new)

Генерируется каждый раз при обновлении записи в таблице.
storage positions delete Массив, содержащий в поле "old" объект с данными, которые удаляются из таблицы

Пример: array('old' => $dataobject)

Генерируется каждый раз при удалении записи из таблицы.