Tag List | Content
Insertion | Expression | Looping | Branching | System
Values | Statistical Functions | Sections
Variables
<?Vr:vName?> ... <?/Vr?>
<?vName?>
<?vName@NumFormat?>
If you have a block of contents that repeats in the same template, you may assign it to a variable using the assignment tag-pair <?Vr:vName?> and <?/Vr?>, where vName is the variable name you provide, under the constraints of the same rules in naming fields. The value assigned can then be inserted repeatedly using the variable-insertion tag above, with or without the NumFormat.
Once a variable value is assigned, it stays constant till its next assignment block, or the next time the same assignment block is run. A variable assignment block is always hidden from the output. To include it, simply follow the block by a variable-insertion tag.
To avoid mistakenly using Mergemill reserved words, such as YearNum, as a variable name, you are advised to begin all variable names with "v", like vMyVariable.
Variables may be included as operands in an expression, and as check values in IF and CASE tags. Please note, however, that a variable name will only be recognized by Mergemill AFTER its assignment block.
<?Hd?> ... <?/Hd?>
These tags mark out a hide section in the template. Nothing in the section will appear in the output. All Mergemill does with the section contents is to create tasks for the new fields found. This enables you to include data feeds that are used only for generating output paths and output file names. By using the hide tags, you may also include comments or whitespaces that you don't intend to show in the output.
Since all contents except field tags in a hide section are ignored by Mergemill, any structure (IF, CASE, and LOOP) and section (email, speech, and variable assignment) that extends partially into a hide section will be broken and causes a template error.
<?Sp?> ... <?/Sp?>
<?Sp-?> ... <?/Sp?>
<?Pause:Count?>
The Sp tag pairs mark out a speech section in the template. An Sp section adds its contents to the speech queue to be spoken by the speech synthesizer of the OS. An Sp- section clears the speech queue first so that the text will be spoken immediately. If you actually wish to turn the entire output to speech, specify the appropriate job output action instead.
You may use the speech tags to add voice alerts to an otherwise silent file output job, or use them to read out emails or web pages. Using Mergemill's auto-run feature, you may also easily create a self-running voice announcement system.
Since Mergemill adds texts to the speech queue much faster than the speech synthesizer speaking them, you will likely hear a continuous piece of spoken text. To slow down Mergemill, you may use the <?Pause:count?> tag, where count is the pause interval in seconds. Count values less than one are not allowed and will default to one second. Please note that this tag does not add a pause between speech texts in the queue, but rather asks Mergemill to wait for a set interval before continuing the job processing. So the pause tag may have other applications as well.
Suppose you want your computer to speak some long pieces of text for 10 seconds each, and pause for 2 seconds in between, you may do this with these tags:
<?Loop?><?Sp?><?[Field_Long_Text]?><?/Sp?><?Pause:10?><?Sp-?> <?/Sp?><?Pause:2?><?EndLoop?>
Please note that there is a space between the Sp- and /Sp tags. You may specify Field_Long_Text to fetch pieces of text from a folder of files, a list of webpage URLs, or emails.
<?EmFrom?> ... <?/Em?>
<?EmTo?> ... <?/Em?>
<?EmCC?> ... <?/Em?>
<?EmBCC?> ... <?/Em?>
<?EmSubj?> ... <?/Em?>
<?EmHTML?> ... <?/Em?>
<?EmText?> ... <?/Em?>
These tags mark out the various sections in the template for outputting to emails.
You may use a field tag to put one email address into the FROM, TO, CC, and BCC sections. Each run of the template will then send one email to the TO recipient, and copy it to the CC and BCC recipients.
Things work a bit differently if you use loop tags to place a list of comma-separated email addresses into the sender and recipient sections. Mergemill picks the first email address in the FROM section as the sender. Each run of the template will send a copy of the email to each of the TO recipients, and copy the same email to the CC and BCC recipients as well. Don't use loops in the recipient address sections if you wish to send out personalized emails.
The SUBJ section contains the subject line. The HTML
section is for the HTML version of the message, where TEXT is for the
plain text version.
[ Top of Page ]
Tag List | Content
Insertion | Expression | Looping | Branching | System
Values | Statistical Functions | Sections
Copyright © 2001-2012 Cross Culture Ltd. All Rights Reserved.