Использование изображений в шаблонах документов
Материал из Planfix
Существует два варианта использования изображений в шаблонах документов:
- Статический - изображение вставляется в шаблон документа и в каждом созданном по этому шаблону документе выводится в неизменном виде.
- Динамический - изображение привязывается к переменной типа Файлы и в каждом созданном по этому шаблону документе заменяется на соответствующее этой переменной в данный момент времени изображение.
В свою очередь, для использования динамически изменяющихся изображений можно использовать переменную с дополнительно задаваемыми параметрами или переменную, привязанную к "изображению-заглушке", которое определяет размер и положение нужного изображения в итоговом документе. Ниже подробно рассмотрены оба варианта.
Переменная с дополнительными параметрами
В общем случае, для вставки изображения в шаблон документа достаточно добавить в нужное место (строку, ячейку) шаблона название переменной, которая в каждом конкретном случае будет содержать нужный файл изображения:
Для управления размером и положением изображения в итоговом файле применяются следующие параметры:
- Для шаблонов в формате MS Word есть возможность в явном виде задавать размер вставляемого изображения.
- Синтаксис переменной:
- {{НазваниеПеременной::РАЗМЕР_Х_ОСЬхРАЗМЕР_Y_ОСЬ}}
- Пример использования переменной с этим параметром:
- {{Задача.Файл.Фото сотрудника::200x300}}
- Для шаблонов в формате MS Word есть возможность в явном виде выбрать вариант обтекания изображения текстом. Для этого используются дополнительный параметр переменной Обтекание:
- Примеры использования:
- {{Системные.Файл::50x50;обтекание=вокруг рамки}}
- {{Системные.Файл::50x50;обтекание=перед тектом}}
- {{Системные.Файл::50x50;обтекание=сверху и снизу}}
- Используемый формат:
- до разделителя :: (два двоеточия) идет имя переменной;
- 50x50 - ширина и высота изображения в сформированном по шаблону документе;
- обтекание - выбирается вариант обтекания изображения текстом.
- Обратите внимание: в примерах выше используется сразу два параметра, разделенных точкой с запятой: размер изображения и обтекание изображения текстом.
- Для шаблонов в формате MS Word дополнительно доступны атрибуты МаксВысота и МаксШирина. При использовании такого атрибута соответствующее ему измерение изображения в итоговом файле будет иметь установленный размер, а второе измерение примет пропорциональное значение.
- Пример использования переменной с дополнительным атрибутом:
- {{Системные.Файл::МаксШирина=150}}
- Результат: у вставленного изображения в итоговом документе ширина будет установлена в 150 пикселей, а высота подогнана пропорционально.
- В шаблонах формата MS Excel изображение по умолчанию "заполняет" ячейку которую занимает переменная, поэтому ее размер и пропорции будут определяться размером отведенной под изображение ячейки. Допускается использование объединенных ячеек.
- Для вставки оригинального размера изображения используется атрибут "оригинал". Пример использования переменной с этим атрибутом:
Для использования динамической вставки изображений в шаблон документа необходимо:
- Открыть шаблон документа в бесплатном пакете LibreOffice
- Вставить в шаблон изображение нужного размера и разместить его на желаемом месте.
- Щелкнуть на нем правой кнопкой мыши и из появившегося меню выбрать пункт:
- для шаблона MS Excel Имя (см. пример)
- для шаблона MS Word Свойства:
- и в появившемся окне перейти на вкладку Параметры, где расположено поле Имя:
- Вставить в поле Имя название переменной, соответствующей полю задачи, которое содержит изображение:
- Сохранить шаблон в формате MS Excel или MS Word
- Перейти в Документы / Шаблоны документов и добавить полученный файл шаблона как новый шаблон документа или как новую версию существующего шаблона:
- При формированию документа по оформленному таким образом шаблону, изображение окажется в том же, относительно других элементов, месте, которое вы указали в шаблоне.
Полезно
- При формировании документа по шаблону, изображение в шаблоне заменяется на изображение, загруженное в поле, которое вы указали в имени. Поэтому неважно, какое изображение будет добавлено в сам файл шаблона - оно играет лишь роль "заглушки" для изображения, которое реально будет вставлено в документ.
- Если в имени изображения в файле шаблона указано имя несуществующего поля или в это поле не загружено изображение, в итоговом файле изображения не будет.
- При формировании документа в него будет вставлено изображение того размера, который был указан в шаблоне. То есть, если в шаблоне у вас вставлено изображение печати 5*5 см, а реальное загруженное в общее поле "Печать" изображение имеет размеры 4*4 см, то в итоговом файле оно будет растянуто до размеров 5*5 см.
Полезные ссылки