Другое · 7 мин
Как добавить предопределённый элемент в справочник 1С
Инструкция по добавлению предопределённого элемента в справочник 1С через Конфигуратор: где найти раздел, как сохранить конфигурацию и проверить результат.
Предопределённый элемент справочника — это запись, которая создаётся разработчиком на этапе настройки конфигурации и доступна во всех информационных базах, развёрнутых от этой конфигурации. В отличие от обычного элемента, который пользователь вводит в режиме предприятия, предопределённый элемент заранее задан в метаданных и имеет постоянный идентификатор в коде.
Основное применение — ссылка в программах, отчётах и документах, где значение не должно меняться от базы к базе. Например, вид номенклатуры «Услуга», статья дохода «Основная деятельность» или статус заказа «Оплачен». Такие значения удобно использовать в условиях, без привязки к конкретному номеру строки в справочнике.
Что такое предопределённый элемент справочника
Предопределённые элементы хранятся в отдельной ветке дерева конфигурации, которая называется «Предопределённые элементы» внутри нужного справочника. Каждый такой элемент имеет синоним, имя и, как правило, код. В режиме предприятия элементы этого типа отображаются в списке справочника, но помечаются системой и недоступны для обычного редактирования или удаления пользователем.
Отличие от обычного элемента заключается в способе доступа. Обычный элемент ищется по наименованию или коду, который может отличаться в разных базах, а предопределённый элемент доступен по адресу вида Справочники.ИмяСправочника.Предопределенный.ИмяЭлемента. Это делает надёжным программное использование значений в отчётах и обработках.
Когда стоит добавлять предопределённый элемент
Добавлять предопределённый элемент имеет смысл, когда значение используется в алгоритме программы и не должно зависеть от действий пользователя. Типичные случаи: значения по умолчанию для реквизитов, константные справочные данные, ссылки в правилах обмена и шаблонах документов. Если значение вводится вручную и меняется от организации к организации, обычный элемент подходит больше.
Не стоит делать предопределённым каждую справочную запись. Чрезмерное количество таких элементов усложняет поддержку конфигурации и обновления, так как при изменении метаданных приходится повторно обновлять конфигурацию базы данных. Решение принимается на этапе проектирования, а не в процессе текущей эксплуатации.
Где находится раздел предопределённых элементов
Раздел находится в Конфигураторе в дереве конфигурации. Нужно открыть ветку «Справочники», найти нужный справочник, развернуть его и выбрать подэлемент «Предопределённые элементы». Если ветка отсутствует, справочник может не поддерживать предопределённые элементы или открыт не тот уровень конфигурации.
Перед внесением изменений обязательно создайте резервную копию информационной базы и файла конфигурации. Работа с конфигурацией требует прав администратора и, как правило, режима «Конфигурация» с возможностью редактирования. На защищённых конфигурациях изменения могут быть заблокированы поставщиком.
Пошаговое добавление предопределённого элемента
Откройте Конфигуратор и выберите нужную информационную базу. В дереве конфигурации разверните «Справочники», найдите целевой справочник и перейдите в раздел «Предопределённые элементы».
Выберите команду «Добавить» или контекстное меню «Новый элемент». Заполните поля: имя элемента в конфигурации, синоним (представление), при необходимости код. Убедитесь, что элемент помечен как предопределённый — в современных версиях платформа это делает автоматически для элементов в этой ветке.
- 1Открыть Конфигуратор и нужную информационную базу
- 2В дереве конфигурации найти справочник и раздел «Предопределённые элементы»
- 3Добавить новый элемент, заполнить имя, синоним и код
- 4Сохранить конфигурацию
- 5Обновить конфигурацию базы данных
- 6Проверить появление элемента в режиме предприятия
Сохраните конфигурацию через меню «Конфигурация» — «Сохранить конфигурацию». Затем выполните обновление конфигурации базы данных, чтобы изменения попали в рабочую информационную базу. Без этого шага новый элемент не появится в режиме предприятия.
После обновления откройте базу в режиме 1С:Предприятие, перейдите в соответствующий справочник и найдите новый элемент в списке. Предопределённый элемент обычно доступен для чтения и не предлагает стандартное удаление через интерфейс пользователя.
Как проверить результат
Элемент отображается и помечен как предопределённый
Элемент отсутствует или доступен для удаления пользователем
Код компилируется и выполняется без ошибок
Ошибка компиляции или неверное значение при выполнении
Как обращаться к элементу в коде
В модулях приложения элемент доступен через глобальный контекст. Например: Справочники.Номенклатура.Предопределенный.Услуга. Имя после слова Предопределенный совпадает с именем элемента в конфигурации, а не обязательно с его синонимом, показанным пользователю.
Использование предопределённых элементов в коде защищает от ошибок, связанных с переименованием или перемещением обычных записей. Если пользователь изменит наименование обычного элемента, программа, ищущая по наименованию, может сломаться, а ссылка на предопределённый элемент останется рабочей.
Проверка результата и ограничения
Проверьте, что элемент появился в списке справочника и доступен в коде под ожидаемым именем. Попробуйте сослаться на него в отчёте или обработке и выполните запуск без ошибок компиляции. Убедитесь, что элемент не предлагается к удалению обычным пользователем в интерфейсе.
Ограничение: предопределённые элементы нельзя массово создавать пользователями в режиме предприятия. Их количество и состав определяются разработчиком. Изменение свойств уже выпущенного элемента может повлиять на отчёты и обмен данными, поэтому правки вносятся осторожно и с тестированием.
Частые ошибки и риски
Частая ошибка — попытка создать предопределённый элемент напрямую в режиме предприятия через форму справочника. Это невозможно: элемент добавляется только в Конфигураторе. Другая ошибка — забыть обновить конфигурацию базы данных после сохранения в Конфигураторе, из-за чего элемент не отображается в рабочей базе.
Риск изменения конфигурации в рабочей базе без резервной копии может привести к потере данных или нарушению работы отчётов. Перед правками рекомендуется протестировать изменения на копии базы, а затем переносить на основную в соответствии с регламентом обновлений.
Что важно запомнить
Предопределённый элемент создаётся в Конфигураторе, сохраняется и обновляется в базе, после чего доступен в коде и только для чтения пользователям.
Часто задаваемые вопросы
Может ли обычный пользователь добавить предопределённый элемент?
Нет. Предопределённые элементы создаются только в Конфигураторе разработчиком или администратором конфигурации. В режиме предприятия пользователь может вводить обычные элементы, но не предопределённые.
Отличается ли имя элемента в коде от наименования в списке?
Да. В коде используется имя элемента из конфигурации, а в пользовательском списке отображается синоним. Они могут не совпадать, поэтому при программном обращении ориентируйтесь на имя из дерева конфигурации.
Нужно ли обновлять базу после добавления элемента?
Да. Сохранения конфигурации в Конфигураторе недостаточно. Требуется обновление конфигурации базы данных, иначе новый элемент не появится в рабочей информационной базе.
Можно ли удалить предопределённый элемент пользователем?
Обычно нет. Предопределённые элементы доступны для чтения и не подлежат стандартному удалению через интерфейс пользователя. Удаление возможно только разработчиком в конфигурации с последующим обновлением базы.
Что делать, если элемент не появился после добавления?
Проверьте, что конфигурация сохранена и обновлена в информационной базе, убедитесь, что элемент находится в ветке «Предопределённые элементы» нужного справочника, и переоткройте базу в режиме предприятия.