Начинает подключение расширения для работы с файлами.
Синтаксис
НачатьПодключениеРасширенияРаботыСФайлами(<ОписаниеОповещения>)Примеры платформы
НаКлиенте
Процедура Команда(Команда)
Подключить(Истина);
КонецПроцедуры
НаКлиенте
Процедура Подключить(УстановитьЕслиНеПодключено) Экспорт
НачатьПодключениеРасширенияРаботыСФайлами(
Новый ОписаниеОповещения(
"ПослеПодключения",
ЭтотОбъект,
УстановитьЕслиНеПодключено));
КонецПроцедуры
НаКлиенте
Процедура ПослеПодключения(Подключено, УстановитьЕслиНеПодключено) Экспорт
Если Подключено Тогда
ИначеЕсли УстановитьЕслиНеПодключено Тогда
НачатьУстановкуРасширенияРаботыСФайлами(
Новый ОписаниеОповещения(
"Подключить",
ЭтотОбъект,
Ложь));
Иначе
КонецЕсли;
КонецПроцедурыПолное описание, параметры и ограничения
Глобальный контекст.НачатьПодключениеРасширенияРаботыСФайлами (Global context.BeginAttachingFileSystemExtension)
Глобальный контекст (Global context)
НачатьПодключениеРасширенияРаботыСФайлами (BeginAttachingFileSystemExtension)
Доступен, начиная с версии 8.3.6.
Синтаксис:
НачатьПодключениеРасширенияРаботыСФайлами(<ОписаниеОповещения>)
Параметры:
<ОписаниеОповещения> (обязательный)
Тип: ОписаниеОповещения.
Содержит описание процедуры, которая будет вызвана после завершения со следующими параметрами:
<Подключено> – результат подключения, Тип: Булево. Истина - расширение успешно подключено
<ДополнительныеПараметры> - значение, которое было указано при создании объекта ОписаниеОповещения.
Возвращаемое значение:
Для тонкого клиента - всегда Истина.
Описание:
Начинает подключение расширения для работы с файлами.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, толстый клиент, мобильное приложение (клиент).
Пример:
НаКлиенте
Процедура Команда(Команда)
Подключить(Истина);
КонецПроцедуры
НаКлиенте
Процедура Подключить(УстановитьЕслиНеПодключено) Экспорт
НачатьПодключениеРасширенияРаботыСФайлами(
Новый ОписаниеОповещения(
"ПослеПодключения",
ЭтотОбъект,
УстановитьЕслиНеПодключено));
КонецПроцедуры
НаКлиенте
Процедура ПослеПодключения(Подключено, УстановитьЕслиНеПодключено) Экспорт
Если Подключено Тогда
// Расширение работы с файлами подключено
ИначеЕсли УстановитьЕслиНеПодключено Тогда
НачатьУстановкуРасширенияРаботыСФайлами(
Новый ОписаниеОповещения(
"Подключить",
ЭтотОбъект,
Ложь));
Иначе
// Не удалось установить или подключить
// расширение работы с файлами
КонецЕсли;
КонецПроцедуры
См. также:
Глобальный контекст, метод НачатьУстановкуРасширенияРаботыСФайлами
Глобальный контекст, метод ПодключитьРасширениеРаботыСФайламиАсинх
Использование в версии:
Доступен, начиная с версии 8.3.6.
Описание изменено в версии 8.3.18.
Методическая информация
Практические примеры
работы с файлами: подключение после оповещения установки
Установка вызывает обработчик с одним дополнительным параметром, а подключение — с результатом и дополнительным параметром.
Где и как запускать
Синтаксический пример в клиентском модуле своей управляемой формы. Полные процедуры вставляются в модуль; короткий фрагмент без процедуры — в тело клиентского обработчика. Здесь ничего не устанавливалось и не выполнялось.
Подготовка
Используйте собственную учебную форму и официальное расширение работы с файлами для своей платформы. Пользователь должен разрешить его установку и подключение.
Установка и подключение — разные этапы. Успех подключения определяется булевым результатом, а окончание установки само по себе не гарантирует подключение.
Все три процедуры относятся к одному модулю формы; имена обработчиков в ОписаниеОповещения должны совпадать.
&НаКлиенте
Процедура ПодготовитьРасширение()
Оповещение = Новый ОписаниеОповещения("ПослеУстановки", ЭтотОбъект, "Учебное расширение");
НачатьУстановкуРасширенияРаботыСФайлами(Оповещение);
КонецПроцедуры
&НаКлиенте
Процедура ПослеУстановки(Название) Экспорт
Сообщить(Название + ": этап установки завершён");
Оповещение = Новый ОписаниеОповещения("ПослеПодключения", ЭтотОбъект, Название);
НачатьПодключениеРасширенияРаботыСФайлами(Оповещение);
КонецПроцедуры
&НаКлиенте
Процедура ПослеПодключения(Подключено, Название) Экспорт
Сообщить(Название + ": подключено = " + Строка(Подключено));
КонецПроцедурыРазбор по шагам
Начните установку с описанием своего обработчика.
Только из ПослеУстановки начните подключение.
В ПослеПодключения используйте оба переданных параметра.
Как проверить результат
ПослеУстановки имеет один параметр, не выдуманный результат установки.
ПослеПодключения получает и выводит настоящий Подключено.
Ожидаемый результат
Показан синтаксис для указанной подготовки. Здесь код не запускался; реальные результаты и побочные эффекты проверяются только при будущем осознанном выполнении в своём учебном приложении.
На что обратить внимание
Не вызывайте обработчики вручную и не принимайте окончание установки за успешное подключение.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.