#Расширенные возможности

#Нумерация страниц

#1. Обновление номеров страниц

#Синтаксис

Просто добавьте его в вашем офисном приложении.

#Пример

В Microsoft Word:

• Используйте функцию «Вставка → Номера страниц».
  В LibreOffice:
• Используйте функцию «Вставка → Поля → Номер страницы».

#Результат

В сгенерированном отчете номера страниц будут обновляться автоматически.

#2. Создание оглавления

#Синтаксис

Просто добавьте его в вашем офисном приложении.

#Пример

В Microsoft Word:

• Используйте функцию «Вставка → Оглавление и указатели → Оглавление».
  В LibreOffice:
• Используйте функцию «Вставка → Оглавления и указатели → Оглавление, указатель или библиография».

#Результат

Оглавление отчета будет автоматически обновляться в соответствии с содержимым документа.

#3. Повторяющиеся заголовки таблиц

#Синтаксис

Просто добавьте его в вашем офисном приложении.

#Пример

В Microsoft Word:

• Щелкните правой кнопкой мыши по заголовку таблицы → Свойства таблицы → Установите флажок «Повторять как строку заголовка на каждой странице».
  В LibreOffice:
• Щелкните правой кнопкой мыши по заголовку таблицы → Свойства таблицы → Вкладка «Обтекание» → Установите флажок «Повторять заголовок».

#Результат

Когда таблица занимает несколько страниц, ее заголовок автоматически повторяется в верхней части каждой страницы.

#Интернационализация (i18n)

#1. Перевод статического текста

#Синтаксис

Используйте тег {t(текст)} для интернационализации статического текста:

{t(meeting)}

#Пример

В шаблоне:

{t(meeting)} {t(apples)}

Данные JSON или внешний словарь локализации (например, для "fr-fr") предоставляют соответствующие переводы, такие как "meeting" → "rendez-vous" и "apples" → "Pommes".

#Результат

При генерации отчета текст будет заменен соответствующим переводом в зависимости от целевого языка.

#2. Перевод динамического текста

#Синтаксис

Для содержимого данных используйте форматтер :t, например:

{d.id:ifEQ(2):show({t(monday)}):elseShow({t(tuesday)})}

#Пример

В шаблоне:

{d.id:ifEQ(2):show({t(monday)}):elseShow({t(tuesday)})}

Данные JSON и словарь локализации предоставляют соответствующие переводы.

#Результат

В зависимости от условия будет выведено «lundi» или «mardi» (на примере целевого языка).

#Сопоставление ключ-значение

#1. Преобразование перечислений (:convEnum)

#Синтаксис

{данные:convEnum(имяПеречисления)}

Например:

0:convEnum('ORDER_STATUS')

#Пример

В примере параметров API передается следующее:

{
  "enum": {
    "ORDER_STATUS": ["pending", "sent", "delivered"]
  }
}

В шаблоне:

0:convEnum('ORDER_STATUS')

#Результат

Выводит «pending»; если индекс выходит за пределы диапазона перечисления, выводится исходное значение.

#Динамические изображения

2. Щелкните правой кнопкой мыши по этому изображению, отредактируйте его «Альтернативный текст» и введите метку поля изображения, которое вы хотите вставить, например {d.imageUrl}:

3. Используйте следующие примеры данных для рендеринга:

{
  "name": "Apple",
  "imageUrl": "https://images.pexels.com/photos/206959/pexels-photo-206959.jpeg",
}

4. В отрендеренном результате временное изображение будет заменено фактическим:

#Замена нескольких изображений в цикле

Если вы хотите вставить группу изображений в шаблон, например, список товаров, вы также можете реализовать это с помощью циклов. Конкретные шаги следующие:

1. Предположим, ваши данные выглядят следующим образом:

{
  "products": [
    {
      "name": "Apple",
      "imageUrl": "https://images.pexels.com/photos/206959/pexels-photo-206959.jpeg",
    },
    {
      "name": "Banana",
      "imageUrl": "https://images.pexels.com/photos/61127/pexels-photo-61127.jpeg",
    },
  ]
}

2. Настройте область цикла в шаблоне DOCX и вставьте временные изображения в каждый элемент цикла с альтернативным текстом, установленным как {d.products[i].imageUrl}, как показано ниже:

3. После рендеринга все временные изображения будут заменены соответствующими изображениями из данных:

#Вставка динамических изображений в файлы XLSX

Метод работы в шаблонах Excel (XLSX) в основном тот же, просто обратите внимание на следующие моменты:

1. После вставки изображения убедитесь, что вы выбрали «изображение в ячейке», а не изображение, плавающее над ячейкой.

2. После выбора ячейки нажмите, чтобы просмотреть «Альтернативный текст» и ввести метку поля, например {d.imageUrl}.

#Штрихкоды

#Генерация штрихкодов (например, QR-кодов)

Генерация штрихкодов работает так же, как и динамические изображения, и требует всего трех шагов:

1. Вставьте временное изображение в шаблон, чтобы отметить местоположение штрихкода.

2. Отредактируйте «Альтернативный текст» изображения и введите метку поля формата штрихкода, например {d.code:barcode(qrcode)}, где qrcode — это тип штрихкода (см. список поддерживаемых типов ниже).

3. После рендеринга изображение-заполнитель будет автоматически заменено соответствующим изображением штрихкода:

#Поддерживаемые типы штрихкодов