Как добавить константу в 1С 8: пошаговое руководство

Константа в 1С 8 — это объект конфигурации для хранения единственного значения, которое меняется редко: наименование организации, ФИО директора, признак включения функциональности, параметры обмена. В отличие от справочника, константа не имеет табличной части и хранит ровно одно значение для всей информационной базы (или для каждого разделителя данных, если включено разделение).

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

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

Что такое константа и когда её использовать

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

Константу стоит выбирать, когда значение одно на всю базу и не требует истории изменений. Если нужно хранить несколько однотипных значений — используйте справочник. Если нужна история изменения значения во времени (например, курс валюты или ставка НДС по датам) — подойдёт периодический регистр сведений, а не константа.

Создание константы в конфигураторе

Откройте конфигуратор и загрузите конфигурацию: меню «Конфигурация» → «Открыть конфигурацию». Если конфигурация находится на поддержке без возможности изменения, сначала включите возможность изменения через «Конфигурация» → «Поддержка» → «Настройка поддержки».

В дереве конфигурации найдите ветку «Константы». Щёлкните по ней правой кнопкой мыши и выберите «Добавить» либо нажмите кнопку добавления в панели инструментов окна конфигурации. Откроется палитра свойств нового объекта.

1. 1
   Откройте конфигуратор и конфигурацию базы
2. 2
   В ветке «Константы» нажмите «Добавить»
3. 3
   Задайте имя (латиница, без пробелов) и синоним (отображается пользователю)
4. 4
   Выберите тип данных в палитре свойств
5. 5
   Настройте права доступа для ролей
6. 6
   Обновите конфигурацию базы данных клавишей F7

Заполните ключевые свойства:

• Имя — программный идентификатор, например НаименованиеОрганизации. Только латинские буквы, цифры и подчёркивания, начинается с буквы.
• Синоним — представление для пользователя, например «Наименование организации».
• Тип — тип хранимого значения: строка, число, булево, дата, ссылка на справочник или перечисление, составной тип.
• Длина — для строки и числа задаётся ограничение размера.

Выбор типа данных и ограничения

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

Для строки неограниченной длины снимите ограничение длины, но учтите: такие значения нельзя использовать в некоторых операциях сравнения и индексирования. Для числа задайте точность — количество знаков после запятой. Составной тип (несколько типов одновременно) усложняет обработку в коде, поэтому применяйте его только при реальной необходимости.

Настройка прав доступа

После создания константы проверьте права: откройте роль пользователя (ветка «Общие» → «Роли») и найдите новую константу в списке объектов. Для чтения значения достаточно права «Чтение», для изменения — «Изменение». Если у роли нет прав, пользователь не увидит константу и получит ошибку при обращении из кода, выполняемого под его учётной записью.

Для типовых конфигураций константу часто добавляют в подсистему (ветка «Общие» → «Подсистемы»), чтобы она появилась в интерфейсе нужного раздела. Отметьте константу галочкой в свойствах подсистемы.

Запись и чтение значения программно

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

Константы.НаименованиеОрганизации.Установить("ООО «Пример»");
Константы.ИспользоватьХарактеристики.Установить(Истина);

Чтение значения:

Наименование = Константы.НаименованиеОрганизации.Получить();
Если Константы.ИспользоватьХарактеристики.Получить() Тогда
// логика при включённой настройке
КонецЕсли;

Для записи нескольких констант одной транзакцией используйте набор констант: объект КонстантыНабор через Константы.СоздатьНабор("НаименованиеОрганизации, ИспользоватьХарактеристики"), заполнение значений и метод Записать().

Константы.НаименованиеОрганизации.Установить("ООО \"Пример\"");
ТекущееЗначение = Константы.НаименованиеОрганизации.Получить();
Сообщить(ТекущееЗначение);

Вывод константы пользователю

Чтобы пользователь мог менять значение без программирования, добавьте константу на форму. В простейшем случае создайте общую форму настроек, добавьте реквизит формы нужного типа и в обработчиках ПриЧтенииНаСервере / ПриЗаписиНаСервере переносите значение между реквизитом и константой.

Альтернатива без создания формы — стандартная обработка «Все функции» в режиме предприятия (при включённом режиме технического специалиста): в ней доступна ветка «Константы», где значение можно отредактировать напрямую. Это подходит для разовых настроек, но не для рядовых пользователей.

Проверка результата и типичные ошибки

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

Если конфигурация типовая и находится на поддержке, добавление собственной константы снимает объект с полной поддержки. При обновлениях релиза такие доработки сохраняются, но требуют контроля при сравнении и объединении конфигураций. Для хранения настроек без изменения конфигурации рассмотрите альтернативы: хранилище общих настроек (ХранилищеОбщихНастроек) или дополнительные сведения в типовых механизмах БСП.

Частые вопросы