Export Code Type:
Export Code Scope of Action:
Export Code First Added:
Export Code Last 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. where 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.
IMPORTANT: if using ^action()^ in the text of an exporting note (i.e. in $Text), remove all line breaks in the enclosed action code. Otherwise a mis-evaluation will occur as each code line will be treated as an HTML paragraph enclosed in <p></p> tags.