СоставХранимыхДанныхХранилищаДвоичныхДанных.Очистить

Удалить правила из своей коллекции, не удаляя файлы

Разбираем две перегрузки Удалить и Очистить на новом составе из двух собственных реквизитов. Ни один метод физической очистки хранилища не вызывается.

Подготовка

1. Создайте отдельную пустую учебную конфигурацию на платформе 8.5.1.1343 с режимом совместимости НеИспользовать. Не используйте производственную базу и не изменяйте предоставленные выгрузки КА2/УТ/УНФ.

2. Добавьте справочник УчебныеФайлы и три реквизита: Данные и Предпросмотр с типом ХранилищеЗначения, ИспользоватьВнешнееХранение с типом Булево. Обновите только свою учебную базу. Сами записи справочника создавать не нужно.

3. Создайте серверный общий модуль УчебныеЗадачи, вставьте полный модуль одного урока и вызовите ВыполнитьПример() из своей серверной команды.

4. Упражнения с Новый СоставХранимыхДанныхХранилищаДвоичныхДанных и параметрами подключения меняют только собственные объекты в памяти. Нет установки состава, записи менеджера, резервного копирования или физической очистки.

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

Процедура ВыполнитьПример() Экспорт
    Справочник = Метаданные.Справочники.Найти("УчебныеФайлы");
    Если Справочник = Неопределено Тогда
        ВызватьИсключение "Сначала подготовьте собственный учебный справочник УчебныеФайлы";
    КонецЕсли;
    Данные = Справочник.Реквизиты.Найти("Данные");
    Предпросмотр = Справочник.Реквизиты.Найти("Предпросмотр");
    Если Данные = Неопределено ИЛИ Предпросмотр = Неопределено Тогда
        ВызватьИсключение "Нужны два собственных реквизита ХранилищеЗначения";
    КонецЕсли;
    Если НЕ Данные.Тип.СодержитТип(Тип("ХранилищеЗначения"))
        ИЛИ НЕ Предпросмотр.Тип.СодержитТип(Тип("ХранилищеЗначения")) Тогда
        ВызватьИсключение "Состав допускает данные типа ХранилищеЗначения, не произвольную строку";
    КонецЕсли;
    Состав = Новый СоставХранимыхДанныхХранилищаДвоичныхДанных;
    Основной = Состав.Добавить(Данные, ИспользованиеХраненияВХранилищеДвоичныхДанных.НеИспользовать);
    Миниатюра = Состав.Добавить(Предпросмотр, ИспользованиеХраненияВХранилищеДвоичныхДанных.НеИспользовать);
    Состав.Удалить(Основной);
    Сообщить(Состав.Количество() = 1);
    Сообщить(Состав.Индекс(Миниатюра) = 0);
    Сообщить(Состав.Найти(Данные) = Неопределено);
    Состав.Удалить(0);
    Сообщить(Состав.Количество() = 0);
    Состав.Добавить(Данные, ИспользованиеХраненияВХранилищеДвоичныхДанных.НеИспользовать);
    Состав.Очистить();
    Сообщить(Состав.Количество() = 0);
КонецПроцедуры

Разбор по шагам

1. Первая перегрузка Удалить получает ранее возвращённый объект элемента. После удаления первого правила индекс второго меняется с 1 на 0.

2. Найти удалённого реквизита возвращает Неопределено. Это отсутствие правила в своей коллекции, не удаление реквизита из конфигурации.

3. Вторая перегрузка Удалить получает индекс 0, существование которого подтверждено предыдущим контролем собственного состава.

4. Очистить удаляет элементы только из этой новой коллекции. Она не заменяет ОчиститьНеиспользуемоеМестоПоУниверсальнойДате менеджера сервиса.

5. Состав не устанавливается как рабочий. Поэтому ни правила реального хранилища, ни его файлы не меняются.

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

1. Пять контрольных Истина. Конечная собственная коллекция пуста.

2. Нет обращения к папке сервиса, удаления двоичных данных или записи настроек.

Ожидаемый результат

Ученик различает удаление описания правила в памяти и физическую очистку хранилища.

На что обратить внимание

1. Нельзя повторно использовать старый индекс после удаления предыдущего элемента.

2. Удаление правила из применённого рабочего состава — отдельная административная операция, которой этот урок не выполняет.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.