Администрирование системы  / Дополнительные параметры

Дополнительные параметры

В этом разделе вы можете добавлять и хранить параметры, а затем использовать их в сценариях внутри бизнес-процессов. В отличие от контекстных переменных, значение которых меняется от экземпляра к экземпляру, параметр остается неизменным для всех экземпляров процесса. Параметры хранятся в разделе централизованно. Это значит, что в дальнейшем, если вам потребуется изменить параметр, не нужно будет вносить правки в сценарии, в которых он используются. Достаточно отредактировать данные в разделе Дополнительные параметры.

доп парам 1

начало примера

Пример применения параметров

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

Такая интеграция осуществляется при помощи сценария. Для корректной работы сценария необходимо указать адрес сайта и токен для авторизации. Неважно, сколько экземпляров процесса будет запущено, эти параметры останутся неизменными. Кроме того, если компания решит создать еще один бизнес-процесс и настроить в нем интеграцию с сайтом, ей понадобятся те же самые параметры.

Учитывая это, удобно хранить адрес сайта и токен в разделе Дополнительные параметры. Если однажды адрес сайта или токен изменятся, сотрудникам компании не придется проверять все сценарии в процессах. Достаточно будет изменить нужный параметр в соответствующем разделе.

конец примера

Какие бывают параметры?

Параметры можно разделить на две группы:

 

  • глобальные параметры – задаются на уровне компании. Глобальные параметры всегда доступны для использования в процессах компании. Также вы можете применять их при создании сценариев в любом разделе или приложении, но для этого необходимо активировать настройку Global. Обратите внимание, что в таком случае экспорт раздела или приложения станет недоступен.

 

  • параметры раздела – задаются на уровне раздела. Параметры раздела всегда доступны для использования в процессах данного раздела. Кроме того, эти параметры могут применяться в бизнес-процессах приложений, входящих в раздел, но для этого необходимо активировать настройку Namespace.

Как добавить новый параметр?

Добавлять, редактировать и удалять параметры могут только пользователи, включенные в группу Администраторы.

Задать дополнительные параметры можно двумя способами:

1. На главной странице в меню выберите пункт Администрирование > Настройки системы > Дополнительные параметры. Используйте этот способ, чтобы задать как глобальные параметры, так и параметры раздела.

или

2. На главной странице выберите нужный раздел, нажмите на иконку шестеренки справа от названия раздела, в выпадающем меню выберите Настройки раздела > Дополнительные параметры. Таким образом можно задать только параметры конкретного раздела.

После того как вы выполните эти действия, независимо от выбранного способа, вы перейдете на страницу с дополнительными параметрами. В правом верхнем углу нажмите на кнопку + Параметр.

доп парам 2

В открывшемся окне заполните следующие поля:

доп парам 3

  • Отображаемое имя* – укажите название, которое будет отображаться в списке параметров;
  • Имя свойства* – генерируется автоматически, исходя из названия параметра. При желании вы можете отредактировать содержимое поля;
  • Подсказка – здесь можно указать дополнительную информацию о параметре;
  • Тип*тип данных, которые хранит данный параметр;
  • Значение – в этом поле задайте значение параметра.

После того как все поля будут заполнены, нажмите на кнопку Создать.

При необходимости значение параметра можно изменить. Для этого в списке параметров выберите значение, которое вы хотите исправить, а затем нажмите на иконку карандаша. доп парам 4

Пример использования дополнительных параметров

Рассмотрим решение для техподдержки. В ходе процесса в 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
}