This version is out of date, covering development from v5.0.0 to v5.12.2. It is maintained here only for inbound reference links from elsewhere.

Jump to the current version of aTbRef.

Tinderbox Icon

Macros in Agents (pre v4.6 only) (DEPRECATED)

This pages describes features, codes or syntax whose use is now DEPRECATED, i.e. not advised either for new or continued pre-existing use.

Deprecated aspects of Tinderbox may be supported on a legacy basis but the latter support can't be presumed to be indefinite. Therefore you should update your active TBX documents to latest practice as soon as practical.

As from v4.6, macros in queries are no longer supported. What follows is legacy information.

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

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.

From v4.6, as agents are now action code expressions, there is no longer a need to use the export code style ^do()^ mark-up.


Possible relevant notes (via "Similar Notes" feature):


A Tinderbox Reference File : Agent Queries : Legacy query code (DEPRECATED) : Macros in Agents (pre v4.6 only) (DEPRECATED)