Частые ошибки в шаблонизаторе

При ошибках использования шаблонизатора срабатывает валидация. Как результат вы получаете название ошибки, которая не дает сохранить письмо.
Научимся разбирать эти ошибки и исправлять их.

В рассылке содержатся неизвестные параметры

Возможные причины и способы исправления.

Работаете с коллекцией?

Проверьте, что правильно задали цикл.

Пример.

Есть параметр Session.GetCategoryActions("ProsmotrKategoriiTovara").Take(1).Categories.Name
Внутри него — коллекция Session.GetCategoryActions("ProsmotrKategoriiTovara").Take(1).Categoriesи значение (название) элемента из этой коллекции: ...Name.

Правильный вывод названий:

@{for category in Session.GetCategoryActions("ProsmotrKategoriiTovara").Take(1).Categories}
${category.Name}
@{end for}

Тоже коллекция, но вложенная

То есть цикл в цикле.

Пример:
Order.Items.Take(1).Product.Categories.Name — коллекция Order.Items.Take(1), каждый её элемент имеет ещё одну коллекцию .Product.Categories, и уже у этого элемента есть значение: ...Name.

Как понять, что мы столкнулись с такой ситуацией и нужен цикл в цикле?

При формировании параметра мы дважды натыкаемся на коллекцию.

Первая коллекция:

Вторая коллекция:

Правильный вывод названий:

@{for item in Order.Items.Take(1)}
    @{for category in item.Product.Categories}
        ${category.Name}
    @{end for}
@{end for}

Параметр правильный, но используется неправильным типом.

Например, параметр — строка, а вы пытаетесь сложить его с числом.
${Recipient.CustomField.String + 1} выдаст ошибку, если дополнительное поле не числового типа.

Некорректный шаблон: Строка N, символ M: Недопустимый символ (жалоба на последний символ в шаблоне)

Проверьте, что у вас закрыты все циклы: сравните количество @{for и @{end for}, @{if и @{end if} — они должны совпадать.

Строка M, символ N: Invalid symbol

Проверьте верстку в редакторе кода — возможно в него попали символы из неподходящей кодировки. Такое может быть при копировании кода из различных источников.

Например, можно использовать VS Code:

В метод Take в качестве аргумента под номером 1 передано не константное значение

Функции принимают только константные значения — то есть не переменные, а конкретные значения.
Попытка использовать вместо них переменные закончится ошибкой.

Например, Session.GetCategoryActions("ProsmotrKategoriiTovara").Take(N).Categories — нерабочий вариант.

Недопустимый тип аргумента «quantity» функции «appendForms»: Ожидался Decimal, а передан String, Строка 1, символ 14: Недопустимый тип результата функции FormatDecimal. Ожидался Decimal, а она возвращает String

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

Например,
${AppendForms(FormatDecimal(CustomParameters.balance, 'N0′), "балл", "балла", "баллов")} — функция FormatDecimal преобразует параметр в строку, а функция AppendForms ожидает получить число. Получается конфликт.

Шаблон содержит элементы базового языка параметров, но для рассылки включен расширенный язык

Символ вывода параметра указан внутри фигурных скобок, а не снаружи.
Например, вместо ${Recipient.OnlyStandardFirstName} указали {$Recipient.OnlyStandardFirstName}