Сегодня мы рассмотрим как связать между собой задачи «Компании №1», с задачами «Компании №2».
Для этого мы воспользуемся автодействием Отправить запрос, в котором напишем код для создания задачи в другой компании.
Раcсмотрим кейс на примере техподдержки
Допустим, мы работаем в службе техподдержки и обрабатываем заявки.
Иногда нам требуется помощь компании-партнера, которая также использует Neaktor.
При необходимости подключить коллег из другой компании, наши сотрудники просто нажимают кнопку перевода статуса. После чего в аккаунте Neaktor компании-партнера создается новая задача.
Как это настроить
Для настройки похожего кейса нам придется прибегнуть к программированию (совсем немного). Каждый шаг мы опишем максимально подробно, чтобы у вас все получилось даже без опыта в кодинге.
1. Для начала мы перейдем в аккаунт №2 (аккаунт Neaktor компании-партнера) и создадим там новый процесс.
2. В этом процессе мы добавим текстовое поле.
Назовем его ID исходной задачи.
Это поле мы задействуем в будущем для примера заполнения полей, созданных пользователем. Пока сохраним модель и выйдем.
3. Перейдем в Интеграции, API ключи.
4. Здесь мы сгенерируем новый ключ от лица администратора системы.
Сделаем его Публичным.
5. Теперь вернемся в наш бизнес-процесс и перейдем к шагу: Группы и переходы по этапам.
6. Здесь мы должны выбрать пользователя, который добавил API ключ в одну из ролей, которая может создавать новые задачи.
Примечание! Все задачи, которые будут автоматически создаваться позже из «Компании № 1», будут созданы от имени пользователя, который сгенерировал публичный ключ.
Т.е., если ключ создал Ленточкин Иван,
то и будущие задачи будут созданы от имени Ленточкина Ивана.
7. Вернемся в Интеграции, API ключи. Скопируем код
и перейдем в «Компанию № 1», откуда мы будем создавать задачи.
Откроем бизнес-процесс на шаге: Группы и переходы по этапам.
8. Добавим в схему автодействие: Отправить запрос.
9. Перейдем в настройки шаблона.
10. Здесь сразу перейдем к пункту 3 и добавим новый Заголовок.
11. В поле заголовок пишем “Authorization”, в значение вставляем скопированный публичный ключ.
12. Вернемся к пункту 1 в поле Url. Вставляем код: https://api.neaktor.com/rest/v1/tasks/
13. Url, который мы подставили, пока неполный. После слэша нам нужно подставить Id модели бизнес-процесса, по которой будут создаваться задачи в «Компании № 2».
Как найти такой Id?
Для этого нам надо вернуться в “Компанию № 2” и открыть бизнес-процесс, по которому будут создаваться автоматические задачи.
14. Скопируем последнюю часть Url’a, как показано на рисунке.
15. Вернемся в “Компанию № 1” и подставим скопированное значение в Url.
16. Перейдем в пункт 2.
Здесь нам нужно в виде кода указать, какие поля будущей задачи будут заполнены.
Для примера мы вставим этот код:
{«startDate»:»{{ dateTime start pattern_base =»dd-MM-yyyy HH:mm» pattern_dist=»yyyy-MM-dd’T’HH:mm:ss»}}», «endDate»:»{{dateTime end pattern_base =»dd-MM-yyyy HH:mm» pattern_dist=»yyyy-MM-dd’T’HH:mm:ss»}}», «fields» : [{«id» : «subject», «value» : «{{subject}}»}, {«id»: «ID ПОЛЯ», «value»: «{{id}}»}]}
Посмотрим на значения из этого кода:
«startDate»:»{{dateTime DATETIME_FIELD_CODE pattern_base=»dd-MM-yyyy HH:mm» pattern_dist=»yyyy-MM-dd’T’HH:mm:ss » }}» — это Начало будущей задачи. В нашем случае она начинается в текущий момент.
«endDate»:»plusDays(«startDate»:»{{dateTime DATETIME_FIELD_CODE pattern_base=»dd-MM-yyyy HH:mm» pattern_dist=»yyyy-MM-dd’T’HH:mm:ss » }}», 7)» — Дата окончания задачи. В нашем случае она закончится через 7 дней после начала. Можете заменить цифру 7 на то количество дней, которое нужно вам.
«fields» : [{«id» : «subject , «value» — здесь начинают заполняться непосредственно поля задачи. И первое из них — это Тема задачи. В нашем случае оно заполняется точно также, как и тема основной задачи.
«{{subject}}»}, {«id»: «», «value»: «{{id}}»}] — последняя часть кода, которую нам еще предстоит заполнить. Чтобы это сделать, нам нужно вычислить Id поля из задачи, которая будет заполняться.
17. В этом коде не хватает ID ПОЛЯ. Сейчас мы посмотрим как можно вычислить ID поля будущей задачи, которое пользователь добавил сам. Для этого нужно открыть “Компанию № 2” и создать новую задачу.
18. Теперь нажмем клавишу F12 и перейдем на вкладку Network.
19. Заполните поле, Id которого вам нужен, любым значением. У нас это ID исходной задачи.
20. В консоли ищем значение Save и выбираем его. Справа включаем вкладку Headers.
Нужный ID будет находиться здесь:
21. Копируем ID и вставляем его в тело запроса.
В нашем случае мы передаем исходный код задачи 1 в задачу 2, поэтому у нас стоит значение {{id}}. Вы можете заполнить это значение любым другим кодом.
Сохраняем. Готово!
Теперь, при смене определенного статуса в «Компании № 1»,
у нас создается новая задача в “Компании №2”.
Оставьте комментарий