Табличная часть
Табличная часть элемента проекта — это вложенная таблица, предназначенная для хранения вместе с каждым элементом данных однородной по своей структуре информации. Количество строк такой информации заранее неизвестно и может быть разным для разных элементов данных.
Например, справочник Проекты для каждого проекта может хранить список сведений о задачах: номер задачи, ее описание и срочность. В проектах может быть разное количество задач:
Чтобы смоделировать это в «1С:Шине», используется табличная часть.
Табличные части в элементах проекта
Табличные части поддерживаются в элементе проекта Справочник.
Табличные части по сути являются единым целым с объектом, к которому относятся: они считываются и записываются вместе с ним, а также используют его права доступа (в том числе нельзя настроить ограничения доступа к строкам табличных частей).
Табличные части описываются в свойстве ТабличныеЧасти объекта-владельца. Для каждой табличной части порождается структурный тип ИмяЭлементаСТабличнойЧастью.ИмяТабличнойЧасти. В примере выше это Проекты.Задачи. Тип доступен на клиенте и сервере. Значения этого типа используются в качестве строк табличной части. Тип может иметь модуль.
Табличные части имеют следующие свойства:
Ид—Ууид, идентификатор табличной части;Имя—Строка, имя табличной части;Реквизиты— обычные хранимые реквизиты; табличные части без явно заданных реквизитов не поддерживаются;Индексы— поля, соответствующие явно задаваемым реквизитам, а также стандартные поляКонтейнериИндекс.
В таблицах табличной части порождаются поля для всех явно заданных реквизитов табличной части, а также стандартные поля: Контейнер, Индекс, НомерСтроки.
Табличные части в механизме отражения
Табличные части доступны в механизме отражения (свойство ТабличныеЧасти: ЧитаемыйМассив<ОтражениеТабличнойЧастиСущности> типа ОтражениеОбъектнойСущности).
Табличную часть сущности описывает тип ОтражениеТабличнойЧастиСущности. Тип имеет следующие свойства:
Владелец—ОтражениеСущности, сущность, которой принадлежит табличная часть;Ид—Ууид, идентификатор табличной части;Имя—ДвуязычнаяСтрока, имя на двух языках;Реквизиты—ЧитаемыйМассив<ОтражениеХранимогоСвойства>, реквизиты сущности.
Методы типа ОтражениеТабличнойЧастиСущности:
ПолучитьТаблицу(): ОтражениеТаблицы— позволяет получить таблицу, хранящую данные табличной части.
Пример создания справочника с табличной частью
- В модуле Основной создайте справочник Проекты со стандартными реквизитами Наименование и Код. YAML-файл справочника будет выглядеть так:
ВидЭлемента: Справочник
Ид: ee3618d6-a21c-443b-8ed6-c2087b661536
Имя: Проекты
ОбластьВидимости: ВПодсистеме
Реквизиты:
-
Имя: Наименование
-
Имя: Код
Тип: Строка
Автонумерация:
Использовать: Ложь
-
Нажмите на значок плюса напротив пункта Табличные части и добавьте табличную часть Задачи.
-
Нажмите на значок плюса напротив табличной части Задачи и добавьте реквизиты Номер, Описание и Срочность.
В YAML-файле добавится описание свойства
ТабличныеЧастис реквизитами:ТабличныеЧасти:
-
Ид: 64a781a9-e9fb-4f87-a63a-3445ceea58a7
Имя: Задачи
Реквизиты:
-
Ид: 2a280a5b-31d8-4e67-84d7-dd0416c17d44
Имя: Номер
Тип: Число
-
Ид: be4269cc-f7d0-4d2a-a704-a07c6f88a0ac
Имя: Описание
Тип: Строка
-
Ид: e6d73627-d246-4ac1-9849-a4a75811c66e
Имя: Срочность
Тип: Булево -
В панели Свойства табличной части Задачи добавьте индекс с именем Номер по полю Номер.
Полный YAML-файл справочника Проекты будет выглядеть следующим образом:
ВидЭлемента: Справочник
Ид: ee3618d6-a21c-443b-8ed6-c2087b661536
Имя: Проекты
ОбластьВидимости: ВПодсистеме
Реквизиты:
-
Имя: Наименование
-
Имя: Код
Тип: Строка
Автонумерация:
Использовать: Ложь
ТабличныеЧасти:
-
Ид: d72d66c6-2f9e-49ef-8815-7dfd719cfbed
Имя: Задачи
Реквизиты:
-
Ид: 674cd65b-2650-4f0b-90c7-73a21f2f0807
Имя: Номер
Тип: Число
-
Ид: d1962b99-9de5-46aa-8610-8c670e8923ef
Имя: Описание
Тип: Строка
-
Ид: 1d5e0f82-c21c-452d-8f4c-60a7715b2cf2
Имя: Срочность
Тип: Булево
Индексы:
-
Имя: Номер
Поля:
- Номер
Примеры работы с табличной частью
Создайте справочник Сотрудники. Добавьте реквизит Проект и табличную часть Задачи со структурой, аналогичной табличной части Проекты.Задачи.
Описание добавленных реквизитов в YAML-файле справочника Сотрудники:
Реквизиты:
# ...
-
Ид: c8c87d62-c920-43ce-8f33-9aff0305fe30
Имя: Проект
Тип: Проекты.Ссылка?
ТабличныеЧасти:
-
Ид: 705b7d99-af1a-491a-aaad-2c8cc38440bc
Имя: Задачи
Реквизиты:
-
Ид: bc3d285c-a681-47da-af6c-1a4c9f9d8736
Имя: Номер
Тип: Число
-
Ид: b5862322-3d53-4219-b495-40286928c671
Имя: Описание
Тип: Строка
-
Ид: 162ab406-a0b6-462b-819f-3a20c7db7b6d
Имя: Срочность
Тип: Булево
-
Заполнение табличной части с помощью метода
ДобавитьНовый()на основе данных другой табличной части:пер ТекущийПроект = Проект.ЗагрузитьОбъект()
для СтрокаПроекта из ТекущийПроект.Задачи
пер СтрокаЗадачи = Задачи.ДобавитьНовый()
СтрокаЗадачи.Номер = СтрокаПроекта.Номер
СтрокаЗадачи.Описание = СтрокаПроекта.Описание
СтрокаЗадачи.Срочность = СтрокаПроекта.Срочность
; -
Заполнение табличной части с помощью конструктора на основе данных другой табличной части:
пер ТекущийПроект = Проект.ЗагрузитьОбъект()
для СтрокаПроекта из ТекущийПроект.Задачи
Задачи.Добавить(новый Сотрудники.Задачи(
Номер = СтрокаПроекта.Номер,
Описание = СтрокаПроекта.Описание,
Срочность = СтрокаПроекта.Срочность
))
; -
Изменение данных во всех строках:
пер ТекущийПроект = Проект.ЗагрузитьОбъект()
для СтрокаПроекта из ТекущийПроект.Задачи
СтрокаПроекта.Срочность = Истина
;
Пример обращения к табличной части с помощью языка запросов
Для табличной части порождается таблица языка запросов ИмяЭлементаПроекта.ИмяТабличнойЧасти. Таблица содержит следующие поля:
- Владелец —
ИмяЭлементаПроекта.Ссылка, ссылка на запись, владеющую строками табличной части; - Индекс —
Число, индекс строки табличной части в рамках одного владельца; - НомерСтроки —
Число, номер строки табличной части в рамках одного владельца (индекс + 1); - ИмяРеквизитаТабличнойЧасти —
ТипРеквизитаТабличнойЧасти, поле с данными реквизита табличной части.
Пример использования:
ВЫБРАТЬ
Индекс,
НомерСтроки,
Номер,
Описание,
Срочность,
Владелец
ИЗ
Проекты.Задачи
ГДЕ
Владелец.Представление == "Проект 1"
УПОРЯДОЧИТЬ ПО
НомерСтроки
Выбор между табличной частью и реквизитом-коллекцией
Вместо табличной части вы можете использовать реквизит-коллекцию и хранимую структуру. Это может быть удобно в следующих случаях:
- нужно хранить множество неизменяемых значений (например, чисел или ссылок), при этом добавление дополнительной информации к значениям не планируется;
- если в проекте есть готовая хранимая структура, к которой не планируется добавление дополнительной информации, и нужно хранить множество таких структур.
Однако, если вам понадобится добавить дополнительную информацию в реквизит-коллекцию, то придется переносить данные и переходить к использованию табличной части. Например, если реквизит-коллекция имеет тип Массив<МоеПеречисление>, а вы хотите изменить его на Массив<МояСтруктура>, где МояСтруктура — это некая структура с двумя полями типа Строка и МоеПеречисление, то в этом случае «1С:Шина» не сможет выполнить реструктуризацию таблиц базы данных и вам придется переносить данные самостоятельно.
Также рекомендуется использовать табличную часть в контракте сущности, если в реализациях планируется расширение состава полей. При использовании реквизита-коллекции сделать это не получится.