Переменные в Пинкит: как быстро настроить интеграцию?

В Пинкит появились переменные. С ними интеграцию можно настроить один раз, а потом разворачивать её копии для новых порталов и клиентов, не перебирая шаги вручную. В статье разберём, сколько времени это экономит и как пользоваться переменными, на примере обмена задачами между двумя порталами Битрикс24.

1. Почему настройка интеграций занимала много времени

Возьмём типовую задачу: обмен задачами между порталом вашей компании и порталом клиента. Когда на одном портале создаётся задача, она должна появиться на другом в нужной группе и с нужным исполнителем.

В такой интеграции десятки полей, которые отличаются для каждого клиента:

• ID группы на портале клиента и на вашем портале;
• ID постановщика и исполнителя;
• доступы к обоим порталам.

Эти значения повторяются в разных шагах. Раньше при копировании интеграции для нового клиента приходилось открывать каждый шаг, искать нужные поля и менять значения вручную. На настройку и тестирование одного обмена могло уходить от 1 до 2 часов, и легко было пропустить поле в одном из шагов.

2. Что такое переменные и как они работают

Переменная — это значение, которое задаётся один раз в отдельном окне и подставляется во все шаги интеграции, где она указана.

У каждой переменной есть:

• название — понятная подпись, например «ID группы на портале клиента»;
• ключ — короткое имя латиницей, например GROUP_ID;
• значение — постоянное (например, 19) или динамическое, взятое из данных другого шага (например, {{source.ID}}).

В полях шагов переменная записывается в двойных квадратных скобках: [[GROUP_ID]]. Так её легко отличить от динамических значений в фигурных скобках {{...}}.

Сравнение «было / стало»

3. Шаг 1. Определите, какие значения меняются от клиента к клиенту

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

Всё, что одинаково для всех клиентов, можно оставить прямо в шагах.

4. Шаг 2. Создайте переменные

1. Откройте личный кабинет Пинкит → раздел «Интеграции».
2. В строке нужной интеграции нажмите кнопку «Переменные».
3. В открывшемся окне добавьте переменные из таблицы выше: название, ключ и значение.
4. Нажмите «Сохранить».

5. Шаг 3. Подставьте переменные в шаги интеграции

Откройте шаги интеграции и замените конкретные значения на переменные. Например, в фильтре по группе вместо 19 укажите [[CLIENT_GROUP_ID]], а в поле исполнителя вместо 241 — [[OUR_RESPONSIBLE_ID]].

Совет. Название переменной можно задать прямо в поле шага через вертикальную черту: [[CLIENT_GROUP_ID|"ID группы на портале клиента"]]. Тогда в окне «Переменные» она будет подписана этим названием. Если название не указать, в окне будет показан ключ.

6. Шаг 4. Доступы

Доступы к порталам теперь не обязательно указывать при настройке. Если доступ не выбран, Пинкит автоматически добавит его в окно «Переменные». Его можно будет выбрать там же, вместе с остальными значениями.

7. Шаг 5. Разверните интеграцию для нового клиента

Теперь интеграцию можно тиражировать:

1. Скопируйте интеграцию (или установите её из кейса, или импортируйте из файла).
2. Откройте окно «Переменные» и замените значения на данные нового клиента: ID групп, сотрудников, доступы.
3. Сохраните и запустите интеграцию.

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

8. Как это помогает в поддержке

Переменные удобны и после запуска. Если клиент сменил ответственного или перенёс задачи в другую группу, менять нужно одно значение в окне «Переменные», а не искать его по шагам.

Если интеграцию обслуживает сам клиент, ему достаточно короткой инструкции: «Все изменяемые параметры находятся в окне "Переменные". Меняйте значения только там, в шаги заходить не нужно».

9. Итог

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

• вынести в переменные значения, которые меняются от клиента к клиенту;
• подставить их в шаги как [[KEY]];
• при копировании заполнять только окно «Переменные».