Поле «Составное поле»
Составное поле содержит внутри себя другие поля и используется для хранения набора связанных данных об одном объекте.
Например, в составном поле «Контрагент» могут храниться наименование, ИНН, КПП и адрес.
Создание и добавление поля
При создании составного поля его структуру можно сформировать несколькими способами:
- вручную — создать составное поле и самостоятельно добавить в него необходимые вложенные поля (ИНСТРУКЦИЯ);
- из Справочника — связать составное поле со Справочником и использовать его поля;
- из DaData — связать составное поле с DaData и получить необходимые поля из выбранного набора данных.
При ручном создании вложенные поля добавляются и настраиваются отдельно.
При использовании Справочника или DaData составное поле формируется уже с набором связанных полей из выбранного источника.
Создание и добавление полей: ИНСТРУКЦИЯ
Значение поля
При работе с составным полем используются значения его вложенных полей.
Например, структура составного поля «Контрагент» может выглядеть так:
контрагент
├── наименование
├── инн
├── кпп
└── адрес
Каждое из этих полей содержит отдельное значение, с которым можно работать в шаблоне.
В Битрикс24 составное поле может содержать поля сущности, из которой формируется документ.
Например, при работе со сделкой структура может выглядеть так:
сделки
├── название
└── id
Здесь сделки — составное поле, внутри которого находятся поля сделки.
Составные поля могут находиться и внутри других типов полей. Например, «Список» может содержать составное поле с набором полей каждого элемента:
сделки
└── товары
└── товар
├── название
├── количество
└── цена
Где:
сделки— составное поле, представляющее сущность сделки;товары— поле «Список», содержащее несколько товаров;товар— составное поле, которое описывает один элемент списка;название,количество,цена— поля, из которых состоит каждый товар.
Работа с вложенными полями
Для обращения к вложенному полю необходимо указать путь до него через точку.
Например:
контрагент.инн
Здесь:
контрагент— составное поле;инн— вложенное поле.
Например:
сделки.название
Здесь:
сделки— составное поле, содержащее поля сделки;название— вложенное поле.
Если поле находится глубже в структуре, в выражении указывается полный путь до него.
Вложенные поля можно использовать так же, как обычные поля соответствующего типа:
- выводить их значения в документ;
- использовать в условиях;
- передавать в функции;
- использовать в выражениях.
Вставка поля через вкладку «Метки»
Само составное поле не вставляется в документ как отдельное значение. Через вкладку «Метки» используются поля, которые находятся внутри него.
Выбор метки зависит от типа вложенного поля и от того, как его необходимо использовать в шаблоне.
Например:
- текстовое, числовое поле или дату можно вывести через метку «Значение»;
- поле «Да/Нет» можно использовать с меткой «Условие»;
- поле «Список» можно использовать с метками «Цикл» или «Таблица».
Функции для работы с полем
Для самого составного поля отдельных функций нет.
Функции применяются к вложенным полям в зависимости от их типа. Например:
- к полю «Текст» применяются функции для работы с текстом;
- к полям «Целое число» и «Десятичное число» — математические функции;
- к полю «Дата» — функции для работы с датами.
Особенности
Составное поле может содержать несколько уровней вложенности. Для обращения к конкретному значению необходимо указывать полный путь до соответствующего поля.
В APP составное поле может использоваться не только как набор самостоятельно заполненных полей, но и для работы со связанными данными из Справочников и DaData.