Работа с плейсхолдерами

Что такое плейсхолдеры?

Плейсхолдер (placeholder, переменная) — это специальный текст в фигурных скобках {{ }}, который автоматически заменяется на реальные данные при печати документа.

Пример:

{{fio}} → Иванов Иван Иванович
{{birthDate}} → 15.03.1990
{{program}} → Педагогика дополнительного образования
{{"program"}} → "Педагогика дополнительного образования"

Синтаксис плейсхолдеров

Базовый формат

{{название}}

Где название — имя переменной без пробелов в начале и конце.

Примеры правильного написания:

• {{fio}}
• {{firstName}}
• {{birth_date}}
• {{регНомер}}

Примеры неправильного написания:

• {{ fio }} — пробелы внутри скобок
• {fio} — одна фигурная скобка
• {{fio} — не закрыты скобки
• {{ firstName}} — пробел только слева

Типы плейсхолдеров

1. Обычные переменные

Назначение: Подставляют одно значение для каждого слушателя.

Синтаксис: {{название}}

Примеры:

• {{fio}} — ФИО слушателя
• {{program}} — название программы
• {{hours}} — количество часов
• {{regNumber}} — регистрационный номер

Когда использовать: В индивидуальных и групповых шаблонах.

2. Управляющие теги (цикл)

Назначение: Повторяют блок текста для каждого слушателя в группе.

Синтаксис:

{{#s}}
  Содержимое, которое будет повторяться
{{/s}}

Где:

• {{#s}} — начало цикла (opening tag)
• {{/s}} — конец цикла (closing tag)
• s — сокращение от «students» (слушатели)

Пример шаблона:

Список слушателей группы:

{{#s}}
{{index}}. {{lastName}} {{firstName}} {{middleName}} — {{birthDate}}
{{/s}}

Результат для 3 слушателей:

Список слушателей группы:

1. Иванов Иван Иванович — 15.03.1990
2. Петрова Мария Сергеевна — 22.07.1985
3. Сидоров Алексей Владимирович — 10.11.1992

Всего: 3 человек

Когда использовать: Только в групповых шаблонах.

Доступные плейсхолдеры

Персональные данные слушателя

Плейсхолдер	Описание	Пример значения
{{fio}}	ФИО полностью	Иванов Иван Иванович
{{lastName}}	Фамилия	Иванов
{{firstName}}	Имя	Иван
{{middleName}}	Отчество	Иванович
{{birthDate}}	Дата рождения	15.03.1990
{{gender}}	Пол получателя	Мужской / Женский

Данные программы обучения

Плейсхолдер	Описание	Пример значения
{{program}}	Название программы	Педагогика дополнительного образования
{{qualification}}	Квалификация	Педагог дополнительного образования
{{hours}}	Количество часов	250
{{studyStartYear}}	Год начала обучения	2025
{{studyEndYear}}	Год окончания обучения	2026

Данные документа

Плейсхолдер	Описание	Пример значения
{{regNumber}}	Регистрационный номер	2024-123
{{poIssueDate}}	Дата выдачи	30.12.2024
{{poBlankSeries}}	Серия документа	12 АВ
{{poBlankNumber}}	Номер документа	0123456

Данные организации

Плейсхолдер	Описание	Пример значения
{{organizationFullName}}	Название организации	АНО ДПО «Центр»
{{organizationInn}}	ИНН организации	1234567890
{{directorName}}	ФИО руководителя	Петров П.П.

(Зависит от настроек организации в программе)

Просмотр плейсхолдеров шаблона

Способ 1: Наведение мыши

1. Откройте вкладку «Шаблоны»
2. Найдите нужный шаблон в списке
3. Наведите мышь на название шаблона
4. Появится всплывающая подсказка со списком плейсхолдеров

Отображение:

• Синие — обычные переменные
• Жёлтые — управляющие теги ({{#s}}, {{/s}})

Способ 2: Кнопка просмотра

1. Найдите шаблон в списке
2. Нажмите кнопку <> (иконка кода)
3. Откроется модальное окно со списком всех плейсхолдеров

Что отображается:

• Все найденные плейсхолдеры
• Сортировка: управляющие теги сначала, затем обычные
• Визуальная группировка по типу

Способ 3: Скачать справочник

1. В верхней части вкладки «Шаблоны» нажмите «Скачать справочник (DOCX)»
2. Откроется Word-документ со всеми доступными переменными
3. Используйте как шпаргалку при создании шаблонов

Создание индивидуального шаблона

Пример: Удостоверение о повышении квалификации

УДОСТОВЕРЕНИЕ
о повышении квалификации

Регистрационный номер: {{regNumber}}

Настоящее удостоверение свидетельствует о том, что

{{lastName}}
{{firstName}} {{middleName}}

{{birthDate}} года рождения

прошёл(а) обучение в {{orgName}}
по дополнительной профессиональной программе

«{{program}}»

в объёме {{hours}} академических часов
с {{startDate}} по {{endDate}}

Выдано: {{issueDate}}
Серия и номер: {{series}} {{number}}

Создание группового шаблона

Пример: Приказ на группу

ПРИКАЗ № {{orderNumber}}
от {{orderDate}}

О завершении обучения

Группа: {{groupName}}
Программа: {{program}}

В связи с завершением обучения ПРИКАЗЫВАЮ:

1. Считать завершившими обучение следующих слушателей:

{{#s}}
{{index}}. {{lastName}} {{firstName}} {{middleName}} ({{birthDate}})
{{/s}}

Всего: {{count}} человек.

2. Выдать документы об образовании.

Основание: Протокол итоговой аттестации от {{examDate}}

Директор _________________ {{director}}

Проверка плейсхолдеров

Автоматическая проверка

При загрузке шаблона программа:

• Находит все плейсхолдеры
• Определяет тип шаблона (индивидуальный/групповой)
• Проверяет парность тегов цикла

Ошибки, которые программа НЕ проверяет:

• Опечатки в названиях ({{fio}} vs {{fiо}} с русской «о»)
• Несуществующие переменные ({{чтотонепонятное}})
• Логические ошибки (например, {{index}} вне цикла)

Ручная проверка

Рекомендуется:

После создания шаблона:

1. Просмотрите список плейсхолдеров (кнопка <>)
2. Сверьте со справочником
3. Проверьте наличие всех нужных переменных

Перед использованием:

1. Напечатайте тестовый документ
2. Проверьте, что все данные подставляются правильно
3. Убедитесь, что форматирование сохранилось

Частые ошибки

1. Пробелы в плейсхолдерах

Неправильно:

{{ fio }}
{{  firstName }}
{{lastName }}

Правильно:

{{fio}}
{{firstName}}
{{lastName}}

2. Опечатки в названиях

Неправильно:

{{fiо}}        // русская "о" вместо английской "o"
{{birtDate}}   // пропущена "h"
{{programm}}   // лишняя "m"

Правильно:

{{fio}}
{{birthDate}}
{{program}}

Совет: Копируйте названия из справочника, а не набирайте вручную.

3. Незакрытые теги цикла

Неправильно:

{{#s}}
{{index}}. {{fio}}
// Забыли {{/s}}

Неправильно:

{{#s}}
{{index}}. {{fio}}
{{#s}}  // Повторное открытие без закрытия

Правильно:

{{#s}}
{{index}}. {{fio}}
{{/s}}

4. Использование {{index}} вне цикла

Неправильно:

Документ № {{index}} для {{fio}}

Правильно (если нужна нумерация):

{{#s}}
Документ № {{index}} для {{fio}}
{{/s}}

5. Вложенные циклы

Неправильно:

{{#s}}
  {{#s}}
    {{fio}}
  {{/s}}
{{/s}}

Правильно:

{{#s}}
{{fio}}
{{/s}}

Примечание: Программа не поддерживает вложенные циклы.

Советы по работе

Рекомендуется:

• Используйте справочник — всегда сверяйтесь с официальным списком переменных
• Копируйте, не набирайте — избежите опечаток
• Тестируйте сразу — не ждите накопления множества шаблонов
• Документируйте нестандартное — если используете необычные переменные, запишите что и для чего
• Сохраняйте старые версии — перед изменением сделайте копию

Избегайте:

• Изобретения своих переменных — программа их не заполнит
• Сложных конструкций — чем проще, тем надёжнее
• Редактирования в спешке — легко допустить ошибку
• Использования одинаковых названий — путаница гарантирована

Следующие шаги

• Управление категориями
• Синхронизация и хранение
• Частые проблемы