Escaping characters
- Last UpdatedDec 06, 2023
- 1 minute read
Escaping is when you mask one or more characters to prevent the engine from considering them keywords.
Some examples that may require escaping:
-
Writing an email address that contains the @ symbol.
-
Patching a field with a conditional or a mathematical assignment, but preventing field evaluation before applying the patch.
Resolving escape tags
All escaping tags but [‘] are eliminated whenever the string value is resolved. This could be in setfields, inside commands, or in route value assignments.
The [‘] syntax is resolved only when the string appears on screen. That is, when it is assigned to node fields such as text, displayName, displayValue. Or, if the string value is resolved and the tag is enclosed within a "screen resolve" tag [T...]. This forces the screen resolve on any value resolution phase.
Escape codes
Some examples for using escape characters.
|
Mode |
Escape code |
Example |
|---|---|---|
|
Single character |
\ |
<createroute from="thisNode.field" to="thatNode.field" value="true" condition="[R\[\@thisNode.field.elementAt([@%0%])\]==true]" /> |
|
Text |
' … ' |
<patch name="aItem" displayValue="'[?@aItem.value@==0,CLOSED,OPEN]'" /> |
|
Text (screen resolve) |
[‘...] |
<setfield name="myText2D.text" value="That[‘’]s right!" /> |
|
Screen Resolve |
[T...] |
<setfield name="plainTextVar.value" value="[TThat[‘’]s right!]" /> |