Активити «Парсинг json»
Описание
Превращаем JSON в управляемые данные для бизнес-процессов
Работа с JSON-объектами в 1С-Битрикс часто превращается в головную боль: нужно писать дополнительный код, разбираться с вложенными структурами и тратить время на отладку. Активити «Парсинг json» решает эту задачу за один шаг. Вам больше не нужно вручную обрабатывать сырые данные — достаточно одного действия, и сложная строка превращается в понятный массив данных, с которым можно работать прямо в бизнес-процессе.
Представьте: вы получаете ответ от внешнего API, загружаете данные из стороннего сервиса или импортируете информацию из другого раздела сайта. Всё это приходит в виде JSON-строки. Вместо того чтобы писать обработчик, вы просто добавляете нашу активность в схему бизнес-процесса. Система сама разберёт объект на ключи и значения, подготовив их для дальнейшего использования. Это экономит часы разработки и снижает риск ошибок при ручном парсинге.
Два сценария работы: от простого поиска до сложной обработки
Первая возможность — прямое получение значения по ключу. Если вам нужно вытащить из JSON-объекта конкретное поле (например, email пользователя, статус заказа или ID товара), активность сделает это мгновенно. Вы задаёте ключ, а на выходе получаете готовое значение, которое можно сразу подставить в уведомление, письмо или условие ветвления.
Второй сценарий — полноценное преобразование JSON в массив данных. Это открывает путь к итеративной обработке: вы передаёте полученный массив в итератор бизнес-процесса, проходите по каждому элементу и применяете к нему любые условия. Хотите отфильтровать только те записи, где статус равен «активен»? Или собрать список всех товаров с ценой выше заданной? Просто настройте условие по значению ключа — и бизнес-процесс сам найдёт нужные данные.
Как это работает на практике: пошаговая логика без кода
Всё строится на простой последовательности действий. Вы добавляете активность «Парсинг json» в нужное место бизнес-процесса. На вход подаёте строку с JSON-объектом. На выходе получаете структурированный массив, где каждый ключ становится отдельным полем, а каждое значение — доступным для проверки и использования.
Дальше — работа с итератором. Вы передаёте массив в цикл, и для каждого элемента проверяете условия: «если значение ключа равно X, то делаем Y». Это позволяет, например, разобрать корзину интернет-магазина, полученную из внешней системы, и для каждого товара создать отдельную задачу или отправить уведомление менеджеру. Никакого программирования — только настройка условий в визуальном редакторе бизнес-процессов.
Реальные сценарии использования в вашем проекте
Самый частый кейс — интеграция с внешними сервисами. Любой современный API отдаёт данные в JSON: CRM-системы, платёжные шлюзы, сервисы доставки, маркетплейсы. Активити позволяет забрать ответ от любого такого сервиса и сразу встроить его в логику Битрикса. Например, после оплаты заказа платёжная система присылает JSON с подтверждением — вы парсите его, извлекаете статус и сумму, и на основе этих данных запускаете нужный сценарий.
Второй популярный сценарий — обработка импортированных данных. Если вы загружаете товары, контакты или сделки из внешнего источника в формате JSON, активность поможет разложить их по полям и проверить на дубликаты. Просто пройдитесь по массиву в итераторе, сравните значения ключей с существующими записями и примите решение: создать новый элемент или обновить существующий. Всё автоматически, без участия разработчика.
Что вы получаете: скорость, гибкость и отсутствие лишнего кода
Главное преимущество — вы перестаёте зависеть от разработчиков при работе с JSON. Любой менеджер или администратор сайта может настроить обработку данных через бизнес-процессы, не вникая в синтаксис и структуру объектов. Достаточно понимать, какие ключи вам нужны, и активность сделает всё остальное.
Второй важный момент — универсальность. Активити работает с любым JSON любой вложенности. Она не привязана к конкретному источнику данных или структуре. Это значит, что вы можете использовать её в десятках разных процессов: от обработки вебхуков до синхронизации каталогов. Один раз настроили — и пользуетесь во всех проектах на Битриксе. Никаких дополнительных модулей, никаких доработок ядра — только стандартные возможности платформы и эта активность.
Часто задаваемые вопросы
Характеристики
| Версия | 1.0.0 |
| Добавлен | 19.06.2024 |
| Установок | Менее 50 раз |
| Код | ye.jsonparseactivity |
| Адаптивный | Нет |
| Composite | Нет |