Какие существуют типы данных и объектов в 1С: Предприятие

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

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

Примитивные типы данных в языке 1С

Базовые скалярные типы составляют фундамент любой системы. К ним относятся Число, Строка, Дата, Булево и Null (Неопределено). Эти значения хранятся непосредственно в переменных и передаются по значению, если не используются специальные конструкции. Например, переменная типа Число может хранить целые и дробные значения с произвольной точностью, что отличает 1С от многих других языков, где используется фиксированная точность float или double.

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

Отдельного внимания заслуживает тип Null. В отличие от SQL, где NULL означает отсутствие значения, в 1С Неопределено является полноценным значением, которое можно присвоить переменной. Однако попытка выполнить арифметическую операцию с неопределенным значением приведет к/runtime ошибке. Всегда проверяйте переменные функцией ЗначениеЗаполнено() перед использованием.

Ссылочные типы: Справочники, Документы и Планы видов

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

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

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

• 📁 Справочники: хранят условно-постоянную информацию (номенклатура, контрагенты).
• 📄 Документы: фиксируют хозяйственные операции и имеют временную метку.
• 📊 Планы счетов: используются для построения бухгалтерского и налогового учета.

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

Регистры и их типы данных

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

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

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

Особенность регистров бухгалтерии

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

Составные типы и их применение

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

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

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

Тип значения	Изменяемость	Пример использования
Число, Строка, Дата	Неизменяемые	Параметры функций, временные вычисления
СправочникОбъект	Изменяемый	Редактирование карточки номенклатуры
СправочникСсылка	Неизменяемая	Передача идентификатора в другие модули
Структура, Соответствие	Изменяемые	Хранение сложных наборов данных в памяти

Коллекции значений и структуры

Для работы с наборами данных в памяти в 1С предусмотрены специальные типы коллекций. Массив представляет собой упорядоченный список значений, доступ к которым осуществляется по индексу. Структура — это набор пар «Ключ-Значение», где ключом может быть строка. Соответствие (Map) позволяет использовать в качестве ключа любой объект, включая ссылки и числа.

Коллекции значений (ТаблицаЗначений, ДеревоЗначений) являются наиболее производительным способом обработки данных внутри сеанса. Они позволяют выполнять фильтрацию, сортировку и поиск без обращения к серверу базы данных. Тип ТаблицаЗначений часто используется как буфер между запросом и формой отчета.

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

• 📦 Массив: простой список элементов, быстрый доступ по номеру.
• 🏷️ Структура: ассоциативный массив, удобен для передачи параметров.
• 🗂️ ТаблицаЗначений: имитация таблицы базы данных в оперативной памяти.

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

Определение и приведение типов в коде

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

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

В современных версиях платформы (8.3.20+) рекомендуется использовать аннотации типов в комментариях к коду. Это помогает системе интеллектуальной подсветки (Autocomplete) правильно определять доступные методы и свойства, даже если тип переменной вычисляется динамически.

Интерфейсы и функциональные опции в 1С постоянно обновляются. Методы работы с новыми типами (например, Битовая маска или JSON) могут отличаться в разных релизах платформы. Всегда сверяйтесь с синтаксис-помощником вашей конкретной версии 1С.

Часто задаваемые вопросы (FAQ)

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

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

Как узнать тип переменной в отладчике?

В отладчике 1С наведите курсор на переменную. Во всплывающей подсказке будет указано текущее значение и его тип, например: Число: 100 или Строка: "Тест". Также можно использовать метод Сообщить(ТипЗнч(Переменная)) в коде.

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

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

Что такое Неопределено и чем оно отличается от ПустаяСтрока?

Неопределено (Null) означает, что значение не задано вовсе. ПустаяСтрока — это строка длиной 0 символов. В логических выражениях Неопределено часто ведет себя как Ложь, но при сравнении строк "" = Неопределено вернет Ложь. Это принципиально разные сущности.

Зачем нужны Фиксированные структуры?

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