Вложенные таблицы в 1С: полное руководство для разработчиков и пользователей

Вложенные таблицы в 1С:Предприятие — это мощный инструмент для организации сложных данных, который позволяет хранить табличные структуры внутри других объектов (документов, справочников, регистров). Они решают задачи, где требуется детализация информации: например, список товаров в накладной, состав комплекта оборудования или график платежей по договору. Без вложенных таблиц пришлось бы создавать отдельные документы для каждой строки или использовать громоздкие обходные решения.

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

Что такое вложенная таблица в 1С и зачем она нужна

Вложенная таблица (или табличная часть) — это объект конфигурации, который представляет собой таблицу с колонками и строками, «встроенную» в другой объект 1С. Например:

• 📄 В документе РеализацияТоваровУслуг — табличная часть Товары со списком продаваемых позиций.
• 🗃️ В справочнике Номенклатура — табличная часть Комплектующие для составных изделий.
• 📊 В регистре сведений ЦеныНоменклатуры — табличная часть ИсторияИзменений для отслеживания динамики цен.

Главное отличие от обычных таблиц — вложенная таблица существует только в контексте родительского объекта. Например, строки табличной части Товары не могут существовать отдельно от документа РеализацияТоваровУслуг. Это обеспечивает целостность данных: при удалении документа автоматически удаляются и все его строки.

Основные преимущества:

• 🔄 Связанность данных: изменения в родительском объекте автоматически распространяются на табличную часть (например, при проведении документа).
• 📈 Гибкость структуры: колонки таблицы настраиваются под конкретные задачи (типы данных, обязательность заполнения, видимость).
• 🖥️ Удобный интерфейс: пользователи работают с таблицей прямо в форме объекта, без переключения между окнами.

Структура вложенной таблицы: колонки, типы данных, свойства

Любая вложенная таблица в 1С:Предприятие 8.3 состоит из колонок (столбцов) и строк. Колонки определяют структуру данных, а строки — их конкретные значения. Рассмотрим ключевые элементы:

При создании колонки в конфигураторе настраиваются следующие свойства:

• 🔠 Тип данных: Строка, Число, Дата, СправочникСсылка.Номенклатура и др.
• 📏 Длина/точности: например, Строка(100) или Число(15,2).
• ⚠️ Обязательность: если галочка установлена, поле нельзя оставить пустым.
• 👁️ Видимость: можно скрыть колонку в форме, но оставить её в данных.

⚠️ Внимание: Если в колонке типа СправочникСсылка не указан конкретный справочник (например, СправочникСсылка.Номенклатура), то при работе с таблицей в коде потребуется явное приведение типов. Это может вызвать ошибки при компиляции!

Как создать вложенную таблицу в конфигураторе 1С

Рассмотрим пошаговую инструкцию по добавлению табличной части к документу ЗаказПокупателя. Аналогичные действия применимы для справочников, регистров и других объектов.

1. Откройте конфигуратор 1С:Предприятия и перейдите в дерево объектов. Найдите раздел Документы → выберите ЗаказПокупателя (или создайте новый документ).

2. В палитре свойств документа перейдите на вкладку Табличные части и нажмите Добавить.

3. Задайте имя табличной части (например, Товары) и заголовок (отображается пользователям, например, Список товаров).

4. Перейдите на вкладку Колонки и добавьте необходимые поля. Например:

   • 📦 Номенклатура (тип СправочникСсылка.Номенклатура).
   • 🔢 Количество (тип Число(10,3)).
   • 💰 Цена (тип Число(15,2)).
   • 📝 Сумма (тип Число(15,2), вычисляемое поле).

Имя таблицы задано без пробелов и кириллицы|

Все колонки имеют уникальные имена|

Типы данных колонок соответствуют бизнес-логике|

Обязательные поля помечены галочкой|

Заголовки колонок понятны пользователям-->

После создания табличной части её нужно добавить в форму документа, чтобы пользователи могли с ней работать. Для этого:

1. Откройте форму документа ЗаказПокупателя в режиме редактирования.

2. Перетащите табличную часть Товары из дерева элементов формы в нужное место (обычно в центр формы).

3. Настройте отображение: ширину колонок, порядок следования, видимость служебных колонок (например, НомерСтроки).

⚠️ Внимание: Если в табличной части есть вычисляемые поля (например, Сумма = Количество * Цена), их значения не сохраняются в базе данных. Они пересчитываются динамически при открытии документа. Это может влиять на производительность при большом количестве строк!

Работа с вложенной таблицей через встроенный язык 1С

В коде 1С табличная часть доступна как коллекция строк, с которой можно работать через методы и свойства. Основные приёмы:

Добавление строк

Чтобы добавить новую строку в табличную часть Товары документа Док, используйте метод Добавить():

НоваяСтрока = Док.Товары.Добавить();
НоваяСтрока.Номенклатура = Справочники.Номенклатура.НайтиПоНаименованию("Монитор 24\"");
НоваяСтрока.Количество = 2;
НоваяСтрока.Цена = 15000;

Изменение данных

Для изменения существующей строки обращайтесь к ней по индексу или используйте цикл:

// Изменить цену в первой строке
Док.Товары[0].Цена = 16000;

// Перебрать все строки и увеличить количество на 10%
Для Каждого Строка Из Док.Товары Цикл
Строка.Количество = Строка.Количество * 1.1;
КонецЦикла;

Удаление строк

Удалить строку можно по индексу или по ссылке:

// Удалить вторую строку
Док.Товары.Удалить(1);

// Удалить все строки с нулевым количеством
Пока Док.Товары.НайтиСтроки(Новый Структура("Количество", 0)).Количество() > 0 Цикл
Док.Товары.Удалить(Док.Товары.НайтиСтроки(Новый Структура("Количество", 0))[0]);
КонецЦикла;

Поиск и фильтрация

Для поиска строк по условию используйте метод НайтиСтроки():

// Найти все строки с номенклатурой "Клавиатура"
НайденныеСтроки = Док.Товары.НайтиСтроки(Новый Структура("Номенклатура", Справочники.Номенклатура.Клавиатура));

// Фильтрация по нескольким условиям
Фильтр = Новый Структура();
Фильтр.Вставить("Количество", Новый Диапазон(10, 100));
Фильтр.Вставить("Цена", Новый Диапазон(1000, 50000));
НайденныеСтроки = Док.Товары.НайтиСтроки(Фильтр);

💡

При работе с большими табличными частями (1000+ строк) используйте метод ЗагрузитьКолонку() для оптимизации производительности. Он загружает данные только для указанной колонки, а не для всей таблицы.

События табличной части

В 1С можно обрабатывать события, связанные с изменением табличной части. Например, автоматически пересчитывать сумму при изменении цены или количества:

Процедура ТоварыПриИзменении(Элемент)
Если Элемент.Имя = "Количество" Или Элемент.Имя = "Цена" Тогда
Элемент.Строка.Сумма = Элемент.Строка.Количество * Элемент.Строка.Цена;
КонецЕсли;
КонецПроцедуры

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

Вложенные таблицы широко применяются в типовых конфигурациях 1С, таких как 1С:Бухгалтерия, 1С:Управление торговлей или 1С:Зарплата и управление персоналом. Рассмотрим несколько практических примеров:

1. Табличная часть Товары в документе РеализацияТоваровУслуг

Содержит колонки:

• 📦 Номенклатура — ссылка на справочник номенклатуры.
• 🔢 Количество — количество товара.
• 💰 Цена — цена за единицу.
• 📝 Сумма — вычисляемое поле (Количество * Цена).
• 📌 Склад — склад, с которого списывается товар.

Особенность: при проведении документа строки табличной части формируют движения по регистрам ТоварыНаСкладах и Продажи.

2. Табличная часть Сотрудники в документе ПриказОПриемеНаРаботу

Используется для группового приёма сотрудников. Колонки:

• 👤 Сотрудник — ссылка на справочник ФизическиеЛица.
• 📅 ДатаПриема — дата начала работы.
• 💼 Должность — ссылка на справочник должностей.
• 💰 Оклад — размер оклада.

3. Табличная часть ГрафикПлатежей в документе ДоговорКонтрагента

Хранит плановые даты и суммы платежей по договору. Колонки:

• 📅 ДатаПлатежа — планируемая дата оплаты.
• 💰 СуммаПлатежа — сумма к оплате.
• 🔄 Статус — перечисление (Планируется, Оплачено, Просрочено).
Как в типовых конфигурациях реализована связь между табличными частями и регистрами?

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

Ошибки при работе с вложенными таблицами и как их избежать

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

1. Ошибка "Поле объекта не обнаружено"

Возникает, когда в коде обращаются к несуществующей колонке табличной части. Причины:

• 🔍 Опечатка в имени колонки (например, Количествo вместо Количество).
• 🔄 Колонка была удалена или переименована в конфигураторе, но код не обновлён.

Решение: проверьте имена колонок в конфигураторе и исправьте код.

2. Ошибка при добавлении строки: "Тип не совпадает"

Происходит, если пытаетесь присвоить колонке значение неверного типа. Например:

НоваяСтрока.Номенклатура = "Монитор"; // Ошибка! Нужно передавать ссылку на справочник
НоваяСтрока.Номенклатура = Справочники.Номенклатура.НайтиПоНаименованию("Монитор"); // Правильно

3. Потеря данных при копировании документа

Если при копировании документа табличная часть не копируется, проверьте:

• 📋 Настроено ли копирование табличных частей в модуле объекта (процедура ОбработкаКопирования).
• 🔄 Обновлена ли конфигурация после изменений.

4. Медленная работа формы с большой табличной частью

При 1000+ строках интерфейс может "тормозить". Решения:

• 🔄 Используйте ОтображатьТолькоАктивныеСтроки в настройках таблицы.
• 📊 Загружайте данные порциями (постранично).
• 🛠️ Оптимизируйте вычисляемые поля (например, перенесите логику в модуль формы).

⚠️ Внимание: При программном изменении табличной части в обработчике события ПередЗаписью может возникнуть рекурсия (бесконечный цикл), если в коде снова вызывается запись документа. Чтобы избежать этого, используйте флаг ИзменениеЗапрещено или переносите логику в ПриЗаписи.

Оптимизация работы с вложенными таблицами

При большом объёме данных или высокой нагрузке на систему вложенные таблицы могут стать "узким местом". Рассмотрим способы оптимизации:

1. Использование отборов

Если в табличной части много строк, но нужны только некоторые, применяйте отборы:

Отбор = Новый Структура("Дата", Новый Диапазон(НачалоМесяца(ТекущаяДата()), КонецМесяца(ТекущаяДата())));
Строки = Док.Товары.НайтиСтроки(Отбор);

2. Массовое изменение данных

Вместо поэлементного изменения строк используйте циклы с минимальными операциями:

Для Каждого Строка Из Док.Товары Цикл
Если Строка.Цена < 1000 Тогда
Строка.Цена = 1000; // Установить минимальную цену
КонецЕсли;
КонецЦикла;

3. Кэширование вычисляемых полей

Если в табличной части есть сложные вычисляемые поля (например, с обращением к справочникам), кэшируйте их значения:

Процедура ПриОткрытии()
Для Каждого Строка Из Товары Цикл
Строка.СуммаСНДС = РассчитатьСуммуСНДС(Строка); // Кэшируем значение
КонецЦикла;
КонецПроцедуры

4. Разделение больших таблиц

Если табличная часть содержит более 10 000 строк, рассмотрите возможность:

• 📂 Разбиения на несколько таблиц (например, по периодам).
• 🗃️ Переноса данных в регистры сведений с ссылкой на документ.
💡

Оптимизация вложенных таблиц особенно важна в облачных решениях 1С (например, 1С:Fresh), где производительность зависит от скорости интернет-соединения и ограничений сервера.

FAQ: Частые вопросы о вложенных таблицах в 1С

Можно ли создать вложенную таблицу внутри другой вложенной таблицы?
Нет, в 1С:Предприятие 8.3 не поддерживаются таблицы более чем с одним уровнем вложенности. Если требуется такая структура, используйте:
• 🔗 Ссылки на другие документы/справочники (например, в колонке хранить ссылку на документ с детализацией).
• 🗃️ Регистры сведений для хранения иерархических данных.
Как экспортировать данные из вложенной таблицы в Excel?

Используйте объект ЗаписьXML или ТабличныйДокумент:

ТабДок = Новый ТабличныйДокумент;
ТабДок.Вывести(Док.Товары);
ТабДок.Записать("C:\Temp\Товары.xlsx", ТипФайлаТабличногоДокумента.XLSX);

Для сложных экспортов (с форматированием) используйте библиотеку OneScript.Excel.

Почему при изменении строки в табличной части не обновляется итоговая сумма документа?
Итоговая сумма документа обычно рассчитывается в обработчике события ПриИзменении табличной части или в процедуре ПересчитатьИтоги(). Проверьте:
• 🔄 Есть ли в модуле формы обработчик ТоварыПриИзменении.
• 📊 Правильно ли настроено вычисляемое поле ИтоговаяСумма в реквизитах документа.
• 🛠️ Не сброшен ли флаг АвтоПересчет в свойствах таблицы.

Процедура ТоварыПриАктивизацииСтроки(Элемент)
Элемент.Колонки.Цена.Редактирование = Не Пользователь.ЭтоАдминистратор();
КонецПроцедуры