Система плейсхолдеров: основа для шаблонов
Informationen zum Artikel
Autor: Dmitry Dugarev
Неважно, пишешь ли ты шаблон счёта или шаблон письма: везде, где позже должно стоять конкретное значение, ты вставляешь плейсхолдер.
- В шаблоне: «für meinen Dolmetscheinsatz am
date» («за моё переводческое заданиеdate») - На счёте: «für meinen Dolmetscheinsatz am 20.07.2026» («за моё переводческое задание 20.07.2026»)
Плейсхолдеры — это блоки, а не текст
Плейсхолдер — это не слово, которое нужно правильно написать: это блок, который ты вставляешь в текст. В редакторе он выглядит как маленькая серая плашка посреди предложения. Ты можешь удалить его, как обычный символ, переместить или продолжать писать текст до и после него.
У этого есть практическое преимущество: опечаток не бывает. Либо блок стоит на месте — либо его там нет.
Как вставить плейсхолдер
В каждом поле, поддерживающем плейсхолдеры, под ним есть кнопка Platzhalter einfügen («Вставить плейсхолдер»). Либо просто набери в тексте две фигурные скобки {{ — откроется та же самая панель выбора.
- Помести курсор туда, где должно быть значение.
- Нажми Platzhalter einfügen или набери
{{. - Найди нужный пункт — поиск фильтрует по названию и описанию.
- Выбери его. Готово.
Доступные плейсхолдеры
Auftragsdaten (данные заказа)
Всё, что относится к самому заданию.
| Плейсхолдер | Значение |
|---|---|
occasion | Повод / тема задания |
date | Дата задания |
cancelledOn · cancelledBy | Дата отмены и кто отменил (Merkblatt (памятка), пункт 8) |
orderedOn · orderedBy | Дата поручения и заказчик (Merkblatt, пункт 8) |
timeRange | Время перевода от–до (например, 09:00–17:30) |
timeStart · timeEnd | Начало и конец времени перевода |
doorToDoorWindow | Окно задания «от двери до двери»: от первого выезда до последнего прибытия, включая время ожидания |
assignmentWindow | Всё задание целиком, с дорогой, свёрнутой в блок перевода, без учёта времени ожидания |
serviceAddress | Адрес задания |
startAddress · endAddress | Адрес отправления и адрес возвращения |
Что было выставлено к оплате — эти значения всегда соответствуют столбцу „Menge" («Количество») позиции:
| Плейсхолдер | Значение |
|---|---|
billableDuration · billedQuantity | Оплачиваемое количество этой позиции, округлённое согласно модели (= столбец „Menge") |
travelHours | Оплачиваемое время в пути (при необходимости округлённое) |
hourlyRate | Почасовая ставка этой позиции |
unitRate | Цена за единицу этой позиции (например, фиксированная сумма) |
travelKmRate | Ставка за километр |
lineTotal | Итоговая сумма этой позиции |
Что было измерено — чтобы Kostenträger (орган-плательщик) мог проверить округление:
| Плейсхолдер | Значение |
|---|---|
assignmentDuration | Измеренная продолжительность задания, включая дорогу (например, 5 ч 13 мин) |
serviceDuration | Измеренная продолжительность перевода без учёта дороги |
travelDuration · travelOutDuration | Измеренная общая продолжительность поездки и продолжительность только пути туда |
travelOutRange · travelReturnRange | Путь туда и обратно в виде временного интервала |
travelWindow | Окно времени в пути: от первого выезда до последнего прибытия |
travelDistanceKm | Расстояние поездки в километрах |
distanceTier | Применённый порог фиксированной ставки (например, „bis 50 km" — «до 50 км») |
transportMode | Вид транспорта (PKW — легковой автомобиль / ÖPNV — общественный транспорт) |
ticketDescription | Описание билета ÖPNV (включая указание на Deutschlandticket) |
ticketReference | Номер чека/билета оплачиваемой поездки на ÖPNV |
Kunde (клиент)
| Плейсхолдер | Значение |
|---|---|
customerName | Имя клиента |
customerBirthDate | Дата рождения |
customerInsuranceNumber | Номер страхования |
customerFileNumber | Номер дела |
Kostenträgerdaten (данные об органе-плательщике)
| Плейсхолдер | Значение |
|---|---|
recipientName | Название Kostenträger |
recipientAddress | Адрес Kostenträger |
salutation | Обращение (из данных Kostenträger) |
travelPolicyNote | Примечание о возмещении дорожных расходов |
Rechnungsdaten (данные счёта)
| Плейсхолдер | Значение |
|---|---|
invoiceNumber | Номер счёта |
serviceDate | Дата оказания услуги |
Только в текстах сторно и корректировок
| Плейсхолдер | Значение |
|---|---|
originalInvoiceNumber | Номер исходного счёта |
originalInvoiceDate | Дата исходного счёта |
stornoInvoiceNumber | Номер сторно-счёта |
Только в текстах напоминаний об оплате
Напоминание об оплате не содержит данных о задании или клиенте — оно относится к счёту. Поэтому здесь используется отдельный, более узкий набор плейсхолдеров:
| Плейсхолдер | Значение |
|---|---|
invoiceNumber | Номер счёта |
originalDueDate | Первоначальный срок оплаты |
newDueDate | Новый срок оплаты |
reminderStage | Ступень напоминания (1–3) |
outstandingAmount | Сумма задолженности |
dunningFee | Комиссия за напоминание |
interest | Проценты за просрочку |
total | Итоговая сумма (к оплате) |
recipientName · salutation | Название и обращение Kostenträger |
Что происходит, если значение отсутствует?
Не в каждом задании есть все значения — не у каждого клиента есть номер дела, не у каждой поездки есть билет. Если пустой плейсхолдер оказывается посреди предложения, его место просто остаётся пустым — не возникает ни сообщения об ошибке, ни {{…}} в готовом PDF.
Скрыть строку, если значение пустое
Но часто нужно, чтобы исчезала вся строка целиком: «Повод:» без повода никому не поможет. Это включается прямо у самого плейсхолдера:
Просто нажми (или кликни) на плашку плейсхолдера в описании — каждое нажатие переключает состояние. Маленький значок строки на плашке показывает текущее состояние: три сплошные линии означают «строка остаётся всегда», пунктирная средняя линия означает «строка исчезает, если значение пустое». При наведении мыши подсказка сообщает, что произойдёт при следующем клике. Без этого переключателя строка остаётся всегда, даже с пустым значением — то есть ничего не происходит у тебя за спиной без предупреждения. В готовых шаблонах этот переключатель уже установлен там, где это имеет смысл.
С клавиатуры: с помощью Tab ты добираешься до любой плашки, Enter открывает её настройки, Entf удаляет её.
Условия: печать строк в зависимости от ситуации
Некоторые строки зависят не от значения, а от ситуации — например, юридическая формулировка о расходах на ÖPNV должна появляться только на тех счетах, где поездка действительно подлежала оплате (а не при поездке по Deutschlandticket — единому проездному билету Германии). Для этого в панели выбора плейсхолдеров есть группа Bedingungen (Условия):
- Помести курсор в нужную строку и вставь условие (например, «Fahrt mit Deutschlandticket» — «поездка по Deutschlandticket»).
- В начале строки появится пунктирная плашка, например „nur ohne: Deutschlandticket" («только без: Deutschlandticket»).
- Нажатие на плашку открывает её настройки: там ты выбираешь, печатать строку только если условие выполняется или только если оно не выполняется — либо снова удаляешь условие.
Сама плашка ничего не печатает — она лишь управляет тем, появится ли её строка на счёте.
Об авторе