Как установить тип реквизита в 1С Предприятие

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

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

Базовый интерфейс конструктора типов

Работа с метаданными ведется в режиме Конфигуратор. После открытия дерева метаданных и выбора нужного объекта (например, справочника Номенклатура), необходимо перейти на вкладку Реквизиты. Здесь отображается список всех полей объекта. Для добавления нового поля используется контекстное меню или кнопка добавления, после чего открывается окно свойств нового элемента.

Ключевым элементом управления здесь является поле Тип. По умолчанию оно может быть пустым или содержать базовый тип, унаследованный от родительского объекта, если речь идет о предопределенных элементах. Нажатие на кнопку выбора типа (обычно обозначена тремя точками ...) открывает диалоговое окно Типы. Это окно представляет собой иерархический список всех примитивных и составных типов данных, доступных в платформе 1С:Предприятие 8.

Интерфейс конструктора типов интуитивно понятен, но скрывает в себе множество возможностей. Слева находится дерево категорий типов (Числа, Строки, Даты, Ссылки и т.д.), а справа — конкретные значения. При выборе типа в нижней части окна отображается краткое описание и примеры использования. Важно понимать, что выбор типа здесь фиксирует правило валидации данных на уровне базы данных.

После выбора конкретного типа, например Строка или Число, необходимо подтвердить действие кнопкой ОК. Система автоматически применит ограничения к полю ввода. Если вы попытаетесь ввести текст в поле, которому назначен тип Число, платформа выдаст ошибку еще на этапе ввода пользователем, предотвращая порчу данных.

Выбор простых и составных типов данных

Все типы данных в 1С делятся на простые и составные. Простые типы, такие как Число, Строка, Дата, Булево, позволяют хранить однородные данные. Они наиболее производительны и занимают минимум места в базе данных. Например, для хранения количества товара всегда следует использовать тип Число, а для даты отгрузки — тип Дата.

Однако реальные бизнес-процессы часто требуют гибкости. Здесь на сцену выходят составные типы. Это механизм, позволяющий одному реквизиту хранить данные разных видов. Классический пример — реквизит "Контрагент" в документе, который может ссылаться как на юридическое лицо, так и на физическое лицо, или даже на предопределенный элемент справочника "Прочие".

Для создания составного типа в конструкторе необходимо выбрать несколько элементов из списка, удерживая клавишу Ctrl или Shift. Система объединит их в один логический тип. При этом в коде программы переменная с таким типом потребует обязательной проверки перед использованием, так как компилятор не будет знать заранее, какой именно тип данных находится в ячейке в конкретный момент времени.

• 🔢 Число — используется для количественных показателей, сумм, курсов валют. Требует настройки длины и точности.
• 📝 Строка — универсальный тип для текстовой информации, кодов, артикулов. Ограничивается длиной (до 1024 символов в базе, больше — в хранилище).
• 📅 Дата — хранит момент времени. Может быть настроена на хранение только даты, только времени или полной даты с временем.
• 🔗 Ссылка — самый мощный тип, указывающий на конкретный объект метаданных (справочник, документ, план счетов).

Использование составных типов должно быть обоснованным. Чрезмерное увлечение ими усложняет написание запросов и замедляет работу системы, так как СУБД приходится выполнять дополнительные проверки типов при выборке данных. Всегда стремитесь к максимально простой типизации, если бизнес-логика это позволяет.

Настройка справочников и документов в качестве типа

Одной из самых частых задач является привязка реквизита к конкретному справочнику или документу. Это реализуется через тип СправочникСсылка.ИмяСправочника или ДокументОбъект.ИмяДокумента. В конструкторе типов эти значения находятся в соответствующих ветках дерева. Выбор конкретного справочника накладывает жесткую ссылочную целостность.

При установке типа "СправочникСсылка" система гарантирует, что в реквизите будет храниться только уникальная ссылка на существующий элемент этого справочника. Это критически важно для построения связей между объектами. Например, в документе "Реализация товаров" реквизит "Покупатель" должен иметь тип СправочникСсылка.Контрагенты.

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

⚠️ Внимание: При изменении имени справочника в дереве метаданных все реквизиты, использующие этот справочник как тип, автоматически обновят свои внутренние идентификаторы, но в программном коде придется вручную исправить устаревшие имена типов, иначе возникнут ошибки компиляции.

Также существует возможность использования типа СправочникОбъект. В отличие от ссылки, этот тип позволяет хранить весь объект в памяти, что удобно для временных обработок, но категорически не рекомендуется для хранения данных в табличной части документов или в регистрах, так как это резко увеличивает объем базы данных и снижает производительность.

Ограничения длины, точности и форматирования

После выбора базового типа часто требуется его дополнительная настройка. Для типа Строка критически важным параметром является Длина. По умолчанию она может быть установлена в 100 или 250 символов, но для полей типа "Комментарий" или "Описание" это значение следует увеличить. Максимальная длина строки в табличной части ограничена возможностями СУБД, обычно это 1024 символа для стандартных полей.

Для типа Число конфигурируются два параметра: Разрядность (общее количество цифр) и Точность (количество знаков после запятой). Для денежных сумм стандартом де-факто является точность 2 знака, для курсов валют — 4 или более знаков, а для количественных показателей (штуки, килограммы) точность может быть 0 или 3 в зависимости от специфики товара.

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

Тип данных	Параметр настройки	Рекомендуемое значение	Риск ошибки
Число (Сумма)	Точность	2 знака	Потеря копеек при округлении
Число (Количество)	Точность	0 или 3 знака	Невозможность ввода дробных частей
Строка (Артикул)	Длина	50-100 символов	Обрезание длинных кодов поставщиков
Дата	Части даты	Дата и время	Потеря информации о времени события

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

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

Тип Перечисление является одним из самых удобных инструментов для стандартизации ввода данных. Он позволяет создать закрытый список значений, из которых пользователь может выбрать только один вариант. Это идеально подходит для статусов документов, видов операций или категорий товаров.

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

Тип Булево (Логическое) используется для флагов и переключателей. Он принимает только два значения: Истина или Ложь. В интерфейсе такой реквизит чаще всего отображается как чекбокс (галочка). Использование булевого типа упрощает логику программных проверок: вместо сравнения строки со значением "Да" или "Нет", вы проверяете логическое условие напрямую.

Почему не стоит хранить статусы в строках?

Хранение статусов в типе Строка (например, "Новый", "Проведен") опасно опечатками. Пользователь может ввести "Проведён" с буквой "ё", и программный поиск по статусу "Проведен" не найдет этот документ. Перечисления исключают эту проблему.

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

Частые ошибки и способы их устранения

Одной из распространенных ошибок является несоответствие типа реквизита в табличной части и в шапке документа при попытке переноса данных. Если вы программируете перенос строки из одного документа в другой, типы соответствующих колонок должны быть совместимы. Попытка записать СправочникСсылка.Номенклатура в поле типа Строка вызовет исключение во время выполнения.

Также разработчики часто забывают про тип ХранилищеЗначения. Этот специальный тип позволяет сохранять в реквизите любой сериализуемый объект 1С. Это мощный инструмент для хранения настроек, сложных структур данных или даже макетов отчетов прямо в базе. Однако использование хранилища усложняет анализ данных средствами запросов, так как содержимое хранилища непрозрачно для языка запросов.

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

Еще одна проблема — использование устаревших типов или типов, не поддерживаемых в новых версиях платформы. Хотя платформа 1С обладает высокой обратной совместимостью, при переходе на новые релизы (например, с 8.2 на 8.3 и выше) некоторые особенности поведения типов могли измениться. Всегда тестируйте конфигурацию на актуальной версии платформы.

Программная установка типа и динамические структуры

В некоторых сценариях требуется динамическое определение типа на этапе выполнения программы. Для этого используется встроенный тип ОписаниеТипов. Этот объект позволяет программно сконструировать набор допустимых типов, установить ограничения (минимум, максимум, длину строки) и применить их к полю формы или переменной.

Пример создания описания типов в коде:

ОпрТипа = Новый ОписаниеТипов("Число", , Новый КвалификаторыЧисла(15, 2));
ЭлементФормы.ТипЗначения = ОпрТипа;

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

При работе с динамическими списками и универсальными обработчиками часто используется тип Неопределено. Переменная такого типа может принять любое значение. Это удобно для временных вычислений, но требует тщательного контроля перед записью в базу данных, так как база не примет неопределенное значение в типизированную колонку.

Как проверить тип в коде?

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

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

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

В чем разница между СправочникСсылка и СправочникОбъект?

Ссылка хранит только уникальный идентификатор объекта (легкая структура). Объект хранит полную копию всех данных объекта в памяти (тяжелая структура). В реквизитах таблиц базы данных всегда следует использовать Ссылку для производительности.

Что делать, если нужного типа нет в списке конструктора?

Проверьте, подключена ли соответствующая библиотека стандартных подсистем (БСП) или расширение. Некоторые типы становятся доступными только при наличии определенных компонентов. Также убедитесь, что вы не ищете тип объекта в ветке примитивных типов.

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

Это настраивается не в типе реквизита, а в свойствах поля формы через параметр "Список выбора" или программно в событии "НачалоВыбора". Тип реквизита лишь определяет, на какой справочник можно ссылаться в принципе.

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

При использовании составных типов в условиях отбора (ГДЕ) серверу базы данных сложнее использовать индексы, так как в одной колонке могут храниться данные разной физической структуры. Это приводит к полному сканированию таблиц вместо быстрого поиска по индексу.