Асинхронная функция. Открывает PDF-документ для чтения.
Синтаксис
ОткрытьАсинх(<ИмяФайла>)ОткрытьАсинх(<Поток>)Полное описание, параметры и ограничения
ЧтениеPDF.ОткрытьАсинх (PDFReader.OpenAsync)
ЧтениеPDF (PDFReader)
ОткрытьАсинх (OpenAsync)
Доступен, начиная с версии 8.3.18.
Вариант синтаксиса: Открыть файл
Синтаксис:
ОткрытьАсинх(<ИмяФайла>)
Параметры:
<ИмяФайла> (необязательный)
Тип: Строка.
Имя файла для чтения PDF-документа.
Вариант синтаксиса: Установить поток
Синтаксис:
ОткрытьАсинх(<Поток>)
Параметры:
<Поток> (необязательный)
Тип: Поток, ПотокВПамяти, ФайловыйПоток.
Поток для чтения PDF-документа.
Возвращаемое значение:
Тип: Обещание.
Результат выполнения обещания - Неопределено.
Описание:
Асинхронная функция. Открывает PDF-документ для чтения.
Доступность:
Тонкий клиент, веб-клиент, толстый клиент.
См. также:
ЧтениеPDF, метод Открыть
ЧтениеPDF, метод НачатьОткрытие
Использование в версии:
Доступен, начиная с версии 8.3.18.
Методическая информация
Практические примеры
Асинхронно открыть свой PDF, получить вложения и закрыть читатель
В отличие от процедур открытия и закрытия, обещание ПолучитьВложенияАсинх разрешается в настоящую коллекцию. Все три операции дожидаются завершения.
Где и как запускать
Полный модуль собственной управляемой формы внешней обработки, толстый клиент Windows 8.5.1.1343.
Подготовка
Создайте отдельную собственную конфигурацию УчебнаяКонфигурацияСинтаксиса и внешнюю обработку с управляемой формой. Команда Выполнить связана с процедурой Выполнить, кнопка вызывает эту команду.
Вставьте полный модуль одного урока на уровне модуля формы, не внутрь существующего обработчика. Серверная функция создаёт собственную таблицу Книга / 3 / 250 / 750 и возвращает настоящие PDF-байты.
Используйте толстый клиент Windows платформы 8.5.1.1343. Серверу необходима возможность экспортировать табличный документ в PDF. Веб-клиент и его расширения этим уроком не проверяются.
Окна имеют префикс guide-owned; закрывайте вручную только эти окна. Показать передаётся пустое имя файла, поэтому рабочий файл для автосохранения не назначается.
Во время асинхронной операции не закрывайте форму и не запускайте второй экземпляр операции. Ждать означает ожидание завершения обещания, а не получение готового документа без ожидания.
Только урок печати требует строковый реквизит формы Подтверждение. Печать разрешается отдельной фразой и обязательным диалогом, в котором пользователь сам выбирает собственное тестовое устройство или отменяет.
При подготовке пособия эти окна и печать в 1С не запускались: проверки структуры не являются доказательством внешнего вида или физического вывода.
Перем Занято;
&НаСервереБезКонтекста
Функция СоздатьСобственныеБайтыPDF()
Таблица = Новый ТабличныйДокумент;
Таблица.КодЯзыка = "ru";
Таблица.Область(1, 1).Текст = "СОБСТВЕННЫЙ УЧЕБНЫЙ ОБРАЗЕЦ";
Таблица.Область(2, 1).Текст = "Книга";
Таблица.Область(2, 2).Текст = "3";
Таблица.Область(2, 3).Текст = "250";
Таблица.Область(2, 4).Текст = "750";
Таблица.Область(1, 1, 2, 4).ЦветФона = Новый Цвет(255, 255, 210);
Таблица.Область(, 1, , 1).ШиринаКолонки = 45;
Поток = Новый ПотокВПамяти;
Попытка
Таблица.Записать(Поток, ТипФайлаТабличногоДокумента.PDF);
Данные = Поток.ЗакрытьИПолучитьДвоичныеДанные();
Исключение
Поток.Закрыть();
ВызватьИсключение;
КонецПопытки;
Возврат Данные;
КонецФункции
&НаКлиенте
Асинх Процедура Выполнить(Команда)
Если Занято = Истина Тогда
ВызватьИсключение "Дождитесь завершения собственного читателя";
КонецЕсли;
Занято = Истина;
Поток = Неопределено;
Чтение = Неопределено;
Попытка
Данные = СоздатьСобственныеБайтыPDF();
Поток = Данные.ОткрытьПотокДляЧтения();
Чтение = Новый ЧтениеPDF;
Ждать Чтение.ОткрытьАсинх(Поток);
Вложения = Ждать Чтение.ПолучитьВложенияАсинх();
Сообщить(ТипЗнч(Вложения) = Тип("КоллекцияВложенийPDF"));
Сообщить(Вложения.Количество() = 0);
Ждать Чтение.ЗакрытьАсинх();
Чтение = Неопределено;
Поток.Закрыть();
Поток = Неопределено;
Занято = Ложь;
Исключение
ОшибкаОперации = ОписаниеОшибки();
Если Чтение <> Неопределено Тогда
Чтение.Закрыть();
КонецЕсли;
Если Поток <> Неопределено Тогда
Поток.Закрыть();
КонецЕсли;
Занято = Ложь;
ВызватьИсключение ОшибкаОперации;
КонецПопытки;
КонецПроцедурыРазбор по шагам
Ограничить один запуск флагом занятости и получить собственные PDF-байты.
Создать неинициализированный ЧтениеPDF и дождаться ОткрытьАсинх собственного потока.
Присвоить результат Ждать ПолучитьВложенияАсинх переменной. Проверить тип и отсутствие вложений у своего исходника.
Дождаться асинхронного закрытия читателя до закрытия своего потока. При ошибке закрыть собственные ресурсы и передать исходную ошибку.
Как проверить результат
Обе булевые проверки дают Истина: коллекция правильного типа и содержит 0 вложений.
Повторное нажатие во время операции отвергается. После завершения можно повторить упражнение с новым собственным документом.
Ожидаемый результат
Полная асинхронная цепочка специализированного PDF-читателя без открытия чужого файла.
На что обратить внимание
Вложения — КоллекцияВложенийPDF после Ждать, не объект Обещание. Не вызывайте Количество до завершения ожидания.
Ноль вложений не доказывает отсутствие страниц или подписи.
Поток не закрывается до завершения работы читателя; другие собственные уроки не должны использовать этот закрытый ресурс.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Прочитать вложения собственного PDF через Ждать
Полный модуль учебной формы последовательно ожидает экспорт, открытие, чтение вложений и закрытие. Серверный код и callback-обработчики здесь не смешиваются.
Где и как запускать
Модуль пустой управляемой формы учебной внешней обработки; тонкий или толстый клиент Windows. Вставьте весь модуль. Это не серверный код.
Подготовка
Создайте учебную внешнюю обработку с пустой управляемой основной формой. Создайте команду УчебныйПример и кнопку этой команды.
В свойстве команды Действие выберите процедуру УчебныйПример. Вставьте полный приведённый модуль формы.
Откройте EPF в тонком или толстом клиенте Windows и нажмите кнопку. Не переносите Ждать и Асинх в серверный общий модуль.
Пример работает только со своими данными в памяти; записи в базу, файлы и сеть нет.
Документ PDF строится из собственной ячейки Книга: 3 шт. Внешний PDF, установленный PDF-редактор, криптографический сертификат и реальные персональные данные не нужны.
Файловый путь нигде не используется. Для просмотра в PDF-программе сохраните только полученные собственные двоичные данные в отдельно выбранный новый учебный файл.
&НаКлиенте
Асинх Процедура УчебныйПример(Команда)
Вложения = Новый КоллекцияВложенийPDF;
ТекстJSON = "{""товар"":""Книга"",""количество"":3}";
БайтыJSON = ПолучитьДвоичныеДанныеИзСтроки(ТекстJSON, КодировкаТекста.UTF8, Ложь);
Вложения.Добавить("товар.json", БайтыJSON, "application/json", ТипСвязиВложенияPDF.Данные);
Чтение = Неопределено;
Запись = Неопределено;
ПотокЧтения = Неопределено;
ПотокPDF = Новый ПотокВПамяти;
Документ = Новый ТабличныйДокумент;
Документ.Область("A1").Текст = "Книга: 3 шт.";
Документ.Область("A1").ЦветТекста = Новый Цвет(30, 90, 180);
Попытка
Ждать Документ.ЗаписатьАсинх(ПотокPDF, ТипФайлаТабличногоДокумента.PDF, Вложения);
БайтыPDF = ПотокPDF.ЗакрытьИПолучитьДвоичныеДанные();
ПотокPDF = Неопределено;
ПотокЧтения = БайтыPDF.ОткрытьПотокДляЧтения();
Чтение = Новый ЧтениеPDF;
Ждать Чтение.ОткрытьАсинх(ПотокЧтения);
Прочитанные = Ждать Чтение.ПолучитьВложенияАсинх();
ФайлJSON = Прочитанные.Найти("товар.json");
Если ФайлJSON = Неопределено Тогда
ВызватьИсключение "Асинхронное чтение не вернуло собственное вложение";
КонецЕсли;
Сообщить(Прочитанные.Количество() = 1);
Сообщить(ПолучитьСтрокуИзДвоичныхДанных(ФайлJSON.Содержимое, КодировкаТекста.UTF8) = ТекстJSON);
Ждать Чтение.ЗакрытьАсинх();
Чтение = Неопределено;
Исключение
Если Чтение <> Неопределено Тогда
Ждать Чтение.ЗакрытьАсинх();
КонецЕсли;
Если Запись <> Неопределено Тогда
Ждать Запись.ЗакрытьАсинх();
КонецЕсли;
Если ПотокЧтения <> Неопределено Тогда
ПотокЧтения.Закрыть();
КонецЕсли;
Если ПотокPDF <> Неопределено Тогда
ПотокPDF.Закрыть();
КонецЕсли;
ВызватьИсключение;
КонецПопытки;
Если Чтение <> Неопределено Тогда
Ждать Чтение.ЗакрытьАсинх();
КонецЕсли;
Если Запись <> Неопределено Тогда
Ждать Запись.ЗакрытьАсинх();
КонецЕсли;
Если ПотокЧтения <> Неопределено Тогда
ПотокЧтения.Закрыть();
КонецЕсли;
Если ПотокPDF <> Неопределено Тогда
ПотокPDF.Закрыть();
КонецЕсли;
КонецПроцедурыРазбор по шагам
Асинх Процедура находится в модуле формы с директивой НаКлиенте.
Ждать ЗаписатьАсинх завершается до получения байтов: нельзя читать ещё незавершённый экспорт.
Ждать ОткрытьАсинх завершается до ПолучитьВложенияАсинх. Возвращённый результат чтения — коллекция, а не Обещание.
Закрытие PDF тоже ожидается; после него переменная обнуляется. При исключении оставшиеся ресурсы освобождаются.
Как проверить результат
Две проверки Истина и завершённая цепочка без записи на диск.
В форме используйте полный модуль, а не отдельный Ждать внутри обычной процедуры.
Ожидаемый результат
Вложение собственного PDF прочитано последовательной асинхронной цепочкой.
На что обратить внимание
Асинх/Ждать в данном упражнении предназначены для клиентского модуля, не для серверного общего модуля.
Веб-клиент имеет отдельные ограничения расширений; этот учебный пример рассчитан на Windows-клиент.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.