Зависимые поля

Сущность CRM

Тип смарт-процесса

Настройки зависимостей

Логика «при каком значении триггера какие поля показывать» задаётся здесь: нажмите «Добавить настройку зависимых полей» → в открывшемся окне выберите поле-триггер → нажмите «+ Ветка по значению» и для каждого значения триггера укажите, какие поля показывать. Можно добавить несколько веток и вложенные условия. После сохранения правила действуют во вкладке «Зависимые поля» в карточках.

Вывод в карточке

После настройки нажмите «Добавить зависимые поля в карточку» — во вкладке карточки откроется виджет. При дублях вкладок: «Очистить вкладки» → F5 → «Добавить зависимые поля в карточку». Основное хранилище — портал Битрикс24; копия правил по домену сохраняется на сервере приложения, чтобы настройки не терялись при обновлении приложения.

Если во вкладке «Зависимые поля» в сделке вы видите эту же страницу (Сущность CRM, кнопки «Создать поле», «Добавить настройку») — открывается приложение вместо виджета. Сделайте: «Очистить вкладки» → откройте любую сделку и нажмите F5 → снова зайдите в приложение и нажмите «Добавить зависимые поля в карточку». После этого во вкладке должен появиться блок с триггером и полями.

Помощь по приложению «Зависимые поля»

Что делает приложение

Приложение настраивает показ полей в карточках CRM в зависимости от значений других полей. Например: при выборе в поле «Тип» значения «Отказ» показываются дополнительные поля (причина отказа, комментарий), а при значении «Успех» — другие поля. Все настройки хранятся на вашем портале Битрикс24.

Где задаётся логика «при каком значении какие поля показывать»

Логика задаётся только в этом приложении, не во вкладке карточки. Откройте приложение из меню Битрикс24 → нажмите «Добавить настройку зависимых полей» (или «Изменить» у уже созданной настройки). В окне «Редактор зависимостей»: выберите поле-триггер (от его значения зависит показ) → нажмите «+ Ветка по значению» → для каждого значения триггера укажите, какие поля показывать. Можно добавить несколько веток (разные значения — разные наборы полей) и вложенные условия. После сохранения эти правила действуют во вкладке «Зависимые поля» во всех карточках выбранной сущности. Во вкладке карточки только вводятся и сохраняются значения, сама логика там не настраивается.

Шаг 1. Выбор сущности

В блоке «Сущность CRM» выберите, где применять зависимые поля: Лид, Сделка, Контакт, Компания или Смарт процесс. Для смарт-процесса дополнительно выберите тип процесса.

Шаг 2. Создание полей (по необходимости)

Если нужных полей ещё нет в CRM, нажмите «Создать новое поле в CRM». Укажите название, тип (строка, список, дата, число и т.д.), обязательность, множественность, значение по умолчанию. Для списка — введите значения с новой строки. После создания поле появится в выбранной сущности. В перспективе планируется расширение типов полей (привязки к смарт-процессам, инфоблокам и т.д.), по аналогии со стандартным интерфейсом CRM.

Шаг 3. Настройка зависимостей

Нажмите «Добавить настройку зависимых полей». В открывшемся окне:

Поле-триггер — выберите поле, от значения которого будет зависеть показ других полей. Над списком есть поиск.
Нажмите «+ Ветка по значению». Для каждой ветки укажите значение триггера и список полей, которые нужно показывать при этом значении. Значение триггера вводится по типу поля: для списка — выбор из выпадающего списка, для даты — выбор даты, для числа — ввод числа, для «Да/Нет» — Да или Нет, для строки — текст. Список полей можно искать через «Поиск полей…».
При необходимости добавьте вложенное условие: внутри ветки выберите второе поле-триггер и настройте свои ветки по его значениям (ввод значения тоже по типу поля). Глубина вложенности не ограничена.

Как работает вложенность (цепочка)

Вложенность строится именно как цепочка, а не как два независимых правила. Пример: основное поле (1) — «Тип», при значении «Отказ» показываем поле (2) «Причина отказа». Внутри этой ветки нажимаете «+ Вложенное условие» и выбираете второе поле-триггер — например, то же поле (2) «Причина отказа»: при значении «Другое» показываем поле (3) «Комментарий». В карточке получится: выбрали «Тип» = «Отказ» → показалось поле «Причина отказа»; выбрали в нём «Другое» → дополнительно показалось «Комментарий». То есть поле 2 зависит от поля 1, поле 3 зависит от поля 2. Поле 3 не выводится «отдельно» на верхнем уровне — только внутри ветки поля 1, когда уже сработало значение поля 1 и отображается поле 2.

Сохраните настройку. Её можно изменить или удалить из списка «Настройки зависимостей».

Шаг 4. Вывод в карточке

Нажмите «Добавить зависимые поля в карточку». Во всех карточках выбранной сущности появится вкладка «Зависимые поля». Важно: полная настройка выполняется только здесь, в приложении. Во вкладке карточки — форма для ввода данных (триггер и зависимые поля в одном блоке). Открыть настройки из карточки можно по ссылке «Открыть настройки» во вкладке. Если вкладка не появляется — включите право «Встраивание приложений» и места встраивания. Подробнее: PRAVA_SCOPE.md.

Как вывести зависимые поля в карточку (кратко)

Зависимые поля не добавляются через стандартное окно Битрикс24 «Выбор полей» (Дополнительно / Скрытые поля). Приложение добавляет отдельную вкладку «Зависимые поля» в карточку. Чтобы она появилась:

Настроить правила в приложении: сущность → «Добавить настройку зависимых полей» → поле-триггер → ветки (при каком значении какие поля показывать) → Сохранить.
Добавить вкладку: нажать «Добавить зависимые поля в карточку».
Открыть карточку сделки (лида, контакта…) и перейти на вкладку «Зависимые поля» — внутри блок с триггером и зависимыми полями.

Логика показа: в настройке задаёте правила «при значении триггера X → показывать поля A, B, C». В карточке во вкладке сверху показывается поле-триггер, ниже — только те поля, которые привязаны к текущему значению триггера. При смене триггера список пересчитывается; «Сохранить» записывает триггер и все видимые зависимые поля в сущность. Подробная инструкция: docs/KAK_VYVESTI_POLYA.md.