This version is out of date, covering development from v4.6.0 to v4.7.1. It is maintained here only for inbound reference links from elsewhere.
Jump to the current version of aTbRef.
|A Tinderbox Reference File : Objects & Concepts : Rules||aTbRef Site Map|
A Rule is an action, much like an agent action, but while agents act on other notes a Rule acts on it own note (and only that note).
Rules are actions attached to notes and containers. Agents may have rules.
Rules are run periodically, and change the note's attributes. For example, suppose we have a Boolean attribute called Urgent. A note might have a rule
...meaning, "this note is urgent if any of its immediate children are urgent."
Another rule might be
...meaning, "this note is urgent if its parent is urgent."
Given that rules run periodically, Tinderbox will eventually enforce each rule, although there may be a delay between a change made to one note and its impact throughout the document depending on the agent update (cycle) time, i.e. in complex TBXs the update time may be a little slower.
Notice, too, that contradictory rules can be written; this may lead to constant changes in the document and should be avoided.
Agents can have rules and this is especially useful for highlighting agents under specified circumstances (e.g. if UrgentTasks isn't empty, or if ThingsToDo find more than seven tasks in your inbox).
Like actions, rules may use simple arithmetic and logical expressions as well as action code functions.
If there are a lot of rules running, especially if complex ones, it is a good idea to use a logical OR (|=) rather than a normal assignment (=). The |= method ensures the rule is only run if the left side equates as empty. An alternate solution is to use a Boolean 'guard' attribute and an if() test to ensure the running of the rule is controlled. This is a specimen such Rule:
Note how the rule only runs if ShouldRun is true and that once the run is run, ShouldRun is set to false. This allows for some other action or rule to reset ShouldRun and allow the rule to run noe more time.
|Up: Objects & Concepts|
|Previous: Actions||Next: Prototypes|
Licensed under Creative Commons Attribution-Noncommercial-Share Alike 3.0 License
[See aTbRef CC licence Attribution/Waiver info info]