Webjack
Вход Начать
Получение изменений задач из ПланФикса Извлечение полей из JSON

Интеграция

Получение изменений задач из ПланФикса → Извлечение полей из JSON

В этой инструкции мы по шагам с примерами разберём, как настроить оба сервиса и связать их между собой:

  1. Настройка приёма изменений задач из ПланФикса: выбор подключения, копирование URL и POST из автоматического сценария при изменении задачи.
  2. Извлечение полей из JSON: скопируйте образец из экземпляра данных, выберите переменную, вставьте пример, отметьте нужные поля и проверьте их названия.

Отдельные инструкции: источник «Получение изменений задач из ПланФикса» · действие «Извлечение полей из JSON»

Не хотите настраивать сами? Сделаем бесплатно

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

Получить бесплатную настройку Или следуйте инструкции ниже

Создание подключений

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

Подключение ПланФикса

Создание подключения

  1. В меню откройте «Подключения» и нажмите «+».
  2. Выберите «ПланФикс» и нажмите «Выбрать».
  3. В поле «Название» укажите, как подключение будет видно в сценариях.
  4. В поле «Портал» выберите «planfix.ru» или «planfix.com».
  5. Нажмите «Подключить».
  6. На странице ПланФикса выберите аккаунт и разрешите доступ.

Создайте обработку

В левом меню откройте «Обработки» и нажмите «+».

integrations: В левом меню откройте «Обработки» и нажмите «+»

Источник «ПланФикс: Задача изменена»

Изменения задач из ПланФикса начнут поступать после выбора подключения и сохранения источника. Скопируйте URL и отправьте на него POST из автоматического сценария, когда задачу изменяют.

Выбор типа источника

  1. В списке типов источника выберите «ПланФикс: Задача изменена» и нажмите «Выбрать».

Подключение

  1. В поле «Подключение» выберите аккаунт ПланФикса.
  2. Нажмите «Сохранить».

URL приёма

  1. Откройте вкладку «Источник данных» и скопируйте «URL».

Сценарий в ПланФиксе

  1. В ПланФиксе откройте «Управление аккаунтом» → «Автоматические сценарии».
  2. Создайте сценарий для задач с событием изменения задачи.
  3. Добавьте действие «Отправить HTTP-запрос»: метод POST, адрес - скопированный «URL».
  4. В тело запроса передайте поля задачи 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-запросы в ПланФиксе.

Действие «Парсер JSON»

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

Перейдите в обработке во вкладку "Действия" и нажмите на кнопку "Добавить действие"
actions: Перейдите в обработке во вкладку Действия и нажмите на кнопку Добавить действие

Для чего нужен

Действие «Парсер JSON» достаёт отдельные значения из JSON и делает их доступными как поля сценария. Так удобно работать с вложенными данными из вебхуков и форм.

Как настроить

  1. Если образца JSON нет, отправьте тестовую заявку. Откройте вкладку «Экземпляры данных», откройте нужную строку и скопируйте значение, например из «Тело (строка)».
    Извлечение полей из JSON: Во вкладке «Экземпляры данных» откройте нужную строку
    Извлечение полей из JSON: В поле «Тело (строка)» скопируйте значение JSON
  2. Добавьте действие «Парсер JSON» и нажмите «Выбрать».
  3. В поле «JSON» нажмите значок выбора переменной и выберите поле с JSON, например «Источник данных Тело (строка)».
    Извлечение полей из JSON: В поле «JSON» нажмите значок выбора переменной
    Извлечение полей из JSON: Выберите «Источник данных Тело (строка)» и нажмите «Выбрать»
  4. Вставьте скопированный образец в поле «Пример».
  5. Нажмите «Сохранить» под полем «Пример».
    Извлечение полей из JSON: Вставьте образец в поле «Пример» и нажмите «Сохранить»
  6. Кликами отметьте нужные элементы, чтобы собрать список «Поля».
  7. Проверьте «Название» полей и дополнительные настройки: «Тип», «Путь». При необходимости включите «Пустой JSON», чтобы при ошибке разбора использовать пустой объект.
  8. Нажмите «Сохранить».
    Извлечение полей из JSON: Проверьте список «Поля» и нажмите «Сохранить»

Когда использовать

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

Запустите обработку

  1. В обработку начнут поступать данные из настроенного источника.
  2. По очереди выполнятся все добавленные действия.
  3. Входящие данные, статус и история отобразятся в «Истории операций».

integrations: Входящие данные, статус и история отобразятся в «Истории операций»

Застряли на подключении или полях?

Соберём обработку «Получение изменений задач из ПланФикса → Извлечение полей из JSON», проверим тест и запустим.

Получить бесплатную настройку