Code Type:
Code Scope of Action:
Code First Added:
Code Altered:
^action( action )^
This code performs any action, or list of actions, that could be performed by an agent or rule. For simplicity, consider it as if it were a rule that is only run when a note is exported using the template holding the ^action()^ code.
The action code is performed immediately. ^action^ does not export anything itself. For example:
^action($Color="red")^ ^value($Color.format())^
will change the colour of the exported note to "red" and export "red".
This allows manipulations for export use without needing to, for instance, hold the value in a user attribute first.
Also see, action(), ^value( expression )^.
The internal equivalent is a normal action/rule statement, i.e. there is no point in using ^action^ internally. However, if you want some logic during export to change an internal attribute value (e.g. exported notes having a new colour), then use ^action^ in the context of your export codes.