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

Другое · 7 мин

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

Инструкция по добавлению предопределённого элемента в справочник 1С через Конфигуратор: где найти раздел, как сохранить конфигурацию и проверить результат.

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

Основное применение — ссылка в программах, отчётах и документах, где значение не должно меняться от базы к базе. Например, вид номенклатуры «Услуга», статья дохода «Основная деятельность» или статус заказа «Оплачен». Такие значения удобно использовать в условиях, без привязки к конкретному номеру строки в справочнике.

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

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

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

Когда стоит добавлять предопределённый элемент

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

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

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

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

Перед внесением изменений обязательно создайте резервную копию информационной базы и файла конфигурации. Работа с конфигурацией требует прав администратора и, как правило, режима «Конфигурация» с возможностью редактирования. На защищённых конфигурациях изменения могут быть заблокированы поставщиком.

Пошаговое добавление предопределённого элемента

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

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

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

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

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

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

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

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

Элемент отображается и помечен как предопределённый

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

Элемент отсутствует или доступен для удаления пользователем

Ссылка в коде
Норма

Код компилируется и выполняется без ошибок

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

Ошибка компиляции или неверное значение при выполнении

Как обращаться к элементу в коде

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

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

Типичные ошибки
01
Попытка создать предопределённый элемент в режиме предприятия через форму справочника — это невозможно, элемент добавляется только в Конфигураторе
02
Забыть обновить конфигурацию базы данных после сохранения в Конфигураторе, из-за чего элемент не отображается в рабочей базе

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

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

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

Частые ошибки и риски

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

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

Итог

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

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

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

Может ли обычный пользователь добавить предопределённый элемент?

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

Отличается ли имя элемента в коде от наименования в списке?

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

Нужно ли обновлять базу после добавления элемента?

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

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

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

Что делать, если элемент не появился после добавления?

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