Другое · 7 мин
Как обращаться к константе в 1С
Как обращаться к константе в 1С: способы чтения и записи, контексты клиент и сервер, права доступа, проверка результата и частые ошибки конфигурации.
Константа в конфигурации 1С — именованное хранилище одного значения, которое используется в разных частях решения: ставки налогов, наименование организации, флаги поведения отчётов, пороги скидок и тому подобное. Обращение к ней по символьному имени избавляет от дублирования значений в коде и упрощает изменение при изменении правил.
В встроенном языке чтение выполняется через глобальный контекст: Константы.<ИмяКонстанты>.Получить(). Результат зависит от типа константы, конфигурации, прав текущего пользователя и того, выполнен ли код на клиенте, сервере или в фоновом задании. Нельзя считать, что один способ одинаково работает в обычном и управляемом приложении, в тонком и толстом клиенте.
Объявление и свойства константы
Константа создаётся в конфигураторе как объект метаданных с типом значения, именем и текущим значением. Значение может быть строкой, числом, датой, булевым значением, ссылкой на справочник и другими типами, поддерживаемыми платформой.
Свойство доступности определяет, где значение видно: только на сервере, на клиенте или в обоих контекстах. Если константа помечена как недоступная для клиента, попытка чтения из обычной формы может вернуть неопределённое значение или вызвать ошибку в зависимости от версии платформы.
Чтение из клиентского и серверного кода
В управляемой форме обращение обычно записывается так: Константы.НазваниеКонстанты.Получить(). Возвращаемое значение можно присвоить переменной, использовать в условии или передать в параметр отчёта.
Значение = Константы.СтавкаНДС.Получить();
Если Значение <> 0 Тогда
// использование значения
КонецЕсли;В серверном модуле синтаксис тот же, но выполнение происходит на сервере приложения, что важно для фоновых заданий и распределённых баз. В обычном приложении доступ может зависеть от типа клиента и настроек безопасности, поэтому код стоит проверять в том же режиме, в котором будет использоваться.
Отличие обычного и управляемого приложения
В управляемом приложении константы чаще доступны напрямую из форм и модулей объектов. В обычном приложении нужно учитывать разницу между клиентским и серверным вызовами, а также возможность отсутствия константы в текущем сеансе после изменений конфигурации.
Фоновые задания и расписания
Для регламентных и фоновых заданий предпочтительнее серверный контекст, где значения констант читаются без привязки к интерфейсу пользователя. Если задание запускается от имени пользователя без нужных прав, чтение может завершиться ошибкой доступа.
Проверьте имя регистронезависимо, права пользователя и доступность константы в текущем контексте
Сохраните конфигурацию, обновите сеанс и повторите проверку на чистой базе
Чтение и запись значения
Чтение константы в большинстве случаев безопасно и не требует особых прав, кроме прав на просмотр конфигурации. Запись значения возможна только в пределах, предусмотренных конфигурацией, и часто требует прав администратора или изменения в конфигураторе.
Программное изменение константы в режиме предприятия может влиять на все пользователи и все документы, которые используют это значение. Перед таким действием стоит сделать резервную копию базы и протестировать изменение на изолированной копии.
После изменения значения константы уже запущенные сеансы могут продолжать использовать старое значение до перезапуска или обновления сеанса. Это не ошибка платформы, а особенность кэширования значений в рабочем месте пользователя.
Права доступа и контексты выполнения
Права на чтение и запись констант настраиваются в ролях и правах доступа к объектам конфигурации. Если пользователь не имеет права на объект, попытка обращения к константе может быть заблокирована на уровне платформы.
В веб-клиенте и тонком клиенте код выполняется на стороне клиента с ограниченным набором серверных вызовов. Если константа доступна только на сервере, клиентский код должен обращаться к серверной процедуре или функции, а не читать константу напрямую.
Проверка результата и типичные ошибки
После чтения константы проверяйте, что значение не равно неопределённому и имеет ожидаемый тип. Пустая строка, ноль или неопределённое значение могут означать как корректное значение, так и ошибку доступа, поэтому результат нужно интерпретировать в контексте задачи.
Как проверить результат
Ожидаемый тип и непустое значение
Неопределённое значение, пустая строка или ошибка доступа
Чтение работает в тонком, веб и обычном клиенте
Работает только в конфигураторе или только на сервере
Проверяйте результат в том же клиенте и под тем же пользователем, под которым будет работать окончательный сценарий. Значение, которое корректно читается в конфигураторе, может быть недоступно в тонком клиенте из-за прав или контекста.
Когда константа не подходит и альтернативы
Константы подходят для значений, которые меняются редко и одинаковы для всей базы. Если значение зависит от организации, пользователя, склада или периода, лучше использовать регистры сведений, настройки пользователей, параметры сеанса или справочники.
Сравнение вариантов
Подходит для общих стабильных значений, ограничена правами и контекстом
Подходит для зависимых и часто меняющихся значений, требует больше разработки
Для часто меняющихся параметров константы становятся узким местом: каждое изменение требует доступа к конфигурации или правам администратора, что замедляет внесение правок. В таких случаях вынесите значение в справочник или регистр с настраиваемым доступом.
Не используйте константы для хранения чувствительных данных, паролей или ключей доступа. Такая информация лучше выносить в защищённые хранилища или параметры соединения, а не оставлять в открытом коде конфигурации.
Что важно запомнить
Читайте константы через Константы.<Имя>.Получить(), учитывайте контекст и права, проверяйте результат в целевом клиенте и не меняйте значения в рабочей базе без тестирования.
Можно ли изменить константу программно в режиме предприятия?
Возможность зависит от настроек конфигурации и прав пользователя. Обычно изменение требует прав администратора, доступа к объекту константы и может не вступить в силу сразу для уже запущенных сеансов.
Почему Константы.Имя.Получить() возвращает неопределённое значение?
Причины могут быть в неверном имени, отсутствии доступа к константе, недоступности в текущем клиентском контексте или использовании старого сеанса после изменений конфигурации.
Нужно ли перезапускать программу после изменения константы?
Часто требуется обновить сеанс или перезапустить рабочее место, чтобы новые значения применились везде. Точное поведение зависит от типа клиента и способа изменения значения.
Какая разница между константой и реквизитом справочника?
Константа хранит одно значение для всей базы, а реквизит справочника — значение для конкретного элемента. Для общих правил подходит константа, для зависимых от объекта данных — справочник или регистр.