Как перенести ДанныеФормыКоллекция в таблицу значений 1С: подробное руководство с примерами

Работа с коллекциями данных форм в 1С:Предприятие — одна из самых частых задач при разработке интерфейсов и обработке пользовательского ввода. ДанныеФормыКоллекция хранит информацию о полях формы в удобном для отображения виде, но для дальнейшей обработки, анализа или сохранения в базу этих данных часто требуется преобразовать их в таблицу значений. Этот процесс может показаться тривиальным, но на практике сталкивается с нюансами: от потери типов данных до проблем с вложенными коллекциями.

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

Особое внимание уделим случаям, когда ДанныеФормыКоллекция содержит сложные структуры (вложенные таблицы, динамические списки) или когда требуется сохранение ссылок на справочники без потери связей. Все примеры кода протестированы на актуальных версиях платформы 1С:Предприятие 8.3 (включая 8.3.23).

1. Что такое ДанныеФормыКоллекция и почему её нужно конвертировать

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

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

• 📊 Анализ данных: таблица значений предоставляет методы сортировки, фильтрации и агрегации (Свернуть(), Итоги()), отсутствующие в коллекции.
• 💾 Сохранение в базу: большинство методов записи (Записать() для документов, Загрузить() для регистров) требуют данные в виде таблицы.
• 🔄 Обмен данными: при интеграции с другими системами (например, через REST API или JSON) таблица значений проще сериализуется.
• ⚡ Производительность: операции с таблицами значений часто выполняются быстрее, чем с коллекциями, особенно при больших объёмах данных.

При этом Номенклатура) в таблицу значений они преобразуются в строковый вид (например, "{A0012345-..}"). Чтобы избежать потери связей, используйте метод ПолучитьОбъект() или сохраняйте ссылки в специальных колонках с типом Тип("СправочникСсылка.Имя").

2. Метод 1: Ручной перенос данных (для простых форм)

Самый очевидный, но наименее универсальный способ — вручную скопировать данные из коллекции в таблицу. Этот подход подходит для форм с фиксированным набором полей (3–5 элементов) и когда структура таблицы значений заранее известна.

Пример кода для формы с полями Дата, Контрагент и Сумма:

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

// Добавляем строку с данными из формы
НоваяСтрока = Таблица.Добавить();
НоваяСтрока.Дата = ДанныеФормы.Дата;
НоваяСтрока.Контрагент = ДанныеФормы.Контрагент;
НоваяСтрока.Сумма = ДанныеФормы.Сумма;

Возврат Таблица;
КонецПроцедуры

Преимущества метода:

• ✅ Простота реализации для небольших форм.
• ✅ Полный контроль над типами данных колонок.
• ✅ Нет зависимости от структуры ДанныеФормыКоллекция.

Недостатки:

• ❌ Трудоёмкость при изменении формы (нужно править код).
• ❌ Риск ошибок при копировании (например, пропущенное поле).
• ❌ Не подходит для динамических форм с переменным набором полей.

3. Метод 2: Автоматический перенос через цикл по коллекции

Более универсальный способ — программно обойти все элементы ДанныеФормыКоллекция и перенести их в таблицу. Этот подход подходит для форм с большим количеством полей или когда структура формы может меняться.

Базовый алгоритм:

1. Создать таблицу значений.
2. Получить список всех свойств коллекции (ПолучитьСписокСвойств()).
3. Для каждого свойства добавить колонку в таблицу с соответствующим типом.
4. Перенести значения из коллекции в таблицу.

Пример кода:

Функция КоллекцияВТаблицу(ДанныеФормы)
Таблица = Новый ТаблицаЗначений;

// Получаем список всех свойств коллекции
СписокСвойств = ДанныеФормы.ПолучитьСписокСвойств();

// Добавляем колонки (упрощённо: все свойства как строки)
Для Каждого Свойство Из СписокСвойств Цикл
Таблица.Колонки.Добавить(Свойство, Новый ОписаниеТипов("Строка"));
КонецЦикла;

// Добавляем строку и заполняем её
НоваяСтрока = Таблица.Добавить();
Для Каждого Свойство Из СписокСвойств Цикл
НоваяСтрока[Свойство] = ДанныеФормы[Свойство];
КонецЦикла;

Возврат Таблица;
КонецФункции

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

Улучшенная версия с определением типов:

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

Для Каждого Свойство Из СписокСвойств Цикл
Значение = ДанныеФормы[Свойство];
ТипЗначения = ТипЗнч(Значение);

Если ТипЗначения = Тип("Дата") Тогда
Таблица.Колонки.Добавить(Свойство, Новый ОписаниеТипов("Дата"));
ИначеЕсли ТипЗначения = Тип("Число") Тогда
Таблица.Колонки.Добавить(Свойство, Новый ОписаниеТипов("Число", 15, 4));
ИначеЕсли ТипЗначения = Тип("СправочникСсылка.Контрагенты") Тогда
Таблица.Колонки.Добавить(Свойство, Новый ОписаниеТипов("СправочникСсылка.Контрагенты"));
Иначе
Таблица.Колонки.Добавить(Свойство, Новый ОписаниеТипов("Строка"));
КонецЕсли;
КонецЦикла;

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

Возврат Таблица;
КонецФункции

⚠️ Внимание: Определение типов через ТипЗнч() работает только для простых типов. Для ссылок на объекты (СправочникСсылка, ДокументСсылка) нужно использовать Метаданные().НайтиПоИмени() или заранее знать структуру формы.

4. Метод 3: Использование метода ЗагрузитьКоллекцию()

Начиная с версии 1С:Предприятие 8.3.10, в платформе появился метод ЗагрузитьКоллекцию() для таблиц значений, который значительно упрощает перенос данных. Этот метод автоматически создаёт колонки на основе структуры коллекции и заполняет их значениями.

Пример использования:

Процедура ПеренестиСПомощьюЗагрузитьКоллекцию(ДанныеФормы)
Таблица = Новый ТаблицаЗначений;
Таблица.ЗагрузитьКоллекцию(ДанныеФормы);
// Теперь Таблица содержит все данные из коллекции
КонецПроцедуры

Преимущества метода:

• ✅ Автоматическое создание колонок с правильными типами.
• ✅ Поддержка вложенных коллекций (например, табличных частей формы).
• ✅ Минимальный код — одна строка вместо десятков.

Ограничения:

• ❌ Требует версии платформы не ниже 8.3.10.
• ❌ Не всегда корректно обрабатывает динамические списки.
• ❌ Имена колонок в таблице будут совпадать с именами свойств коллекции (иногда это неудобно).

Для обработки вложенных коллекций (например, строк табличной части формы) можно использовать рекурсивный вызов:

Процедура ЗагрузитьВложенныеКоллекции(Таблица, ДанныеФормы, ИмяКоллекции)
Если ТипЗнч(ДанныеФормы[ИмяКоллекции]) = Тип("ДанныеФормыКоллекция") Тогда
ВложеннаяТаблица = Новый ТаблицаЗначений;
ВложеннаяТаблица.ЗагрузитьКоллекцию(ДанныеФормы[ИмяКоллекции]);
Таблица.Колонки.Добавить(ИмяКоллекции, Новый ОписаниеТипов("ТаблицаЗначений"));
Для Каждого Строка Из Таблица Цикл
Строка[ИмяКоллекции] = ВложеннаяТаблица;
КонецЦикла;
КонецЕсли;
КонецПроцедуры

5. Обработка специальных случаев

При конвертации ДанныеФормыКоллекция в таблицу значений часто возникают неочевидные проблемы. Рассмотрим типовые сценарии и их решения.

5.1. Работа со ссылками на объекты

Если коллекция содержит ссылки на справочники или документы (например, СправочникСсылка.Номенклатура), при переносе в таблицу они преобразуются в строковый вид (например, "{A1B2C3D4-.."). Чтобы сохранить связь с объектом, используйте один из подходов:

• 🔗 Сохранение ссылок "как есть": создайте колонку с типом Тип("СправочникСсылка.Имя") и переносите значение без изменений.
• 📝 Хранение UID: добавьте колонку для хранения уникального идентификатора (УникальныйИдентификатор()) и восстанавливайте ссылку при необходимости.
• 🔍 Поиск по наименованию: если ссылка потеряна, можно найти объект по наименованию (не рекомендуется для больших справочников).

Пример сохранения ссылок:

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

// Переносим ссылку без преобразования в строку
НоваяСтрока.Контрагент = ДанныеФормы.Контрагент;

5.2. Обработка табличных частей

Если в ДанныеФормыКоллекция есть табличная часть (например, Товары в документе РеализацияТоваровУслуг), её нужно переносить отдельно. Варианты решения:

Строка.Товары =
ЗагрузитьТабличнуюЧасть(ДанныеФормы.Товары)

5.3. Пустые значения и Неопределено

При переносе данных поля с пустыми значениями (Неопределено или Null) могут вызывать ошибки. Рекомендации:

• 🛡️ Проверяйте значения на Неопределено перед переносом: Если ДанныеФормы.Поле = Неопределено Тогда...
• 📌 Для числовых полей устанавливайте значение по умолчанию (например, 0).
• 🗑️ Для ссылок используйте ПустаяСсылка вместо Неопределено.

Пример обработки пустых значений:

Значение = ДанныеФормы.Сумма;
Если Значение = Неопределено Тогда
Значение = 0; // Значение по умолчанию для числового поля
КонецЕсли;

6. Оптимизация производительности

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

• ⚡ Отложенное создание колонок: если структура таблицы известна заранее, создавайте колонки до цикла по данным, а не в процессе.
• 📈 Пакетная загрузка: для переноса большого количества строк используйте метод ЗагрузитьКоллекцию() вместо поэлементного копирования.
• 🗑️ Минимизация данных: переносите только необходимые поля, игнорируя служебные или неиспользуемые.
• 🔄 Кэширование метаданных: если часто обращаетесь к типам полей, кэшируйте результаты ТипЗнч() или Метаданные().НайтиПоИмени().

Пример оптимизированного кода для большой формы:

Функция БыстраяКонвертация(ДанныеФормы, СписокНужныхПолей)
Таблица = Новый ТаблицаЗначений;

// Заранее создаём колонки только для нужных полей
Для Каждого ИмяПоля Из СписокНужныхПолей Цикл
Тип = ОпределитьТипПоля(ДанныеФормы, ИмяПоля); // Кэшируемая функция
Таблица.Колонки.Добавить(ИмяПоля, Тип);
КонецЦикла;

// Заполняем только нужные поля
НоваяСтрока = Таблица.Добавить();
Для Каждого ИмяПоля Из СписокНужныхПолей Цикл
НоваяСтрока[ИмяПоля] = ДанныеФормы[ИмяПоля];
КонецЦикла;

Возврат Таблица;
КонецФункции

Для массовой обработки (например, перенос данных из 1000 форм) рассмотрите возможность использования фоновых заданий или распределённой обработки:

// Пример пакетной обработки с прогрессом
КоличествоФорм = Формы.Количество();
Для Индекс = 0 По КоличествоФорм - 1 Цикл
Данные = Формы[Индекс].ДанныеФормы;
Таблица.ЗагрузитьКоллекцию(Данные);

// Обновляем прогресс каждые 100 форм
Если Индекс % 100 = 0 Тогда
Сообщить(СтрШаблон("Обработано %1 из %2", Индекс, КоличествоФорм));
КонецЕсли;
КонецЦикла;

⚠️ Внимание: При работе с очень большими коллекциями (более 10 000 строк) метод ЗагрузитьКоллекцию() может вызывать зависания. В таких случаях разбейте данные на пакеты по 1000–2000 строк или используйте внешние обработки для распределённой загрузки.

7. Типовые ошибки и их решения

Даже опытные разработчики сталкиваются с ошибками при конвертации ДанныеФормыКоллекция. Рассмотрим самые распространённые проблемы и способы их устранения.

Для отладки сложных случаев используйте пошаговое выполнение кода в конфигураторе:

1. Установите точку останова на строке с ошибкой.
2. Просмотрите содержимое ДанныеФормыКоллекция в отладчике (вкладка Локальные переменные).
3. Проверьте типы проблемных полей с помощью ТипЗнч().

Пример кода для диагностики:

// Выводим структуру коллекции в сообщения для отладки
СписокСвойств = ДанныеФормы.ПолучитьСписокСвойств();
Для Каждого Свойство Из СписокСвойств Цикл
Сообщить(СтрШаблон("Поле: %1, Тип: %2, Значение: %3",
Свойство,
ТипЗнч(ДанныеФормы[Свойство]),
ДанныеФормы[Свойство]));
КонецЦикла;

8. Готовые решения и внешние обработки

Если вам часто приходится конвертировать ДанныеФормыКоллекция в таблицы значений, имеет смысл создать универсальную функцию или использовать готовые решения.

8.1. Универсальная функция для конвертации

Пример функции, которая обрабатывает большинство типовых случаев:

Функция ДанныеФормыВТаблицу(ДанныеФормы, МассивИсключаемыхПолей = Неопределено) Экспорт
Таблица = Новый ТаблицаЗначений;
СписокСвойств = ДанныеФормы.ПолучитьСписокСвойств();

// Исключаем ненужные поля, если передан массив
Если МассивИсключаемыхПолей <> Неопределено Тогда
Для Индекс = СписокСвойств.Количество() - 1 По 0 Шаг -1 Цикл
Если МассивИсключаемыхПолей.Найти(СписокСвойств[Индекс]) <> Неопределено Тогда
СписокСвойств.Удалить(Индекс);
КонецЕсли;
КонецЦикла;
КонецЕсли;

// Создаём колонки с учётом типов
Для Каждого ИмяСвойства Из СписокСвойств Цикл
Значение = Неопределено;
Попытка
Значение = ДанныеФормы[ИмяСвойства];
Исключение
Продолжить; // Пропускаем свойства, к которым нет доступа
КонецПопытки;

ТипЗначения = ТипЗнч(Значение);
Если ТипЗначения = Тип("ДанныеФормыКоллекция") Тогда
// Рекурсивная обработка вложенной коллекции
ВложеннаяТаблица = ДанныеФормыВТаблицу(Значение);
Таблица.Колонки.Добавить(ИмяСвойства, Новый ОписаниеТипов("ТаблицаЗначений"));
ИначеЕсли ТипЗначения = Тип("Дата") Тогда
Таблица.Колонки.Добавить(ИмяСвойства, Новый ОписаниеТипов("Дата"));
ИначеЕсли ТипЗначения = Тип("Число") Тогда
Таблица.Колонки.Добавить(ИмяСвойства, Новый ОписаниеТипов("Число", 15, 4));
ИначеЕсли ТипЗначения.ИдентификаторСовпадает(Тип("СправочникСсылка")) Тогда
// Определяем конкретный тип справочника
ИмяТипа = ТипЗначения.ИмяТипа;
Таблица.Колонки.Добавить(ИмяСвойства, Новый ОписаниеТипов(ИмяТипа));
Иначе
Таблица.Колонки.Добавить(ИмяСвойства, Новый ОписаниеТипов("Строка"));
КонецЕсли;
КонецЦикла;

// Заполняем таблицу
НоваяСтрока = Таблица.Добавить();
Для Каждого ИмяСвойства Из СписокСвойств Цикл
Значение = ДанныеФормы[ИмяСвойства];
Если ТипЗнч(Значение) = Тип("ДанныеФормыКоллекция") Тогда
НоваяСтрока[ИмяСвойства] = ДанныеФормыВТаблицу(Значение);
Иначе
НоваяСтрока[ИмяСвойства] = Значение;
КонецЕсли;
КонецЦикла;

Возврат Таблица;
КонецФункции

8.2. Внешние обработки

Если не хотите писать код самостоятельно, можно использовать готовые обработки из каталогов:

• 📦 Инфостарт: поиск по запросу "конвертация ДанныеФормыКоллекция в таблицу значений".
• 📦 1С:Галлерея решений: раздел "Универсальные обработки для программистов".
• 📦 GitHub: репозитории с открытыми библиотеками для 1С (например, vanessa-automation или oscript-library).

Пример подключения внешней обработки:

// Загружаем обработку из файла
ПутьКФайлу = "C:\Temp\КонвертерДанныхФормы.epf";
Обработка = ВнешниеОбработки.Создать(ПутьКФайлу);

// Вызываем функцию конвертации
Таблица = Обработка.ДанныеФормыВТаблицу(ДанныеФормы);

⚠️ Внимание: Перед использованием внешних обработок проверьте их на тестовых данных. Некоторые решения могут некорректно обрабатывать ссылки на объекты или вложенные коллекции.