Восстанавливает работоспособность настроек. В случае, если был изменен источник доступных настроек, часть полей, использованных в настройках, может потерять связь с доступными полями. При использовании таких настроек в компоновке данных произойдет ошибка. Вызов метода с параметром <Способ> = Полное: снимает признак использования у всех элементов настроек, потерявших связь с доступными полями; в случае, если при работе метода у оформляемого поля условного оформления снят признак использования и в оформляемых полях этого элемента условного оформления отсутствуют оформляемые поля с установленным свойством использования, то признак использования отключается и у самого элемента оформления; в случае если при работе метода у элемента отбора, находящегося в группе, отключается признак использования, и в группе отсутствуют элементы с установленным признаком использования, признак использования отключается у всей группы. И, таким образом, работоспособность настроек восстанавливается. Вызов метода с параметром <Способ> = ПроверятьДоступность: удалит из настроек все элементы, которые содержат поля, не доступные для текущих функциональных опций и прав.
Синтаксис
Восстановить(<Способ>)Полное описание, параметры и ограничения
КомпоновщикНастроекКомпоновкиДанных.Восстановить (DataCompositionSettingsComposer.Refresh)
КомпоновщикНастроекКомпоновкиДанных (DataCompositionSettingsComposer)
Восстановить (Refresh)
Доступен, начиная с версии 8.1.
Синтаксис:
Восстановить(<Способ>)
Параметры:
<Способ> (необязательный)
Тип: СпособВосстановленияНастроекКомпоновкиДанных.
Указывает способ восстановления настроек.
Значение по умолчанию: Полное.
Описание:
Восстанавливает работоспособность настроек. В случае, если был изменен источник доступных настроек, часть полей, использованных в настройках, может потерять связь с доступными полями. При использовании таких настроек в компоновке данных произойдет ошибка.
Вызов метода с параметром <Способ> = Полное:
снимает признак использования у всех элементов настроек, потерявших связь с доступными полями;
в случае, если при работе метода у оформляемого поля условного оформления снят признак использования и в оформляемых полях этого элемента условного оформления отсутствуют оформляемые поля с установленным свойством использования, то признак использования отключается и у самого элемента оформления;
в случае если при работе метода у элемента отбора, находящегося в группе, отключается признак использования, и в группе отсутствуют элементы с установленным признаком использования, признак использования отключается у всей группы.
И, таким образом, работоспособность настроек восстанавливается.
Вызов метода с параметром <Способ> = ПроверятьДоступность:
удалит из настроек все элементы, которые содержат поля, не доступные для текущих функциональных опций и прав.
Доступность:
Тонкий клиент, веб-клиент, сервер, толстый клиент, внешнее соединение.
Примечание:
Если поле недоступно по функциональным опциям, вызов данного метода отключает его свойство Использование.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Проверить загруженный вариант перед построением отчёта
Восстановление работоспособности и проверка доступности — не восстановление удалённых данных. Применяем оба режима к собственному корректному варианту.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
В отдельной учебной базе 8.5.1.1343 создайте серверный общий модуль УчебныеЗадачи. Фрагмент без директив вставьте в тело ВыполнитьПример() Экспорт и вызовите своей учебной командой.
Схема СКД строится программно, макет в конфигурации не нужен. Источник Local выполняет запрос из двух собственных константных строк, без справочников, документов и регистров.
Каждое упражнение запускайте отдельно. Книга: 3 × 250 = 750; Ручка: 1 × 50 = 50; общая сумма 800. Результат хранится в памяти, не записывается в файл или базу.
Для исследования поставьте точку останова перед последними проверками. ТаблицаЗначений и процессоры СКД здесь создаются и используются на сервере; напрямую в тонкий клиент таблица не возвращается.
Схема = Новый СхемаКомпоновкиДанных;
Источник = Схема.ИсточникиДанных.Добавить();
Источник.Имя = "УчебныйИсточник";
Источник.ТипИсточникаДанных = "Local";
Набор = Схема.НаборыДанных.Добавить(Тип("НаборДанныхЗапросСхемыКомпоновкиДанных"));
Набор.Имя = "УчебныеТовары";
Набор.ИсточникДанных = Источник.Имя;
Набор.АвтоЗаполнениеДоступныхПолей = Истина;
Набор.Запрос = "ВЫБРАТЬ
| ""Книга"" КАК Наименование,
| 3 КАК Количество,
| 250 КАК Цена,
| 750 КАК Сумма
|ОБЪЕДИНИТЬ ВСЕ
|ВЫБРАТЬ ""Ручка"", 1, 50, 50";
Настройки = Схема.НастройкиПоУмолчанию;
Для Каждого ИмяПоля Из СтрРазделить("Наименование,Количество,Цена,Сумма", ",") Цикл
Выбранное = Настройки.Выбор.Элементы.Добавить(Тип("ВыбранноеПолеКомпоновкиДанных"));
Выбранное.Поле = Новый ПолеКомпоновкиДанных(ИмяПоля);
Выбранное.Использование = Истина;
КонецЦикла;
Детали = Настройки.Структура.Добавить(Тип("ГруппировкаКомпоновкиДанных"));
Детали.Использование = Истина;
АвтоВыбор = Детали.Выбор.Элементы.Добавить(Тип("АвтоВыбранноеПолеКомпоновкиДанных"));
АвтоВыбор.Использование = Истина;
Доступные = Новый ИсточникДоступныхНастроекКомпоновкиДанных(Схема);
Редактор = Новый КомпоновщикНастроекКомпоновкиДанных;
Редактор.Инициализировать(Доступные);
Редактор.ЗагрузитьНастройки(Настройки);
Редактор.Восстановить(СпособВосстановленияНастроекКомпоновкиДанных.Полное);
Редактор.Восстановить(СпособВосстановленияНастроекКомпоновкиДанных.ПроверятьДоступность);
Сообщить(Редактор.Настройки.Выбор.Элементы.Количество() = 4);
РабочиеНастройки = Редактор.ПолучитьНастройки();
КомпоновщикМакета = Новый КомпоновщикМакетаКомпоновкиДанных;
Макет = КомпоновщикМакета.Выполнить(Схема, РабочиеНастройки, , ,
Тип("ГенераторМакетаКомпоновкиДанныхДляКоллекцииЗначений"));
Процессор = Новый ПроцессорКомпоновкиДанных;
Процессор.Инициализировать(Макет);
Приемник = Новый ТаблицаЗначений;
Вывод = Новый ПроцессорВыводаРезультатаКомпоновкиДанныхВКоллекциюЗначений;
Вывод.ОтображатьПроцентВывода = Ложь;
Вывод.УстановитьОбъект(Приемник);
Результат = Вывод.Вывести(Процессор, Ложь);
Сообщить(Результат.Количество() = 2);
Сообщить(Результат.Найти("Книга", "Наименование") <> Неопределено);
Сообщить(Результат.Итог("Сумма") = 800);Разбор по шагам
Рабочий вариант загружен из собственной схемы, все его поля существуют. Поэтому оба режима не должны убирать четыре выбранных поля в этом упражнении.
Полное восстанавливает работоспособность, отключая использование элементов, потерявших связь с доступными полями, если такие элементы есть.
ПроверятьДоступность удаляет элементы с полями, недоступными из-за текущих прав/функциональных опций. У константного запроса урока нет таких прикладных ограничений.
После проверки компонуем и контролируем обе строки. Код не возвращает удалённый товар и не меняет права пользователя.
Как проверить результат
Четыре проверки дают Истина.
В Результат Книга и Ручка, сумма 800. В этом варианте восстанавливать отсутствующие поля не требовалось — они все существуют.
Ожидаемый результат
Проверенный путь загрузки и проверки корректного собственного варианта перед выводом.
На что обратить внимание
Урок не демонстрирует миграцию варианта после удаления поля схемы: для неё нужен отдельный изменённый источник и контроль отключённых элементов.
Восстановить не создаёт отсутствующие колонки запроса и не выдаёт права доступа.
ПроверятьДоступность может реально удалить элементы чужого варианта; сначала работайте с копией.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.