The listing below shows those operators where one or more arguments are scoping in nature. This means the argument is trying to pass one or more note item(s) using $Name or $Path data (Lees usual, but supported, is $ID)) or a list of items. The aim of a scoping argument is to set the scope of the action, i.e. limit as to which note(s) are affected by the action.
Some operators support deeper evaluation than others—think of that in terms of how many nested levels of offset address arguments are included, or the number of implicit nested levels of evaluation. The variation might be from an explicit literal string for $Name or $Path, through data stored in an attribute, data stored in an attribute is a different note, to complex action code expressions. This aspect of operators is not well documented. The more complex the intended argument value, the better it is to do a small rest file first to ensure the argument is evaluated correctly before using the same in a large document.
List of such operators:
- $AttributeName[(scope)]
- any(scope, condition)
- avg_if(scope, condition, expressionStr)
- avg(scope, expressionStr)
- changed([scope])
- collect_if(scope, condition, expressionStr)
- collect(scope, expressionStr)
- count_if(scope, condition)
- count(scope)
- createLink(sourceItem, destinationItem[, linkTypeStr])
- delete(scope)
- eachLink(loopVar[,scope]){actions}
- every(scope, condition)
- expand(scope,methodStr)
- find(scope)
- linkedFrom(scope[, linkTypeStr])
- linkedTo(scope[, linkTypeStr])
- linkFrom(scope[, linkTypeStr])
- linkFromOriginal(scope[, linkTypeStr])
- links[(scope)].directionStr.[linkTypeRegex].attributeNameRefStr
- linkTo(scope[, linkTypeStr])
- linkToOriginal(scope[, linkTypeStr])
- list.select()
- neighbors(scope, distanceNum[, linkTypeStr])
- neighbors2(scope, distanceNum[, linkTypeStr])
- neighbors2Within(scope, distanceNum[, linkTypeStr])
- neighborsWithin(scope, distanceNum[, linkTypeStr])
- originalLinkedFrom(scope[, linkTypeStr])
- originalLinkedTo(scope[, linkTypeStr])
- select()
- select(scope)
- sum_if(scope, condition, expressionStr)
- sum(scope, expressionStr)
- unlinkFrom(scope[, linkTypeStr])
- unlinkFromOriginal(scope[, linkTypeStr])
- unlinkTo(scope[, linkTypeStr])
- unlinkToOriginal(scope[, linkTypeStr])
- update(scope)
- values([scope, ]attributeNameStr)
See also—notes linking to here: