Пользовательские интеграцииBETANEW

Интеграции — это процесс объединения различных систем и приложений для обмена данными и функциями.

Интеграции позволяют автоматизировать рабочие процессы, сократить объем ручной работы, ускорить выполнение задач и снизить вероятность ошибок. Например, интеграция с сервисом Jira позволяет автоматически создавать задачи при получении новых писем или изменять статус задачи в зависимости от определенных условий.

В этом разделе приведена подробная информация о том, как использовать интеграции:

• Быстрый старт
• Расширенные возможности

Быстрый старт

Для работы с интеграциями выполните следующие шаги:

1. Добавьте интеграцию в свое рабочее пространство.
2. Выполните настройку подключения, указав свои учетные данные для связи с выбранным сервисом.
3. Создайте скрипты с блоками интеграции.

Добавление интеграции в рабочее пространство

Чтобы добавить интеграцию в пространство:

1. В Панели управления в пространстве нажмите + Добавить и выберите Интеграцию.
2. В открывшемся окне укажите следующие параметры:
   • Название интеграции
   • Ключ интеграции в произвольном формате
   • Логотип — загрузите иконку системы, с которой будет сделана интеграция, в формате .svg или .png
   • Описание (при необходимости)
   
3. Нажмите Создание.

После добавления интеграции в пространство автоматически откроется редактор кода, в котором необходимо написать код интеграции.

Настройка подключения

Чтобы интеграция работала корректно, необходимо настроить подключение и выполнить аутентификацию с помощью своих учетных данных. Список данных, которые нужно предоставить для аутентификации, может отличаться в зависимости от выбранного способа подключения.

Основные типы подключения:

• Подключение через oAuth2 — это способ, при котором вместо логина и пароля используется токен. Токен обеспечивает доступ к данным без необходимости повторного ввода учетных данных. Для настройки необходимы специальные ключи — клиентский идентификатор и секрет. Этот способ подключения используется для таких сервисов, как Google Drive, Google Таблицы, Microsoft SharePoint, amoCRM и других
• Подключение через логин и пароль — в этом случае достаточно указать свои учетные данные для доступа к сервису. Этот способ используется для интеграций с инструментом Jira
• Подключение через ключ API. Ключ API — это уникальный код, который позволяет системе получить доступ к данным без ввода логина и пароля. Для настройки требуется ключ API, а также права на изменение скриптов. Сгенерируйте ключ в системе и используйте его при подключении. Этот способ подходит для интеграций с Huntflow и Proceset

Чтобы добавить подключение:

1. Перейдите в Панель управления пространства, в котором будет использоваться интеграция.
2. Нажмите + Добавить и выберите Подключение.
3. Выберите нужное подключение в списке.
4. Задайте название подключения и нажмите Создать.
5. Введите данные для аутентификации, которые требуются в рамках интеграции, и нажмите Сохранить.

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

Пример настройки подключения к Jira Software

Настроим подключение для связи системы Proceset с сервером Jira Software.

Для получения доступа к Jira необходимо выполнить аутентификацию по логину и паролю, указав свои учетные данные в настройках подключения. Для этого:

1. Откроем вкладку пространства Панель управления.
2. Нажмем + Добавить и выберем Подключение.
3. В открывшемся окне выберем Подключение к Jira.
4. В следующем окне введем название подключения и нажмем Сохранить
5. На открывшейся странице укажем параметры подключения:
   • Название
   • URL сервера Jira
   • Логин
   • Пароль
   При необходимости можем Проверить подключение.
6. Нажмем Сохранить.
7. Подключение добавлено в пространство.

Использование блоков интеграции в скриптах

После добавления интеграции в пространство в скриптах становятся доступны соответствующие блоки автоматизации.

Для работы с блоками интеграции:

1. Создайте скрипт и добавьте в него необходимый блок-триггер.
2. Добавьте следующий блок, кликнув иконку + под блоком.
3. Кликните по блоку и в открывшейся левой панели выберите категорию Установлено.
4. Выберите нужную интеграцию, чтобы открыть список доступных блоков.
5. Выберите нужный блок автоматизации.
6. Введите параметры для блока или укажите их с помощью маппинга и протестируйте работу блока.
7. После тестирования блок возвращает данные по указанным параметрам.

Пример создания задачи в Jira Software

Интеграция с Jira Software упрощает управление проектами и позволяет автоматизировать рабочие процессы.

Создадим задачу в Jira с помощью скрипта с блоками интеграции:

1. Создадим новый скрипт в пространстве.
2. Добавим триггер Ручной запуск.
3. Добавим блок Получить содержимое файла, настроим его для получения изображения из хранилища и протестируем блок.
4. Добавим блок Создать задачу, настроим его параметры и протестируем.
5. Добавим к задаче вложение с полученным во втором блоке изображением и протестируем блок.
6. Добавим комментарий к задаче с помощью соответствующего блока. Протестируем блок.
7. Добавим пользователя в список наблюдателей за задачей и протестируем блок.
8. Создадим связь между текущей задачей и другой задачей в Jira. Протестируем блок.
9. Добавим блок для получения информации о задаче. Протестируем блок.
10. В выходных данных видим, что все действия успешно выполнены. Задача создана с вложением, комментариями и другими настройками, заданными через блоки интеграции.
11. При необходимости можем добавить в скрипт другие блоки автоматизации, которые будут работать с данными, полученными в предыдущих блоках, или же можем опубликовать скрипт в его текущем виде.

Расширенные возможности

Использование расширенных возможностей позволяет адаптировать интеграции под специфические нужды вашего рабочего процесса.

Подробная информация о работе с API интеграций и примеры запросов представлены в документации для разработчиков.