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

Другое · 8 мин

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

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

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

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

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

В статье рассмотрим, в каких ситуациях программное создание оправдано, как проверить результат, какие ограничения существуют и какие ошибки встречаются чаще всего. Материал ориентирован на самостоятельную работу разработчика и администратора базы 1С.

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

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

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

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

Когда программное создание может быть оправдано

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

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

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

Порядок действий при программном создании

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

В коде элемент справочника создается через метод СоздатьЭлемент() менеджера справочника, после чего заполняются реквизиты: код, наименование, родитель и прочие поля. Если платформа и режим позволяют установить признак предопределенности, это делается перед записью элемента.

Запись выполняется методом Записать(). После записи следует проверить, что элемент появился в справочнике, доступен через коллекцию ПредопределенныеЭлементы и корректно связывается с документами, которые на него ссылаются.

Порядок действий
  1. 1
    Проверить права доступа к справочнику и режиму работы
  2. 2
    Создать элемент через СоздатьЭлемент() и заполнить реквизиты
  3. 3
    При необходимости установить признак предопределенности
  4. 4
    Записать элемент методом Записать()
  5. 5
    Проверить доступ через ПредопределенныеЭлементы и связь с документами

Обычный элемент и предопределенный: ключевые различия

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

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

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

Сравнение вариантов

Обычный элемент справочника

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

Предопределенный элемент

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

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

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

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

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

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

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

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

Запись создана и открывается для редактирования

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

Элемент отсутствует или выдает ошибку при открытии

Доступ через ПредопределенныеЭлементы
Норма

Возвращает ссылку на созданный элемент

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

Возвращает неопределенное значение или ошибку

Связь с документами
Норма

Элемент можно выбрать в реквизите документа

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

Элемент не отображается в списке выбора

Типичные ошибки и риски

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

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

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

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

Альтернативы и безопасная самостоятельная работа

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

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

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

Итог

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

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

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

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

Что делать, если после создания элемента он не виден через ПредопределенныеЭлементы?

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

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

Да, особенно если работа идет с критическими справочниками учета. Резервная копия позволяет откатить изменения при ошибке записи или конфликте кодов.

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

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