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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Имя предопределенного элемента должно быть уникальным в рамках объекта и соответствовать правилам именования идентификаторов встроенного языка: без пробелов, начиная с буквы. Используйте осмысленные имена — по ним код будет читаться сам собой: ОсновнойСклад понятнее, чем Элемент1.

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

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

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

// Прямое обращение по имени
ВалютаРубль = Справочники.Валюты.Рубль;
СчетКасса = ПланыСчетов.Хозрасчетный.КассаОрганизации;

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

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

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

Проверка существования элемента

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

Режимы обновления предопределенных данных

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

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

Типичные ошибки и их устранение

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

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

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

Предопределенные элементы в расширениях конфигурации

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

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

Как проверить результат

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

Частые вопросы