Использование переменных

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

Базовый синтаксис

Переменная записывается в двойных фигурных скобках:

{{имяПроцессора.имяПоля}}

• имяПроцессора - системное имя процессора-источника (то, которое указано в узле на холсте)
• имяПоля - имя поля из выходной схемы данных процессора

Пример

Если процессор с именем file-upload выдаёт поле inn, переменная выглядит так:

{{file-upload.inn}}

При выполнении воронки система заменит эту запись на реальное значение ИНН из каждого пакета данных.

Как узнать доступные переменные

Способ 1. Автодополнение

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

Способ 2. Схема данных процессора-источника

1. Кликните на процессор-источник в редакторе.
2. Перейдите на вкладку “Схема данных”.
3. В разделе “Выходные поля” вы увидите все доступные поля и их типы.

Способ 3. Просмотр данных

Если процессор уже выполнялся, перейдите в “Просмотр данных” и посмотрите заголовки колонок таблицы - они соответствуют именам полей.

Использование в поисковых запросах

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

Задача: искать компании по ИНН из CSV-файла.

Настройка процессора “Поиск в реестрах”:

Поисковый запрос: {{file-upload.inn}}

Для каждой строки из файла будет выполнен отдельный поиск с подставленным ИНН.

Использование в GPT-промптах

При работе с процессором GPT-фильтр переменные подставляются прямо в текст промпта.

Задача: классифицировать компании по виду деятельности.

Промпт:

Проанализируй компанию "{{registry-search.name}}" с ОКВЭД "{{registry-search.okved}}".
Определи, относится ли она к категории IT-компаний.
Ответь "да" или "нет" с кратким обоснованием.

При выполнении каждое значение будет подставлено из результатов процессора registry-search.

Использование в маппинге полей CRM

При настройке CRM-процессора переменные используются для указания, какие данные записать в поля CRM-сущности.

Задача: создать контакт в Bitrix24 с данными из реестра.

Маппинг полей:

Поле CRM	Значение
Название	{{registry-search.name}}
ИНН	{{file-upload.inn}}
Адрес	{{registry-search.address}}
Руководитель	{{registry-search.director}}

Обращение к данным из цепочки

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

Пример цепочки: file-upload -> registry-search -> gpt-filter -> crm-update

В настройках crm-update доступны переменные из всех предыдущих процессоров:

{{file-upload.inn}}          -- из первого процессора
{{registry-search.name}}     -- из второго процессора
{{gpt-filter.category}}      -- из третьего процессора

Комбинирование переменных с текстом

Переменные можно комбинировать со статическим текстом:

Компания {{registry-search.name}} (ИНН: {{file-upload.inn}})

Результат: Компания ООО Ромашка (ИНН: 7712345678)

Работа с вложенными полями

Если поле содержит вложенные данные (объект), обращайтесь через точку:

{{registry-search.address.city}}
{{registry-search.contacts.phone}}

Частые ошибки и их решение

Переменная не подставляется (отображается как есть)

Причина: неверное имя процессора или поля.

Решение:

1. Проверьте точное системное имя процессора (видно в заголовке узла).
2. Проверьте имя поля в схеме данных процессора-источника.
3. Убедитесь, что между процессорами есть связь (соединение на холсте).

Пустое значение вместо данных

Причина: поле существует, но не заполнено для данного пакета.

Решение:

1. Проверьте данные процессора-источника: все ли записи содержат нужное поле.
2. Добавьте фильтр fieldName IS NOT NULL, чтобы пропускать записи без данных.

Ошибка “Процессор не найден в цепочке”

Причина: процессор, на который вы ссылаетесь, не является предшественником в цепочке.

Решение: убедитесь, что существует путь из процессора-источника к текущему процессору через связи на холсте.

Советы

• Используйте понятные имена процессоров, чтобы переменные были читаемыми.
• Начинайте с простых воронок из 2-3 процессоров, чтобы убедиться, что переменные работают корректно.
• При отладке загляните в логи процессора: там видно, какие значения были подставлены.
• Если у вас сложная цепочка, задокументируйте доступные переменные в описании воронки.

Что дальше

• Настройка процессора - полный обзор параметров конфигурации
• Настройка фильтров - используйте переменные вместе с фильтрами
• Решение проблем - диагностика ошибок с переменными