Как передать пользовательские параметры в операции

Задача: отправить рассылку с данными, переданными через операцию.

Решение: создаем рассылку с пользовательским параметром.

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

Как настроить отправку рассылки с пользовательскими параметрами

1. Создаём рассылку

В шаблоне рассылки указываем параметр CustomParameters.value
Вместо "value" подставляем свой параметр:

Название рассылки не имеет значения. В нашем примере используем рассылку "custom".

2. Создаём операцию

В шаге отправки выбираем рассылку с параметром:

В описании видим наш параметр:

Количество параметров на рассылку не ограничено.

Обязательно ли передавать все поля в вызове операции

Значение заполнять необязательно, но сам узел передать надо.

Например, в рассылке есть параметр CustomParameters.promo

Корректный вызов с пустым параметром:

"customParameters": {
    "promo": ""
},

Как передавать данные в CustomParameters

Значение может быть в любом типе данных.

Можно форматировать в том числе даты, числа, коллекции — так же, как стандартные параметры.

Примеры 1:

Код в рассылке:

Начислено ${FormatDecimal (CustomParameters.balance, ’N0′)} ${Forms(CustomParameters.balance, "балл", "балла", "баллов")}.

Вызов операции:

"customParameters": {
    "balance": 10500
}

Получаем в письме:

Начислено 10 500 баллов.

Пример 2:

Код в рассылке:

Дата списания: ${Formatdatetime(AddDays (CustomParameters.Expire, 5), "m") }

Вызов операции:

"customParameters": {
    "Expire": "01.01.2021"
}

Получаем в письме:

Дата списания: 6 января