Как получить настройки формы 1С: инструкция с примерами

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

Есть три практических сценария, где требуется получить настройки формы: пользователь жалуется, что форма «сломалась» и нужно посмотреть, что сохранено; требуется скопировать настройки одного пользователя другому; в коде нужно прочитать сохранённые значения, например параметры отчёта. Ниже разобраны все способы — от пользовательского интерфейса до работы с хранилищем настроек через встроенный язык.

Где 1С хранит настройки форм

Платформа 1С:Предприятие автоматически сохраняет настройки форм в системном хранилище — ХранилищеНастроекФорм. Физически данные размещаются в информационной базе (в клиент-серверном варианте — на сервере СУБД), а не в файлах пользователя, как это было в ранних версиях платформы. Настройки привязаны к конкретному пользователю, конкретной форме и ключу настроек.

Помимо хранилища настроек форм, в платформе есть и другие системные хранилища: ХранилищеОбщихНастроек (произвольные данные прикладного решения), ХранилищеПользовательскихНастроекОтчетов (настройки отчётов на СКД), ХранилищеВариантовОтчетов и ХранилищеСистемныхНастроек. Важно не путать их: если нужны именно параметры внешнего вида формы — размеры, видимость колонок, — работа идёт именно с ХранилищеНастроекФорм.

Как получить настройки формы программно

Основной способ — метод Загрузить() объекта ХранилищеНастроекФорм. Он принимает имя объекта (полное имя формы), ключ настроек и имя пользователя, чьи настройки нужно получить. Если пользователь не указан, возвращаются настройки текущего пользователя.

Пример кода для получения настроек формы списка справочника конкретного пользователя:

ИмяОбъекта = "Справочник.Номенклатура.Форма.ФормаСписка";
КлючНастроек = ""; // ключ по умолчанию
ИмяПользователя = "ИвановИИ";

Настройки = ХранилищеНастроекФорм.Загрузить(ИмяОбъекта, КлючНастроек, , ИмяПользователя);

Если Настройки = Неопределено Тогда
Сообщить("Сохранённых настроек нет");
Иначе
// Настройки — объект, состав зависит от типа формы
Сообщить("Настройки получены: " + ТипЗнч(Настройки));
КонецЕсли;

Возвращаемое значение зависит от того, что сохранила форма: это может быть структура, соответствие, объект НастройкиКомпоновкиДанных (для динамических списков и отчётов) или другой сериализуемый объект. Перед использованием значения всегда проверяйте результат на Неопределено — если пользователь ни разу не менял настройки формы, в хранилище может ничего не быть.

Настройки = ХранилищеНастроекФорм.Загрузить("Справочник.Номенклатура.Форма.ФормаСписка", "", , "ИвановИИ");

Получение настроек внутри самой формы

Если код выполняется в модуле формы, доступен более прямой путь. У формы есть автоматические механизмы: свойства АвтоматическоеСохранениеДанныхВНастройках и список сохраняемых реквизитов. Платформа сама сохраняет значения указанных реквизитов при закрытии и восстанавливает при открытии.

Для ручного управления в модуле формы используются методы СохранитьДанныеВНастройках() и события ПриСохраненииДанныхВНастройкахНаСервере и ПриЗагрузкеДанныхИзНастроекНаСервере. В обработчике загрузки можно получить сохранённые значения из переданного параметра настроек и применить их к реквизитам формы.

Для форм отчётов на СКД настройки компоновки доступны напрямую через Отчет.КомпоновщикНастроек.Настройки, а пользовательские настройки — через свойство ПользовательскиеНастройки. Это частый источник путаницы: настройки отчёта и настройки его формы — разные сущности, хранящиеся в разных хранилищах.

Как посмотреть и скопировать настройки без программирования

В типовых конфигурациях на управляемых формах пользователь может сбросить или изменить настройки формы через меню «Ещё» → «Изменить форму» (для состава элементов) или «Установить стандартные настройки» (для списков и отчётов). Это не даёт «сырого» содержимого настроек, но позволяет вернуть форму в рабочее состояние без кода.

Для администратора в типовых решениях на базе Библиотеки стандартных подсистем есть обработка копирования настроек: раздел администрирования, пункт «Настройки пользователей и прав» или аналогичный. Через неё можно скопировать настройки форм, отчётов и внешнего вида от одного пользователя другому или нескольким сразу — это самый быстрый способ тиражировать удачную настройку на отдел.

1. 1
   Откройте раздел администрирования под пользователем с полными правами
2. 2
   Найдите функцию копирования настроек пользователей (в БСП — «Копирование настроек пользователей»)
3. 3
   Выберите пользователя-источника и отметьте нужные виды настроек
4. 4
   Укажите получателей и выполните копирование
5. 5
   Попросите получателя перезапустить сеанс и проверить форму

Сброс и удаление настроек формы

Когда форма открывается с ошибкой или показывает «пустые» колонки после обновления конфигурации, стандартное решение — удалить сохранённые настройки. Программно это делает метод ХранилищеНастроекФорм.Удалить() с теми же параметрами, что и Загрузить: имя объекта, ключ, пользователь.

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

Типичные ошибки при работе с настройками форм

Самая частая ошибка — неверное имя объекта. Оно должно точно совпадать с полным именем формы, включая путь: «Справочник.Номенклатура.Форма.ФормаСписка», а не просто «ФормаСписка». При ошибке в имени метод Загрузить молча вернёт Неопределено, и поиск причины займёт время.

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

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

После получения настроек убедитесь, что результат не Неопределено и тип соответствует ожиданиям — выведите ТипЗнч(Настройки) в сообщение или посмотрите в отладчике. Если ожидаются НастройкиКомпоновкиДанных, проверьте состав отборов и порядка: они должны совпадать с тем, что видит пользователь в форме.

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

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