Предопределенный элемент в 1С: что это и как с ним работать

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

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

Понимание механизма предопределенных данных важно и администраторам, и разработчикам: именно с ним связаны типовые ошибки вроде «Предопределенный элемент отсутствует в данных», а также ограничения на удаление и переименование таких элементов в пользовательском режиме.

Где встречаются предопределенные элементы и как они устроены

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

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

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

Чем предопределенный элемент отличается от обычного

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

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

Как создать предопределенный элемент в конфигураторе

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

1. 1
   Откройте конфигуратор и найдите нужный объект (справочник, план счетов и т.д.) в дереве конфигурации.
2. 2
   Откройте окно редактирования объекта и перейдите к списку предопределенных элементов (кнопка «Предопределенные» или соответствующая закладка).
3. 3
   Добавьте новый элемент: задайте имя по правилам идентификаторов, наименование и при необходимости код.
4. 4
   Сохраните конфигурацию и выполните обновление конфигурации базы данных (F7).
5. 5
   Запустите режим «Предприятие» и проверьте, что элемент появился в списке и доступен из кода.

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

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

Как обратиться к предопределенному элементу из кода

Основной способ — обращение через менеджер объекта по имени. Платформа предоставляет два синтаксиса: классический (через точку) и безопасный (через метод).

// Классическое обращение — вызовет исключение, если элемента нет
ВалютаРубль = Справочники.Валюты.Рубль;

// Безопасное обращение — вернет Неопределено при отсутствии
ВалютаРубль = Справочники.Валюты.ПредопределенныйЭлемент("Рубль");
Если ВалютаРубль = Неопределено Тогда
    // элемент отсутствует в данных
КонецЕсли;

Метод ПредопределенныйЭлемент() предпочтительнее в прикладном коде: он не вызывает исключение, если элемент по какой-то причине отсутствует в данных (например, после загрузки данных из другой базы). Классическое обращение через точку короче, но при отсутствии элемента прерывает выполнение с ошибкой.

Для проверки, является ли конкретная ссылка предопределенной, используется метод объекта Предопределенный() — он возвращает Истина для предопределенных элементов. Это полезно, например, при написании обработок удаления данных, чтобы случайно не затронуть служебные элементы.

Типовые ошибки и проблемы с предопределенными элементами

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

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

Как восстановить отсутствующий предопределенный элемент

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

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

Когда использовать предопределенные элементы, а когда — нет

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

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

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

Проверка результата и контрольные точки

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

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

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