Macros in Agents

Macros can be useful in agent queries.

A macro that evaluates to a Boolean value may be evaluated in a query. For example, consider the macro

Macro: IsUrgent

Prototype="Task" & DueDate>"today-1 week" & Done=false

An agent may search for the query

^do(IsUrgent)^

the macro will be expanded and evaluated, Previously, the macro was expanded but not evaluated.

Macros can also be used in actions. Note however that the caret syntax ^do()^ is required in agent queries; conversely in actions it is not used, i.e. just do(). A little confusing is the fact that if statements in action do require the carets, until you realise that the method is evaluating a query (q.v.). Thus:

• In an export template, ^do(this) is a macro.
• In a query, ^do(this)^ is a macro, and do(this) searches the attribute "do" for the string "this".
• In an action:
  • if(^do(this)^) {...} calls a macro
  • if if(do(this)){...} does a regular expression test
  • do(this) calls a macro

Licensed under Creative Commons Attribution-Noncommercial-Share Alike 3.0 License
[See aTbRef CC licence Attribution/Waiver info info]