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