Iterative tags, or looping tags, start with <<@. These tags process all text starting immediately after the tag until immediately before a corresponding <<@end>> tag for each object in a set. The resulting blocks of text are filtered for macros based on each object and the text is appended to the results. The set of objects is usually defined by a filter results set. The result will be a block of text being filtered and inserted into the notification for each filter result hit.
Iterative blocks can be nested. When doing so, care should be taken to make sure each start marker has a correctly placed end marker.
|
Tag |
Description |
|---|---|
|
<<@AttributeName.elementEncode>> |
The code will insert the attribute value and will encode it using standard HTML encoding. |
|
<<@@>> |
<<@@>> is a special case of an iterative tag. In the case of a timer triggered notification, there is often is a logical reference to filter results that were obtained as part of the notification's condition test. To iterate over this result set, the <<@@>> tag is used (with the required <<@end>> tag to mark the end of the block.) Example: <<@@>> <<Attribute>> <p> <<@End>> |
|
<<@~FilterName>> |
Runs the filter independent of objects and allows you to pull values from the specified filter. Example: <<@@>> <<@~FilterName>> <<@End>> When the filter macro is used to generate a recipient list (in the TO, CC, or BCC fields), it needs to be formatted with no line feeds and have a comma after the attribute name, which contains the email addresses of the recipients. Example: <<@~FilterName>><<Attribute>>;<<@END>> |
|
<<@FilterName>> |
Calls the specified filter. In order to successfully use this option, you must also specify the attributes for which you want values displayed in the following format: <<ClassName.AttributeName>> You can use HTML to format the values into a table. Example: <<@@>> <<@FilterName>> <<@End>> When the filter macro is used to generate a recipient list (in the TO, CC, or BCC fields), it needs to be formatted with no line feeds and have a semicolon after the attribute name, which contains the email addresses of the recipients. Example: <<@FilterName>><<Attribute>>;<<@END>> |