Асинхронная функция. Открывает PDF-документ для записи.
Синтаксис
ОткрытьАсинх(<ИмяФайла>)ОткрытьАсинх(<Поток>)Полное описание, параметры и ограничения
ЗаписьPDF.ОткрытьАсинх (PDFWriter.OpenAsync)
ЗаписьPDF (PDFWriter)
ОткрытьАсинх (OpenAsync)
Доступен, начиная с версии 8.3.18.
Вариант синтаксиса: Открыть файл
Синтаксис:
ОткрытьАсинх(<ИмяФайла>)
Параметры:
<ИмяФайла> (необязательный)
Тип: Строка.
Имя файла для записи PDF-документа.
Вариант синтаксиса: Установить поток
Синтаксис:
ОткрытьАсинх(<Поток>)
Параметры:
<Поток> (необязательный)
Тип: Поток, ПотокВПамяти, ФайловыйПоток.
Поток для записи PDF-файла.
Возвращаемое значение:
Тип: Обещание.
Результат выполнения обещания - Неопределено.
Описание:
Асинхронная функция. Открывает PDF-документ для записи.
Доступность:
Тонкий клиент, веб-клиент, толстый клиент.
См. также:
ЗаписьPDF, метод Открыть
ЗаписьPDF, метод НачатьОткрытие
Использование в версии:
Доступен, начиная с версии 8.3.18.
Методическая информация
Практические примеры
Асинхронно добавить JSON в свой PDF
Открываем собственный поток записи через Ждать, дописываем вложение и ожидаем закрытие. Проверку выполняет другой PDF-объект после завершения записи.
Где и как запускать
Модуль пустой управляемой формы учебной внешней обработки; тонкий или толстый клиент Windows. Вставьте весь модуль. Это не серверный код.
Подготовка
Создайте учебную внешнюю обработку с пустой управляемой основной формой. Создайте команду УчебныйПример и кнопку этой команды.
В свойстве команды Действие выберите процедуру УчебныйПример. Вставьте полный приведённый модуль формы.
Откройте EPF в тонком или толстом клиенте Windows и нажмите кнопку. Не переносите Ждать и Асинх в серверный общий модуль.
Пример работает только со своими данными в памяти; записи в базу, файлы и сеть нет.
Документ PDF строится из собственной ячейки Книга: 3 шт. Внешний PDF, установленный PDF-редактор, криптографический сертификат и реальные персональные данные не нужны.
Файловый путь нигде не используется. Для просмотра в PDF-программе сохраните только полученные собственные двоичные данные в отдельно выбранный новый учебный файл.
&НаКлиенте
Асинх Процедура УчебныйПример(Команда)
Чтение = Неопределено;
Запись = Неопределено;
ПотокЧтения = Неопределено;
ПотокPDF = Новый ПотокВПамяти;
Документ = Новый ТабличныйДокумент;
Документ.Область("A1").Текст = "Книга: 3 шт.";
Документ.Область("A1").ЦветТекста = Новый Цвет(30, 90, 180);
Попытка
Ждать Документ.ЗаписатьАсинх(ПотокPDF, ТипФайлаТабличногоДокумента.PDF);
Вложения = Новый КоллекцияВложенийPDF;
ТекстJSON = "{""товар"":""Книга"",""количество"":3}";
БайтыJSON = ПолучитьДвоичныеДанныеИзСтроки(ТекстJSON, КодировкаТекста.UTF8, Ложь);
Вложения.Добавить("товар.json", БайтыJSON, "application/json", ТипСвязиВложенияPDF.Данные);
ПотокPDF.Перейти(0, ПозицияВПотоке.Начало);
Запись = Новый ЗаписьPDF;
Ждать Запись.ОткрытьАсинх(ПотокPDF);
Ждать Запись.ЗаписатьВложенияАсинх(Вложения);
Ждать Запись.ЗакрытьАсинх();
Запись = Неопределено;
БайтыPDF = ПотокPDF.ЗакрытьИПолучитьДвоичныеДанные();
ПотокPDF = Неопределено;
ПотокЧтения = БайтыPDF.ОткрытьПотокДляЧтения();
Чтение = Новый ЧтениеPDF;
Ждать Чтение.ОткрытьАсинх(ПотокЧтения);
Прочитанные = Ждать Чтение.ПолучитьВложенияАсинх();
ФайлJSON = Прочитанные.Найти("товар.json");
Если ФайлJSON = Неопределено Тогда
ВызватьИсключение "Нет вложения после завершённой асинхронной записи";
КонецЕсли;
Сообщить(Прочитанные.Количество() = 1);
Сообщить(ПолучитьСтрокуИзДвоичныхДанных(ФайлJSON.Содержимое, КодировкаТекста.UTF8) = ТекстJSON);
Исключение
Если Чтение <> Неопределено Тогда
Ждать Чтение.ЗакрытьАсинх();
КонецЕсли;
Если Запись <> Неопределено Тогда
Ждать Запись.ЗакрытьАсинх();
КонецЕсли;
Если ПотокЧтения <> Неопределено Тогда
ПотокЧтения.Закрыть();
КонецЕсли;
Если ПотокPDF <> Неопределено Тогда
ПотокPDF.Закрыть();
КонецЕсли;
ВызватьИсключение;
КонецПопытки;
Если Чтение <> Неопределено Тогда
Ждать Чтение.ЗакрытьАсинх();
КонецЕсли;
Если Запись <> Неопределено Тогда
Ждать Запись.ЗакрытьАсинх();
КонецЕсли;
Если ПотокЧтения <> Неопределено Тогда
ПотокЧтения.Закрыть();
КонецЕсли;
Если ПотокPDF <> Неопределено Тогда
ПотокPDF.Закрыть();
КонецЕсли;
КонецПроцедурыРазбор по шагам
Сначала ожидаем экспорт исходного PDF без вложений.
Создаём неинициализированный ЗаписьPDF; каждую следующую операцию выполняем после Ждать предыдущей.
Запись и её закрытие завершаются до получения итоговых байтов из потока.
Новый ЧтениеPDF независимо подтверждает имя и содержимое вложения; выводим именно результат, не объект Обещание.
Как проверить результат
Две проверки Истина; JSON проверен после завершения записи.
Файл товар.json на диске не создаётся; все байты принадлежат этой форме.
Ожидаемый результат
Асинхронная запись и независимая проверка завершены в правильном порядке.
На что обратить внимание
Обещание не является признаком уже завершённой записи: требуется Ждать.
Нельзя освобождать поток, пока асинхронная операция PDF ещё использует его.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Асинхронно преобразовать свой PDF в оттенки серого
В клиентском модуле используется асинхронный вариант преобразования. JSON-вложение и пригодность PDF к чтению проверяются отдельно от цвета страницы.
Где и как запускать
Модуль пустой управляемой формы учебной внешней обработки; тонкий или толстый клиент 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.Перейти(0, ПозицияВПотоке.Начало);
Ждать Запись.ОткрытьАсинх(ПотокPDF);
Ждать Запись.ПреобразоватьВОттенкиСерогоАсинх();
Ждать Запись.ЗакрытьАсинх();
Запись = Неопределено;
БайтыPDF = ПотокPDF.ЗакрытьИПолучитьДвоичныеДанные();
ПотокPDF = Неопределено;
ПотокЧтения = БайтыPDF.ОткрытьПотокДляЧтения();
Чтение = Новый ЧтениеPDF;
Ждать Чтение.ОткрытьАсинх(ПотокЧтения);
Прочитанные = Ждать Чтение.ПолучитьВложенияАсинх();
ФайлJSON = Прочитанные.Найти("товар.json");
Если ФайлJSON = Неопределено Тогда
ВызватьИсключение "Нет собственного JSON после преобразования";
КонецЕсли;
Сообщить(Прочитанные.Количество() = 1);
Сообщить(ПолучитьСтрокуИзДвоичныхДанных(ФайлJSON.Содержимое, КодировкаТекста.UTF8) = ТекстJSON);
Исключение
Если Чтение <> Неопределено Тогда
Ждать Чтение.ЗакрытьАсинх();
КонецЕсли;
Если Запись <> Неопределено Тогда
Ждать Запись.ЗакрытьАсинх();
КонецЕсли;
Если ПотокЧтения <> Неопределено Тогда
ПотокЧтения.Закрыть();
КонецЕсли;
Если ПотокPDF <> Неопределено Тогда
ПотокPDF.Закрыть();
КонецЕсли;
ВызватьИсключение;
КонецПопытки;
Если Чтение <> Неопределено Тогда
Ждать Чтение.ЗакрытьАсинх();
КонецЕсли;
Если Запись <> Неопределено Тогда
Ждать Запись.ЗакрытьАсинх();
КонецЕсли;
Если ПотокЧтения <> Неопределено Тогда
ПотокЧтения.Закрыть();
КонецЕсли;
Если ПотокPDF <> Неопределено Тогда
ПотокPDF.Закрыть();
КонецЕсли;
КонецПроцедурыРазбор по шагам
Синий текст задан у учебной ячейки до экспорта; процесс выполняется на клиенте Windows.
Для клиента вызываем ПреобразоватьВОттенкиСерогоАсинх, а не переносим серверный синхронный вызов без проверки доступности.
Последовательно ожидаем открытие, преобразование и закрытие; поток остаётся жив до завершения писателя.
Новый читатель проверяет исходное JSON-вложение. Для проверки цвета нужен отдельный просмотр собственного результата.
Как проверить результат
Две проверки Истина: одно вложение, его текст не изменён.
После ручного сохранения своего результата проверьте серый, а не синий текст; автоматического визуального подтверждения здесь нет.
Ожидаемый результат
Завершено асинхронное преобразование собственного PDF и отдельно проверено вложение.
На что обратить внимание
Сохранное вложение не доказывает цвет пикселей страницы.
Пример не выполняет OCR, подпись или PDF/A-валидацию.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.