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