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

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

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

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

Что такое предопределенные элементы и когда они нужны

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

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

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

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

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

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

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

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

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

ВалютаРубль = Справочники.Валюты.Рубль;
Если Документ.Валюта = Справочники.Валюты.Рубль Тогда
    // логика для рублевых документов
КонецЕсли;

Для планов счетов и планов видов характеристик синтаксис аналогичный: ПланыСчетов.Хозрасчетный.Товары или ПланыВидовХарактеристик.ДополнительныеРеквизитыИСведения.ИмяЭлемента. Если элемент с таким именем не существует в конфигурации, обращение вызовет ошибку еще на этапе проверки модуля, что защищает от опечаток.

В запросах предопределенные элементы передают как параметры. Конструкция вида «Значение(Справочник.Валюты.Рубль)» в тексте запроса тоже поддерживается и позволяет сравнивать поля напрямую с предопределенной ссылкой.

ВЫБРАТЬ Документ.Ссылка
ИЗ Документ.РеализацияТоваровУслуг КАК Документ
ГДЕ Документ.Валюта = ЗНАЧЕНИЕ(Справочник.Валюты.Рубль)

Режимы создания предопределенных элементов

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

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

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

Особенности для планов счетов и планов видов характеристик

У планов счетов предопределенные элементы — основной способ задания плана счетов: счета «Товары», «Касса», «РасчетныеСчета» создаются именно так. Для них в конфигураторе задаются код, наименование, вид счета (активный, пассивный, активно-пассивный), признаки учета и забалансовость.

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

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

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

Ограничения и когда предопределенные элементы не подходят

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

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

FAQ