Создание предопределённых элементов в 1С: от теории к практике

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

В этой статье мы разберём не только техническую сторону создания предопределённых элементов, но и нюансы их применения. Вы узнаете, как правильно добавлять такие элементы в справочники, перечисления и планы видов характеристик, избегая типичных ошибок. Особое внимание уделим различиям между версиями платформы 1С 8.3 и 1С 8.2, а также рассмотрим примеры кода на встроенном языке. Материал будет полезен как начинающим разработчикам, так и опытным программистам, которые хотят систематизировать свои знания.

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

Что такое предопределённый элемент и зачем он нужен

Предопределённый элемент — это объект конфигурации, который существует одновременно в двух ипостасях:

• 📝 В метаданных — как часть структуры конфигурации (виден в конфигураторе).
• 🗃️ В базе данных — как запись в таблице (виден в пользовательском режиме).

Основные сценарии использования:

• 🔄 Системные справочники: валюты (Рубль, Доллар США), единицы измерения (шт., кг), страны.
• 📊 Перечисления: статусы документов (Новый, Оплачен, Отгружен), типы операций.
• 🔧 Планы видов характеристик: свойства номенклатуры (Цвет, Размер).
• 📌 Константы с предопределёнными значениями (реже, но возможно).

Главное преимущество — гарантированное наличие таких элементов в базе даже после её полной перезагрузки. Например, если в справочнике Валюты предопределён Рубль, то при создании нового документа ПоступлениеТоваровУслуг пользователь всегда сможет выбрать его в поле Валюта, не опасаясь ошибки "Справочник пуст".

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

Виды объектов, поддерживающих предопределённые элементы

Не все объекты конфигурации могут содержать предопределённые элементы. В таблице ниже приведены основные типы с примерами:

Важно понимать, что документы, регистры и отчёты не поддерживают предопределённые элементы в классическом понимании. Однако для документов можно создавать предопределённые шаблоны (через механизм ДокументОбъект.Заполнить()), но это уже другая тема.

Пошаговая инструкция: создание предопределённого элемента в справочнике

Рассмотрим процесс на примере справочника ЕдиницыИзмерения. Предположим, нам нужно добавить предопределённую единицу Литр.

1. Откройте конфигуратор и перейдите в дерево метаданных: Общие → Справочники → ЕдиницыИзмерения.

2. Дважды кликните на справочник, чтобы открыть его форму.

3. Перейдите на закладку Данные и нажмите кнопку Добавить (или Ins).

4. В поле Наименование введите Литр, в поле Полное наименование — Литр (л).

5. Установите флажок Предопределённый (в нижней части формы).

6. Заполните дополнительные реквизиты (например, Международное обозначение — L).

7. Сохраните изменения (кнопка ОК или Ctrl+S).

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

Справочник = Справочники.ЕдиницыИзмерения;
Элемент = Справочник.НайтиПоНаименованию("Литр");
Если Элемент.Пустая() Тогда
Сообщить("Элемент не найден!");
Иначе
Сообщить("ID элемента: " + Элемент.УникальныйИдентификатор());
КонецЕсли;

Убедиться, что флажок "Предопределённый" установлен|

Проверить уникальность наименования (нет дублей)|

Заполнить все обязательные реквизиты|

Сохранить конфигурацию и обновить базу|

Проверить наличие элемента в пользовательском режиме-->

Работа с предопределёнными элементами через код

Иногда требуется программно получить доступ к предопределённому элементу или создать его динамически (например, при миграции данных). Для этого используются методы глобального контекста:

Получение предопределённого элемента:

// Получение по имени (для справочников)
Элемент = Справочники.Валюты.Рубль;

// Получение по идентификатору (универсальный способ)
ИдЭлемента = Новый УникальныйИдентификатор("a4f1d3b2-...-..."); // ID из конфигуратора
Элемент = Справочники.Валюты.ПолучитьСсылку(ИдЭлемента);

Создание предопределённого элемента в коде (для опытных разработчиков):

// Только для случаев, когда элемент ещё не существует в конфигурации!
Процедура СоздатьПредопределенныйЭлемент()
СправочникОбъект = Справочники.ЕдиницыИзмерения.СоздатьЭлемент();
СправочникОбъект.Наименование = "Килограмм";
СправочникОбъект.ПолноеНаименование = "Килограмм (кг)";
СправочникОбъект.МеждународноеОбозначение = "kg";
СправочникОбъект.ПометкаУдаления = Ложь;
СправочникОбъект.Записать();

// Присвоение статуса "предопределённый" (только в конфигураторе!)
// В пользовательском режиме это сделать нельзя!
КонецПроцедуры

⚠️ Внимание: Динамическое создание предопределённых элементов в пользовательском режиме не поддерживается платформой. Все манипуляции должны выполняться в конфигураторе или через механизм ЗагрузкаДанныхИзФайла() с использованием XML-шаблонов.

Для массовой работы с предопределёнными элементами удобно использовать Запрос:

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|   ЕдиницыИзмерения.Ссылка КАК Ссылка,
|   ЕдиницыИзмерения.Наименование КАК Наименование
|ИЗ
|   Справочник.ЕдиницыИзмерения КАК ЕдиницыИзмерения
|ГДЕ
|   ЕдиницыИзмерения.ЭтоГруппа = ЛОЖЬ
|   И ЕдиницыИзмерения.Предопределенный = ИСТИНА";
Результат = Запрос.Выполнить();

Типичные ошибки и как их избежать

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

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

Чтобы избежать этих проблем, следуйте правилам:

1. Всегда проверяйте ссылки на предопределённые элементы перед их изменением (используйте отчёт Анализ использования метаданных в конфигураторе).
2. Для массовых изменений используйте обработки сравнения и объединения (cf-файлы).
3. Перед удалением предопределённого элемента замените все ссылки на него в базе (через запрос или обработку).

Особенности работы в разных версиях 1С

Механизм предопределённых элементов эволюционировал вместе с платформой. Основные различия между версиями:

Для версий 1С 8.3.18+ доступен удобный механизм работы с предопределёнными элементами через расширения конфигурации. Это позволяет добавлять новые предопределённые элементы без изменения основной конфигурации, что критично для типовых решений.

⚠️ Внимание: В версиях 1С 8.2 и ранних 8.3 при изменении свойств предопределённого элемента (например, наименования) не обновляются ссылки в уже созданных документах. Это может привести к "битым" ссылкам. Всегда тестируйте такие изменения на копии базы!

Практические примеры: от простого к сложному

Пример 1. Добавление предопределённой валюты

Задача: создать предопределённую валюту Евро со стандартными реквизитами.

// В конфигураторе:
1. Открыть справочник "Валюты".
2. Добавить новый элемент с наименованием "Евро".
3. Установить флажок "Предопределённый".
4. Заполнить реквизиты:
- Код: "EUR"
- Кратность: 1
- Курс: 1 (по умолчанию)
5. Сохранить.

Пример 2. Массовое создание предопределённых элементов через обработку

Если нужно добавить несколько элементов (например, список стран), удобно использовать обработку:

Процедура ЗаполнитьСправочникСтраны()
МассивСтран = Новый Массив;
МассивСтран.Добавить("Россия,RU");
МассивСтран.Добавить("Германия,DE");
МассивСтран.Добавить("Франция,FR");

Для Каждого Строки Из МассивСтран Цикл
Данные = РазложитьСтрокуВМассив(Строки, ",");
Наименование = Данные[0];
Код = Данные[1];

Элемент = Справочники.Страны.СоздатьЭлемент();
Элемент.Наименование = Наименование;
Элемент.Код = Код;
Элемент.Предопределенный = Истина; // Только в конфигураторе!
Элемент.Записать();
КонецЦикла;
КонецПроцедуры

Пример 3. Использование предопределённых элементов в коде модуля

Типичная задача: при создании документа автоматически подставлять предопределённую валюту Рубль:

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

FAQ: Частые вопросы по предопределённым элементам

ВЫБРАТЬ РАЗРЕШЕННЫЕ ЕдиницыИзмерения.Ссылка, ЕдиницыИзмерения.Наименование ИЗ Справочник.ЕдиницыИзмерения КАК ЕдиницыИзмерения

Процедура ПриНачалеРаботыСистемы()
Если НЕ РегистрыСведений.КурсыВалют.НайтиПоРеквизиту("Валюта", Справочники.Валюты.ДолларUSA) Тогда
Запись = РегистрыСведений.КурсыВалют.СоздатьЗапись();
Запись.Валюта = Справочники.Валюты.ДолларUSA;
Запись.Курс = 75;
Запись.Дата = ТекущаяДата();
Запись.Записать();
КонецЕсли;
КонецПроцедуры