К статье
Практический материал

Другое · 6 мин

Создание предопределённого элемента справочника в 1С

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

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

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

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

Что такое предопределённый элемент справочника

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

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

Зачем нужны предопределённые элементы

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

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

Создание в конфигураторе

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

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

Порядок создания в конфигураторе
  1. 1
    Откройте справочник в конфигураторе и создайте новый элемент
  2. 2
    В свойствах элемента установите признак предопределённости
  3. 3
    Присвойте элементу уникальное символическое имя
  4. 4
    Сохраните конфигурацию и обновите базу данных
  5. 5
    Проверьте доступность элемента в списке справочника

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

Программное обращение к предопределённому элементу

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

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

bsl
Элемент = Справочники.МояСправочник.ПредопределенныйЭлемент.ИмяЭлемента;Если Элемент = Неопределено Тогда ... КонецЕсли;

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

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

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

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

Контрольные точки

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

Элемент виден в списке справочника
Норма

Отображается с признаком предопределённости

Тревожный признак

Элемент отсутствует или не имеет специальной пометки

Программное обращение
Норма

Возвращает ссылку без ошибки

Тревожный признак

Возвращается неопределённое значение или пустая ссылка

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

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

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

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

Типичные ошибки
01
Попытка удалить предопределённый элемент обычным способом вместо пометки на удаление
02
Использование несуществующего имени предопределённого элемента в коде без проверки на неопределённость

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

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

Итог

Что важно запомнить

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

Можно ли создать предопределённый элемент без конфигуратора?

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

Что делать, если программное обращение к элементу возвращает пустоту?

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

Можно ли удалить предопределённый элемент?

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

Нужно ли проверять ссылку на предопределённый элемент перед использованием?

Да. Если элемент отсутствует или не инициализирован, код может получить неопределённое значение, поэтому проверка на заполненность ссылки делает надёжнее документы, отчёты и обработки.