Тип: КоллекцияВложенийPDF. Коллекция, содержащая вложения PDF-файлов.
Полное описание, параметры и ограничения
ДокументPDF.Вложения (PDFDocument.Attachments)
ДокументPDF (PDFDocument)
Вложения (Attachments)
Доступен, начиная с версии 8.3.21.
Использование:
Только чтение.
Описание:
Тип: КоллекцияВложенийPDF.
Коллекция, содержащая вложения PDF-файлов.
Доступность:
Тонкий клиент, веб-клиент, сервер, толстый клиент.
Использование в версии:
Доступен, начиная с версии 8.3.21.
Методическая информация
Практические примеры
Встроить собственный CSV в PDF/A-3 и прочитать обратно
Записываем настоящую копию собственного PDF с вложением и повторно читаем содержимое CSV из новых PDF-байтов.
Где и как запускать
Полный серверный общий модуль УчебныйPDF собственной учебной конфигурации; только собственные PDF-байты в памяти.
Подготовка
Отдельная собственная учебная база 8.5.1.1343: серверный общий модуль УчебныйPDF. Вставьте полный модуль одного урока и вызовите ВыполнитьПример() своей серверной командой.
Имя конфигурации должно быть УчебнаяКонфигурацияСинтаксиса. Все данные создаются кодом: строка Книга / 3 / 250 / 750 и собственные текстовые вложения.
Исходный 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());
ТекстCSV = "Книга;3;250;750";
БайтыCSV = ПолучитьДвоичныеДанныеИзСтроки(ТекстCSV, КодировкаТекста.UTF8, Ложь);
Документ.Вложения.Добавить("guide-owned-book.csv", БайтыCSV, "text/csv", ТипСвязиВложенияPDF.Данные);
Байты = ЗаписатьСобственныйДокумент(Документ, ТипФайлаДокументаPDF.PDF_A_3);
Копия = ПрочитатьСобственныйДокумент(Байты);
Сообщить(Байты.Размер() > 0);
Сообщить(Копия.КоличествоСтраниц() = Документ.КоличествоСтраниц());
Сообщить(Копия.ТипФайла = ТипФайлаДокументаPDF.PDF_A_3);
Сообщить(Копия.Вложения.Количество() = 1);
Вложение = Копия.Вложения.Найти("guide-owned-book.csv");
Если Вложение = Неопределено Тогда
ВызватьИсключение "Вложение не прошло запись и повторное чтение";
КонецЕсли;
Сообщить(ПолучитьСтрокуИзДвоичныхДанных(Вложение.Содержимое, КодировкаТекста.UTF8) = ТекстCSV);
Сообщить(Вложение.ТипСодержимого = "text/csv");
Сообщить(Вложение.ТипСвязи = ТипСвязиВложенияPDF.Данные);
КонецПроцедурыРазбор по шагам
Прочитать собственный PDF и добавить своё CSV-вложение в принадлежащую документу коллекцию.
Передать записи поток, пустой пароль и формат PDF_A_3 в правильном порядке. ТипФайла только читается, а формат задаётся аргументом Записать.
Закрыть выходной поток с получением байтов и создать новый ДокументPDF, не повторно проверять только исходный объект.
Найти вложение в копии и сверить декодированное UTF-8 содержимое, MIME, тип связи, число страниц и формат.
Как проверить результат
Семь булевых проверок должны дать Истина; в повторно прочитанном документе ровно одно собственное CSV.
Содержимое вложения после PDF-цикла равно исходной строке. Это проверка данных, не результат внешнего валидатора PDF/A.
Ожидаемый результат
Рабочий по контрактам платформы обмен собственным PDF/A-3 с учебными данными в памяти.
На что обратить внимание
PDF/A-1 и PDF/A-2 нельзя считать подходящими форматами для этих произвольных CSV-вложений; пример явно выбирает PDF/A-3.
Ненулевой размер PDF недостаточен: упражнение действительно открывает новые байты и читает CSV обратно.
Документ не подписан. Указание PDF_A_3 не доказывает соответствие внешнему архивному стандарту без отдельной проверки.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Преобразовать цветную учебную таблицу в серую PDF-копию
Исходник имеет жёлтую подложку. Преобразование выполняется над собственной прочитанной копией; исходные байты остаются для сравнения.
Где и как запускать
Полный серверный общий модуль УчебныйPDF собственной учебной конфигурации; только собственные PDF-байты в памяти.
Подготовка
Отдельная собственная учебная база 8.5.1.1343: серверный общий модуль УчебныйPDF. Вставьте полный модуль одного урока и вызовите ВыполнитьПример() своей серверной командой.
Имя конфигурации должно быть УчебнаяКонфигурацияСинтаксиса. Все данные создаются кодом: строка Книга / 3 / 250 / 750 и собственные текстовые вложения.
Исходный 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);
Копия = ПрочитатьСобственныйДокумент(СерыеБайты);
Сообщить(ИсходныеБайты.Размер() > 0);
Сообщить(СерыеБайты.Размер() > 0);
Сообщить(Копия.КоличествоСтраниц() = ДоИзменения);
Сообщить(Копия.Вложения.Количество() = 0);
Сообщить("ИсходныеБайты и СерыеБайты — разные собственные версии; сравните их визуально, а не только по размеру");
КонецПроцедурыРазбор по шагам
Сохранить исходные PDF-байты собственного цветного документа до преобразования.
Прочитать отдельный ДокументPDF и вызвать ПреобразоватьВОттенкиСерого как процедуру без возвращаемого PDF.
Записать новые байты и прочитать их отдельным документом. Сверить страницы и отсутствие вложений.
Для визуальной оценки сравнить обе собственные версии. Ни размер файла, ни число страниц не доказывают серый цвет.
Как проверить результат
Четыре структурные проверки дают Истина; исходные и серые байты читаются платформой.
При ручном просмотре жёлтая подложка исходника должна стать серой; содержимое Книга / 3 / 250 / 750 сохраниться. Этот визуальный результат автоматическими тестами пособия не подтверждён.
Ожидаемый результат
Показано реальное преобразование собственного документа с сохранением исходной версии для проверки.
На что обратить внимание
Не сравнивайте размер как показатель качества или правильности преобразования: новый PDF может стать больше или меньше.
Не обрабатывайте подписанный рабочий документ этим учебным кодом: изменение может нарушить подпись.
У ДокументPDF нет метода Закрыть: закрываются созданные потоки, а данные документа живут в объекте.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.