1с где хранятся варианты отчетов пользователя
Дата публикации 03.09.2019
Использован релиз 1.6.18
Если отчет с собственными настройками будет использоваться в дальнейшей работе, сохраните свой вариант отчета.
- Раздел: Продажи (или CRM, Закупки, Работы, Производство, Деньги, Зарплата) – Отчеты.
- Откройте нужный отчет и выполните необходимые настройки (подробнее об этом здесь).
- Кнопка "Запомнить настройки".
- Сохранить свой вариант отчета с выполненными настройками можно либо под именем уже существующего отчета (в этом случае существующий отчет будет заменен на отчет с новыми настройками), либо под новым именем (в этом случае будет создан новый отчет).
- Для сохранения отчета с выполненными настройками под именем уже существующего отчета используйте кнопку "Сохранить" (рис. 1). В этом случае у существующего отчета обновятся только его настройки (оформление, группировка и отбор данных и др.). Остальные параметры отчета (доступ к отчету, доступность в разделах, документах и элементах справочников, описание отчета и др.) останутся неизменными.
Изменение предопределенных отчетов программы со значком невозможно (например, отчет "Продажи" ) (рис. 1). Можно обновить настройки только для ранее созданных пользователем отчетов.
- Для сохранения отчета с выполненными настройками c новым названием введите новое название в поле "Наименование отчета" и по кнопке "Далее" продолжите настройку параметров нового отчета (рис. 2).
Настройка параметров поиска отчета и доступа к нему (рис. 3):
- Чтобы отчет был доступен только автору, установите переключатель "Доступен" в положение "Только для автора". Если вы сохранили отчет для всех пользователей программы, установите переключатель в положение "Всем пользователям".
- Отчет будет доступен в тех же разделах, что и отчет, на основании которого создается новый.
- Чтобы отчет был доступен для выбора в списке отчетов раздела при открытии, установите флажок "Добавить в рекомендуемые". Если флажок не установлен, отчет будет доступен в списке отчетов для выбора только после нажатия кнопки "Показать еще отчеты".
- Для добавления своего изображения для отчета щелкните мышью по окну "Добавьте изображение отчета" и выберите файл с сохраненным отчетом.
- Для быстрого поиска отчета по ключевым словам добавьте тег в поле "#Теги".
- В поле "Описание" при необходимости уточните назначение и особенности отчета.
Настройка возможности открытия отчета из документа или справочника (рис. 4):
- По ссылке "Добавить привязку" в блоке "Контекстное открытие отчета" можно выбрать из списка документы и справочники, в которых на вкладке "Отчеты" будет доступно использование данного отчета (рис. 5).
Сохраните настройки поиска, доступа и использования нового отчета по кнопке "Сохранить".
- После сохранения настроек отчет будет доступен для использования в программе.
Смотрите также
Не пропускайте последние новости — подпишитесь
на бесплатную рассылку сайта:
Хранилище вариантов отчета 1С для внешнего отчета
Наверное вам приходилось сталкиваться с тем, что при подключении внешнего отчета в типовых конфигурациях 1С получаем такое сообщение:
Свойство отчета «Хранилище вариантов» не заполнено.
Сохранение (выбор) вариантов отчета будет работать в ограниченном режиме.
Обратитесь к разработчику дополнительного (внешнего) отчета.
Ошибка при подключении внешнего отчета 1С
Для чего нужно хранилище вариантов отчета
Между тем, типовые конфигурации 1С (далее рассмотрим на примере 1С: Зарплата и управление персоналом КОРП, редакция 3.1 (3.1.15.40)) имеют удобный механизм хранилища вариантов отчетов. Он позволяет сохранять варианты отчетов, а также сделать их доступными другим пользователям. Доступные варианты отчета будут видны как в самой форме отчета, так и в типовой разделе «Отчеты». Ниже пример вывода в форме «Кадровые отчеты» различных настроек для отчета «Личные данные сотрудников». Теперь каждый пользователь имеющий право использования данного отчета сможет открыть нужную настройку отчета и сформировать его.
Пример сохраненных вариантов отчетов 1С
Настраиваем свойство «Хранилище вариантов» для внешних отчетов
1С позаботилась о разработчиках и предоставила им возможность без лишних доработок использовать данный механизм в своих внешних отчетах.
1. Открываем палитру свойств нашего внешнего отчета как показано на картинке ниже:
2. В свойстве «Хранилище вариантов» выбираем хранилище настроек с именем «ХранилищеВариантовОтчетов»
Выбираем хранилище вариантов
Сохраняем вариант отчета для других пользователей
После подключения нашего внешнего отчета в конфигурацию, открываем его. Например, вы внесли какие-то изменения в структуру отчета в пользовательском режиме и хотим поделиться этим вариантом с другими пользователями.
1. Для этого, выбираем типовую команду «Сохранить вариант отчета»:
Сохранение варианта отчета для других пользователей
2. Указываем наименование нашей настройки отчета «Отчет о передаче мероприятий СЗВ-ТД — без уволенных». Ставим переключатель «Доступен» в положение «Всем пользователям». Нажимаем кнопку «Далее».
3. Указываем раздел, в который хотим поместить нашу настройку отчета, например, «Кадры». Пишем описание для варианта отчета, если надо и сохраняем.
4. Теперь наш вариант отчета доступен другим пользователям как в самом отчете:
Пример выбора настройки внешнего отчета 1С
Так и в разделе «Отчеты» в ветке «Кадры»
Вариант внешнего отчета 1С в разделе Отчеты
Итоги
После нехитрых настроек наш внешний отчет теперь может работать с типовым хранилищем вариантов отчетов. Это позволит сохранять различные настройки внешнего отчета в хранилище и давать доступ к ним для других пользователей 1С.
Хранение пользовательских настроек отчета.
Добрый день. Подскажите, кто в курсе, где 1С хранит пользовательские настройки отчета?
Используются управляемые формы.
Хранилище вариантов и хранилище настроек отчета не установлены, т.е. должны использоваться стандартные хранилища настроек.
Подумал было, что должны обитать тут — ХранилищеПользовательскихНастроекОтчетов. Но нет, нет их тут..
(4) нет, отчет новый.
К каждому варианту отчета привязаны свои пользовательские настройки (видимость полей, значения параметров и т.п.) — т.е. при смене варианта меняются и пользовательские настройки. Специальных обработчиков для этого не написано, все делается платформой — соответственно, эти пользовательские настройки тоже должны где-то в системе хранится.
Варианты отчетов, например, хранятся в "ХранилищеВариантовОтчетов"
Вообще, изначально задача — устанавливать пользовательские настройки одного пользователя другому.
>>Вообще, изначально задача — устанавливать пользовательские настройки одного пользователя другому.
Вариантами отчета и можно это штатно делать, почему не нравится?
>> Вообще, изначально задача — устанавливать пользовательские настройки одного пользователя другому.
Если дело разовое — быстрее всего файлом.
(8) Не соображу чет — это управляемая форма?
(9) Да, хранятся где-то в базе. Вот сами варианты отчета читать и передавать другим пользователям получилось без проблем. А вот с пользовательскими настройками. Если не докопаюсь, придется так и делать..
(10) Нет, это доп. функционал для пользователей, чтобы пользователи могли самостоятельно обмениваться своими настройками.
Посмотрели таблицы БД.
Привязка пользовательских настроек отчета к варианту отчета осуществляется в ХранилищеСистемныхНастроек.
Пример получения и установки пользовательской настройки другому пользователю:
НовФильтр = Новый Структура();
НовФильтр.Вставить("Пользователь", Пользователь);
НовФильтр.Вставить("КлючОбъекта" , КлючОбъекта + "/" + КлючНастроек + "/ТекущиеПользовательскиеНастройки");
ВыборкаСистемныхНастроек = ХранилищеСистемныхНастроек.Выбрать(НовФильтр);
Пока ВыборкаСистемныхНастроек.Следующий() Цикл
ХранилищеСистемныхНастроек.Сохранить(НовФильтр.КлючОбъекта, ВыборкаСистемныхНастроек.КлючНастроек, ВыборкаСистемныхНастроек.Настройки ,, Строка(ПользователиИнформационнойБазы.ТекущийПользователь()));
КонецЦикла;
НовФильтр.КлючОбъекта — "Отчет.ИмяОтчета"
КлючНастроек — ключ варианта отчета. Получить можно из хранилища вариантов отчета
Всем спасибо за помощь.
(17) Нет, не нужно было. Да и, я думаю, не получится, т.к. одному варианту соответствует одна пользовательская настройка.
Ведь нельзя в рамках одного варианта отчета выбирать (в пользовательском режиме) разные пользовательские настройки?
Механизм настроек пользователей в 1Cv8
Для сохранения информации о настройках пользователя, которая должна сохраняться между сеансами работы, в платформе реализованы хранилища настроек.
Существует два вида хранилищ настроек:
- Стандартное хранилище – хранилище, используемое системой по умолчанию и хранящее данные в системных таблицах информационной базы.
- Хранилища настроек – специальные объекты метаданных, которые описывают хранение данных в некотором объекте информационной базы.
Например, в этом объекте может быть описана работа с настройками, которые хранятся в справочнике.
Платформа использует пять хранилищ:
- Системное хранилище – в данное хранилище система сохраняет все возможные настройки, которые нужны для работы платформы. К данным настройкам относятся настройки размеров форм, настройки печати табличного документа и т. п. Полный перечень настроек, сохраняемых в системном хранилище, перечислен в Приложении В. В качестве системного хранилища настроек всегда используется стандартное хранилище настроек. Т. е. данные системного хранилища всегда сохраняются в системной таблице информационной базы.
- Хранилище общих настроек – данное хранилище предназначено для хранения различных настроек прикладного решения. Платформа самостоятельно не записывает в данное хранилище никаких настроек. Данное хранилище должен использовать разработчик из встроенного языка, для того чтобы выполнять сохранение/восстановление прикладных настроек пользователя.
- Хранилище пользовательских настроек отчетов – в данное хранилище помещаются пользовательские настройки отчетов.
- Хранилище вариантов отчетов – в данное хранилище помещаются варианты отчетов.
- Хранилище настроек данных форм – в это хранилище сохраняются данные форм. Этим хранилищем можно пользоваться, например, для сохранения реквизитов обработок. При этом можно выбрать индивидуальное хранилище для каждого отчета и обработки.
При разработке конфигурации имеется возможность определить собственные хранилища настроек для всех хранилищ (кроме системного хранилища). Для этого необходимо создать объект хранилище настроек в соответствующей ветке дерева метаданных и затем указать его в нужном свойстве конфигурации. Свойства объекта Конфигурация имеют те же имена, что и вышеперечисленные хранилища.
Таким образом, данные хранилищ могут храниться как в системной таблице информационной базы, так и в некотором специальном объекте информационной базы, например, в справочнике или регистре сведений. Например, можно создать в конфигурации объект хранилище настроек и указать в свойстве конфигурации, что данное хранилище следует использовать для хранения настроек отчетов. Таким образом, настройки отчетов будут сохраняться не в системной таблице, а в некотором объекте, например, в справочнике, что дает возможность организовать работу с едиными настройками отчетов, реализовать систему прав, обмен настройками и т.п.
Объект метаданных ХранилищеНастроек
Объект метаданных ХранилищеНастроек предназначен для обеспечения хранения прикладных настроек конфигурации. За счет реализации обработчиков событий и создания формы объекта выполняется модификация механизма работы с настройками таким образом, что изменяется место хранения настроек (вместо системных таблиц используются специальные объекты конфигурации, которые создал разработчик) и визуальные механизмы работы с настройками.
В конфигурации может быть определено произвольное количество хранилищ настроек.
Методы и обработчики
У объекта ХранилищеНастроекМенеджер имеется ряд методов, которые вызывают соответствующие события. Таким образом, определением обработчиков событий описывается логика сохранения/загрузки настроек.
В методах хранилища и обработчиках используются следующие параметры:
- КлючОбъекта – значение любого типа, которое используется в хранилище в качестве идентификатора объекта настройки. Например, для идентификации отчета платформа использует полное имя отчета.
- КлючНастроек – значение любого типа, которое используется в хранилище в качестве идентификатора объекта хранилища, хранящего настройку. Этот ключ используется в тех случаях, когда хранится несколько настроек, из которых возможен выбор пользователем.
В процессе разработки хранилища, разработчик самостоятельно определяет, каким образом будет идентифицироваться объект хранилища, тем самым, определяя тип параметра.
Например, если настройки сохраняются в справочнике, то в качестве ключа настройки можно использовать поле Код или значение Ссылка (элемента справочника).
- Настройка – объект, содержащий настройки. Значение любого типа, которое необходимо сохранить как настройку. Например, при сохранении настроек отчета будет использоваться объект ПользовательскиеНастройкиКомпоновкиДанных, а при сохранении данных формы – объект Соответствие.
- ОписаниеНастроек – значение типа ОписаниеНастроек. Специальный объект, содержащий информацию о настройке. Содержит ключ объекта, ключ настройки и представление настройки.
- Пользователь – имя пользователя. Если имеет значение Неопределено, то следует использовать имя текущего пользователя. В других случаях содержит имя пользователя, для которого нужно получить или сохранить настройки. По умолчанию имеет значение Неопределено.
Объект ХранилищеНастроек предоставляет следующие методы:
- Сохранить() – используется для сохранения настройки.
Вызывает событие ОбработкаСохранения. Если обработчик события не реализован или пустой, то действие не будет выполнено.
- Загрузить() – используется для получения настройки.
Вызывает событие ОбработкаЗагрузки. Если обработчик события не реализован или пустой, то действие не будет выполнено.
- ПолучитьОписание() – используется для получения описания настройки.
Вызывает событие ОбработкаПолученияОписания. Если обработчик события не реализован или пустой, то действие не будет выполнено.
- УстановитьОписание() – используется для установки описания настройки.
Вызывает событие ОбработкаУстановкиОписания. Если обработчик события не реализован или пустой, то действие не будет выполнено.
Подробнее про параметры методов можно посмотреть во встроенной справке.
В модуле менеджера объекта должны находится обработчики следующих событий:
- ОбработкаСохранения – содержит реализацию метода Сохранить(). В данном обработчике необходимо выполнить сохранение настройки в некоторый объект. Например, в элемент справочника.
- ОбработкаЗагрузки – содержит реализацию метода Загрузить(). В данном обработчике необходимо получить настройки из некоторого объекта. Например, из элемента справочника.
- ОбработкаПолученияОписания – содержит реализацию метода ПолучитьОписание(). В данном обработчике необходимо заполнить описание настройки на основании свойств сохраненной настройки. Например, из элемента справочника.
- ОбработкаУстановкиОписания – содержит реализацию метода УстановитьОписание(). В данном обработчике необходимо заполнить описание сохраненной настройки из переданного объекта ОписаниеНастроек. Например, в элементе справочника.
Подробнее про параметры обработчиков можно посмотреть во встроенной справке.
Формы
Кроме описания обработчиков в хранилище настроек необходимо определить формы, которые будут использоваться при сохранении и выборе настроек пользователем.
Когда пользователь применяет команды сохранения или загрузки настроек, система получает соответствующую форму объекта хранилища настроек, и отображает ее на экране.
Например, при сохранении настроек отчета система будет использовать форму сохранения того объекта метаданных, который указан в качестве хранилища настроек отчетов (непосредственно у самого отчета или у всей конфигурации). При этом форме будут переданы следующие параметры:
- КлючОбъекта – идентификатор объекта, для которого нужно отображать список настроек. Например, для отчета это будет полным именем отчета.
- КлючТекущихНастроек – идентификатор настройки, которая была текущей там, откуда вызывается форма сохранения или восстановления настроек. Например, это может быть идентификатором текущей настройки отчета.
- СтандартныеНастройки – список значений, содержащий стандартные настройки. Например, для выбора варианта отчета данный список содержит список стандартных вариантов, настроек, описанных в схеме компоновки данных отчета. Данный параметр передается только в форму загрузки.
При создании формы с помощью конструктора, вышеописанные параметры будут автоматически добавлены в список параметров формы.
В формах следует использовать переданные параметры и соответствующим образом фильтровать список настроек. Так, следует отображать только настройки для указанного в параметре КлючОбъекта объекта настройки (например, отчета).
Если пользователь выбрал настройку, то результатом работы формы должно быть значение типа ВыборНастроек. В этом значении, в свойстве КлючНастроек, должен находиться ключ выбранной настройки (например, код элемента справочника или другой, идентифицирующий настройку параметр), а в свойстве ДополнительныеСвойства – дополнительная информация, которую пользователь мог указать в форме.
Стандартное хранилище настроек
Стандартное хранилище настроек представляется во встроенном языке объектом СтандартноеХранилищеНастроекМенеджер. Данный объект реализует тот же набор методов, что и объект ХранилищеНастроекМенеджер, и дополнительно реализует методы:
- ПолучитьСписок() – метод получения списка настроек для выбранного объекта настройки,
- Удалить() – удаление определенной настройки выбранного объекта настройки.
Стандартное хранилище сохраняет настройки в системных таблицах информационной базы.
В качестве ключа объекта настройки и в качестве ключа настройки системное хранилище настроек принимает строку.
В качестве настроек системное хранилище принимает любое значение, которое может быть помещено в хранилище значений.
Сохранение настроек форм
Разработчик может управлять сохранением данных управляемых форм в настройках. Для этого при разработке формы ему необходимо воспользоваться следующими свойствами формы:
- СохранениеДанныхВНастройках – при помощи данного свойства разработчик формы может включить возможность сохранения данных формы (с возможностью выбора настройки, в которую будут сохраняться данные). Если у формы включена необходимость сохранения, то форма предоставляет команды сохранения / загрузки настроек.
- АвтоматическоеСохранениеДанныхВНастройках – указывает необходимость автоматического сохранения настроек при закрытии формы и восстановлении при открытии формы. При этом не важно, используется или нет список настроек.
- ХранилищеНастроек – ссылка на хранилище настроек, в котором предполагается сохранение настроек. Если не указано, то используется хранилище сохранения настроек данных формы, указанное в конфигурации. А если и в конфигурации не указано хранилище, то настройки сохраняются в стандартное хранилище настроек.
Если для формы установлена возможность сохранения данных, то необходимо указать, какие реквизиты формы должны сохраняться (колонка Сохранение на закладке Реквизиты редактора формы).
При сохранении настроек в качестве ключа объекта используется полное имя формы. В настройках сохраняется объект типа Соответствие, в котором в качестве ключей находятся пути к сохраняемым реквизитам, а в качестве значений – их (реквизитов) значения.
Для дополнительной обработки сохранения и загрузки в форме имеются следующие обработчики:
- ПриСохраненииДанныхВНастройкахНаСервере – в данный обработчик передается объект (типа Соответствие), в который будут сохраняться настройки. В объекте уже заполнены значения реквизитов, которые требовалось сохранять. В этом обработчике можно программно добавить в объект настроек дополнительную информацию. Например, поместить в реквизит настроек отбор.
- ПриЗагрузкеДанныхИзНастроекНаСервере – в данный обработчик передается объект, из которого уже загружены настройки. Это соответствие, в котором находятся значения реквизитов. В этом обработчике можно будет загрузить собственные свойства из соответствия. Например, восстановить параметры отбора.
Сохранение настроек отчетов
У объектов отчет и внешний отчет имеется свойства метаданных ХранилищеВариантов и ХранилищеНастроек. В данных свойствах указывается, в какие хранилища нужно сохранять варианты и настройки отчета соответственно. Если хранилища не указаны, то используются хранилища, указанные в свойствах конфигурации.
Форма отчета предоставляет команды сохранения и загрузки вариантов и настроек отчетов.
Для дополнительной обработки сохранения и загрузки настроек и вариантов отчета в расширении формы отчета имеются следующие обработчики:
- ПриСохраненииВариантаНаСервере – в данный обработчик передаются настройки компоновки данных, которые будут сохраняться. В этом обработчике можно программно добавить в объект настроек дополнительную информацию.
- ПриЗагрузкеВариантаНаСервере – в данный обработчик передается объект настроек, из которого уже загружен вариант отчета. В этом обработчике можно прочитать из объекта настроек дополнительную информацию.
- ПриСохраненииПользовательскихНастроекНаСервере – в данный обработчик передаются пользовательские настройки отчета, которые будут сохраняться. В этом обработчике можно добавить в настройки дополнительную информацию.
- ПриЗагрузкеПользовательскихНастроекНаСервере – в данный обработчик передается объект настроек, которые содержит уже загруженные пользовательские настройки. В этом обработчике можно прочитать из объекта настроек дополнительную информацию.
При необходимости сохранять в настройках компоновки данных или пользовательских настройках компоновки данных некоторую дополнительную информацию можно воспользоваться свойствами ДополнительныеСвойства объектов НастройкиКомпоновкиДанных и ПользовательскиеНастройкиКомпоновкиДанных. Свойство ДополнительныеСвойства представляет собой объект типа Структура.
Порядок разработки хранилища настроек
Далее приводится рекомендованный порядок разработки хранилищ настроек в управляемом приложении:
- Определяется, какое хранилище (см. начало главы) будет использоваться. Например, будем реализовывать хранилище настроек данных форм конфигурации.
- Определяется перечень объектов метаданных, которые будут использовать это хранилище, и определяется перечень хранимой информации, ее структура и типы. Эта информация поможет нам правильно выбрать объект метаданных, в данных которого будут храниться наши настройки.
- На основании информации из п. 2 создается объект (и его структура), который будет хранить настройки. Пусть наши настройки хранятся в элементах справочника. Т. к. в нашем случае структура сохраняемых данных крайне разнородна, то нет смысла реализовывать отдельный набор реквизитов для хранения настроек каждой формы, поэтому настройки будут храниться в реквизите справочника типа ХранилищеЗначения.
- Создается объект типа ХранилищеНастроек и для него выполняется реализация форм сохранения и загрузки. Тем самым мы обеспечиваем интерактивность при сохранении и восстановлении настроек.
- Для созданного объекта ХранилищеНастроек выполняется реализация обработчиков событий, связанных с сохранением и восстановлением настроек. Если не выполнить эту операцию, то не будут происходить собственно операции чтения/записи настроек. Для решения этой задачи нужно реализовать обработчики событий ОбработкаСохранения и ОбработкаЗагрузки в модуле созданного объекта типа ХранилищеНастроек.
- В объектах, выделенных в п. 2 (или в свойствах конфигурации), заполняются соответствующие свойства, тем самым указывая объектам, в каких хранилищах будут храниться настройки. В нашем примере необходимо заполнить свойство конфигурации Хранилище настроек данных форм ссылкой на объект, созданный на шаге 4.
- При необходимости выполняется реализация обработчиков событий, связанных с сохранением и восстановлением настроек в тех прикладных объектах, где это необходимо.
Приложение В. Настройки, сохраняемые платформой в хранилищах настроек
Приложение описывает настройки, которые автоматически сохраняются платформой в системном хранилище.
Хранилище: вариантов отчета
- Настройка: варианты отчета.
- Ключ объекта – полное имя отчета. Например: Отчет.Продажи.
- Ключ настройки – текстовый идентификатор варианта. Например: ПродажиПоРегионам.
- Тип сохраняемого значения – НастройкиКомпоновкиДанных.
Хранилище: настроек отчета
- Настройка: настройки отчета.
- Ключ объекта – текстовая строка, составленная из полного имени отчета, символа «/» и ключа варианта. Например: Отчет.Продажи/ПродажиПоРегионам.
- Ключ настройки – текстовый идентификатор настройки. Пример: МоиКлиенты.
- Тип сохраняемого значения – ПользовательскиеНастройкиКомпоновкиДанны.
Хранилище данных форм
- Настройка: значения полей формы.
- Ключ объекта – полное имя формы. Например: Обработка.ВыгрузкаДанных.Форма.ОсновнаяФорма.
- Ключ настройки – текстовый идентификатор сохраняемых значений. Пример: ВыгрузкаВСбербанк.
- Тип сохраняемого значения – Соответствие. Ключом соответствия выступает текстовый путь к сохраняемому реквизиту данных, а значением является значение реквизита.
Системное хранилище
- Настройка: ключ текущего варианта отчета.
- Ключ объекта – текстовая строка, составленная из полного имени отчета и строки «/КлючТекущегоВарианта» («/CurrentVariantKey»).
- Например: Отчет.Продажи/КлючТекущегоВарианта.
- Ключ объекта – является строковым значением, состоящим из полного имени отчета, ключа варианта отчета (в виде строки) и текста «КлючТекущихПользовательскихНастроек» (CurrentUserSettingsKey), разделенными символами «/».
- Например: Отчет.Продажи/ПродажиПоРегионам/ КлючТекущихПользовательскихНастроек.
- Ключ объекта – является строковым значением, состоящим из полного имени отчета, ключа варианта отчета (в виде строки) и текста «ТекущиеПользовательскиеНастройки» («CurrentUserSettings»), разделенными символами «/».
- Например: Отчет.Продажи/ПродажиПоРегионам/ ТекущиеПользовательскиеНастройки.
- Ключ объекта – является строковым значением, состоящим из полного имени формы и текста «КлючТекущихНастроекДанных» («CurrentDataSettingsKey»), разделенными символом «/».
- Например: Обработка.ВыгрузкаДанных.Формы.ОсновнаяФорма/КлючТекущихНастроекДанных
- Ключ объекта – является строковым значением, состоящим из полного имени формы и текста «ТекущиеДанные» («CurrentData»), разделенными символом «/».
- Например: Обработка.ВыгрузкаДанных.Формы.ОсновнаяФорма/ТекущиеДанные.
- Ключ объекта – является строковым значением, состоящим из полного имени формы и текста «НастройкиФормы» («FormSettings»), разделенными символом «/».
- Например: Обработка.ВыгрузкаДанных.Формы.ОсновнаяФорма/НастройкиФормы.
- Ключ объекта – является строковым значением, состоящим из полного имени формы и текста «НастройкиОкна» («WindowSettings»), разделенными символом «/».
- Например: Обработка.ВыгрузкаДанных.Формы.ОсновнаяФорма/ НастройкиОкна.
- Ключ объекта – «Общее/ИзбранноеРаботыПользователя» («Common/UserWorkFavorites»).
- Ключ настройки – пустая строка.
- Тип сохраняемого значения – ИзбранноеРаботыПользователя. Подробнее смотри раздел «Избранные ссылки пользователя» главы «Сервисные возможности навигации».
- Ключ объекта – строковое значение, один из вариантов:
- полное имя фрагмента командного интерфейса и «/ПанельДействий» («/ActionsPanel»);
- полное имени фрагмента командного интерфейса и «/ПанельНавигации/НастройкиКомандногоИнтерфейса» («/NavigationPanel/CommandInterfaceSettings»);
- «Общее/ПанельРазделов/НастройкиКоманд-ногоИнтерфейса» («Common/PartitionPanel/CommandInterfaceSettings»).
- Например: Подсистема.Продажи/ПанельНавигации/Нас-тройкиКомандногоИнтерфейса.
- Ключ объекта – «Общее/НастройкиРабочегоСтола» («Common/DesktopSettings»).
- Ключ настройки – пустая строка.
- Тип сохраняемого значения – НастройкиРабочегоСтола. Объект без свойств и методов.
- Ключ объекта – строковое значение, состоящее из «Общее/НастройкиПечатиТабличногоДокумента/» («Common/SpreadsheetDocumentPrintSettings/») и имени параметров печати. Например:
- Общее/НастройкиПечатиТабличногоДокумента/РасходнаяНакладная.
Объекты конфигуратора для работы с настройками
меню Справка/Содержание справки/1С предприятие/Встроенный язык/Глобальный контекст/Свойства/Хранилища настроек
меню Справка/Содержание справки/1С предприятие/Встроенный язык/Прикладные объекты/Хранилища настроек
Глобальный контекст
Глобальный контекст содержит ряд свойств (глобальных объектов), используемых для работы с настройками.
Использование: Только чтение.
Тип: СтандартноеХранилищеНастроекМенеджер; ХранилищеНастроекМенеджер.
Доступность: клиент, сервер, внешнее соединение.
Свойства глобального контекста:
- ХранилищаНастроек. Предназначено для доступа к хранилищам настроек.
- ХранилищеВариантовОтчетов. Содержит хранилище для хранения вариантов отчета.
- ХранилищеНастроекДанныхФорм. Содержит хранилище для хранения настроек данных форм.
- ХранилищеОбщихНастроек. Содержит хранилище, используемое для сохранения общих настроек.
- ХранилищеПользовательскихНастроекОтчетов. Содержит хранилище для хранения настроек отчетов.
- ХранилищеСистемныхНастроек. Содержит хранилище, в котором сохраняются системные настройки.
Хранилища настроек
В разделе описываются прикладные объекты, используемые для работы с хранилищем настроек.
СтандартноеХранилищеНастроекМенеджер (StandardSettingsStorageManager)
- Загрузить (Load)
- ПолучитьОписание (GetDescription)
- ПолучитьСписок (GetList)
- Сохранить (Save)
- Удалить (Delete)
- УстановитьОписание (SetDescription)
Описание: Хранилище настроек, хранящее настройки в системных таблицах.
Доступность: клиент, сервер, внешнее соединение.
См. также: Глобальный контекст, свойство ХранилищеСистемныхНастроек
ХранилищаНастроекМенеджер (SettingsStoragesManager)
Элементы коллекции: ХранилищеНастроекМенеджер
Для объекта доступен обход коллекции посредством оператора Для каждого … Из … Цикл. При обходе выбираются хранилища настроек.
Возможно обращение к хранилищу настроек посредством оператора [. ]. В качестве аргумента передается имя хранилища, как оно задано в конфигурации.
- <Имя хранилища> (<Имя хранилища>)
Описание: Коллекция хранилищ настроек, определенных в конфигурации.
Доступность: клиент, сервер, внешнее соединение.
См. также: Глобальный контекст, свойство ХранилищаНастроек
ХранилищеНастроекМенеджер.<Имя хранилища> (SettingsStorageManager.<Имя хранилища>)
- Загрузить (Load)
- ПолучитьМакет (GetTemplate)
- ПолучитьОписание (GetDescription)
- ПолучитьФорму (GetForm)
- ПолучитьФормуЗагрузки (GetLoadForm)
- ПолучитьФормуСохранения (GetSaveForm)
- Сохранить (Save)
- УстановитьОписание (SetDescription)
- ОбработкаЗагрузки (LoadProcessing)
- ОбработкаПолученияОписания (GetDescriptionProcessing)
- ОбработкаСохранения (SaveProcessing)
- ОбработкаУстановкиОписания (SetDescriptionProcessing)
Описание: Объект, предоставляющий доступ к хранилищу настроек определенного типа.
Доступность: клиент, сервер, внешнее соединение.
См. также: ХранилищаНастроекМенеджер, свойство <Имя хранилища>
ВыборНастроек (SettingsChoice)
- ДополнительныеСвойства (AdditionalProperties)
- КлючНастроек (SettingsKey)
- На основании ключа
Описание: Содержит информацию о выбранной пользователем настройке.
Доступность: клиент, сервер, внешнее соединение, тонкий клиент, веб-клиент.
ОписаниеНастроек (SettingsDescription)
- ДополнительныеСвойства (AdditionalProperties)
- КлючНастроек (SettingsKey)
- КлючОбъекта (ObjectKey)
- Пользователь (User)
- Представление (Presentation)
Описание: Содержит информацию об описании настройки.
Доступность: клиент, сервер, внешнее соединение.
- ХранилищеНастроекМенеджер, метод ПолучитьОписание
- ХранилищеНастроекМенеджер, метод УстановитьОписание
- ХранилищеНастроекМенеджер, событие ОбработкаПолученияОписания
- ХранилищеНастроекМенеджер, событие ОбработкаУстановкиОписания
- СтандартноеХранилищеНастроекМенеджер, метод ПолучитьОписание
- СтандартноеХранилищеНастроекМенеджер, метод Сохранить
- СтандартноеХранилищеНастроекМенеджер, метод УстановитьОписание
- ХранилищеНастроекМенеджер, метод Сохранить
- ХранилищеНастроекМенеджер, событие ОбработкаСохранения
Использование форм сохранения и загрузки
В разделе описываются механизмы использования форм сохранения и загрузки.
Форма сохранения
- КлючОбъекта (ObjectKey)
- КлючТекущихНастроек (CurrentSettingsKey)
Описание: Форма, используемая для сохранения настроек. Результатом работы формы должно быть значение типа ВыборНастроек или значение Неопределено в случае, если пользователь отказался от сохранения настройки.
Форма загрузки
- КлючОбъекта (ObjectKey)
- КлючТекущихНастроек (CurrentSettingsKey)
- СтандартныеНастройки (StandardSettings)
Форма, используемая для загрузки настроек.
Результатом работы формы (значение, передаваемое в метод Закрыть()) должно быть значение типа ВыборНастроек или значение Неопределено в случае, если пользователь отказался от загрузки настройки.
Особенности использования механизма настроек
Насколько можно понять из описания, можно выделить две части механизма:
- Использование прикладных объектов хранилища настройки для сохранения/восстановления настроек
- Замена встроенных объектов на определённые в конфигурации (паттерн плагин)
Не очень понятно зачем нужен механизм переопределения стандартных хранилищ, но, наверное, можно что-то придумать. Типа контекстной чувствительности настроек.
В глобальном контексте всегда существует набор объектов-менеджеров хранилищ различного рода настроек, которые и используются системой и/или разработчиками.
- ХранилищеВариантовОтчетов
- ХранилищеНастроекДанныхФорм
- ХранилищеОбщихНастроек
- ХранилищеПользовательскихНастроекОтчетов
- ХранилищеСистемныхНастроек
Сохранение/восстановление пользовательских настроек
Методы СохранитьЗначение и ВосстановитьЗначение не работают на тонком клиенте, поэтому их можно заменить на аналоги, которые исполняются на сервере (значение хранится индивидуально для пользователя).
- Ключ объекта – текстовая строка, составленная из полного имени отчета и строки «/КлючТекущегоВарианта» («/CurrentVariantKey»).