Общие сведения

Правка выполняется в оснастке Администрирование => Процессы => Типы процессов.

Типы процессов представляют из себя дерево.

...

Конфигурация

Далее описываются параметры конфигурации типа процесса, поддержанные ядром.

...

# код параметра - категории, который должен быть указан перед переводом процесса в конечный статус
categoryParamId=<param_code>
# требование заполненности параметров перед установкой статуса, одна или несколько записей вида
requireFillParamIdsBeforeStatusSet.<status_to_code>=<param_codes>
# скрытие в редакторе процесса ссылки полной правки описания
hideDescriptionChange=1
# сокрытие (0) либо отображение 1 (на вкладке) сообщений, связанных с процессом
processShowMessages=1
# требования указания обязательного комментария при переводы в статусы
requireChangeCommentStatusIds=<status_ids>
# коды групп исполнителей через запятую, которые можно указать при создани процесса
onCreateSelectGroup=<groupIds>
# сокрытие параметров в том или ином статусе, одна или несколько записей вида
hideParamIdsInStatus.<status_code>=<param_codes>
# параметры, редактор для которых скрыт в данном типе процесса (заполняются программно)
readonlyParamIds=<param_codes>
# шаблон текста при добавлении в описание процесса текста кнопкой "Добавить"
descriptionAddPattern=\n[${time} ${user}]\n\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%

Где:

• <param_code> - код параметра процесса, который должен быть указан при его закрытии, при этом редактор открывается под переключением статуса процесса;
• <status_to_code> - код статуса, в который переводится процесс;
• <param_codes> - коды параметров процесса через запятую;
• <status_ids> - коды статусов через запятую;
• <status_code> - код текущего статуса процеса;.
• <groupIds> - коды групп через запятую.

...

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

Создание процесса с привязанными объектами

...

Разрешает создание процесса с привязанным данным объектом во вкладке Процессы объекта (ниже на скриншоте).

Копирование параметров поддерживается только для объектов, использующих стандартную систему параметров системы.

Типы объектов ядра:

• customer - контрагент.

Типы объектов плагинов описаны в документации плагинов.

...

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.

Пример конфигурации для генерации описания списке процессов контрагента из адреса и перечня услуг и на вкладке процесса из наименования контрагента и адреса:

...