Создание таблиц в 1С Конфигураторе: пошаговая инструкция

Работа с таблицами в 1С Конфигураторе — одна из ключевых задач при разработке прикладных решений. Без правильно настроенных таблиц невозможно организовать хранение данных, построить отчеты или реализовать сложную бизнес-логику. Однако многие начинающие разработчики сталкиваются с трудностями: как выбрать тип таблицы, какие свойства задать, как связать её с другими объектами конфигурации?

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

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

Виды таблиц в 1С: когда и какую использовать

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

📊 Таблица значений — временная таблица, существующая только в памяти во время сеанса. Используется для промежуточных расчетов, обработки данных перед выводом в отчеты или формы.
🗃️ Таблица документа — встроенная табличная часть в объектах типа "Документ". Хранит данные, связанные с конкретным документом (например, строки товара в накладной).
🔗 Таблица справочника — табличная часть в объекте "Справочник". Применяется для хранения дополнительных атрибутов элементов справочника (например, контактные лица контрагента).
📎 Регистры сведений/накопления — специализированные таблицы для хранения исторических данных, остатков или оборотов. Используются в бухгалтерских и складских модулях.
🖥️ Виртуальные таблицы — динамически формируемые таблицы на основе запросов. Не хранят данные физически, но удобны для отображения сложных выборок.

Выбор типа таблицы зависит от задачи:

🔹 Нужно временно обработать данные? → Таблица значений.
🔹 Требуется хранить строки документа? → Табличная часть документа.
🔹 Необходимо вести историю изменений? → Регистр сведений.
🔹 Нужно показать пользователю результат запроса? → Виртуальная таблица.

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

Пошаговая инструкция: создание таблицы значений в Конфигураторе

Рассмотрим процесс создания на примере таблицы значений — самого распространённого типа для временных данных. Этот метод применим и к другим видам таблиц с незначительными корректировками.

Откройте 1С:Предприятие в режиме Конфигуратор (для этого при запуске удерживайте клавишу Shift или выберите пункт в меню запуска). Далее следуйте алгоритму:

Создайте новый объект конфигурации, если таблица будет частью документа или справочника. Для самостоятельной таблицы значений переходите к пункту 2.
Откройте модуль, где планируете работать с таблицей (например, модуль формы или общий модуль).
Объявите переменную для таблицы значений:
```
Перем МояТаблица;
```
Инициализируйте таблицу в процедуре или функции:
```
МояТаблица = Новый ТаблицаЗначений;
```

Добавьте колонки с указанием типов данных:

МояТаблица.Колонки.Добавить("Наименование", Новый ОписаниеТипов("Строка"));
МояТаблица.Колонки.Добавить("Количество", Новый ОписаниеТипов("Число"));
МояТаблица.Колонки.Добавить("Цена", Новый ОписаниеТипов("Число", Новый КвалификаторыЧисла(10, 2)));

Заполните таблицу данными:

НоваяСтрока = МояТаблица.Добавить();
НоваяСтрока.Наименование = "Товар 1";
НоваяСтрока.Количество = 5;
НоваяСтрока.Цена = 1000.50;

После выполнения этого кода в переменной МояТаблица будет храниться таблица с одной строкой. Чтобы вывести её на экран, используйте метод ПоказатьТаблицуЗначений() или свяжите с элементом формы ПолеТаблицы.

Колонки имеют корректные типы данных

Указаны квалификаторы для числовых полей (точность, масштаб)

Добавлены все необходимые строки

Таблица связана с формой (если требуется вывод)

-->

Настройка колонок: типы данных, формат и ограничения

Колонки — основа любой таблицы. Их правильная настройка определяет, какие данные можно хранить и как они будут отображаться. В 1С:Предприятие для каждой колонки можно задать:

🔢 Тип данных: Строка, Число, Дата, Булево, Ссылка на справочник/документ и др.
📏 Формат: например, для чисел — количество знаков после запятой, для строк — максимальная длина.
🔒 Ограничения: обязательность заполнения, диапазон значений.
📌 Заголовок: отображаемое имя колонки (может отличаться от системного).
🔄 Вычисляемое поле: значение колонки рассчитывается по формуле.

Пример настройки колонки с типом Число и ограничениями:

КолонкаЦена = МояТаблица.Колонки.Добавить("Цена");
КолонкаЦена.Тип = Новый ОписаниеТипов("Число", Новый КвалификаторыЧисла(10, 2));
КолонкаЦена.Заголовок = "Цена за ед., руб.";
КолонкаЦена.ТолькоЧтение = Ложь; // Разрешить редактирование
КолонкаЦена.Минимум = 0; // Цена не может быть отрицательной

Для колонок типа Ссылка (на справочники, документы) укажите конкретный объект:

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

💡

Если колонка должна содержать только уникальные значения, используйте метод ТаблицаЗначений.Индексировать() после заполнения. Это ускорит поиск по таблице.

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

КолонкаДата.Тип = Новый ОписаниеТипов("Дата");
КолонкаДата.Формат = "ДФ=dd.MM.yyyy";

Работа с табличными частями документов и справочников

Табличные части — неотъемлемая часть объектов Документ и Справочник. Они позволяют хранить набор данных, связанных с одним элементом. Например, в документе "РеализацияТоваровУслуг" табличная часть содержит строки с товарами, количеством и ценами.

Чтобы добавить табличную часть в документ:

Откройте объект Документ в дереве конфигурации (например, РеализацияТоваровУслуг).
Перейдите на закладку Данные.
Нажмите Добавить → Табличная часть.
Задайте имя (например, Товары) и настройте колонки аналогично таблице значений.

Ключевое отличие табличных частей от таблиц значений:

Параметр	Таблица значений	Табличная часть
Хранение данных	В памяти (временные данные)	В базе данных (постоянные данные)
Связь с объектом	Не привязана	Является частью документа/справочника
Доступ из кода	Через переменную	Через свойство объекта (например, `ДокументОбъект.Товары`)
Использование в отчетах	Требует передачи в параметры	Доступна напрямую через запрос

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

📝 Добавить() — создать новую строку.
🗑️ Удалить() — удалить строку по индексу.
🔍 Найти() — найти строку по условию.
🔄 Очистить() — удалить все строки.

Как скопировать строки между табличными частями?

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

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

Распространённые ошибки и как их избежать

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

⚠️ Внимание: Если вы изменяете структуру таблицы (добавляете/удаляете колонки) в уже используемом решении, обязательно проверьте все места в коде, где происходит обращение к этой таблице. Несоответствие колонок может привести к ошибкам выполнения.

Ошибка 1: Несоответствие типов данных

Ситуация: вы пытаетесь записать строку в колонку типа Число или дату в колонку типа Строка. Результат — ошибка выполнения.

Решение: всегда проверяйте типы данных перед записью. Используйте функции приведения типов:

МояТаблица.Колонки.Добавить("Сумма", Новый ОписаниеТипов("Число")); // Правильно: НоваяСтрока.Сумма = Число(СтрокаТаблицы.Цена * СтрокаТаблицы.Количество); // Неправильно (может вызвать ошибку, если Цена или Количество не числа):

НоваяСтрока.Сумма = СтрокаТаблицы.Цена * СтрокаТаблицы.Количество;

Ошибка 2: Переполнение памяти

Таблицы значений хранятся в оперативной памяти. Если вы загружаете в них большие объёмы данных (десятки тысяч строк), это может привести к замедлению работы или аварийному завершению сеанса.

Решение: для обработки больших данных используйте:

🔄 Постраничную загрузку (обрабатывайте данные порциями по 100–500 строк).
🗃️ Временные таблицы базы данных (метод ПоместитьВременныеДанные()).
📊 Запросы с ограничением (ключевое слово ПЕРВЫЕ в языке запросов).

Ошибка 3: Неправильная сортировка

Если вы сортируете таблицу по колонке, содержащей NULL (неопределённое значение), строки с пустыми значениями могут оказаться в начале или конце в зависимости от настроек.

Решение: явно задавайте направление сортировки и обрабатывайте пустые значения:

МояТаблица.Сортировать("Цена Нарастание");
// Для игнорирования пустых значений:
МояТаблица.Сортировать("ЕСТЬNULL(Цена, 0) Нарастание");

Оптимизация работы с таблицами: советы экспертов

Производительность работы с таблицами напрямую влияет на скорость выполнения операций в 1С. Следующие рекомендации помогут ускорить обработку данных:

⚡ Индексируйте колонки, по которым часто выполняется поиск. Для таблиц значений используйте метод Индексировать():

МояТаблица.Индексировать("Код");

🔄 Минимизируйте операции с таблицами в циклах. Лучше собрать все данные в массиве, а затем одним методом добавить в таблицу.
🗑️ Очищайте ненужные данные. Если таблица значений больше не нужна, присвойте переменной значение Неопределено, чтобы освободить память:

МояТаблица = Неопределено;

📊 Используйте запросы вместо обработки таблиц. Для сложных выборок и агрегаций язык запросов 1С работает быстрее, чем программная обработка таблиц.

Для табличных частей документов и справочников:

🔗 Настраивайте связи между таблицами. Если табличная часть содержит ссылки на другие объекты (например, номенклатуру), убедитесь, что эти связи проиндексированы в базе данных.
📈 Ограничивайте количество колонок. Каждая дополнительная колонка увеличивает размер хранимых данных. Удаляйте неиспользуемые колонки.
🔒 Используйте права доступа. Ограничьте редактирование табличных частей на уровне ролей, если это не требуется пользователям.

💡

Самый эффективный способ ускорить работу с большими таблицами — перенести логику обработки на сторону СУБД с помощью запросов. Язык запросов 1С оптимизирован для работы с большими объёмами данных.

Практические примеры: от простого к сложному

Разберём несколько реальных сценариев использования таблиц в 1С, от базовых до продвинутых.

Пример 1: Формирование прайс-листа

Задача: создать таблицу с товарами и ценами для выгрузки в Excel.

// 1. Создаём таблицу
ТаблицаПрайс = Новый ТаблицаЗначений;
ТаблицаПрайс.Колонки.Добавить("Артикул", Новый ОписаниеТипов("Строка"));
ТаблицаПрайс.Колонки.Добавить("Наименование", Новый ОписаниеТипов("Строка"));
ТаблицаПрайс.Колонки.Добавить("Цена", Новый ОписаниеТипов("Число", Новый КвалификаторыЧисла(10, 2)));

// 2. Заполняем данными из справочника Номенклатура
Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|   Номенклатура.Артикул КАК Артикул,
|   Номенклатура.Наименование КАК Наименование,
|   Номенклатура.ЦенаПродажи КАК Цена
|ИЗ
|   Справочник.Номенклатура КАК Номенклатура
|ГДЕ
|   НЕ Номенклатура.ПометкаУдаления
|УПОРЯДОЧИТЬ ПО
|   Наименование";

Результат = Запрос.Выполнить();
Выборка = Результат.Выбрать();

Пока Выборка.Следующий() Цикл
НоваяСтрока = ТаблицаПрайс.Добавить();
НоваяСтрока.Артикул = Выборка.Артикул;
НоваяСтрока.Наименование = Выборка.Наименование;
НоваяСтрока.Цена = Выборка.Цена;
КонецЦикла;

// 3. Выгружаем в Excel
ТаблицаПрайс.Выгрузить("C:\Pricelist.xlsx", ТипФайлаExcel.Excel2007);

Пример 2: Агрегация данных по периодам

Задача: посчитать продажи по месяцам на основе табличной части документа "РеализацияТоваровУслуг".

// 1. Создаём таблицу для результатов
ТаблицаИтогов = Новый ТаблицаЗначений;
ТаблицаИтогов.Колонки.Добавить("Месяц", Новый ОписаниеТипов("Дата"));
ТаблицаИтогов.Колонки.Добавить("СуммаПродаж", Новый ОписаниеТипов("Число", Новый КвалификаторыЧисла(15, 2)));

// 2. Запрос с группировкой по месяцам
Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|   НачалоМесяца(Документ.Дата) КАК Месяц,
|   СУММА(Документ.Товары.Сумма) КАК СуммаПродаж
|ИЗ
|   Документ.РеализацияТоваровУслуг КАК Документ
|ГДЕ
|   Документ.Дата МЕЖДУ &НачалоПериода И &КонецПериода
|СГРУППИРОВАТЬ ПО
|   НачалоМесяца(Документ.Дата)
|УПОРЯДОЧИТЬ ПО
|   Месяц";

Запрос.УстановитьПараметр("НачалоПериода", НачалоГода(ТекущаяДата()));
Запрос.УстановитьПараметр("КонецПериода", КонецМесяца(ТекущаяДата()));

Результат = Запрос.Выполнить();
ТаблицаИтогов.Загрузить(Результат);

Пример 3: Динамическое создание колонок

Задача: добавить в таблицу колонки на основе пользовательского ввода (например, для анализа по произвольным периодам).

// Пользователь ввёл список месяцев для анализа
МассивМесяцев = Новый Массив;
МассивМесяцев.Добавить("Январь");
МассивМесяцев.Добавить("Февраль");

// Создаём таблицу с динамическими колонками
ТаблицаАнализ = Новый ТаблицаЗначений;
ТаблицаАнализ.Колонки.Добавить("Товар", Новый ОписаниеТипов("СправочникСсылка.Номенклатура"));

Для Каждого Месяц Из МассивМесяцев Цикл
ТаблицаАнализ.Колонки.Добавить(Месяц, Новый ОписаниеТипов("Число", Новый КвалификаторыЧисла(15, 2)));
КонецЦикла;

FAQ: Ответы на частые вопросы

Как сохранить таблицу значений между сеансами?

Таблица значений существует только в памяти и не сохраняется автоматически. Чтобы сохранить её данные, используйте:

🗃️ Хранение в базе данных: перенесите данные в табличную часть документа или регистр сведений.
💾 Сериализация: сохраните таблицу в файл с помощью метода ЗаписатьJSON() или ЗаписатьXML():

ТекстJSON = ЗаписатьJSON(МояТаблица);
ЗаписатьТекст("C:\temp\таблица.json", ТекстJSON);

📊 Экспорт в Excel/CSV: методы Выгрузить() или ЗаписатьТаблицу().

Можно ли в таблице значений хранить вложенные таблицы?

Да, но с ограничениями. Колонка таблицы значений может иметь тип ТаблицаЗначений, однако:

⚠️ Такие таблицы сложно обрабатывать в запросах.
⚠️ Сериализация (JSON/XML) может работать некорректно.
✅ Лучше использовать отдельные таблицы с ссылками или регистры сведений.

Пример объявления:

Таблица.Колонки.Добавить("Детали", Новый ОписаниеТипов("ТаблицаЗначений"));

Как связать две таблицы значений по ключевому полю?

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

// Таблица1 и Таблица2 связаны по колонке "КодТовара" Для Каждого Строка Из Таблица1 Цикл НайденныеСтроки = Таблица2.НайтиСтроки(Новый Структура("КодТовара", Строка.КодТовара)); Если НайденныеСтроки.Количество() > 0 Тогда // Обработка связанных строк КонецЕсли;

КонецЦикла;

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

Таблица2.Индексировать("КодТовара");

Почему при изменении структуры табличной части документа возникают ошибки?

Это связано с тем, что:

🔧 Изменения структуры требуют обновления конфигурации базы данных. После изменения табличной части выполните Конфигуратор → Администрирование → Обновить конфигурацию базы данных.
📎 Данные в базе могут не соответствовать новой структуре. Если вы удалили колонку, которая содержала данные, может потребоваться миграция.
🔒 Права доступа: проверьте, что у пользователей есть права на изменение структуры.

⚠️ Внимание: Перед изменением структуры табличных частей в рабочей базе сделайте резервную копию. Некоторые изменения (например, удаление колонок) могут привести к потере данных.

Как отладить ошибки при работе с таблицами?

Используйте следующие инструменты:

🐞 Отладчик 1С: установите точку останова на строке с ошибкой и проверьте значения переменных.
📋 Журнал регистрации: включите запись событий (Администрирование → Журнал регистрации) для отслеживания ошибок.
🔍 Вывод в сообщения: временно добавьте код для вывода содержимого таблицы:

Для Каждого Строка Из МояТаблица Цикл Сообщить(Строка.Наименование + " - " + Строка.Количество);