This version is out of date, covering development from v9.5.0 to v9.7.3. It is maintained here only for inbound reference links from elsewhere. It is no longer actively updated.

Jump to the current version of aTbRef

Tinderbox v9 Icon

originalLinkedTo(scope[, linkTypeStr])


Operator Type: 

Operator Scope of Action: 

Operator Purpose: 

Operator First Added: 

Operator Last Altered: 

Operator Uses Scoped Arguments: 

Operator Has Optional Arguments: 


originalLinkedTo(scope[,linkTypeStr])

A test for outbound links. This returns true if the current note corresponding to this is linked from the designated scope, i.e. an item or group of items (defining scope); this is optionally filtered to only links of type linkTypeStr. Put another way, "Does an outbound link exist from the original current note to item(s)?". This is especially useful in agents, where this is bound to an alias owned by the agent but the user is interested in links to the original note.

This is effectively only a query term, it returns a Boolean. If you are trying to collect data about the linked note(s), use links() instead.

Ways to define item. The item argument must be quoted unless an attribute reference, e.g. "Some note" vs. $MyString.

Ways to define group. In group scope, a wildcard "*" designator matches all notes and replaces the normal "all" group designator.

Links of type 'prototype' are ignored. If using linkType, you must use the value "*untitled" to match an 'untitled' type link (rather than "" or "untitled").

Thus, to test if any original note using the 'Event' prototype has an outbound link of the 'untitled' link type the agent query would be:

$Prototype=="Event" & originalLinkedTo("*", "*untitled"); 

The logical opposite of this test is originalLinkedFrom().