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