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

Материал из DOF
Перейти к: навигация, поиск
м (Генерируемые события)
 
(не показано 15 промежуточных версий 2 участников)
Строка 9: Строка 9:
 
====Подробный формат полей в таблице:====
 
====Подробный формат полей в таблице:====
 
* personid - id пользователя в таблице [[Разработка:storages/persons | persons ]]
 
* personid - id пользователя в таблице [[Разработка:storages/persons | persons ]]
 +
* num - уникальный номер договора.
 +
* numpass - номер пропуска сотрудника.
 
* date - дата заключения договора
 
* date - дата заключения договора
* departmentid - подразделение, которому принадлежит учебный процесс в таблице [[Разработка:storages/departments | departments ]]
 
 
* begindate - дата начала работы в формате unixtime
 
* begindate - дата начала работы в формате unixtime
 
* enddate  - дата окончания работы в формате unixtime
 
* enddate  - дата окончания работы в формате unixtime
 +
* departmentid - подразделение, которому принадлежит учебный процесс в таблице [[Разработка:storages/departments | departments ]]
 +
* status - список статусов указан в одноименном плагине рабочих процессов  [[Разработка:workflows/eagreements | eagreements ]]
 
* notice - дополнительные заметки о договоре.
 
* notice - дополнительные заметки о договоре.
* status - список статусов указан в одноименном плагине рабочих процессов  [[Разработка:workflows/eagreements | eagreements ]]
+
* adddate - дата вставки договора в БД.
  
 
===Дополнительные методы:===
 
===Дополнительные методы:===
 +
 +
 +
===='''insert($dataobject,$quiet=NULL)'''====
 +
 +
Вставляет запись в таблицу(ы) плагина
 +
''Аргументы:''
 +
* (obj) dataobject
 +
* quiet - не генерировать событий, по умолчанию null
 +
''Возвращаемые значения:''
 +
* mixed bool false если операция не удалась или id вставленной записи
 +
 +
===='''insert($dataobject,$quiet=NULL)'''====
 +
 +
Вставляет запись в таблицу(ы) плагина
 +
''Аргументы:''
 +
* (obj) dataobject
 +
* quiet - не генерировать событий, по умолчанию null
 +
''Возвращаемые значения:''
 +
* mixed bool false если операция не удалась или id вставленной записи
 +
 +
===='''get_listing($limitfrom, $limitnum, $conds=null, $countonly=false)'''====
 +
 +
Возвращает список записей из таблицы по указанным параметрам для отображения списка
 +
 +
''Аргументы:''
 +
* (int) $limitfrom - номер записи с которой начинается выборка
 +
* (int) $limitnum - количество записей, которое нужно извлечь
 +
* (obj) $conds - условия выборки, по умолчанию null
 +
* (bool) $countonly - только вернуть количество, по умолчанию false
 +
''Возвращаемые значения:''
 +
* (mixed) array|int
 +
 +
===='''get_eagreements($personid, $sort='adddate DESC', $limitfrom=0, $limitnum=1)'''====
 +
 +
Возвращает договора персоны отсортированных по наибольшиму значению adddate
 +
 +
''Аргументы:''
 +
* (int) $personid - id персоны
 +
* (str) $sort - параметры сортировки
 +
* (int) $limitfrom - номер записи с которой начинается выборка, по умолчанию=0
 +
* (int) $limitnum - количество записей, которое нужно извлечь, по умолчанию=1
 +
''Возвращаемые значения:''
 +
* (mixed) array - договора сотрудника или bool false
  
 
===События===
 
===События===
Строка 61: Строка 107:
 
  |Генерируется каждый раз при удалении записи из таблицы.
 
  |Генерируется каждый раз при удалении записи из таблицы.
 
  |}
 
  |}
 
[[Категория:Разработка]]
 
[[Категория:Плагины_storages]]
 

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

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


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

eagreements - Договора с сотрудниками.

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

  • personid - id пользователя в таблице persons
  • num - уникальный номер договора.
  • numpass - номер пропуска сотрудника.
  • date - дата заключения договора
  • begindate - дата начала работы в формате unixtime
  • enddate - дата окончания работы в формате unixtime
  • departmentid - подразделение, которому принадлежит учебный процесс в таблице departments
  • status - список статусов указан в одноименном плагине рабочих процессов eagreements
  • notice - дополнительные заметки о договоре.
  • adddate - дата вставки договора в БД.

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

insert($dataobject,$quiet=NULL)

Вставляет запись в таблицу(ы) плагина Аргументы:

  • (obj) dataobject
  • quiet - не генерировать событий, по умолчанию null

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

  • mixed bool false если операция не удалась или id вставленной записи

insert($dataobject,$quiet=NULL)

Вставляет запись в таблицу(ы) плагина Аргументы:

  • (obj) dataobject
  • quiet - не генерировать событий, по умолчанию null

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

  • mixed bool false если операция не удалась или id вставленной записи

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

Возвращает список записей из таблицы по указанным параметрам для отображения списка

Аргументы:

  • (int) $limitfrom - номер записи с которой начинается выборка
  • (int) $limitnum - количество записей, которое нужно извлечь
  • (obj) $conds - условия выборки, по умолчанию null
  • (bool) $countonly - только вернуть количество, по умолчанию false

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

  • (mixed) array|int

get_eagreements($personid, $sort='adddate DESC', $limitfrom=0, $limitnum=1)

Возвращает договора персоны отсортированных по наибольшиму значению adddate

Аргументы:

  • (int) $personid - id персоны
  • (str) $sort - параметры сортировки
  • (int) $limitfrom - номер записи с которой начинается выборка, по умолчанию=0
  • (int) $limitnum - количество записей, которое нужно извлечь, по умолчанию=1

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

  • (mixed) array - договора сотрудника или bool false

События

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

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

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

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

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

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

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

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

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

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

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