Как вывести фотографию в макет табличного документа 1С, используя данные из временного хранилища?

← На главную

При разработке печатных форм в 1С часто возникает задача вывода изображений, например, фотографий сотрудников, в табличные документы. Если изображение хранится в базе данных, а затем помещается во временное хранилище, его необходимо правильно извлечь для отображения в макете. Давайте разберем типовую ситуацию, когда фотография не выводится в макет, и посмотрим, как корректно решить эту задачу.

Начальная проблема: Неверный подход к получению данных фотографии

Допустим, у нас есть адрес фотографии, полученный из функции КадровыйУчетРасширенный.АдресФотографииФизическогоЛица, и мы пытаемся его использовать для создания объекта Картинка. Изначально мы можем ошибочно предположить, что этот адрес представляет собой строку в формате Base64, или прямой путь к файлу. Рассмотрим пример кода, который демонстрирует эту распространенную ошибку:


ПутьКФотке = КадровыйУчетРасширенный.АдресФотографииФизическогоЛица(ДанныеДляПечати.ФизическоеЛицо); 
// Предполагалось, что ПутьКФотке - это Base64-строка
ДвоичныеДанные = Base64Значение(ПутьКФотке);
    
Фотка = Новый Картинка(ДвоичныеДанные);
Сообщить("" + ТипЗнч(Фотка) + " - " + Фотка); // Сообщает "Картинка - Картинка", но не отображается
Если (ТипЗнч(Фотка) <> Неопределено) Тогда
    Рисунок = Область.Рисунки.Добавить(ТипРисункаТабличногоДокумента.Картинка);
    Рисунок.Картинка = Фотка;
    Рисунок.РазмерКартинки = РазмерКартинки.Пропорционально;
КонецЕсли;

В этой ситуации, несмотря на то что переменная Фотка, казалось бы, успешно создается и имеет тип Картинка, изображение на макете не появляется. Причина кроется в неправильном преобразовании данных. Функция КадровыйУчетРасширенный.АдресФотографииФизическогоЛица возвращает не Base64-строку и не обычный путь к файлу на диске, а адрес временного хранилища. Такие адреса в 1С имеют специфический вид, например, e1cib/tempstorage/51f8321c-2368-4201-88ba-2f5fef47b825?seanceId=.... Попытка применить к такой строке функцию Base64Значение() приведет к некорректным двоичным данным, из которых невозможно создать валидный объект Картинка, хоть платформа и может не ругаться явно на создание объекта.

Решение: Используем ПолучитьИзВременногоХранилища()

Для корректного получения двоичных данных изображения, когда у нас есть адрес временного хранилища, необходимо использовать специализированную функцию платформы 1С – ПолучитьИзВременногоХранилища(). Эта функция принимает в качестве параметра адрес временного хранилища и возвращает объект типа ДвоичныеДанные, которые уже можно использовать для создания объекта Картинка. Давайте скорректируем наш код:


ПутьКФотке = КадровыйУчетРасширенный.АдресФотографииФизическогоЛица(ДанныеДляПечати.ФизическоеЛицо); 
    
// Корректное получение двоичных данных из временного хранилища
ДвоичныеДанные = ПолучитьИзВременногоХранилища(ПутьКФотке);
    
Фотка = Новый Картинка(ДвоичныеДанные);
// Для отладки можно убедиться, что ТипЗнч(Фотка) - Картинка
Сообщить("" + ТипЗнч(Фотка) + " - " + Фотка); 
    
Если (ТипЗнч(Фотка) <> Неопределено) Тогда
    // Добавление нового рисунка в область макета
    Рисунок = Область.Рисунки.Добавить(ТипРисункаТабличногоДокумента.Картинка);
    Рисунок.Картинка = Фотка;
    Рисунок.РазмерКартинки = РазмерКартинки.Пропорционально;
    // Здесь также можно настроить позицию и размеры, например:
    // Рисунок.Верх = 0;
    // Рисунок.Лево = 0;
    // Рисунок.Высота = 50;
    // Рисунок.Ширина = 50;
КонецЕсли;

После внесения этих изменений, фотография должна корректно отобразиться в макете табличного документа. Ключевым моментом здесь является понимание того, что адреса вида e1cib/tempstorage/... всегда должны обрабатываться функцией ПолучитьИзВременногоХранилища() для извлечения содержимого.

Детализированный процесс вывода картинки в табличный документ

Для более глубокого понимания процесса, давайте рассмотрим шаги по выводу картинки в табличный документ:

Получение области макета: Прежде всего, нам необходимо получить область табличного документа, в которую мы хотим вставить изображение. Обычно это делается с помощью метода ПолучитьОбласть() объекта макета:
```
Макет = ПолучитьМакет("ИмяВашегоМакета"); // Получаем макет по имени
Область = Макет.ПолучитьОбласть("ИмяОбластиСРисунком"); // Получаем нужную область макета
```
Убедитесь, что в конфигураторе в макете есть область с соответствующим именем.
Создание объекта Картинка: Как мы уже выяснили, для создания объекта Картинка из данных временного хранилища, сначала получаем двоичные данные, а затем передаем их конструктору:
```
АдресФотографии = КадровыйУчетРасширенный.АдресФотографииФизическогоЛица(ДанныеДляПечати.ФизическоеЛицо);
ДвоичныеДанныеФото = ПолучитьИзВременногоХранилища(АдресФотографии);
ФотоОбъект = Новый Картинка(ДвоичныеДанныеФото);
```
Объект Картинка также может быть создан из файла на диске (Новый Картинка("C:\Путь\К\Файлу.jpg")) или из общих картинок конфигурации.
Добавление рисунка в область макета: Чтобы добавить картинку в область, мы обращаемся к коллекции Рисунки этой области и добавляем новый элемент, указывая его тип:
```
РисунокДляМакета = Область.Рисунки.Добавить(ТипРисункаТабличногоДокумента.Картинка);
```
Если в макете уже был предопределенный рисунок-заглушка с именем, например, "Фотка", то можно было бы обратиться к нему так: РисунокДляМакета = Область.Рисунки.Получить("Фотка");. В этом случае рисунок не добавляется, а модифицируется существующий.

Настройка параметров рисунка: После создания объекта рисунка, мы присваиваем ему наш объект Картинка и настраиваем его свойства. Это критически важно для корректного отображения.


РисунокДляМакета.Картинка = ФотоОбъект;
РисунокДляМакета.РазмерКартинки = РазмерКартинки.Пропорционально; // Или РазмерКартинки.РеальныйРазмер, РазмерКартинки.АвтоРазмер
            
// Также важно задать позиционирование рисунка в ячейке или области
// Эти свойства определяют, в какой области макета будет расположен рисунок
РисунокДляМакета.Верх = 0; // Верхняя граница относительно начала области
РисунокДляМакета.Лево = 0; // Левая граница относительно начала области
РисунокДляМакета.Высота = 100; // Высота рисунка в пикселях
РисунокДляМакета.Ширина = 100; // Ширина рисунка в пикселях
            
// Можно также настроить режим размещения, рамку, фон и т.д.
РисунокДляМакета.Привязка = ТипПривязкиРисункаТабличногоДокумента.КЯчейкам;
РисунокДляМакета.ГраницаСверху = Ложь;
РисунокДляМакета.ГраницаСлева = Ложь;
РисунокДляМакета.ГраницаСнизу = Ложь;
РисунокДляМакета.ГраницаСправа = Ложь;

Параметр РазмерКартинки позволяет контролировать, как изображение будет масштабироваться. Пропорционально сохраняет соотношение сторон, РеальныйРазмер использует оригинальные размеры изображения, а АвтоРазмер пытается уместить изображение в заданную область. Важно также установить координаты Верх, Лево, Высота, Ширина, чтобы рисунок отображался в ожидаемом месте и размере.

Важность правильного именования переменных

В процессе работы с кодом мы часто сталкиваемся с ситуациями, когда неправильно выбранное имя переменной может ввести в заблуждение и привести к ошибкам. В нашем случае, переменная ПутьКФотке фактически содержала не путь к файлу на диске, а адрес во временном хранилище. Если бы переменная была названа, например, АдресФоткиВоВременномХранилище, это сразу подсказало бы, какой метод для извлечения данных следует использовать, и помогло бы избежать ошибок с Base64Значение(). Всегда старайтесь давать переменным максимально точные и описывающие их содержимое имена, чтобы ваш код был более читаемым и легким для отладки.

Дополнительная информация о работе с изображениями в 1С

Чтобы глубже понимать механику работы с изображениями, рассмотрим несколько важных аспектов:

Хранение изображений в 1С:

В 1С изображения чаще всего хранятся в реквизитах типа ХранилищеЗначения. Этот тип данных позволяет сохранять любые двоичные данные, включая изображения, прямо в информационной базе. Использование ХранилищеЗначения гарантирует, что изображения будут сохранены при выгрузке базы данных в формат .dt и включены в резервные копии. Однако, реквизит ХранилищеЗначения нельзя напрямую отобразить на управляемой форме. Для вывода изображения на форму или в печатную форму его необходимо предварительно поместить во временное хранилище или получить двоичные данные и создать объект Картинка.

Временное хранилище:

Временное хранилище является ключевым механизмом платформы 1С, особенно в клиент-серверном взаимодействии. Оно служит для временного хранения любых данных, которые нужно передать между клиентом и сервером или использовать в течение ограниченного времени. Данные помещаются во временное хранилище с помощью функции ПоместитьВоВременноеХранилище(), которая возвращает уникальный адрес (идентификатор) этих данных. Этот адрес имеет формат e1cib/tempstorage/.... Получить данные по этому адресу можно функцией ПолучитьИзВременногоХранилища(). Важно помнить, что время жизни данных во временном хранилище ограничено. Оно может быть привязано к жизни формы или сеанса и автоматически очищается платформой. Также данные можно удалить вручную функцией УдалитьИзВременногоХранилища().

Работа с объектом Картинка:

Объект Картинка — это универсальный инструмент для представления изображений в 1С. Мы можем создать его из разных источников:

Из пути к файлу на диске: Новый Картинка("C:\photo.jpg").
Из двоичных данных: Новый Картинка(ДвоичныеДанные). При этом можно дополнительно указать, должен ли фон быть прозрачным. Если формат изображения не поддерживает прозрачность, система может использовать цвет последнего пикселя как прозрачный.
Из объекта ОбщаяКартинка конфигурации.

При создании объекта Картинка из двоичных данных, платформа сама определяет формат изображения (JPEG, PNG, GIF и т.д.) и декодирует его.

Частые проблемы и особенности:

Невидимость картинки: Если картинка не отображается, это может быть связано с тем, что она находится за пределами выводимой области макета, ее размеры слишком малы или велики, или не заданы свойства позиционирования (Верх, Лево, Высота, Ширина).
Рамки и фон: При вставке картинки в макет она по умолчанию может иметь рамку или непрозрачный фон. Эти свойства можно настроить как в конфигураторе (в палитре свойств рисунка, установив "Нет линии" для рамки и "Нет заливки" для фона), так и программно через свойства объекта рисунка.
Масштабирование: Для обеспечения качественного отображения на устройствах с различной плотностью пикселей (DPI), рекомендуется предоставлять изображения в виде набора для разных интервалов DPI. Платформа 1С может автоматически выбрать наиболее подходящее изображение.
Именование рисунков: В макете каждый рисунок имеет уникальное имя. При программном обращении к существующему рисунку (например, через Область.Рисунки.Получить("ИмяРисунка")) важно использовать именно это имя. Иногда имя, отображаемое в свойствах рисунка в конфигураторе, может отличаться от его фактического программного идентификатора.
Передача файлов между клиентом и сервером: Временное хранилище — это основной и наиболее эффективный механизм для обмена данными, включая файлы и изображения, между клиентским и серверным уровнем в архитектуре 1С:Предприятие.

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