Общие сведения
Правка выполняется в оснастке Администрирование => Процессы => Типы процессов.
Типы процессов представляют из себя дерево.
При редактирование типа может быть указано его название и признак наследования либо не наследования свойств от родительского типа.
В свойствах типа указываются следующие параметры:
разрешённые статусы, их порядок в редакторе и возможные переходы между ними;
допустимые параметры процесса, их порядок;
код (ID) начального и конечных статусов;
динамический класс, обрабатывающий события изменения процесса (не обязательно);
начальные группы решения, устанавливаемые в процесс с указанием их ролей (не обязательно) ;
допустимые для установки в процесс группы решения с указанием их ролей;
конфигурация (не обязательно).
Не следует без необходимости порождать большое количество типов процессов, наследованных от общего предка и различающихся только наименованием. Тип - главный классифицирующий признак для очереди процессов и в случае их большого количества эффективность фильтрации сильно падает. Пользуйтесь списковым параметром для разделения таких процессов.
Конфигурация
Далее описываются параметры конфигурации типа процесса, поддержанные ядром.
Параметры, поддерживаемые различными плагинами, описываются в разделах документации соответствующих плагинов, например.
В конфигурации типа процесса может быть указано:
# скрытие в редакторе процесса ссылки полной правки описания
hideDescriptionChange=1
# сокрытие (0) либо отображение 1 (на вкладке) сообщений, связанных с процессом
processShowMessages=1
# сокрытие (0) либо отображение 1 (на вкладке) привязок процесса
processShowLinks=1
# требования указания обязательного комментария при переводы в статусы
requireChangeCommentStatusIds=<status_ids>
# коды групп исполнителей через запятую, которые можно указать при создании процесса
onCreateSelectGroup=<groupIds>
# шаблон текста при добавлении в описание процесса текста кнопкой "Добавить"
descriptionAddPattern=(${description}\n)[(${time}) (${user})]\t(${text})
# произвольный шаблон времени для добавляемого текста
descriptionAddPattern.timePattern=dd.MM HH:mm
#
# JSP шаблон для отображения карточки процесса вместо стандартного /WEB-INF/jspf/user/process/process/process.jsp
#processCardJsp=/WEB-INF/jspf/user/process/process/custom/process_jur/zayavka.jsp
# HTML стиль левого и правого блока карточки процесса, по-умолчанию они делятся поровну
#style.processCardLeftBlock=min-width: 500px;
#style.processCardRightBlock=width: 100%
#
# параметры для отображения в карточке связанных процессов
#processShowProcessLinks=1
#processCreateLinkModeSelect=1
#
Где:
- <status_ids> - коды статусов через запятую;
- <groupIds> - коды групп через запятую.
Настройки поведения параметров процесса
# при ошибке правки параметров - обновление таблицы с параметрами, необходимо в случае, если при этом другие параметры изменяются динамическим кодом onErrorChangeParamsReload=1 # код параметра - категории, который должен быть указан перед переводом процесса в конечный статус categoryParamId=<param_code> # требование заполненности параметров перед установкой статуса, одна или несколько записей вида requireFillParamIdsBeforeStatusSet.<status_to_code>=<param_codes> # сокрытие параметров в том или ином статусе, одна или несколько записей вида hideParamIdsInStatus.<status_code>=<param_codes> # параметры, редактор для которых скрыт в данном типе процесса (заполняются программно) readonlyParamIds=<param_codes>
Где:
- <param_code> - код параметра процесса, который должен быть указан при его закрытии, при этом редактор открывается под переключением статуса процесса;
- <status_to_code> - код статуса, в который переводится процесс;
- <param_codes> - коды параметров процесса через запятую;
- <status_code> - код текущего статуса процесса.
Для настройки отображения параметра в зависимости от гибкой проверки условия одно или несколько правил:
# отображение параметра, только если выполняется JEXL выражение showParam.<paramId>.checkExpression=<JEXL_EXPR>
Где:
- <paramId> - код параметра;
- <JEXL_EXPR> - JEXL выражение.
В JEXL процессор передаются следующие объекты для вызова функций:
- user - объект класса ru.bgcrm.model.user.User - текущий пользователь;
- process - объект класс ru.bgcrm.model.process.Process - изменяющийся процесс;
- processParam - объект класса ru.bgcrm.dao.expression.ParamValueFunction - параметры изменяющегося процесса.
Ограничение количества исполнителей по группам
Одно или несколько правил вида:
executorRestriction.<n>.groupId=<groupId> executorRestriction.<n>.maxCount=<maxCount>
Где:
- <n> - порядковый числовой номер правила;
- <groupId> - код группы пользователей;
- <maxCount> - максимальное число исполнителей из данной группы на процессе.
Просматриваются все правила в порядке их номеров.
Настройка левой области карточки процесса
Для настройки отображения левой области карточки процесса в конфигурацию типа добавляются одна или несколько конструкций вида:
processCard.<id>.mode=<modes> processCard.<id>.components=<components>
Где:
- <id> - порядковый номер правила;
- <modes> - список через запятую режимов отображения карточки процесса, допустимые значения: card - просмотр карточки с открытием в буфере, linked - просмотр карточки процесса, привязанного к другому процессу с открытием в правой области первого процесса;
- <components> - через запятую компоненты левого блока, либо произвольные JSP файлы, позволяющие кастомизировать карту процесса; допустимые стандартные блоки: header, status, description, executors, links, params.
На снимке ниже подписаны соответствующие блоки левого блока карточки процесса.
Пример:
processCard.1.mode=card processCard.1.components=header;jsp:/WEB-INF/jspf/user/process/process/custom/process_stp/contract_process_count.jsp;status;description;executors;params
Создание процесса с привязанными объектами
Переменная в конфигурации типа процесса:
create.in.objectTypes=<типы объектов через запятую> create.in.copyParams=перечень пар <с параметра>:<на параметр>, разделённых точкой с запятой # открывать (1) либо не открывать (0) вкладку с созданным привязанным процессом create.in.<тип объекта>.openCreated=1
Разрешает создание процесса с привязанным данным объектом во вкладке Процессы объекта (ниже на скриншоте).
Копирование параметров поддерживается только для объектов, использующих стандартную систему параметров системы.
Типы объектов ядра:
- customer - контрагент.
Типы объектов плагинов описаны в документации плагинов.
Пример. Возможность создания процесса с привязкой контрагента, копированием параметра с кодами 1 и 5 в контрагента в параметры процесса с кодами 3 и 6 соответственно:
create.in.objectTypes=customer create.in.copyParams=1:3;5:6
Описание процесса
Макрос описаний процесса позволяет сгенерировать текст для заголовка вкладки процесса или для перечня процессов.
Для генерации описаний в конфигурацию типа процесса добавляются записи вида:
processReference.<n>.objectTypes=<objectTypes> processReference.<n>.stringExpression=<macros>
Где:
- <n> - порядковый номер записи;
- <objectTypes> - области, где используется данный макрос через запятую, перечень областей см. далее;
- <macros> - JEXL выражение, передаваемые объекты см. далее.
Перечень областей:
- customer - вкладка Процессы контрагента;
- processCard - заголовок вкладки процесса;
- linkedProcessList - список процессов к которым привязан данный процесс;
- linkProcessList - список процессов, привязанных к данному.
В JEXL процессор передаются объекты:
- process - объект класса ru.bgcrm.model.process.Process- процесс;
- processParam - объект класса ru.bgcrm.dao.expression.ParamValueFunction- параметры процесса.
- processLink - объект класса ru.bgcrm.dao.expression.ProcessLinkFunction- для работы с привязками процесса.
Кроме того доступны переменные устанавливаемые в ru.bgcrm.servlet.filter.SetRequestParamsFilter.
Пример конфигурации для генерации описания списке процессов контрагента из адреса и перечня услуг и на вкладке процесса из наименования контрагента и адреса:
processReference.1.objectTypes=customer processReference.1.stringExpression=u.toString( processParam.addressValues( 90, 'fromStreet' ) ) + " : " + u.toString( processParam.listValueTitles( 238 ) ) processReference.2.objectTypes=processCard processReference.2.stringExpression="Запрос док. ОИО: " + u.escapeXml( u.toString( processLink:linkTitles( "customer" ) ) ) + "<br/>" + u.escapeXml( u.toString( processParam.addressValues( 90, 'fromStreet' ) ) ) + " "
Пример вывода исполнителей процесса в описании. Выводится в связанных процессах контрагентов и договорах биллинга bitel.
processReference.1.objectTypes=customer,contract:bitel processReference.1.stringExpression=<<END result = process.getDescription(); result += "<br><b>" + u.getObjectTitles(u.getObjectList(ctxUserList, process.getExecutorIds())) + "</b>"; return result; END
Как выглядит в интерфейсе.
В описании возможно использование HTML разметки, с выделением части описания жирным шрифтом для отображения в буфере. Например:
processReference.2.objectTypes=processCard processReference.2.stringExpression="<span class='title'>#" + process.getId() + " " + process.getTypeTitle() + " " + "</span><span>" + u.escapeXml( process.getDescription() ) + "</span>"
При закрытии в буфер, данный процесс будет выглядеть следующим образом:
