В этом разделе вы можете добавлять и хранить параметры, а затем использовать их в сценариях внутри бизнес-процессов. В отличие от контекстных переменных, значение которых меняется от экземпляра к экземпляру, параметр остается неизменным для всех экземпляров процесса. Параметры хранятся в разделе централизованно. Это значит, что в дальнейшем, если вам потребуется изменить параметр, не нужно будет вносить правки в сценарии, в которых он используются. Достаточно отредактировать данные в разделе Дополнительные параметры.
начало примера
Пример применения параметров
Предположим, компания принимает заказы от клиентов через сайт. Между сайтом и QuickBPM настроена интеграция. Это позволяет передавать данные о готовности заказа в личный кабинет на сайте.
Такая интеграция осуществляется при помощи сценария. Для корректной работы сценария необходимо указать адрес сайта и токен для авторизации. Неважно, сколько экземпляров процесса будет запущено, эти параметры останутся неизменными. Кроме того, если компания решит создать еще один бизнес-процесс и настроить в нем интеграцию с сайтом, ей понадобятся те же самые параметры.
Учитывая это, удобно хранить адрес сайта и токен в разделе Дополнительные параметры. Если однажды адрес сайта или токен изменятся, сотрудникам компании не придется проверять все сценарии в процессах. Достаточно будет изменить нужный параметр в соответствующем разделе.
конец примера
Какие бывают параметры?
Параметры можно разделить на две группы:
- глобальные параметры – задаются на уровне компании. Глобальные параметры всегда доступны для использования в процессах компании. Также вы можете применять их при создании сценариев в любом разделе или приложении, но для этого необходимо активировать настройку Global. Обратите внимание, что в таком случае экспорт раздела или приложения станет недоступен.
- параметры раздела – задаются на уровне раздела. Параметры раздела всегда доступны для использования в процессах данного раздела. Кроме того, эти параметры могут применяться в бизнес-процессах приложений, входящих в раздел, но для этого необходимо активировать настройку Namespace.
Как добавить новый параметр?
начало внимание
Добавлять, редактировать и удалять параметры могут только пользователи, включенные в группу Администраторы.
конец внимание
Задать дополнительные параметры можно двумя способами:
1. На главной странице в меню выберите пункт Администрирование > Настройки системы > Дополнительные параметры. Используйте этот способ, чтобы задать как глобальные параметры, так и параметры раздела.
или
2. На главной странице выберите нужный раздел, нажмите на иконку шестеренки справа от названия раздела, в выпадающем меню выберите Настройки раздела > Дополнительные параметры. Таким образом можно задать только параметры конкретного раздела.
После того как вы выполните эти действия, независимо от выбранного способа, вы перейдете на страницу с дополнительными параметрами. В правом верхнем углу нажмите на кнопку + Параметр.
В открывшемся окне заполните следующие поля:
- Отображаемое имя* – укажите название, которое будет отображаться в списке параметров;
- Имя свойства* – генерируется автоматически, исходя из названия параметра. При желании вы можете отредактировать содержимое поля;
- Подсказка – здесь можно указать дополнительную информацию о параметре;
- Тип* – тип данных, которые хранит данный параметр;
- Значение – в этом поле задайте значение параметра.
После того как все поля будут заполнены, нажмите на кнопку Создать.
При необходимости значение параметра можно изменить. Для этого в списке параметров выберите значение, которое вы хотите исправить, а затем нажмите на иконку карандаша.
Пример использования дополнительных параметров
Рассмотрим решение для техподдержки. В ходе процесса в QuickBPM сотрудник описывает возникшую проблему, а затем при помощи сценария данные отправляются в систему для отслеживания сообщений об ошибках – GitLab. Там автоматически создается задача с заголовком и описанием, и выбирается исполнитель.
Чтобы реализовать данную интеграцию были заданы следующие дополнительные параметры:
- gitlab_host: адрес сервера;
- gitlab_project: идентификатор проекта, в котором будет создаваться тикет;
- gitlab_token: токен авторизации;
- gitlab_user: пользователь, на которого тикет будет назначен.
Заголовок задачи и описание определяются через контекстные переменные title и description.
Сам сценарий выглядит следующим образом:
async function createIssueInGitlab(): Promise {
const issue = await fetch(`${ Namespace.params.data.gitlab_host }/api/v4/projects/${ Namespace.params.data.gitlab_project }/issues`, {
method: 'post',
headers: {
'PRIVATE-TOKEN': Namespace.params.data.gitlab_token,
'Content-Type': 'application/json',
},
body: JSON.stringify({
title: Context.data.title,
description: Context.data.description,
assignee_ids: [Namespace.params.data.gitlab_user],
}),
}).then(res => res.json());
Context.data.issue_url = issue.web_url
}