#Розширені можливості

#Нумерація сторінок

#1. Оновлення номерів сторінок

#Синтаксис

Просто вставте у вашій Office програмі.

#Приклад

У Microsoft Word:

• Використайте функцію "Вставка → Номер сторінки"
  У LibreOffice:
• Використайте функцію "Вставка → Поле → Номер сторінки"

#Результат

У згенерованому звіті номери сторінок на кожній сторінці оновлюватимуться автоматично.

#2. Генерація змісту

#Синтаксис

Просто вставте у вашій Office програмі.

#Приклад

У Microsoft Word:

• Використайте функцію "Вставка → Індекс і таблиці → Зміст"
  У LibreOffice:
• Використайте функцію "Вставка → Зміст і покажчики → Зміст, покажчик або бібліографія"

#Результат

Зміст звіту автоматично оновлюватиметься відповідно до вмісту документа.

#3. Повторення заголовків таблиць

#Синтаксис

Просто вставте у вашій Office програмі.

#Приклад

У 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. Клацніть правою кнопкою миші на цьому зображенні, відредагуйте його "Альтернативний текст" (Alt Text) і введіть мітку поля зображення, яке ви хочете вставити, наприклад {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. Після рендерингу це зображення-заповнювач буде автоматично замінено відповідним зображенням штрих-коду:

#Підтримувані типи штрих-кодів