Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Menggunakan pembantu template pesan
Dengan template Amazon Pinpoint, pelanggan dapat membuat templat pesan yang dapat digunakan kembali berdasarkan bahasa Handlebars.js. Pembantu menyediakan berbagai fitur seperti memformat harga ke mata uang Wilayah tertentu atau menambahkan lokasi berbasis zona waktu. Helper dapat menggunakan string atau bilangan bulat tertentu untuk nilai atau variabel pesan Amazon Pinpoint tertentu.
Ini adalah kategori pembantu, dijelaskan di bagian berikut:
Bagian ini menjelaskan pembantu bawaan yang disediakan oleh Setang. Untuk daftar lengkapnya, lihat Pembantu Bawaan
-
each
— Mengulangi daftar.catatan
Ukuran daftar maksimum adalah 15 item.
-
if
— Mengevaluasi pernyataan.
- setiap
-
Mengulangi daftar. Helper ini hanya menggunakan pernyataan blok. Anda dapat secara opsional:
-
Lulus
@index
permintaan untuk mereferensikan indeks loop saat ini. -
Gunakan
this
helper untuk mereferensikan elemen saat ini yang sedang diulang. -
Kembalikan respons pembantu dalam daftar, menggunakan
<li>
tag.
Penggunaan
{{#each
value
}}Nilai pada posisi
{{@index}}
adalah{{this}}
.{{else}}
Kondisinya salah.
{{/each}}
each
harus diawali dengan tanda pound (#
) dan diakhiri dengan penutupan{{/each}}
dalam pernyataan blok.Contoh
Dalam contoh
each
ini, digunakan untuk mengembalikan daftar warna favorit pengguna. Untuk afalse
,else
pernyataan dikembalikan. Jika permintaannya adalah ini:{{#each User.UserAttributes.FavoriteColors}}
<li>{{this}}</li>
{{else}}
You have no favorite colors.
{{/each}}
kembali-
red
-
blue
-
yellow
untuk pernyataan yang benar.
-
- jika
-
Mengevaluasi apakah sesuatu itu benar dan mengembalikan respons berdasarkan evaluasi.
Penggunaan
{{#if
value
}}Nilai tidak terdefinisi
{{else}}
Nilai tidak terdefinisi
{{/if}}
if
harus diawali dengan tanda pound (#
) dan diakhiri dengan penutupan{{/if}}
dalam pernyataan blok.Contoh
Dalam contoh ini,
if
helper digunakan untuk mengevaluasi apakah nama depan pengguna. Jika nama ditemukan, salam dikembalikan yang melewati nama depan pengguna dalam respons. Jika tidak,else
pernyataan mengembalikan salam alternatif.{{#if User.UserAttributes.FirstName.[0]}}
Hello
{{User.UserAttributes.FirstName.[0]}},
{{else}}
Hello,
{{/if}}
kembali
Hello, Jane
jikaif
penolong benar.
Bagian ini menjelaskan pembantu bersyarat.
Pembantu bersyarat dapat digunakan pada satu baris atau dalam pernyataan blok. Anda dapat menyesuaikan respons terlepas dari metode pembantu yang Anda gunakan. Anda dapat melewati pembantu bersyarat tambahan dalam pernyataan baris tunggal dan blok. Pembantu bersyarat berikut menunjukkan penggunaan pertama untuk satu baris dan kemudian pernyataan blok menggunakan klausa opsionalelse
. Ini adalah pembantu bersyarat:
-
and
— Membandingkan apakah semua elemen yang dilewati sama. -
eq
— Menguji apakah dua elemen sama. -
gt
— Menguji apakah satu elemen lebih besar dari yang lain. -
gte
— Menguji apakah satu elemen lebih besar dari atau sama dengan yang lain. -
if
Mengevaluasi apakah sesuatu itu benar. -
lt
— Menguji apakah satu elemen kurang dari yang lain. -
lte
— Menguji apakah satu elemen kurang dari atau sama dengan yang lain. -
neq
Mengevaluasi apakah dua elemen tidak sama. -
not
— Membalikkan respons operasi Boolean. -
or
— Membandingkan apakah salah satu elemen dalam argumen sama.
- and
-
Membandingkan apakah semua elemen yang dilewatkan dalam argumen sama, dan kemudian mengembalikan respons berdasarkan hasilnya. Helper ini dapat digunakan untuk nilai-nilai non-Boolean. Anda harus melewati setidaknya dua elemen untuk kondisi tersebut.
Penggunaan
-
{{and
valuea
valueb
valuec
valued
yes='y
' no='n
'}}Anda dapat mengganti
y
dann
dengan nilai lain, sepertiyes
danno
, atau string lain yang ingin Anda kembalikan, tergantung pada kondisinya. -
{{#and
valuea
valueb
}}Kondisi itu benar.
{{else}}
Kondisinya salah.
{{/and}}
and
harus diawali dengan tanda pound (#
) dan diakhiri dengan penutupan{{/and}}
dalam pernyataan blok.
Contoh
Dalam contoh ini,
eq
digunakan dalam pernyataanand
blok untuk menentukan apakah kedua string yang diteruskan untukLocation.Country
atributLocation.City
dan benar. Jika kedua kondisi sama, maka pernyataan yang benar dikembalikan. Jika salah satu dari atribut tersebut salah, makaelse
pernyataan dikembalikan.{{#and (eq Location.City "Los Angeles") (eq Location.Country "US")}}
You live in Los Angeles and the US.
{{else}}
You don’t live in Los Angeles and the US.
{{/and}}
-
- persamaan
-
Menguji apakah dua elemen sama atau jika nilai satu elemen sama dengan string yang dilewatkan.
Penggunaan
-
{{eq
valuea
valueb
yes='y
' no='n
'}}Anda dapat mengganti
y
dann
dengan nilai lain, sepertiyes
danno
, atau string lain yang ingin Anda kembalikan, tergantung pada kondisinya. -
{{#eq
valuea
valueb
}}Kondisi itu benar.
{{else}}
Kondisinya salah.
{{/eq}}
eq
harus diawali dengan tanda pound (#
) dan diakhiri dengan penutupan{{/eq}}
dalam pernyataan blok.
Contoh
Dalam contoh
eq
ini, digunakan untuk mengevaluasi apakah nilaiUser.UserAttributes.FavoriteColors.[0]
adalahRed
. Jika jawabannyatrue
, pernyataan yang benar dikembalikan. Jika jawabannyafalse
, makaelse
pernyataan dikembalikan.{{#eq User.UserAttributes.FavoriteColors.[0] "
red
"}}Your favorite color is red.
{{else}}
You don't like red.
{{/eq}}
-
- gt
-
Menguji apakah nilai satu elemen lebih besar dari yang lain.
Penggunaan
-
{{gt
valuea
valueb
yes='y
' no='n
'}}Anda dapat mengganti
y
dann
dengan nilai lain, sepertiyes
danno
, atau string lain yang ingin Anda kembalikan, tergantung pada kondisinya. -
{{#gt
valuea
valueb
}}Kondisi itu benar.
{{else}}
Kondisinya salah.
{{/gt}}
gt
harus diawali dengan tanda pound (#
) dan diakhiri dengan penutupan{{/gt}}
dalam pernyataan blok.
Contoh
Dalam contoh ini, helper membandingkan nilai
User.UserAttributes.UserAge.[0]
atribut terhadap string17
, untuk memverifikasi apakah usia pengguna lebih besar dari 17. Jika jawabannyatrue
, pernyataan yang benar dikembalikan. Jika jawabannyafalse
, makaelse
pernyataan dikembalikan.{{#gt User.UserAttributes.UserAge.[0] "
17
"}}You are old enough to rent a car.
{{else}}
You are not old enough to rent a car.
{{/gt}}
-
- gte
-
Menguji apakah nilai satu elemen lebih besar dari atau sama dengan yang lain.
Usage
-
{{gte
valuea
valueb
yes='y
' no='n
'}}Anda dapat mengganti
y
dann
dengan nilai lain, sepertiyes
danno
, atau string lain yang ingin Anda kembalikan, tergantung pada kondisinya. -
{{#gte
valuea
valueb
}}Kondisi itu benar.
{{else}}
Kondisinya salah.
{{/gte}}
get
harus diawali dengan tanda pound (#
) dan diakhiri dengan penutupan{{/gte}}
dalam pernyataan blok.
Contoh
Dalam contoh ini, helper membandingkan
User.UserAttributes.UserAge.[0]
atribut terhadap string18
, untuk memverifikasi apakah usia pengguna lebih besar dari atau sama dengan 18. Jika jawabannyatrue
, pernyataan yang benar dikembalikan. Jika jawabannyafalse
, makaelse
pernyataan dikembalikan.{{#gte User.UserAttributes.UserAge.[0] "
18
"}}You are old enough to rent a car.
{{else}}
You are not old enough to rent a car.
{{/gte}}
-
- jika
-
Mengevaluasi apakah sesuatu itu benar dan mengembalikan respons berdasarkan evaluasi.
Penggunaan
-
{{#if
value
}}Anda dapat mengganti
y
dann
dengan nilai lain, sepertiyes
danno
, atau string lain yang ingin Anda kembalikan, tergantung pada kondisinya. -
{{#if
}}value
Kondisi itu benar.
{{else}}
Kondisinya salah.
{{/if}}
if
harus diawali dengan tanda pound (#
) dan diakhiri dengan penutupan{{/if}}
dalam pernyataan blok.
Contoh
Dalam contoh ini, helper digunakan untuk mengevaluasi apakah nama depan pengguna. Jika nama ditemukan, salam dikembalikan yang melewati nama depan pengguna dalam respons. Jika tidak, pernyataan else mengembalikan salam alternatif.
{{#if User.UserAttributes.FirstName.[0]}}
Hello
{{User.UserAttributes.FirstName.[0]}}
,
{{else}}
Hello,
{{/if}}
kembali
Hello Jane,
jika penolong benar. -
- lt
-
Menguji apakah nilai satu elemen kurang dari nilai elemen lainnya.
Penggunaan
-
{{lt
valuea
valueb
yes='y
' no='n
'}}Anda dapat mengganti
y
dann
dengan nilai lain, sepertiyes
danno
, atau string lain yang ingin Anda kembalikan, tergantung pada kondisinya. -
{{#lt
valuea
valueb
}}Kondisi itu benar.
{{else}}
Kondisinya salah.
{{/lt}}
lt
harus diawali dengan tanda pound (#
) dan diakhiri dengan penutupan{{/lt}}
dalam pernyataan blok.
Contoh
Dalam contoh ini, helper membandingkan
User.UserAttributes.UserAge.[0]
atribut terhadap string18
, untuk memverifikasi apakah usia pengguna kurang dari 18. Jika jawabannyatrue
, pernyataan yang benar dikembalikan. Jika jawabannyafalse
, makaelse
pernyataan dikembalikan.{{#lt User.UserAttributes.UserAge.[0] "
18
"}}You are not old enough to rent a car.
{{else}}
You are old enough to rent a car.
{{/lt}}
-
- lte
-
Menguji apakah nilai suatu elemen kurang dari atau sama dengan yang lain.
Penggunaan
-
{{lte
valuea
valueb
yes='y
' no='n
'}}Anda dapat mengganti
y
dann
dengan nilai lain, sepertiyes
danno
, atau string lain yang ingin Anda kembalikan, tergantung pada kondisinya. -
{{#lte
valuea
valueb
}}Kondisi itu benar.
{{else}}
Kondisinya salah.
{{/lte}}
lte
harus diawali dengan tanda pound (#
) dan diakhiri dengan penutupan{{/lte}}
dalam pernyataan blok.
Contoh
Dalam pernyataan blok ini, helper membandingkan
User.UserAttributes.UserAge.[0]
atribut terhadap string17
, untuk memverifikasi apakah usia pengguna sama dengan 17 atau lebih muda. Jika jawabannyatrue
, pernyataan yang benar dikembalikan. Jika jawabannyafalse
, makaelse
pernyataan dikembalikan.{{#lte User.UserAttributes.Age.[0] "
17
"}}You are not old enough to rent a car.
{{else}}
You are old enough to rent a car.
{{/lte}}
-
- neq
-
Uji apakah dua elemen tidak sama.
Penggunaan
-
{{neq
valuea
valueb
yes='y
' no='n
'}}Anda dapat mengganti
y
dann
dengan nilai lain, sepertiyes
danno
, atau string lain yang ingin Anda kembalikan, tergantung pada kondisinya. -
{{#neq
valuea
valueb
}}Kondisi itu benar.
{{else}}
Kondisinya salah.
{{/neq}}
neq
harus diawali dengan tanda pound (#
) dan diakhiri dengan penutupan{{/neq}}
dalam pernyataan blok.
Contoh
Dalam pernyataan blok ini,
User.UserAttributes.FavoriteColors.[0]
atribut diperiksa terhadap string
. Jika jawabannyaRed
true
, pernyataan yang benar dikembalikan. Jika jawabannyafalse
, makaelse
pernyataan dikembalikan.{{#neq User.UserAttributes.Favorite.Colors.[0] "
red
"}}You do not like red.
{{else}}
You like red.
{{/neq}}
-
- tidak
-
Membalikkan respon dari operasi Boolean, sehingga jika
not
adalah perbandingan positif, makatrue
pernyataan dikembalikan. Jika responsnya salah, maka pernyataan else dikembalikan.Penggunaan
-
{{not
value
yes='y
' no='n
'}}Anda dapat mengganti
y
dann
dengan nilai lain, sepertiyes
danno
, atau string lain yang ingin Anda kembalikan, tergantung pada kondisinya. -
{{#not
}}value
Kondisi itu benar.
{{else}}
Kondisinya salah.
{{/not}}
not
harus diawali dengan tanda pound (#
) dan diakhiri dengan penutupan{{/not}}
dalam pernyataan blok.
Contoh
Dalam pernyataan blok ini,
User.UerAttributes.FavoriteColors.[0]
atribut diperiksa terhadap stringred
, menggunakaneq
helper.not
Pembantu kemudian mengembalikan kebalikan darieq
penolong. Jika respons mengembalikan warna apa pun selainred
,true
pernyataan dikembalikan. Jika respon kembalired
, makaelse
pernyataan dikembalikan menunjukkan pernyataan palsu.{{#not (eq User.UserAttributes.Favorite.Colors.[0] "
red
")}}You do not like red.
{{else}}
You like red.
{{/not}}
Contoh
Dalam contoh ini,
{{not (eq User.UserAttributes.FavoriteColors.[0] "
red
")}}mengembalikan false jika
User.UserAttributes.FavoriteColors.[0]
adared
. -
- atau
-
Membandingkan apakah salah satu elemen dalam argumen sama, dan kemudian mengembalikan respons berdasarkan hasilnya. Helper ini dapat digunakan untuk nilai-nilai non-Boolean.
Penggunaan
-
{{or
valuea
valueb
valuec
valued
yes='y
' no='n
'}}Anda dapat mengganti
y
dann
dengan nilai lain, sepertiyes
danno
, atau string lain yang ingin Anda kembalikan, tergantung pada kondisinya. Anda harus melewati setidaknya dua elemen untuk kondisi tersebut. -
{{#or
valuea
valueb
}}Kondisi itu benar.
{{else}}
Kondisinya salah.
{{/or}}
or
harus diawali dengan tanda pound (#
) dan diakhiri dengan penutupan{{/or}}
dalam pernyataan blok.
Contoh
Dalam pernyataan
or
blok ini, dua string untukLocation.City
atribut dibandingkan tambahan menggunakaneq
helper. Jika salah satu atribut adalahtrue
, maka pernyataan yang benar dikembalikan. Jika satu atau lebih tanggapanfalse
, makaelse
pernyataan dikembalikan.{{#or (eq Location.City "Los Angeles") (eq Location.City "Seattle")}}
You live on the West Coast of the United States.
{{else}}
You do not live on the West Coast of the United States.
{{/or}}
-
Bagian ini menjelaskan pembantu string berikut:
-
abbreviate
— Memotong nilai. -
capitalize
— Kapitalisasi setiap kata di antara spasi putih. -
capitalizeFirst
— Mengkapitalisasi karakter pertama dari suatu nilai. -
center
— Memusatkan nilai. -
cut
— Memotong nilai. -
dateFormat
— Menetapkan gaya tanggal. -
inflect
— Mengembalikan string tunggal atau jamak berdasarkan hitungan. -
join
— Bergabung dengan array, iterator, atau objek iterable. -
ljust
— Membenarkan nilai ke margin kiri. -
lower
— Mengkonversi nilai ke huruf kecil. -
now
— Mencetak tanggal saat ini. -
ordinalize
— Ordinalisasi nilai numerik. -
replace
— Mengganti satu string dengan yang lain. -
rjust
— Membenarkan nilai ke margin kanan. -
slugify
— Mengonversi nilai menjadi huruf kecil dan menghapus karakter non-kata, mengubah spasi menjadi tanda hubung, dan menghapus spasi putih yang tertinggal. -
stripTags
— Strip [X] tag HTML dari nilai. -
substring
— Mengembalikan string baru sebagai substring dari nilai yang dilewatkan. -
upper
— Mengonversi nilai yang dilewatkan ke huruf besar.
-
yesno
Menggantikan benar, salah, dan tidak dengan Ya, Tidak, dan Mungkin.
- menyingkat
-
Memangkas nilai jika nilainya melebihi angka yang ditentukan. Ruang putih termasuk dalam hitungan panjang. Elipsis ditampilkan dalam respons untuk menunjukkan nilai terpotong. Elipsis dihitung terhadap nilai terpotong dalam respons. Jenis pembantu ini berguna jika Anda memiliki meja besar dan ruang minimal. Memotong nilai dalam sel memungkinkan Anda untuk memiliki tampilan yang lebih seragam ke tabel.
Penggunaan
{{abbreviate
, menggantivalue
X
}}X
dengan nilai numerik yang menunjukkan jumlah karakter yang harus disimpan. Angka negatif tidak didukung.Contoh
Dalam contoh ini,
abbreviate
digunakan untuk memotongUser.UserAttributes.LastName.[0]
menjadi enam (6) karakter. Respons termasuk elipsis, titik-titik yang dihitung terhadap total enam karakter.{{abbreviate
kembaliUser.UserAttributes.LastName.[0]
6
}}Ale...
jikaAlejandro
adalah nilai dari[0]
. - memanfaatkan
-
Kapitalisasi setiap kata di antara spasi putih.
Penggunaan
{{capitalize
value
}}Contoh
Dalam contoh ini, kapitalisasi awal diterapkan pada setiap kata untuk
Attributes.description.[0]
entri.{{capitalize
Attributes.description.[0]
}}Jika
Attributes.description.[0]
kembaliMy First Post
, jika nilainyaAttributes.description.[0]
adalahmy first post
. - KapitalisasiPertama
-
Mengkapitalisasi karakter pertama dalam suatu nilai.
Penggunaan
{{capitalizeFirst
value
}}Contoh
Dalam contoh ini, kapitalisasi diterapkan pada karakter pertama dari kata pertama
Attributes.description.[0]
entri.{{capitalizeFirst
kembaliAttributes.description.[0]
}}My first post
, jika nilainya
adalahAttributes.description.[0]
my first post
.Contoh
- pusat
-
Memusatkan nilai dalam bidang lebar tertentu dengan nomor yang ditentukan. Anda dapat secara opsional meneruskan karakter untuk ditampilkan untuk padding atau membiarkan bidang kosong. Jika tidak ada karakter yang dilewatkan, spasi putih digunakan.
Penggunaan
{{center
, menggantivalue
size=X
[pad=" "}}X
dengan nilai numerik.Jika
pad
dibiarkan kosong, spasi putih digunakan sebagai padding dalam respons. Jika Anda melewati karakter, karakter itu ditampilkan di setiap ruang padding. Angka negatif tidak didukung.Contoh
Dalam contoh ini, nilai
Location.City
dipusatkan dengan ukuran.19
{{center
kembaliLocation.City
size=19
}}" Los Angeles "
JikaLocation.City
adalahLos Angeles
. Perhatikan bahwa tanda kutip yang ditampilkan dalam contoh output disediakan untuk penekanan saja. - memotong
-
Menghapus nilai yang ditentukan dari string.
Penggunaan
{{cut
, mengganti spasi dalam parameter tanda kutip dengan nilai yang akan dipotong. Jika tidak ada nilai parameter yang dilewatkan, spasi putih digunakan.value
[" "
]}}Contoh
Contoh ini menghapus huruf
e
dariLocation.City
atribut.{{cut
kembaliLocation.City
"e
"}}Los Angls
jika[Location.City
adalahLos Angeles
. - DateFormat
-
Menetapkan gaya tanggal default untuk tanggal dalam respons apa pun. Untuk daftar zona waktu IDs, lihathttps://en.wikipedia.org/wiki/List_of_tz_database_time_zones
. Penggunaan
{{dateFormat date [inputFormat="format1"] [outputFormat="format2"] [tz=timeZoneId] [locale=localeID]}}
format
Parameter harus salah satu dari:-
“
full
“: format tanggal lengkap. Misalnya:Tuesday, September 19, 2020
-
“
long
“: format tanggal panjang. Misalnya:September 19, 2020
-
“
medium
“: format tanggal sedang. Misalnya:Sept 19, 2020
-
“
short
“: format tanggal pendek. Misalnya:9/19/20
-
“
pattern
“: menggunakan format pola tanggal kustom. Untuk informasi selengkapnya tentang pola tanggal, lihathttps://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html.
“
locale
“: menggunakan format tanggal berdasarkan lokal tertentu. Untuk informasi lebih lanjut tentang lokal, lihathttps://commons.apache.org/proper/commons-lang/apidocs/org/apache/commons/lang3/LocaleUtils.html#toLocale-java.lang.String-. Jika format tidak diteruskan, maka
medium
digunakan secara default.Contoh
Dalam contoh ini,
[0]
entri untuk
adalahUser.UserAttributes.StartDate.[0]
09/19/2020
dan pesan dikirim ke pengguna menggunakan formatfull
tanggal berdasarkan zonaAmerica/Los_Angeles
waktu.We can meet with you any time on
{{dateFormat User.UserAttributes.StartDate.[0] inputFormat="MM/dd/yyyy" outputFormat="full" tz=America/Los_Angeles}}.
kembaliWe can meet with you any time on Tuesday, September 19, 2020.
-
- belok
-
Mengembalikan string tunggal atau jamak berdasarkan nilai hitungan.
Penggunaan
{{inflect
count
singular
plural
[includeCount=false]}}-
Masukkan bentuk tunggal dan jamak dari string yang ingin Anda lewatkan dalam argumen.
-
Jika
includeCount
disetel kefalse
, tidak ada hitungan yang dikembalikan dalam respons. Jika diatur ketrue
count
, termasuk dalam respons.
Contoh
Contoh berikut menunjukkan infleksi untuk pembelian apel, dengan dan tanpa.
includeCount
Thank you for your purchase of {{inflect
mengembalikan:3
apple
apples
includeCount=false
}}.Thank you for your purchase of apples.
Jika
includeCount
diatur ketrue
, maka responsnya adalahThank you for your purchase of 3 apples.
-
- join
-
Bergabung dengan array, iterator, atau objek iterable. Respons mengembalikan daftar, dengan setiap nilai dalam daftar digabungkan dengan karakter yang Anda berikan dalam.
join
Misalnya, Anda dapat memisahkan nilai menggunakan koma (,
). Nilai dalam helper ini harus berupa daftar tanpa indeks posisi atribut. Misalnya, ini mungkinAttributes.custom_attribute
.Penggunaan
{{join
value
" // " [prefix=""] [suffix=""]}}Contoh
Dalam contoh ini, daftar warna dikembalikan, dengan daftar dipisahkan oleh koma dan spasi (
", "
):{{join
kembaliAttributes.favorite_colors
",
"}}blue, red, green
jikaAttributes.favorite_colors
adalah daftarnyablue,red,green
. - ladil
-
Membenarkan nilai ke margin kiri dan menambahkan spasi ke kanan sehingga panjang nilai cocok dengan angka. Angka negatif tidak didukung.
Anda dapat secara opsional meneruskan karakter untuk ditampilkan untuk
pad
atau membiarkan bidang kosong. Jika Anda membiarkanpad
nilai kosong, nilai default adalah spasi putih.Penggunaan
{{ljust
, divalue
size=X
[pad=" "]}}X
mana panjang total nilai, termasuk spasi putih.Contoh
Dalam contoh ini, nilai justifikasi kiri
15
diterapkan ke Location.City.{{ljust
kembaliLocation.City
size=15
}}"Los Angeles "
jika nilainyaLocation.City
adalahLos Angeles
. Perhatikan bahwa tanda kutip yang ditampilkan dalam contoh output disediakan untuk penekanan saja. - menurunkan
-
Mengkonversi nilai ke semua huruf kecil.
Penggunaan
{{lower
value
}}Contoh
Dalam contoh ini,
[0]
entriUser.UserAttributes.LastName.[0]
untuk diubah menjadi huruf kecil.{{lower
kembaliUser.UserAttributes.LastName.[0]
}}santos
jikaSantos
adalah nilai dari[0]
. - sekarang
-
Mencetak tanggal saat ini berdasarkan ID zona waktu yang dilewati. Untuk daftar zona waktu IDs, lihathttps://en.wikipedia.org/wiki/List_of_tz_database_time_zones
. Penggunaan
{{now [format="format"] [tz=timeZoneId] [locale=localeID]}}
format
Parameter harus salah satu dari:-
“
full
“: format tanggal lengkap. Misalnya:Tuesday, September 19, 2020
-
“
long
“: format tanggal panjang. Misalnya:September 19, 2020
-
“
medium
“: format tanggal sedang. Misalnya: 19 September 2020 -
“
short
“: format tanggal pendek. Misalnya: 9/19/20 -
“
pattern
“: pola tanggal. Untuk informasi selengkapnya tentang pola tanggal, lihathttps://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html.
“
locale
“: menggunakan format tanggal berdasarkan lokal tertentu. Untuk informasi lebih lanjut tentang lokal, lihathttps://commons.apache.org/proper/commons-lang/apidocs/org/apache/commons/lang3/LocaleUtils.html#toLocale-java.lang.String-. Jika format tidak diteruskan, maka
medium
digunakan secara default.Contoh
Dalam contoh ini, tanggal saat ini di Los Angeles dikembalikan dengan
medium
format.{{now "medium" tz=
kembaliAmerica/Los_Angeles
}}Sept 19, 2020
. -
- menordinalisasi
-
Ordinalisasi nilai numerik yang diteruskan dalam argumen. Misalnya,
1
diordinalisasikan sebagai1st
dan2
sebagai2nd
. Hanya nilai numerik yang didukung.Penggunaan
{{ordinalize [
number
]}}Contoh
Dalam contoh ini,
[0]
entriUser.UserAttributes.UserAge
diordinalisasi dan dikembalikan, bersama dengan pesan.Congratulations on your {{ordinalize User.UserAttributes.UserAge.[0]}} birthday!
pengembalian22
diordinalisasi sebagai22nd
.Congratulations on your 22nd birthday!
- menggantikan
-
Mengganti satu string dengan string lain. Sebuah string atau nilai numerik harus literal. Karakter wildcard tidak didukung.
Penggunaan
{{replace
stringToReplace
replacementValue
}}Contoh
Dalam contoh ini, garis bawah (_) menggantikan spasi putih.
{{replace
kembaliLocation.City
" " "_"
}}Los_Angeles
jikaLocation.City
adaLos Angeles
. - radil
-
Membenarkan nilai ke margin kanan dan menambahkan spasi ke kiri sehingga panjang nilai cocok dengan angka. Angka negatif tidak didukung.
Anda dapat secara opsional meneruskan karakter untuk ditampilkan untuk
pad
atau menjaga bidang kosong. Jika Anda menyimpanpad
nilai kosong, nilai default adalah spasi putih.Penggunaan
{{rjust
, divalue
size=X
[pad=" "]}}X
mana panjang total nilai, termasuk spasi putih.Contoh
Dalam contoh ini, nilai justifikasi yang tepat
15
diterapkan padaLocation.City
atribut.{{rjust
kembaliLocation.City
size=15
}}" Los Angeles"
. jikaLocation.City
adaLos Angeles
. Perhatikan bahwa tanda kutip yang ditampilkan dalam output disediakan untuk penekanan saja. - melumpuhkan
-
Mengonversi nilai yang diteruskan menjadi huruf kecil, menghapus karakter non-kata (alfanumerik dan garis bawah), mengonversi spasi menjadi tanda hubung, dan menghapus spasi putih di depan atau di belakang.
Penggunaan
{{slugify
value
}}Contoh
Dalam contoh ini, slugify dilakukan untuk atribut.
Location.City
{{slugify
kembaliLocation.City
}}los-angeles
jikaLocation.City
adalahLos Angeles
. - StripTags
-
Strip [X] tag HTML dari nilai.
Penggunaan
{{stripTags
value
}}Contoh
Dalam contoh ini, tag HTML untuk Pengguna. UserAttributes.interest. [0] dihapus.
{{stripTags
kembaliUser.UserAttributes.interests.[0]
}}Art
, jikaUser.UserAttributes.interests.[0]
ada<h1>Art</h1>
. - substring
-
Mengembalikan string baru sebagai substring dari nilai lulus. Panjang dan posisi ditentukan oleh
endOffset
parameterstartOffset
dan, yang harus bilangan bulat. Angka negatif tidak didukung. Jika tidakendOffset
dilewatkan, substring menggunakan nilai akhir asli dari string.Penggunaan
{{substring
value
startOffset
[endOffset]
}}Contoh
Dalam contoh ini, offset 4 dan EndoffSet dari 9 diterapkan ke atribut Location.City.
{{substring
kembaliLocation.City 4 9
}}
jika Los Angeles adalah nilai dariAngel
Location.City
isLos Angeles
. - atas
-
Mengonversi nilai yang dilewatkan ke huruf besar.
Penggunaan
{{upper
value
}}Contoh
Dalam contoh ini,
[0]
entri untukUser.UserAttributes.LastName
atribut dikonversi ke semua huruf besar.{{upper User.UserAttributes.LastName.[0]}}
kembaliROE
jikaUser.UserAttributes.LastName.[0]
nilainyaRoe
. - yesno
-
Menggantikan
true
,false
, danNULL
denganYes
,No
, danMaybe
.Penggunaan
{{yesno value [yes="yes"] [no="no"] maybe=["maybe"]}}
Contoh
Dalam contoh ini,
IsUserSubscribed
atribut mengembalikan apakah pengguna berlangganan daftar tertentu.{{yesno Attributes.IsUserSubscribed}}
kembaliyes
jikaAttributes.IsUserSubscribed
adalahtrue
.
Bagian ini menjelaskan pembantu matematika dan pengkodean.
-
add
— Mengembalikan jumlah dari dua angka. -
ceiling
— Membulatkan bilangan bulat ke langit-langit matematikanya. -
decode64
— Mendekode nilai yang dikodekan base64 ke string. -
divide
— Mengembalikan hasil bagi dua angka. -
encode64
— Mengkodekan string menggunakan base64. -
floor
— Membulatkan bilangan bulat ke lantai matematikanya. -
md5
— Hash string yang dilewatkan menggunakan MD5 algoritma. -
modulo
— Mengembalikan sisa dari dua angka menggunakan floating point. -
multiply
— Mengembalikan produk dari dua angka. -
round
— Membulatkan desimal ke bilangan bulat terdekat. -
sha256
— Hash string yang dilewatkan menggunakan SHA-256. -
sha512
— Hash string yang dilewatkan menggunakan SHA-512. -
subtract
— Mengembalikan selisih dua angka. -
uuid
— Secara acak menghasilkan UUID dalam format 128-bit.
- tambahkan
-
Mengembalikan jumlah dua angka bersama dengan floating point.
Penggunaan
{{add
arg1
arg2
}}Contoh
{{add
kembali5 2.3
}}7.3
- langit-langit
-
Membulatkan bilangan bulat ke langit-langit matematikanya, yang merupakan bilangan bulat tertinggi yang paling dekat dengan nilai yang dilewatkan.
Penggunaan
{{ceiling
value
}}Contoh
{{ceiling
kembali5.23
}}6
- decode64
-
Mendekode nilai yang dikodekan base64 ke string.
Penggunaan
{{decode64 "
string
"}}Contoh
{{decode64 "
kembaliSGVsbG8gd29ybGQ
="}}Hello World
- membagi
-
Mengembalikan hasil bagi dua angka, termasuk floating point.
Penggunaan
{{divide
arg1
arg2
}}Contoh
{{divide
kembali5 2.3
}}2.17391304
- dikode64
-
Mengkodekan string yang diteruskan dalam argumen menggunakan base64.
Penggunaan
{{encode64 "
string
"}}Contoh
{{encode64 "
Hello World"
}}SGVsbG8gd29ybGQ=
- lantai
-
Membulatkan bilangan bulat ke lantai matematikanya, yang merupakan bilangan bulat terendah yang paling dekat dengan nilai yang dilewatkan.
Penggunaan
{{floor
value
}}Contoh
{{floor
kembali5.23
}}5
- md5
-
Hash string yang dilewatkan menggunakan MD5 algoritma.
Penggunaan
{{md5 "
string
"}}Contoh
{{md5 "
Hello World
"}}3e25960a79dbc69b674cd4ec67a72c62
- modulo
-
Mengembalikan sisa dari dua angka menggunakan floating point.
Penggunaan
{{modulo
arg1
arg2
}}Contoh
{{modulo
kembali7 2
}}1
- kalikan
-
Mengembalikan produk dari dua angka, dengan setiap floating point.
Penggunaan
{{multiply
arg1
arg2
}}Contoh
{{multiply
kembali5 2.3
}}11.5
- bulat
-
Membulatkan tempat desimal ke atas atau ke bawah ke bilangan bulat terdekat.
Penggunaan
{{round
value
}}Contoh
You spent an average of {{round
mengembalikan:19.21
}} minutes on our website each day.You spent an average of 19 minutes on our website each day.
- sha256
-
Hash string yang diteruskan menggunakan keamanan kriptografi SHA-256.
Penggunaan
{{sha256 "
string
"}}Contoh
{{sha256 "
kembaliHello World
"}}a591a6d40bf420404a011733cfb7b190d62c65bf0bcda32b57b277d9ad9f146e
- sha512
-
Hash string yang diteruskan menggunakan keamanan kriptografi SHA-512.
Penggunaan
{{sha512 "
string
"}}Contoh
{{sha512 "
kembaliHello World
"}}2c74fd17edafd80e8447b0d46741ee243b7eb74dd2149a0ab1b9246fb30382f27e853d8585719e0e67cbda0daa8f51671064615d645ae27acb15bfb1447f459b
- kurangi
-
Mengembalikan selisih dua angka, dengan floating point.
Penggunaan
{{subtract
arg1
arg2
}}Contoh
kembali{{subtract
5 2.3
}}2.7
- uuid
-
Secara acak menghasilkan UUID dalam format 128-bit standar. Tidak ada nilai yang perlu diteruskan dalam argumen.
Penggunaan
{{uuid}}
Contoh
kembali{{uuid}}
95f36680-152c-4052-99ec-cc3cdf7ca594
Meskipun secara teknis bukan pembantu, sebagian inline adalah cara Setang untuk merampingkan templat yang menyertakan string berulang, yang lebih baik untuk digunakan kembali. Untuk informasi lebih lanjut, lihat Bagian sebaris di handlebarsjs.com
Penggunaan
{{#* inline "inlineName"}}Content to reuse{{/inline}}
Untuk mereferensikan konten sebagian inline di tempat lain, gunakan:
{{> inlineName}}
Contoh
Contoh berikut membuat sebagian inline yang menyertakan nama depan penerima, dan, jika tersedia, nama belakang, dengan menambahkan kode berikut ke awal template:
{{#* inline "
fullName
"}}
{{User.UserAttributes.FirstName.[0]}} {{#if
User.UserAttributes.LastName.[0]}} {{User.UserAttributes.LastName.[0]}} {{/if}}
{{/inline}}
Setelah membuat fullName
sebagian, Anda dapat memasukkannya di mana saja di template Anda dengan mendahului nama parsi dengan simbol >
(lebih besar dari), diikuti oleh spasi, seperti pada contoh berikut:. {{>
fullName}}
Hello {{> fullName}}
mengembalikan nama depan dan belakang pengguna jika benar - misalnya,Hello
Jane Doe
. Jika tidak, jika tidak ada nama belakang yang ditemukan, Hello
Jane
dikembalikan.
Setang menyertakan fitur tambahan di luar yang didokumentasikan di sini. Untuk informasi lebih lanjut, lihat handlebarsjs.com
Menggunakan variabel dengan pembantu template pesan
Atribut kustom Amazon PinpointUser.UserAttributes.LastName
, seperti, disimpan sebagai daftar, terlepas dari apakah ada satu item atau beberapa item. Saat meneruskan daftar di helper yang mengharapkan string, Anda harus menentukan nilai indeks atribut bersama dengan nama atribut. Nilai indeks atribut ini menunjukkan posisi nilai dari daftar atribut: .[0]
untuk entri pertama dalam daftar, .[1]
untuk yang kedua, .[2]
untuk yang ketiga, dan seterusnya. Misalnya, katakanlah Anda menggunakan upper
helper untuk mengonversi entri ([0]
) pertama User.UserAttributes.LastName
ke semua huruf besar. Penggunaan helper adalah{{upper
, dan atribut diformat sebagai. value
}}User.UserAttributes.LastName
Ganti value
dengan nama atribut dan nilai indeks atribut
sebagai berikut:.[0]
{{upper
User.UserAttributes.LastName.[0]}}
. Respons kemudian mengembalikan [0]
entri dari daftar, diformat dalam semua huruf besar. Misalnya, jika nilai [0]
isSantos
, respon kembaliSANTOS
.
Amazon Pinpoint nama atribut kustom mendukung spasi. Untuk memiliki atribut kustom dipanggil"Last Name"
, Anda harus memformat atribut sebagaiUser.UserAttributes.[Last Name]
. Untuk mengakses entri pertama dalam daftar indeks atribut formatnyaUser.UserAttributes.[Last
Name].[0]
.
Nama atribut kustom dapat berisi hingga 50 karakter. Nilai atribut dapat berisi hingga 100 karakter. Saat Anda menentukan nama atribut kustom, hindari menggunakan karakter berikut: tanda angka (#), titik dua (:), tanda tanya (?) , garis miring terbalik (\), dan garis miring (/). Konsol Amazon Pinpoint tidak dapat menampilkan nama atribut yang berisi karakter ini. Pembatasan ini tidak berlaku untuk nilai atribut.
Menggunakan pembantu bersarang
Anda dapat bersarang beberapa pembantu template pesan dalam satu sama lain. Contoh berikut menunjukkan cara memformat dua pembantu:{{ first helper (second helper)}}
. Pembantu kedua diproses terlebih dahulu, diikuti oleh penolong pertama. Ingatlah bahwa penolong pertama selalu menentukan output. Pembantu selanjutnya harus bersarang di dalam pembantu sebelumnya sebagai berikut:. {{ first helper (second helper (third helper)
)}}
Contoh berikut menunjukkan cara membuat sarang dua pembantu JANE
untuk diubah menjadiJane
:{{capitalizeFirst
(lower "
. JANE
")}}lower
pertama mengkonversi JANE
kejane
. Kemudian capitalizeFirst
mengkonversi jane
keJane
.