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