Интеграция
Получение новых задач из ПланФикса → Получение значения из хранилища
В этой инструкции мы по шагам с примерами разберём, как настроить оба сервиса и связать их между собой:
- Настройка приёма новых задач из ПланФикса: выбор подключения, копирование URL и POST из автоматического сценария в момент создания задачи.
- Чтение записи из хранилища проекта по ключу: выберите хранилище, укажите ключ и при необходимости остановите сценарий, если запись не найдена.
Отдельные инструкции: источник «Получение новых задач из ПланФикса» · действие «Получение значения из хранилища»
Не хотите настраивать сами? Сделаем бесплатно
Напишите, какие сервисы нужно связать. Специалист настроит интеграцию, проверит, что данные доходят, и оставит вам готовый процесс.
Создание подключений
Если вы ещё не создавали нужные подключения - не пропускайте этот блок: без них настроить интеграцию не получится. Если подключения уже есть в WebJack, можно сразу перейти к настройке источника и действия ниже.
Подключение ПланФикса
Создание подключения
- В меню откройте «Подключения» и нажмите «+».
- Выберите «ПланФикс» и нажмите «Выбрать».
- В поле «Название» укажите, как подключение будет видно в сценариях.
- В поле «Портал» выберите «planfix.ru» или «planfix.com».
- Нажмите «Подключить».
- На странице ПланФикса выберите аккаунт и разрешите доступ.
Создайте обработку
В левом меню откройте «Обработки» и нажмите «+».
Источник «ПланФикс: Новая задача»
Новые задачи из ПланФикса начнут поступать после выбора подключения и сохранения источника. Скопируйте URL и отправьте на него POST из автоматического сценария в момент создания задачи.
Выбор типа источника
- В списке типов источника выберите «ПланФикс: Новая задача» и нажмите «Выбрать».
Подключение
- В поле «Подключение» выберите аккаунт ПланФикса.
- Нажмите «Сохранить».
URL приёма
- Откройте вкладку «Источник данных» и скопируйте «URL».
Сценарий в ПланФиксе
- В ПланФиксе откройте «Управление аккаунтом» → «Автоматические сценарии».
- Создайте сценарий для задач с событием создания задачи.
- Добавьте действие «Отправить HTTP-запрос»: метод POST, адрес - скопированный «URL».
- В тело запроса передайте поля задачи JSON-объектом или параметрами формы.
Принимаются такие поля:
- id - номер задачи
- name - название
- description - описание
- priority - приоритет
- status_id - ID статуса
- status_name - статус
- process_id - ID процесса
- project_id - ID проекта
- assigner_id - ID постановщика
- counterparty_id - ID контрагента
- assignees - исполнители через запятую
- start - начало
- end - срок
Подойдёт и JSON задачи ПланФикса: вложенные status, project, assigner, counterparty и assignees разбираются в эти поля.
Пример тела:
{"id":"123","name":"Заявка с сайта","description":"Нужен звонок"}
Как устроены исходящие запросы: HTTP-запросы в ПланФиксе.
Действие «Получить значение из хранилища»
В сценарий поступят поля выбранной записи хранилища. Укажите хранилище и ключ; при необходимости включите остановку, если записи с таким ключом ещё нет.
Перейдите в обработке во вкладку "Действия" и нажмите на кнопку "Добавить действие"
Для чего нужен
Действие «Получить значение из хранилища» читает запись по ключу и возвращает её поля в сценарий. В отличие от переменной, данные хранятся в проекте и доступны между разными запусками и обработками.
Как настроить
1. Выберите «Получить значение из хранилища» и нажмите «Выбрать».
2. В поле «Хранилище» выберите нужное хранилище проекта.
3. В поле «Ключ» укажите ключ записи: константу или значение из предыдущих шагов.
4. При необходимости включите «Выдавать ошибку», если отсутствие ключа должно остановить сценарий.
5. Нажмите «Сохранить».
Когда использовать
Используйте, когда нужно взять ранее сохранённый статус, счётчик, ID диалога или другие данные по ключу и передать их в следующие действия.
Запустите обработку
- В обработку начнут поступать данные из настроенного источника.
- По очереди выполнятся все добавленные действия.
- Входящие данные, статус и история отобразятся в «Истории операций».
Застряли на подключении или полях?
Соберём обработку «Получение новых задач из ПланФикса → Получение значения из хранилища», проверим тест и запустим.