ДокументPDF.ПреобразоватьВОттенкиСерогоАсинх

Сравнить цветной исходник и серую копию в двух своих окнах

Из одних собственных байтов создаём два разных PDF-объекта. Только второй асинхронно преобразуется в серый и открывается после Ждать.

Подготовка

1. Создайте отдельную собственную конфигурацию УчебнаяКонфигурацияСинтаксиса и внешнюю обработку с управляемой формой. Команда Выполнить связана с процедурой Выполнить, кнопка вызывает эту команду.

2. Вставьте полный модуль одного урока на уровне модуля формы, не внутрь существующего обработчика. Серверная функция создаёт собственную таблицу Книга / 3 / 250 / 750 и возвращает настоящие PDF-байты.

3. Используйте толстый клиент Windows платформы 8.5.1.1343. Серверу необходима возможность экспортировать табличный документ в PDF. Веб-клиент и его расширения этим уроком не проверяются.

4. Окна имеют префикс guide-owned; закрывайте вручную только эти окна. Показать передаётся пустое имя файла, поэтому рабочий файл для автосохранения не назначается.

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

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

7. При подготовке пособия эти окна и печать в 1С не запускались: проверки структуры не являются доказательством внешнего вида или физического вывода.

Перем СобственныйPDF;
Перем ИсходныйPDF;
Перем Занято;

&НаСервереБезКонтекста
Функция СоздатьСобственныеБайты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 = ПрочитатьСобственныйДокумент(Данные);
        СобственныйPDF = ПрочитатьСобственныйДокумент(Данные);
        Ждать СобственныйPDF.ПреобразоватьВОттенкиСерогоАсинх();
        Сообщить(ИсходныйPDF.КоличествоСтраниц() = СобственныйPDF.КоличествоСтраниц());
        ИсходныйPDF.Показать("guide-owned: исходник с жёлтой подложкой", "");
        СобственныйPDF.Показать("guide-owned: собственная серая копия", "");
        Занято = Ложь;
    Исключение
        Занято = Ложь;
        ВызватьИсключение;
    КонецПопытки;
КонецПроцедуры

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

1. Заблокировать повторный запуск собственной команды до окончания операции.

2. Прочитать исходные байты дважды: объекты независимы. Не присваивать СобственныйPDF = ИсходныйPDF, иначе это будет одна и та же версия.

3. Дождаться ПреобразоватьВОттенкиСерогоАсинх, затем сверить число страниц.

4. Открыть два собственных окна и сравнить жёлтую и серую подложку. Снять флаг занятости и при успехе, и после исключения.

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

1. Проверка количества страниц даёт Истина. Два окна имеют разные собственные заголовки.

2. В первом окне фон жёлтый, во втором серый; строка книги одинакова. Подтверждение цветов требует ручного запуска в 1С.

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

Законченное упражнение асинхронного преобразования с сохранённой исходной версией и честной визуальной проверкой.

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

1. Обещание преобразования не содержит новый PDF: метод меняет собственный объект, его надо дождаться.

2. До завершения не закрывайте форму. Исходные PDF-байты и два объекта могут занимать память: для огромных документов нужен отдельный проект обработки.

3. Количество страниц не доказывает цвет; внешний вид проверяется глазами в собственных окнах.

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