Tinderbox 8 Icon

originalLinkedFrom(designator[,linkType])


Operator Type: 

Operator Scope of Action: 

Operator Purpose: 

Operator First Added: 

Operator Altered: 

 Function   [other Function type actions]

 Item   [operators of similar scope]

 Query Boolean   [other Query Boolean operators]

 

 


originalLinkedFrom("item"[,linkType])

Returns true if the current note corresponding to this is linked from a designated item or group of items; this is optionally filtered to only links of type linkType. Put another way, "Does an inbound link exist to the original current note from 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 parameter 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 note using the 'Event' prototype has an inbound link of the 'untitled' link type the agent query would be:

$Prototype=="Event" & linkedFrom("*", "*untitled") 

This replaces the legacy #linkedFrom query operator.

The logical opposite of this test is originalLinkedTo().



A Tinderbox Reference File : Actions & Rules : Operators : Full Operator List : originalLinkedFrom(designator[,linkType])