Экземпляр объекта в 1С: просто о сложном — разбираемся с нуля

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

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

Давайте разберёмся подробнее — от теории к практике.

1. Что такое экземпляр объекта: определение и аналогии

В программировании (и в 1С в частности) экземпляр объекта — это конкретная реализация класса, содержащая уникальные данные. Проще говоря, если класс — это шаблон (например, «Справочник.Номенклатура»), то экземпляр — конкретная запись в этом справочнике (например, товар «Монитор Samsung 24\"» с артикулом MON-00123).

Аналогия из реальной жизни:

• 📄 Класс — бланк паспорта (форма, поля, правила заполнения).
• 🆔 Экземпляр — ваш личный паспорт с фотографией, серией и номером.

В 1С:Предприятие экземпляры создаются для:

• 📋 Документов (например, конкретный «Приходный ордер №123» от 15.05.2026).
• 🗃️ Справочников (карточка контрагента «ООО Ромашка»).
• ⚙️ Объектов встроенного языка (например, Новый Структура() или Новый HTTPЗапрос).

Важно: экземпляр всегда существует в определённом состоянии (например, документ может быть «проводён» или «не проводён»), тогда как класс описывает только возможные состояния.

2. Как создаются экземпляры объектов в 1С

Способы создания экземпляров зависят от типа объекта. Рассмотрим основные сценарии:

1. Создание экземпляра справочника или документа:

Используется метод СоздатьОбъект() или конструктор Новый (для управляемых форм). Примеры:

// Для обычных форм (8.2)
Спр = Справочники.Номенклатура.СоздатьОбъект();

// Для управляемых форм (8.3+)
Спр = Справочники.Номенклатура.СоздатьЭлемент();

2. Создание объектов встроенного языка:

Here используются конструкторы Новый с указанием типа:

СтруктураДанных = Новый Структура("Ключ1, Ключ2");
HTTPЗапрос = Новый HTTPЗапрос("/api/data");

3. Получение существующего экземпляра:

Через методы выборки (например, ПолучитьОбъект()):

Док = Документы.ПоступлениеТоваров.НайтиПоНомеру("ПТ-000123", Дата("01.05.2026"));

3. Класс vs. экземпляр: ключевые различия

Чтобы избежать путаницы, сравним класс и экземпляр в контексте 1С:

⚠️ Внимание: В 1С термин «объект» часто используется как синоним «экземпляра», что может вводить в заблуждение. Например, фраза «объект документа» обычно означает конкретный экземпляр документа (например, «ПриходнаяНакладная123»), а не класс Документ.ПриходнаяНакладная.

4. Жизненный цикл экземпляра объекта

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

1. Создание:

Экземпляр появляется в памяти при вызове конструктора или метода создания. На этом этапе он существует только в RAM и не сохранён в базе.

2. Запись в базу:

После вызова Записать() экземпляр получает уникальный идентификатор (например, Ссылка) и сохраняется в таблицах СУБД. Пример:

НовыйТовар = Справочники.Номенклатура.СоздатьЭлемент();
НовыйТовар.Наименование = "Мышь Logitech M185";
НовыйТовар.Записать(); // Теперь экземпляр существует в базе

3. Изменение:

Экземпляр можно модифицировать (например, изменить реквизиты) и повторно сохранять. Важно: при этом создаётся новая версия объекта (включается механизм версионности).

4. Удаление:

Удаление экземпляра из базы выполняется методом Удалить(). Однако в некоторых случаях (например, для документов) может потребоваться пометка на удаление:

СтарыйТовар.ПометитьНаУдаление();
СтарыйТовар.Записать();

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

Убедиться, что объект не используется в других документах|Проверить права пользователя на удаление|Создать резервную копию (для критичных данных)|Пометить на удаление вместо полного удаления (если нужно сохранить историю)-->

5. Практические примеры работы с экземплярами

Рассмотрим типичные задачи, где понимание экземпляров критично:

Пример 1: Копирование документа

Чтобы скопировать документ, нужно создать новый экземпляр на основе существующего:

ИсходныйДок = Документы.РеализацияТоваров.НайтиПоНомеру("РТ-00123");
КопияДока = ИсходныйДок.Скопировать();
КопияДока.Дата = ТекущаяДата();
КопияДока.Записать();

Пример 2: Работа с коллекциями

Экземпляры часто хранятся в массивах или структурах. Добавить(Справочники.Номенклатура.НайтиПоНаименованию("Монитор"));

// Изменяем экземпляр в массиве

СписокТоваров[0].Артикул = "NEW-ARTICLE";

СписокТоваров[0].Записать(); // Изменится оригинальная запись в справочнике!

Пример 3: Сравнение экземпляров

Для сравнения используйте Ссылка или УникальныйИдентификатор(), а не оператор =:

Если Товар1.Ссылка = Товар2.Ссылка Тогда
Сообщить("Это один и тот же экземпляр!");
КонецЕсли;

6. Типичные ошибки при работе с экземплярами

Даже опытные разработчики иногда допускают ошибки. Вот самые распространённые:

1. Путаница с ссылками и объектами

Ошибка: попытка вызвать метод Записать() у ссылки, а не у экземпляра:

// ❌ Неправильно
СсылкаНаДок.Записать(); // Ошибка: "Метод не найден"

// ✅ Правильно
Док = СсылкаНаДок.ПолучитьОбъект();
Док.Записать();

2. Утечки памяти

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

Таблица = Новый ТаблицаЗначений();
//.. работаем с таблицей..
Таблица = Неопределено; // Освобождаем память

3. Неучтённая версионность

В 1С при записи экземпляра создаётся новая версия. Если не контролировать это, можно случайно «затереть» историю изменений. Например:

Док.Записать(РежимЗаписиДокумента.Запись); // Создаст новую версию
Док.Записать(РежимЗаписиДокумента.Проводить); // Проведёт и создаст версию

⚠️ Внимание: При работе с распределёнными базами (например, в 1С:УТ с территориально удалёнными складами) экземпляры объектов могут иметь разные состояния в разных узлах. Всегда проверяйте актуальность данных через ПолучитьПоследнююВерсию().

7. Экземпляры в контексте OOP и 1С

Хотя 1С:Предприятие не является полноценным ООП-языком, в ней есть элементы объектно-ориентированного подхода. Сравним:

Что заимствовано из OOP:

• 🔹 Инкапсуляция: данные и методы объекта объединены (например, у документа есть реквизиты и методы Провести(), ОтменитьПроведение()).
• 🔹 Наследование: объекты метаданных наследуют свойства от базовых классов (например, все документы наследуют методы от класса ДокументОбъект).

Чего нет в 1С (в классическом виде):

• 🚫 Полиморфизм: нельзя переопределять методы родительских классов.
• 🚫 Интерфейсы: нет явной реализации интерфейсов, как в Java или C#.

Перем мЭкземплярSingleton;

Функция ПолучитьЭкземпляр()
Если мЭкземплярSingleton = Неопределено Тогда
мЭкземплярSingleton = Новый Структура();
КонецЕсли;
Возврат мЭкземплярSingleton;
КонецФункции;

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

Неэффективная работа с экземплярами может тормозить систему. Вот как оптимизировать код:

1. Кэширование часто используемых экземпляров

Если вам постоянно нужен один и тот же справочник (например, «Основной склад»), загружайте его один раз:

Перем мОсновнойСклад;

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

2. Массовая обработка без создания экземпляров

Для операций с большими выборками используйте Выбрать() без получения объектов:

Выборка = Справочники.Номенклатура.Выбрать();
Пока Выборка.Следующий() Цикл
// Работаем со ссылкой, а не с экземпляром
Сообщить(Выборка.Наименование);
КонецЦикла;

3. Использование легковесных объектов

Для временных данных вместо СправочникОбъект или ДокументОбъект используйте Структура или ТаблицаЗначений — они потребляют меньше памяти.

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

FAQ: Частые вопросы об экземплярах объектов в 1С

НовыйТовар = Справочники.Номенклатура.СоздатьЭлемент();
НовыйТовар.Наименование = "Тестовый товар";
// Здесь экземпляр есть, но в базе его нет!

СущДок = Документы.ПриходнаяНакладная.ПолучитьОбъект(СсылкаНаДок); // Загружаем существующий
НовыйДок = Документы.ПриходнаяНакладная.СоздатьДокумент(); // Создаём новый

Если Не Справочники.Контрагенты.Существует(СсылкаНаКонтрагента) Тогда
Сообщить("Контрагент не найден!");
КонецЕсли;

ДанныеДляJSON = Новый Структура();
ДанныеДляJSON.Вставить("Наименование", Объект.Наименование);
ДанныеДляJSON.Вставить("Дата", Объект.Дата);
JSONСтрока = ЗаписатьJSON(ДанныеДляJSON);