Вложенные сущности

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

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

Как работают вложенные сущности

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

Когда пользователь создаёт или редактирует запись родительского типа сущности, вложенная сущность показывается как таблица. Каждая строка таблицы — одна вложенная запись, а колонки соответствуют полям типа вложенной сущности. Пользователи могут добавлять строки, редактировать отдельные ячейки и удалять строки.

У родительского типа сущности может быть несколько типов вложенных сущностей. Например, у типа документа может быть один тип вложенной сущности для позиций и другой для подписей согласования.

Создание типа вложенной сущности

Чтобы добавить тип вложенной сущности, откройте страницу редактирования родительского типа сущности и перейдите на вкладку «Вложенные сущности». Нажмите «Создать вложенный тип» и задайте:

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

  • Одну или несколько групп полей, в каждой из которых одно или несколько полей. Доступны те же девять типов данных, что описаны в разделе типы данных.

Сохраните родительский тип сущности, чтобы сохранить тип вложенной сущности и его поля.

Поддерживаемые типы данных во вложенных сущностях

Поля вложенных сущностей поддерживают те же девять типов данных, что и поля верхнего уровня: «Строка», «Целое», «Дробное», «Дата-время», «Ссылка», «Набор», «Коллекция», «Сопоставление» и «Выражение».

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

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

Где доступны вложенные сущности

Вложенные сущности доступны в типах сущностей, которые относятся к этим супертипам:

  • «Документ»

  • «Контрагент»

  • «Справочник»

  • «Задача»

  • «Предложение»

Редактирование и удаление типов вложенных сущностей

Тип вложенной сущности редактируется так же, как родительский: откройте родительский тип сущности, перейдите на вкладку «Вложенные сущности» и измените поля или группы вложенного типа.

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

Здесь действует та же осторожность, что и при удалении поля: удаление необратимо, а сохранённые данные удалённых вложенных структур становятся недоступными.