Action rule keyword expansion

You can include actual field values from the current log file being processed by the action rule. You can also perform directory lookups based on names in such field values, and retrieve values such as a manager’s name or email address for a name.

To include such field values, include the fieldname surrounded by:

Example

The start of each chat is stored in a field named ChatStart in each chat log document. To include the value of this ChatStart field, use {%ChatStart%} in your custom text, like so:

Chat started at {%ChatStart%}

Multi-value handling

If the field name you specify contains multiple values, they will be concatenated using a comma.

Example

The list of chat participants is stored in a field named ListUserNames. Using {%ListUserNames%} will return the names of the chat participants concatenated like so:

CN=John Taylor/O=Instant/C=US, CN=Peyton McManus/O=Instant/C=US

You can use the list subscript operator [ ] to refer to a specific element in a multi-value field. A subscript consists of a numeric value in square brackets, like [0] .

The first element of a list is subscript [0] .

A subscript less than [0] or greater than the number of elements in the list will return an empty string.

Example

If the multi-value field ListUserNames contains these two names:

CN=John Taylor/O=Instant/C=US
CN=Peyton McManus/O=Instant/C=US  

{%ListUserNames[0]%}  returns "CN=John Taylor/O=Instant/C=US"
{%ListUserNames[1]%}  returns "CN=Peyton McManus/O=Instant/C=US"
{%ListUserNames[2]%}  returns ""
{%ListUserNames[-1]%} returns ""

Abbreviated name formatting

To format names in abbreviated mode, use $ instead of %

Example

If you include the field name {$ListUserNames$}, the list of all user names will be abbreviated like so:

John Taylor/Instant/US, Peyton McManus/Instant/US

GMT time zone conversion for date-time fields

To normalize date-time field values into GMT, use # instead of %

If you include the field name {#ChatStart#}, the date-time value will be converted to GMT time zone and suffixed with “GMT”.

Directory Lookup processing

NEW in Instant IMtegrity 9.1

Keywords can now be expanded to perform lookups in Directories to retrieve values such as a user’s internet address, domain, manager name, etc. by appending the field name prefixed with a colon, like :internetAddress

Example

To lookup the value of the internetAddress field in the IBM Domino Directory for the first user in the ListUserNames item, use this syntax:

{%ListUserNames[0]:internetAddress%}

Miscellaneous

You can refer to non-names fields using the $ instead of the % char; the results will be the same. The only difference between $ and % is that fields of type Reader, Author or Names will be abbreviated if $ is used.

You can refer to non-datetime fields using the $ instead of the # char; the results will be the same. The only difference between $ and # is that DateTime fields are normalized from the local timezone to GMT if # is used.

If the field name specified does not exist in the chat log document, it will be replaced with an empty string.

Example

If you use The {%Lazy%} Dog in your custom text, the actual text will be just The Dog because the field “Lazy” does not exist in the chat log documents.