•Date {%Date()%}:
Defines a placeholder, which will be automatically replaced by the current date formatted as dd.mm.yyyy in the email.
Example: Returns the current date in standard format (dd.mm.yyyy), e.g. 24.12.2012.
•Time {%Time()%}:
Defines a placeholder, which will be automatically replaced by the current time formatted as hh.mm.ss in the email.
Example: Returns the current time in standard format (hh::nn:ss), e.g. 08:05:10.
•Recursive Placeholder {r}placeholderorfunction{/r}:
Defines a recursive placeholder which may be used in correlation with other placeholders to combine more than one (placeholder-)function. SmartSerialMail processes the chosen placeholder/placeholderfunctions from the inside to the outside.
Example:
Assuming you have a recipients list with an additional row called "language" in which, depending on the recipient, contains either "english" or "german". Additonally you have created two quick parts called "salutation_english" with content "Sir/Madam", as well as "salutation_german" with content "Herr/Frau".
You're now able to use a recursive placeholder like "{r}{%salutation_{%language%}%}{/r}" in your mail content. It will provide the proper salutation for the matching language.
For this SmartSerialMail will first analyze the innermost placeholder "{%language%}" and substitutes it with the language of the current recipient in the chosen recipients list. So SmartSerialMail will now get
"{r}{%salutation_english%}{/r}" or "{r}{%salutation_german%}{/r}" as interim result.
In the following step the actual placeholder, which is now "salutation_english" or "salutation_german" will be replaced as usual.
As output we'll now get "Sir/Madam" or "Herr/Frau", depending on the dissolved placeholder.
•Contains {r}{%contains(placeholder, contains)%}{/r}:
Defines a placeholder function which checks for a given placeholder if it contains a specific value(contains). If it does, the function will return the value "True", otherwise the value "False".
Example: {r}{%contains({%First_name%}, Dr.)%}{/r}, here SmartSerialMail checks if the first name of the current recipient contains the title "Dr.", in this case SmartSerialMail returns "True", otherwise "False".
•Replace {r}{%replace(placeholder, search, replace)%}{/r}:
Defines a placeholder function which looks up a specific value(search) in a given placeholder and replaces all occurrences of it a by another value(replace).
Example: {r}{%replace({%First_name%}, Max, Tom)%}{/r}, here SmartSerialMail seeks for "Max" in the first name of the current recipient an replaces it with "Tom".
•Substring {r}{%substr(placeholder, start, length)%}{/r}:
Defines a placeholder function which extracts a substring from a given placeholder beginning at a desired start position with a specific length.
Example: {r}{%substr({%First_name%}, 5, 3)%}{/r}, here SmartSerialMail returns the next 3 characters beginning from the 5th letter of the first name of the current recipient, e.g. for "Johnson" SmartSerialMail would return "son".
•Trim {r}{%trim(placeholder)%}{/r}:
Defines a placeholderfunction which trims all whitespaces at the beginning and the end of a given placeholder.
Example: {r}{%trim({%Email%})%}{/r}, here SmartSerialMail removes all potential occurring blanks before and after the e-mail address of the current recipient, e.g. " costumer@provider.com" wird zu "costumer@provider.com"
•Uppercase {r}{%uppercase(placeholder)%}{/r}:
Defines a placeholder function which converts all lowercase characters of a given placeholder into uppercase characters.
Example: {r}{%uppercase({%First_name%})%}{/r}, here SmartSerialMail converts all lowercase letters in the first name of the current recipient into uppercase letters, e.g. "Max" would be converted to "MAX".
•Lowercase {r}{%lowercase(placeholder)%}{/r}:
Defines a placeholder function which converts all uppercase characters of a given placeholder into lowercase characters.
Example: {r}{%lowercase({%First_name%})%}{/r}, here SmartSerialMail converts all uppercase letters in the first name of the current recipient into lowercase letters, e.g. "Max" would be converted to "max".
•Date (formatted) {r}{%date(dateformat)%}{/r}:
Defines a placeholder function which returns the current date formatted with the desired date format,
e.g. dd.mm.yyyy.
Possible formatting strings:
y = Current Year with last 2 digits
yy = Current Year with last 2 digits
yyyy = Current Year as 4 digits
m = Current Month number no-leading 0
mm = Current Month number as 2 digits
mmm = Current Month using short day names (Jan)
mmmm = Current Month using long day names (January)
d = Current Day number no-leading 0
dd = Current Day number as 2 digits
ddd = Current Day using short day names (Sun)
dddd = Current Day using long day names (Sunday)
ddddd = Current Day in short date format
dddddd = Current Day in long date format
. = Current Date separated by "."
Example:
{r}{%date(mm.dd.yyyy)%}{/r}, here SmartSerialMail returns the current date formatted as mm.dd.yyyy,
e.g. 12.24.2012.
Some more examples:
d.m.y = 1.1.12
dd.mm.yy = 01.01.12
ddd d mmm yyyy = Sun 1 Jan 2012
dddd d mmmm yyyy = Sunday 1 January 2012
ddddd = 01.01.2012
dddddd = 01 January 2012
•Time (formatted) {r}{%time(timeformat)%}{/r}:
Defines a placeholder function which returns the current time formatted with the desired time format,
e.g. hh:nn:ss.
Possible formatting strings:
h = Current Hour number no-leading 0
hh = Current Hour number as 2 digits
n = Current Minute number no-leading 0
nn = Current Minute number as 2 digits
s = Current Second number no-leading 0
ss = Current Second number as 2 digits
z = Current Milli-sec number no-leading 0s
zzz = Current Milli-sec number as 3 digits
t = Current time in short time format
tt = Current time in long time format
: = Current time separated by ":"
am/pm = Use after "h" gives 12 hours + am/pm
a/p = Use after "h" gives 12 hours + a/p
ampm = Gives 12 hours as 2 digits for hh and with no-leading 0 for h
Examples: {r}{%time(hh:nn)%}{/r}, here SmartSerialMail returns the current time formatted as
hh:nn, e.g. 01:02.
Some more examples:
hham/pm = 01am
t = 01:02
tt = 01:02:03
hh:nn:ss:zzz = 01:02:03:004
•MD5 Hash {r}{%md5(placeholder)%}{/r}:
Defines a placeholder function which calculates the hash value of a given placeholder using the Message-Digest 5 algorithm.
Example: {r}{%md5({%Email%})%}{/r}, here SmartSerialMail returns the MD5 hash value ensuing from the e-mail address of the current recipient.
|
