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

Другое · 8 мин

Как получить значение функциональной опции 1С: пошаговая инструкция

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

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

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

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

1. Что представляет собой функциональная опция

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

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

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

2. Где взять имя опции и проверить её наличие

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

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

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

3. Чтение через ПараметрыСеанса.ФункциональныеОпции

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

На сервере и в общих модулях

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

На клиенте и в формах

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

В модуле объекта и командах

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

Порядок действий
  1. 1
    Узнать точное имя опции в конфигураторе
  2. 2
    Выбрать способ чтения в зависимости от места вызова
  3. 3
    Получить значение по имени опции
  4. 4
    Проверить, что результат не пустой и соответствует ожидаемому
  5. 5
    Использовать значение в бизнес-логике

4. Стандартный общий модуль библиотеки функциональных опций

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

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

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

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

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

Имя опции совпадает с конфигуратором
Норма

Опция найдена и имеет значение

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

Имя опечатки или опция отсутствует

Права текущего пользователя
Норма

Чтение разрешено

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

Доступ ограничен администратором

Контекст выполнения
Норма

Значение получено в нужном режиме

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

Значение отличается на клиенте и сервере

5. Проверка результата и условия применения

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

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

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

6. Ограничения, риски и типичные ошибки

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

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

Типичные ошибки
01
Обращение к несуществующему имени опции — пустой результат или ошибка
02
Изменение опции в рабочей базе без права администратора — риск для всех пользователей
03
Игнорирование контекста клиент/сервер — разные значения в разных частях программы

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

7. Алгоритм действий и когда обращаться к разработчику

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

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

Безопасная самостоятельная работа ограничивается чтением значения и использованием его в логике без записи в настройки опций.

Итог

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

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

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

Можно ли изменить значение функциональной опции из программы?

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

Что делать, если значение опции возвращает пустоту?

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

Различается ли значение на клиенте и на сервере?

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

Нужно ли перечитывать опцию при каждом действии?

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

Кто может помочь, если опции нет в конфигурации?

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