Плейсхолдеры-изображения

Плейсхолдер-изображение — это фигура в шаблоне, которая при формировании документа заменяется изображением из данных записи. Плейсхолдеры-изображения работают во всех трёх форматах шаблонов: DOCX, XLSX и PPTX.

Как и у всех плейсхолдеров, имя в скобках — это машинное имя поля типа сущности, к которому привязан шаблон (типы сущностей). Поле должно быть типа «Файл» или «Изображение» (см. типы данных).

Как работают плейсхолдеры-изображения

Плейсхолдер-изображение — это фигура (или текстовое поле), весь текст которой состоит из одного тега плейсхолдера.

В этом примере шаблон привязан к типу сущности с полем «Файл/Изображение», у которого машинное имя companyLogo:

{{companyLogo}}

При формировании документа движок проверяет, является ли значение этого поля ссылкой на изображение. Если да, фигура заменяется изображением. Если значение не является ссылкой на изображение (например, это обычная строка), фигура остаётся для обычной подстановки текста.

Тег плейсхолдера должен быть единственным содержимым фигуры. Если в фигуре есть другой текст рядом с плейсхолдером, движок считает её текстовым плейсхолдером, а не плейсхолдером-изображением.

Как настроить плейсхолдер-изображение

Чтобы создать плейсхолдер-изображение в шаблоне:

  1. Вставьте фигуру или текстовое поле в то место, где должно появиться изображение.

  2. Задайте фигуре максимальные размеры итогового изображения — изображение будет масштабироваться так, чтобы поместиться в эту рамку.

  3. Задайте текст фигуры — тег плейсхолдера, например {{companyLogo}}, где companyLogo — машинное имя поля в типе сущности.

  4. Удалите из фигуры любой другой текст, форматирование и содержимое.

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

Соотношение сторон

Движок всегда сохраняет соотношение сторон изображения. Если рамка шире пропорций изображения, изображение масштабируется по высоте рамки и центрируется по горизонтали. Если рамка выше, изображение масштабируется по ширине рамки и центрируется по вертикали.

Изображение никогда не растягивается, не обрезается и не выходит за рамку.

Поддерживаемые форматы изображений

Во всех трёх типах шаблонов поддерживаются такие форматы изображений:

  • PNG

  • JPEG

  • GIF

  • TIFF

  • BMP

  • EMF

  • WMF

  • SVG

  • EPS

  • PICT

  • WPG

  • DIB

Особенности форматов

DOCX

Вставьте текстовое поле для плейсхолдера-изображения и поместите в него тег плейсхолдера. При формировании документа текстовое поле целиком заменяется изображением.

XLSX

Плейсхолдеры-изображения — это фигуры на листе. Фигура заменяется изображением в той же позиции привязки.

PPTX

Плейсхолдеры-изображения — это фигуры на слайде. Текст фигуры проверяется до подстановки текста: если полученное значение — ссылка на изображение, фигура становится изображением, иначе в неё подставляется текст как обычно.

Типичное применение

Плейсхолдеры-изображения в шаблонах для наружной рекламы обычно нужны для таких случаев:

  • логотип компании на счетах и договорах — у типа сущности есть поле «Файл/Изображение» (например, с машинным именем companyLogo),

  • фото конструкции в предложении по кампании или медиаките — у типа сущности «конструкция» есть поле вроде photo,

  • снимок карты с местом установки конструкции,

  • изображение креатива на документе согласования.

Диагностика

Если плейсхолдер-изображение не заменяется:

  • Проверьте, что весь текст фигуры — это тег плейсхолдера и ничего больше.

  • Проверьте, что в поле данных записи лежит ссылка на изображение, а не текстовое значение.

  • Проверьте, что формат изображения входит в список поддерживаемых выше.

  • Проверьте, что машинное имя поля в плейсхолдере точно совпадает с машинным именем поля в определении типа сущности.

Связанные страницы