Macro Syntax Brackets#
Macros can have any of the following markup:
{{
and}}
indicate macros that resolve to single values. The value can also return an object. A direction parameter is also available for hierarchy searching. This is indicated by
||
. Refer to the topic on SELECT-FROM-WHERE type macros for details.Any number of single opening and closing brackets (
{
and}
) can also occur inside these scalar macros.{#
and#}
indicate macros that resolve to lists of values.
{%
and%}
indicate macros that resolve to dictionaries
((
and))
indicate macros that test for a condition are enclosed in round brackets (( and )) - these macros evaluate to True or False
The comparison operators that are available for these macros are:
==, !=, <, >, <=, >=
.The ‘SELECT FROM WHERE’ operator can be used in a test is
|
, for example:(( data.User.username | username:John == 'John' )) <true> <false>
See also ‘SELECT FROM WHERE’-type macros below.
It is highly recommended to use named macros for things in this case, in other words, instead of:
(( data.User.username | username:John == 'John' )) <true> <false>
use:
MY_USER = {{ data.User.username | username:input.username }} (( macro.MY_USER == input.username )) <true> <false>
The WHERE clause can also contain a logical AND, represented by a comma (
,
), for example:(( device.cucm.Line.pattern | pattern:pwf.PassedLine.pattern, routePartitionName:pwf.PassedLine.routePartitionName == '' ))
Similarly, the test condition can contain a logical AND, for example:
(( fn.list_contain macro.GS_CLIMaskANANumberType_MCR,macro.GS_CLIMaskANAGetAllowedTypes_MCR == true ))
((test)) <if value> <else value>
IF ELSE type conditional macro.
((test)) <value> ((test)) <value> <value>
IF ELSEIF ELSE-type macros combine tests and result values if the test resolves to True or False. The logic is IF (test) THEN <value> ELSE IF (test) THEN <value> ELSE <value>.
Example:
((self.a == self.b)) <foo-{{CallManager.host}}> ((self.b == self.c)) <foo-{{CallManager.username}}> <foo-{{CallManager.version}}>
This macro tests for the equality of values in a calling model (referenced by ‘self’) and returns an evaluation for the condition that is True. The evaluation refers in dot notation to attributes of a Data Model called ‘CallManager’ and concatenates the result with a string ‘foo-‘.
‘SELECT FROM WHERE’-type macros returning single-, dictionary- and list type values and can take parameters.
The format is:
{{ SELECT FROM | WHERE }}
{% SELECT FROM | WHERE %}
{# SELECT FROM | WHERE #}
These types and their parameters are illustrated in the topic on ‘SELECT FROM WHERE’ Macros: SELECT FROM WHERE Macro Syntax.