При разработке на платформе 1С:Предприятие одной из самых частых задач является программное создание и заполнение таблиц значений. Однако начинающие разработчики часто сталкиваются с ошибкой «Несоответствие типов (параметр номер 2)» при вызове метода Добавить() для коллекции колонок. В этой статье мы подробно разберем, почему возникает эта ситуация, изучим механику работы платформы и рассмотрим правильные способы типизации колонок.
Проанализируем ситуацию на примере кода, который часто становится источником проблемы:
ТЗ = Новый ТаблицаЗначений;
ТЗ.Колонки.Добавить("Док", Тип("ДокументСсылка.ЗаказПокупателя"), "Док");
При выполнении этого фрагмента система выдает ошибку. Давайте разберем по шагам, что здесь происходит. Метод Колонки.Добавить() принимает несколько параметров. Второй параметр отвечает за тип данных, которые будут храниться в этой колонке. Ошибка возникает из-за того, что разработчик передает туда результат функции Тип(), в то время как платформа ожидает объект другого класса — ОписаниеТипов.
В чем же разница? Рассмотрим подробнее:
Платформа спроектирована так, что колонки таблицы значений должны иметь именно ОписаниеТипов, чтобы система заранее понимала все возможные ограничения данных в этой колонке.
Самый простой и правильный способ исправить ошибку — обернуть нужный нам тип в конструктор Новый ОписаниеТипов. Рассмотрим пример, который решает проблему автора вопроса:
ТЗ = Новый ТаблицаЗначений;
// Вместо Тип(...) используем Новый ОписаниеТипов(...)
ОписаниеТипаДокумента = Новый ОписаниеТипов("ДокументСсылка.ЗаказПокупателя");
ТЗ.Колонки.Добавить("Док", ОписаниеТипаДокумента, "Заказ покупателя");
Теперь система успешно примет параметр, и колонка будет жестко типизирована. Это означает, что в данную колонку нельзя будет записать ничего, кроме ссылки на документ ЗаказПокупателя или значение ПустаяСсылка этого типа.
Часто встречаются задачи, когда колонка должна хранить данные разных видов. Например, это может быть поле «Субъект», где может храниться как ссылка на справочник Контрагенты, так и на справочник ФизическиеЛица. В таких случаях нам необходимо создать массив типов и передать его в конструктор ОписаниеТипов.
Разберем этот процесс по шагам:
// 1. Создаем массив, в который поместим все нужные типы
МассивТипов = Новый Массив;
МассивТипов.Добавить(Тип("СправочникСсылка.Контрагенты"));
МассивТипов.Добавить(Тип("СправочникСсылка.ФизическиеЛица"));
// 2. Создаем ОписаниеТипов на основании этого массива
ОписаниеСоставногоТипа = Новый ОписаниеТипов(МассивТипов);
// 3. Добавляем колонку в таблицу
ТЗ.Колонки.Добавить("Субъект", ОписаниеСоставногоТипа, "Контрагент или Физ.лицо");
Такой подход позволяет создавать гибкие структуры данных, сохраняя при этом контроль над типами, что критически важно для стабильной работы программного кода.
Если мы создаем колонки для хранения чисел, строк или дат, простого указания типа часто бывает недостаточно. Например, для суммы нам важна точность (количество знаков после запятой), а для строк — ограничение по длине. Для этого используются специальные объекты — квалификаторы.
Посмотрим на пример создания колонки для денежной суммы:
// Определяем параметры числа: 15 знаков всего, 2 знака после запятой, только положительное
КвалификаторыЧисла = Новый КвалификаторыЧисла(15, 2, ДопустимыйЗнак.Любой);
// Создаем описание типа "Число" с учетом этих квалификаторов
ОписаниеЧисла = Новый ОписаниеТипов("Число", КвалификаторыЧисла);
ТЗ.Колонки.Добавить("Сумма", ОписаниеЧисла, "Сумма операции");
Если проигнорировать этот шаг и добавить колонку просто как Новый ОписаниеТипов("Число"), система создаст числовое поле с неограниченной длиной. Это может привести к проблемам при отображении данных в формах или при попытке записать эти данные в реквизиты объектов базы данных, имеющих жесткие ограничения.
Проанализируем еще одну эффективную технику. Чтобы не прописывать типы вручную и гарантировать их полное соответствие метаданным вашей конфигурации, можно получить ОписаниеТипов напрямую из свойств объектов конфигурации.
Предположим, наша таблица значений должна полностью повторять структуру реквизита существующего документа:
// Получаем описание типа прямо из метаданных документа
ТипИзМетаданных = Метаданные.Документы.ЗаказПокупателя.Реквизиты.Контрагент.Тип;
// Используем полученный объект при добавлении колонки
ТЗ.Колонки.Добавить("Клиент", ТипИзМетаданных);
Этот метод считается наиболее профессиональным и безопасным, так как при изменении типа реквизита в конфигураторе (например, добавлении нового типа в составной тип в свойствах документа), ваша таблица значений обновится автоматически без изменения программного кода.
При работе с большими объемами данных или в сложных циклах важно помнить о производительности. Процесс создания объекта ОписаниеТипов является довольно ресурсоемким для системы.
Рассмотрим типичную ошибку:
// ПЛОХО: создание описания типов внутри цикла
Для Каждого ТекущаяСтрока Из МассивДанных Цикл
ТЗ = Новый ТаблицаЗначений;
ТЗ.Колонки.Добавить("Сумма", Новый ОписаниеТипов("Число")); // Ресурс тратится на каждой итерации
// ... логика заполнения
КонецЦикла;
Правильнее будет вынести инициализацию ОписаниеТипов в отдельную переменную за пределы цикла или использовать глобальные переменные/кеширование, если структура таблицы создается многократно в течение одного сеанса работы.
Мы выяснили, что ошибка «Несоответствие типов» при добавлении колонки в ТаблицаЗначений связана исключительно с неверным типом передаваемого объекта. Использование ОписаниеТипов вместо функции Тип() не только решает проблему, но и дает разработчику мощные инструменты для контроля данных: ограничение длины строк, точность чисел и создание сложных составных типов.
Всегда старайтесь типизировать колонки таблиц значений, даже если платформа позволяет создавать их пустыми. Это дисциплинирует код, ускоряет поиск по таблице и упрощает отладку, так как система сама будет следить за тем, чтобы в ячейки не попали некорректные данные.