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

Материал из DOF
Перейти к: навигация, поиск
(→‎Возможные статусы:)
(→‎Возможные статусы:)
Строка 1: Строка 1:
−
====Возможные статусы:====
+
{{Infobox_Plugin
−
*доступно (active)
+
| name = invitems
−
*не доступно (notavailable)
+
| type = workflows
−
*списано (scrapped)
+
}}
−
*в ремонте (repairing)
 
−
*удалено(только для ошибочно-заведенных)(deleted)
 
  
−
*доступно
+
==Возможные статусы:==
−
** не доступно
+
* доступно (active) - доступно для заказа
−
** списано
+
* не доступно (notavailable) - не доступно для заказа(поломка)
−
** в ремонте
+
* списано (scrapped) - списано по какойто причине(не починили)
−
** удалено
+
* в ремонте (repairing) - оборудование находится в ремонта
 +
* удалено (deleted) только для ошибочно-заведенных
  
−
* не доступно
+
== Метастатусы ==
−
** доступно
+
* Активный: granted
−
** списано
+
* Актуальный: active, granted
−
** в ремонте
+
* Реальный: active, granted, canceled, notavailable
 +
* Мусорный: deleted
  
 +
== Маршруты статусов==
 +
Правила описания маршрутов: описания возможностей перехода в новый статус на основании текущего статуса и условия, действительные только при переходе в новый статус из текущего статуса. При инициализации статус объекта равен доступный(active)
  
−
* списано конечный
+
==== доступный(active) ====
 +
Возможные переходы ИЗ этого статуса:
 +
* не доступно (notavailable)
 +
* списано (scrapped)
 +
* в ремонте (repairing)
 +
* удалено (deleted)
  
−
* в ремонте
+
==== не доступен (notavailable)  ====
−
** списано
+
Возможные переходы ИЗ этого статуса:
−
** доступно
+
* доступно (active)
 +
* списано (scrapped)
 +
* в ремонте (repairing)
  
−
* удалено - конечный
+
==== в ремонте (repairing) ====
 +
Возможные переходы ИЗ этого статуса:
 +
* списано (scrapped)
 +
* доступно (active)
 +
 
 +
==== списано (scrapped) ====
 +
Это конечный статус.
 +
 
 +
==== удален (deleted) ====
 +
Это конечный статус.
 +
 
 +
 
 +
== API ==
 +
 
 +
==== get_list() ====
 +
Получить список всех возможных статусов
 +
 
 +
''Аргументы:''
 +
* (нет)
 +
''Возвращаемые значения:''
 +
* Массив, со списком всех возможных статусов в формате "обозначение" => "Перевод"
 +
 
 +
==== get_name() ====
 +
Получить название статуса по его обозначению в базе данных
 +
 
 +
''Аргументы:''
 +
* (string) $status - обозначение статуса латинскими буквами
 +
''Возвращаемые значения:''
 +
* (string|bool) - перевод для этого статуса, либо false, если он не обнаружен в списке допустимых
 +
 
 +
==== get_available() ====
 +
Получить список статусов, в которые может перейти указанное оборудование.
 +
 
 +
''Аргументы:''
 +
* $id - id учебного комплекта в таблице [[Разработка:storages/invitems|invitems]]
 +
''Возвращаемые значения:''
 +
* (array|bool) - массив возможных состояний в формате ('обозначение' => 'первод') или false в случае когда запись не найдена. В случае, когда переход из этого статуса невозможен - возвращается пустой массив.
 +
 
 +
==== change() ====
 +
Сменить статус комплекта на указанный.
 +
 
 +
''Аргументы:''
 +
* (int) $id - id комплекта в таблице [[Разработка:storages/invitems|invitems]]
 +
* (string) $status - обозначение статуса латинскими буквами
 +
* (array) $opt - Массив, где содержатся дополнительные параметры для смены статуса. По умолчанию null.
 +
''Возвращаемые значения:''
 +
* (bool) true - если статус удалось изменить, или false в случае ошибки
 +
 
 +
При обращении к функции change() выполняются дополнительные действия, указанные выше, в разделе "Маршруты статусов". При каждом изменении статуса данные записываются в таблицу [[Разработка:storages/statushistory|statushistory]].
 +
==== init() ====
 +
Запускается при вставке в таблицу [[Разработка:storages/invitems|invitems]] новой записи. Автоматически назначает созданному оборудованию статус "доступен" (active).
 +
 
 +
''Аргументы:''
 +
* $id - id только что созданного единицы оборудования в таблице [[Разработка:storages/invitems|invitems]]
 +
''Возвращаемые значения:''
 +
* (bool) true если статус успешно назначен или false в случае ошибки
 +
 
 +
==Перехватываемые события==
 +
{| border="1"
 +
|+ Таблица событий, которые перхватывает этот плагин
 +
! Тип плагина
 +
! Код плагина
 +
! Код события
 +
! Пояснение
 +
|-
 +
|
 +
|
 +
|
 +
|
 +
|}

Версия 13:19, 25 ноября 2011

Плагин
Название invitems
Тип workflows


Возможные статусы:

  • доступно (active) - доступно для заказа
  • не доступно (notavailable) - не доступно для заказа(поломка)
  • списано (scrapped) - списано по какойто причине(не починили)
  • в ремонте (repairing) - оборудование находится в ремонта
  • удалено (deleted) только для ошибочно-заведенных

Метастатусы

  • Активный: granted
  • Актуальный: active, granted
  • Реальный: active, granted, canceled, notavailable
  • Мусорный: deleted

Маршруты статусов

Правила описания маршрутов: описания возможностей перехода в новый статус на основании текущего статуса и условия, действительные только при переходе в новый статус из текущего статуса. При инициализации статус объекта равен доступный(active)

доступный(active)

Возможные переходы ИЗ этого статуса:

  • не доступно (notavailable)
  • списано (scrapped)
  • в ремонте (repairing)
  • удалено (deleted)

не доступен (notavailable)

Возможные переходы ИЗ этого статуса:

  • доступно (active)
  • списано (scrapped)
  • в ремонте (repairing)

в ремонте (repairing)

Возможные переходы ИЗ этого статуса:

  • списано (scrapped)
  • доступно (active)

списано (scrapped)

Это конечный статус.

удален (deleted)

Это конечный статус.


API

get_list()

Получить список всех возможных статусов

Аргументы:

  • (нет)

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

  • Массив, со списком всех возможных статусов в формате "обозначение" => "Перевод"

get_name()

Получить название статуса по его обозначению в базе данных

Аргументы:

  • (string) $status - обозначение статуса латинскими буквами

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

  • (string|bool) - перевод для этого статуса, либо false, если он не обнаружен в списке допустимых

get_available()

Получить список статусов, в которые может перейти указанное оборудование.

Аргументы:

  • $id - id учебного комплекта в таблице invitems

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

  • (array|bool) - массив возможных состояний в формате ('обозначение' => 'первод') или false в случае когда запись не найдена. В случае, когда переход из этого статуса невозможен - возвращается пустой массив.

change()

Сменить статус комплекта на указанный.

Аргументы:

  • (int) $id - id комплекта в таблице invitems
  • (string) $status - обозначение статуса латинскими буквами
  • (array) $opt - Массив, где содержатся дополнительные параметры для смены статуса. По умолчанию null.

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

  • (bool) true - если статус удалось изменить, или false в случае ошибки

При обращении к функции change() выполняются дополнительные действия, указанные выше, в разделе "Маршруты статусов". При каждом изменении статуса данные записываются в таблицу statushistory.

init()

Запускается при вставке в таблицу invitems новой записи. Автоматически назначает созданному оборудованию статус "доступен" (active).

Аргументы:

  • $id - id только что созданного единицы оборудования в таблице invitems

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

  • (bool) true если статус успешно назначен или false в случае ошибки

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

Таблица событий, которые перхватывает этот плагин
Тип плагина Код плагина Код события Пояснение
Источник — «http://docs.deansoffice.ru/wiki/index.php?title=Разработка:workflows/invitems&oldid=2430»