ШАБЛОНЫ БИЛЕТОВ

ЗАПОЛНЕНИЕ ШАБЛОНА ДАННЫМИ
ШАБЛОНЫ ПО УМОЛЧАНИЮ
ЛОКАЛИЗАЦИЯ
ШАБЛОНЫ АГЕНТОВ

Платформа BIL24 позволяет применять шаблоны билетов в форматах DOCX и SVG. Предпочтительнее использовать шаблоны в формате DOCX, так как у шаблонов SVG есть ряд недостатков:

1. Не поддерживаются гиперссылки.
2. Объем данных в SVG шаблоне ограничен сильнее, чем в DOCX.
3. Необходимо указывать количество билетов на странице (1,2 или 4). Для DOCX шаблонов в этом нет необходимости.
4. BIL24 использует спецификацию SVG 1.2 от INKSCAPE, которая не является стандартом и не поддерживается современным ПО.

Приобретенные покупателем билеты формируются по шаблону и отправляются на адрес электронной почты в виде файла в формате PDF. Шаблоны расположены на центральном сервере BIL24 в виде файлов с определенным форматом имени:

1. F1013_A330_P4.svg (FID=1013, ActionID=330, четыре билета на странице)
2. A330_P2.svg (ActionID=330, два билета на странице)
3. V115_P4.svg (VenueID=115, четыре билета на странице)
4. F1013_P1.svg (FID=1013, один билет на странице )
5. D3_P2.svg (Dealer=3, два билета на странице)

Параметры в имени файла это:

FID (FrontendID) – идентификатор интерфейса.
ActionID – идентификатор представления.
VenueID - идентификатор места проведения.
Dealer – идентификатор Агента.
PX (где X может принимать значения 1,2,4) – количество билетов на странице формата A4 в PDF файле, отправляемом на почту клиента. Важно! Для шаблонов DOCX, в имени файла параметр P не используется, необходимо указывать P0, например, A330_P0.docx. При генерации билетов по шаблону DOCX, они добавляются непосредственно друг за другом. В отличие от SVG шаблонов, размещение и количество билетов на одной странице - это забота создателя шаблона.

Центральный сервер выбирает шаблон для создания PDF по принципу «от частного к общему». Используется следующий приоритет шаблонов:

1. Шаблон для конкретного интерфейса и конкретного представления, для любого места проведения - F1013_A330_P4.svg
2. Шаблон для представления, интерфейс и место любые - A330_P4.svg
3. Шаблон для конкретного интерфейса и конкретного места проведения, представление любое - F1013_V446_P4.svg
3. Шаблон для места проведения, интерфейс и представление любые - V115_P4.svg
4. Шаблон для интерфейса, представление и место любые - F1013_P4.svg
5. Шаблон для Агента, для любого из его интерфейсов, представление и место любые - D3_P4.svg

Если для создания билетов не найден ни один из вышеперечисленных шаблонов, то используется шаблон по умолчанию default_P0.docx.

Действует ограничение по максимальному размеру шаблона: 1 Мегабайт.

ЗАПОЛНЕНИЕ ШАБЛОНА ДАННЫМИ

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

На билет попадают данные, указанные в приложении Редактор. Метки начинаются с символа «$». Если какая-то метка отсутствует в шаблоне, то данные, связанные с этой меткой, в итоговый вид билета не попадают. Метки на шаблоне билета представлены на рис.1, билеты с заполненными данными на рис.2 :

рис.1


рис.2

$TICKET_NUMBER – строка « 65552».
$ACTION_NAME – наименование представления, строка «TODES. Продолжение».
$VENUE – наименование и адрес места проведения, строка “Самарская Государственная Филармония, г. Самара, ул. Фрунзе, д. 141”.
$DAY (день), $TIME (время) – дата и время начала представления, строка «31.08.2025» и строка «10:02».
$SEATDATA - координаты места в зале, строка «Сектор: Партер / Ряд: 18 / Место: 2». Для сеансов с билетами без размещения зрителей на местах здесь указывается ценовая категория, например, «Категория: фан-зона».
$PRICE – номинальная цена билета, строка «2000 руб.».
$TPARAM – дополнительные параметры билета, строка «ООО "Эвентсканер", ИНН 2308271092, возрастное ограничение 6+». Вместо метки $TPARAM можно использовать следующие метки:
- $PROMOTER - название организатора
- $TIN - ИНН (TIN) организатора
- $AGE_LIMIT - возрастное ограничение.
$FIO – Фамилия и имя покупателя билета. Попадает в билет, только если ввод этой информации требуется при продаже билета. Эта опция включается галочкой ФИ на билете обязательны в Редакторе событий.
$BARCODE_NUMBER – номер штрихкода, строка «2403108655529».

На шаблоне билета есть якоря для замены изображений. Чтобы посмотреть или установить якорь рисунка необходимо выбрать в контекстном меню изображения (кликнув правой кнопкой мыши на нем) пункт "Изменить замещающий текст". В MS WORD 2010 необходимо выбрать в контекстном меню пункт "Формат изображения" и далее в окне выбрать "Замещающий текст" (рис.3):

рис.3

$AFISHA_IMAGE – изображение афиши.
$BARCODE_IMAGE – изображение шрихкода.
$QR_CODE_IMAGE – изображение QR-кода.

При использовании шаблонов SVG важно понимать , что билетная платформа BIL24 поддерживает спецификацию SVG 1.2 от INKSCAPE, и в частности использует элемент flowRoot, который позволяет размещать текст в границах заданной прямоугольной области. Эта спецификация не является стандартом и не поддерживается современным программным обеспечением, в частности, браузерами.

Действующие шаблоны билетов доступны на странице Билеты агентов. Рекомендуется использовать эти шаблоны для создания собственного вида билета.

ШАБЛОНЫ ПО УМОЛЧАНИЮ

DOCX шаблон, действующий c февраля 2021 года



DOCX шаблон, действовавший в январе-феврале 2021 года




SVG шаблон, действовавший до 2021 года

ЛОКАЛИЗАЦИЯ

В платформе BIL24 реализована локализация и интернационализация. Шаблоны билетов также адаптированы к разным странам. Во всех шаблонах в конце имени файла возможно добавление локали, которая указывается формате IETF BCP 47. Например, в имени файла шаблона D122_P4_en_US.svg указана локаль en_US. Если локаль не указана, используется значение ru_RU. D шаблоне используется валюта сеанса, на который приобретены билеты.