В процессе активной эксплуатации конфигураций на базе 1С:Предприятие 8 пользователи часто создают собственные варианты отчетов для оперативного анализа данных. Со временем возникает необходимость в переносе этих настроек на другое рабочее место, восстановлении после сбоя или глубокой отладке механизмов сохранения. Понимание физической структуры хранения этих данных является критически важным навыком для администраторов и разработчиков.
Механизм хранения не является тривиальным, так как платформа использует специализированные регистры сведений, а не простые текстовые файлы или отдельные таблицы для каждого отчета. Это обеспечивает масштабируемость и целостность данных, но усложняет прямой доступ к ним без использования специализированных инструментов платформы или запросов.
В данной статье мы подробно разберем архитектуру подсистемы Библиотека стандартных подсистем (БСП), отвечающую за сохранение параметров. Мы рассмотрим конкретные объекты метаданных, методы программного доступа и способы ручного извлечения настроек для административных нужд.
Архитектура хранения вариантов отчетов
Центральным элементом системы хранения является подсистема ВариантыОтчетов, входящая в состав БСП. Именно она управляет жизненным циклом пользовательских настроек. Все данные о том, как пользователь свернул группировки, какие отборы задал и в каком порядке расположил поля, сохраняются в едином информационном пространстве конфигурации.
Физически информация записывается в регистр сведений с именем ВариантыОтчетов. Этот регистр является периодическим и подчиненным, что позволяет хранить историю изменений и привязывать настройки к конкретным элементам справочников или документов. Ключевыми измерениями регистра выступают ссылки на объекты метаданных и идентификаторы пользователей.
⚠️ Внимание: Прямое редактирование записей в регистре сведений через консоль запросов или внешние обработки без создания резервной копии может привести к нарушению ссылочной целостности и потере данных пользователей.
Структура записей включает в себя не только саму настройку, но и метаданные о видимости. Система различает варианты, доступные только конкретному пользователю, и общие варианты, видимые всем. Разграничение прав доступа реализуется на уровне ролей и механизмов БСП, а не на уровне файловой системы.
Объект НастройкиОтчета и его свойства
Основным объектом, с которым работает программист при манипуляциях настройками, является структура НастройкиОтчета. Этот объект представляет собой сложную иерархическую структуру данных, которая сериализуется при сохранении в базу данных. Он содержит информацию о полях, отборах, сортировках и оформлении.
Важно понимать, что объект НастройкиОтчета не хранится в базе в "чистом" виде. Перед записью он преобразуется в специализированное представление, понятное механизму БСП. При чтении происходит обратный процесс десериализации, восстанавливающий объект для работы в форме отчета.
Для разработчиков критически важно знать, что настройки могут включать в себя ссылки на другие объекты конфигурации. Например, отбор по контрагенту будет хранить ссылку на элемент справочника Контрагенты. При переносе настроек между базами такие ссылки могут стать невалидными, если объекты не были перенесены корректно.
Используйте метод ПолучитьНастройки() объекта отчета для получения актуальной структуры перед ее сохранением или модификацией программным путем.
Объект поддерживает методы клонирования и сравнения. Это позволяет реализовать функционал "Сохранить как...", создавая копию текущей конфигурации отчета с новым именем. Механизм сравнения используется для определения факта изменения настроек пользователем перед предложением сохранить их.
Регистр сведений ВариантыОтчетов
Как упоминалось ранее, основным хранилищем выступает регистр сведений. Его структура оптимизирована для быстрого поиска по владельцу и объекту отчета. Записи содержат поле Владелец, которое хранит ссылку на пользователя или общую папку вариантов.
Основные измерения регистра включают имя отчета (как строковое представление) и тип объекта. Это позволяет системе однозначно идентифицировать, к какому именно отчету относятся сохраненные параметры, даже если в конфигурации присутствуют отчеты с одинаковыми именами в разных подсистемах.
| Поле регистра | Тип данных | Описание назначения |
|---|---|---|
| Владелец | Справочник.Пользователи | Пользователь, создавший вариант, или значение "Общие" |
| Имя | Строка | Уникальное имя варианта отчета в рамках владельца |
| Настройки | ХранилищеЗначения | Сериализованный объект НастройкиОтчета |
| ПометкаУдаления | Булево | Флаг мягкого удаления варианта из списка доступных |
Поле Настройки имеет тип ХранилищеЗначения. Это означает, что внутри содержится бинарное представление объекта. Для чтения этих данных необходимо использовать специальные функции платформы, такие как ПолучитьИзХранилища, указывая правильный тип восстанавливаемого объекта.
☑️ Диагностика проблем с сохранением
Программное чтение и запись настроек
Для работы с настройками в коде используется менеджер записей регистра сведений. Стандартный алгоритм получения варианта начинается с формирования отбора по текущему пользователю и имени отчета. Если запись не найдена, система может попытаться найти вариант в общих настройках.
Процесс записи требует создания новой записи регистра или модификации существующей. Важно корректно заполнить все обязательные измерения. Ошибка в типе владельца или имени приведет к тому, что отчет не увидит сохраненный вариант при последующем запуске.
Запись = РегистрыСведений.ВариантыОтчетов.СоздатьМенеджерЗаписи();
Запись.Владелец = ТекущийПользователь();
Запись.Имя = "МойВариант";
Запись.Настройки = Новый ХранилищеЗначения(НастройкиОтчета);
Запись.Записать();
При программном создании вариантов часто возникает необходимость в предзаполнении полей стандартными значениями. Для этого используется метод ПолучитьСтандартныеНастройки, который возвращает базовую структуру, которую затем можно модифицировать перед сохранением в регистр.
⚠️ Внимание: Интерфейс и методы работы с БСП могут изменяться в новых релизах типовых конфигураций. Всегда сверяйте актуальную документацию к вашей версии платформы перед внедрением кастомных решений.
Перенос настроек между базами данных
Задача миграции пользовательских вариантов отчетов при переходе на новую версию базы или при консолидации данных является нетривиальной. Простой выгрузки и загрузки данных через стандартные средства часто недостаточно, так как могут измениться внутренние идентификаторы объектов метаданных.
Наиболее надежным способом является использование обработки Универсальный обмен данными в формате XML или специализированных обработок переноса, предоставляемых фирмой "1С". Эти инструменты учитывают зависимости между объектами и корректно мапят ссылки.
Если автоматические средства недоступны, можно реализовать ручной перенос через выгрузку в XML. Для этого необходимо прочитать настройки из регистра, сериализовать объект НастройкиОтчета в XML-строку, перенести текст и восстановить объект в новой базе, предварительно убедившись в наличии всех referenced объектов.
Проблемы при переносе
При переносе настроек часто возникает ошибка "Объект не найден", если в новой базе изменился UUID справочника или документа, на который ссылался отбор в отчете. Решение: использовать обработку поиска и замены ссылок или пересоздавать отборы вручную.
Особое внимание следует уделить общим вариантам отчетов. При переносе они должны быть загружены с владельцем, соответствующим специальной записи для общих данных, иначе они станут персональными и исчезнут из доступа у остальных сотрудников.
Отладка и поиск потерянных вариантов
Часто пользователи сталкиваются с ситуацией, когда сохраненный вариант отчета внезапно исчезает из списка доступных. Причины могут варьироваться от сброса прав доступа до повреждения записи в регистре сведений. Для диагностики необходимо использовать режим предприятия с отладчиком.
Первым шагом является проверка существования записи в регистре ВариантыОтчетов через консоль запросов. Необходимо выполнить выборку по имени отчета и текущему пользователю. Если запись существует, но не отображается, проблема может быть в правах доступа или логике формирования списка в форме отчета.
Для глубокого анализа можно воспользоваться технологическим журналом регистрации событий. Включив логирование событий работы с регистрами сведений, можно отследить момент обращения к данным и выявить ошибки чтения или блокировки со стороны других транзакций.
Потеря вариантов отчетов чаще всего связана не с физическим удалением данных, а с рассинхронизацией прав доступа или изменением идентификаторов пользователей после миграции.
В сложных случаях, когда стандартные методы не помогают, администратор может временно включить видимость всех записей регистра, игнорируя владельца, чтобы убедиться в физической сохранности данных. Однако этот метод требует высокой квалификации и осторожности.
Часто задаваемые вопросы
Можно ли экспортировать настройки отчета в файл для отправки коллеге?
Да, это возможно. В форме отчета обычно есть кнопка "Еще" или контекстное меню, где доступна функция "Сохранить настройки в файл". Файл имеет расширение .dt или xml-подобную структуру, которую коллега сможет загрузить через функцию "Загрузить настройки из файла".
Где физически на диске сервера лежат файлы с настройками?
Настройки хранятся непосредственно в файле базы данных (.1cd для файловых баз) или в таблицах СУБД (для клиент-серверных вариантов). Отдельных файлов для каждого пользователя на диске сервера не создается, все данные упакованы в структуру хранения платформы.
Почему настройки сбрасываются после обновления конфигурации?
При обновлении конфигурации может измениться структура метаданных отчета (добавлены новые поля, изменены имена). Если старые настройки становятся несовместимыми с новой версией объекта, система может игнорировать их или сбрасывать до стандартных значений во избежание ошибок выполнения.
Как очистить все пользовательские варианты отчетов?
Для массовой очистки необходимо использовать обработку удаления данных или написать скрипт, который пройдется по регистру сведений ВариантыОтчетов и установит пометку удаления для всех записей, кроме общих, если их нужно сохранить. После этого необходимо выполнить процедуру удаления помеченных объектов.