Використання Velocity у мобільних пушах
Дізнайтеся, як створювати мобільні push-сповіщення з динамічними змінними. Аналогічно ви можете використовувати змінні в SMS та веб-повідомленнях.
Як приклад ми будемо використовувати мобільне push-повідомлення з підтвердженням замовлення та додамо до нього динамічні деталі замовлення.
Створення мобільного push-сповіщення
- Перейдіть до Повідомлення → Повідомлення та відкрийте або створіть Mobile Push.
- Використовуйте змінні velocity у контенті повідомлення, де мають бути замінені особисті контактні дані.
Щоб отримати доступ до даних масиву, в повідомленні повинна використовуватися структура циклу foreach, вбудована в код. На прикладі масиву orderData velocity-код виглядає так:
// Inside the structure, the data are extracted in a sequence from every element of the array
#foreach($order in $!data.get('orderData'))
// To extract the value from the name field of the order
$!order.get('name')
// For the price field
$!order.get('price')
#end
Зверніть увагуКоманда витягти дані
data.getнеобхідна лише при зверненні до рекомендаційних або зовнішніх джерел даних. В усіх інших випадках ви також можете використовувати формат, описаний в документації Velocity версії 2.4.1.
Наприклад:
| Формат | Змінна | Опис |
|---|---|---|
| Скорочний | $discount | Якщо змінної немає —виводиться буквальний текст $discount |
| Тихий | $!discount | Якщо значення відсутнє, нічого не виводиться |
| Формальний | ${discount} | Дужки для однозначного відокремлення імені змінної від сусіднього тексту |
| Тихий формальний | $!{discount} | Коректно відокремлює змінну та приглушує відсутні значення |
| Альтернативне значення | ${discount|$otherGift} | Якщо значення змінної відсутнє, підставляє запасне значення |
Аналогічно для масиву, що передає recommendationsData:
// Inside the structure, the data are extracted in a sequence from every element of the array
#foreach($recomm in $!data.get('recommendationsData'))
$!recomm.get('name')
$!recomm.get('price')
#end
В результаті динамічної підстановки повідомлення може виглядати так (оформлення повідомлення може відрізнятися залежно від версії ОС):
ВажливоМобільне сповіщення відображається по-різному на різних пристроях, але ми рекомендуємо використовувати не більше 40 символів. Якщо вміст масиву може перевищити цей обсяг, цикл
foreachкраще не використовувати. Натомість можна звернутися до певного елементу масиву. Тоді конструкція velocity для масивуorderDataбуде виглядати так:$!data.get('orderData').get(0).get('name'). У такій конструкції виводиться перший елемент масиву (нумерація починається з 0).
Updated 11 days ago