User Tools

Site Tools


token:Variable

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
token:Variable [2015/07/15 05:59]
peternlewis
token:Variable [2023/09/12 23:50] (current)
peternlewis
Line 1: Line 1:
-The //%Variable%// token allows you to include a variable in a token text field. ​ For Example,+===== Variable ​Token =====
  
-Insert Text: Sally said “Hello” to %Variable%First Name%.+The //​%Variable%//​`<​VariableName>​`% token allows you to include a [[manual:​Variables|variable]] in a [[:Text Fields |token text field]], where `<​VariableName>​` is the name of the variable. 
 + 
 +For Example, using the [[action:​Insert_Text|Insert Text]] Action: 
 + 
 +{{ :​token:​km-wiki-insert-text-action.png?​nolink |}} 
 + 
 +You can (v7.2+) access a variable as if it is a comma separated array of text using the notation //%Variable%//​`<​VariableName>​[3]`where 3 can be any [[manual:​Calculations|Calculation]]. ​ You can use a different item separator by putting the text between the ] and % characters, eg //​%Variable%//​`<​VariableName>​[3]:​`%. In v11+, the separator is processed for backslashes,​ so you can use //​%Variable%//​`<​VariableName>​[3]\n`% to get the 3rd line.  Arrays are indexed starting from 1, and index 0 will give the count of the number of items, negative indices will index from the end of the array.
  
 You can also use a short form of just //%Variable Name%// to include variables as long as the variable exists and has a value and there is no corresponding text token, although generally it is better and clearer to use the longer form //​%Variable%Variable Name%//. You can also use a short form of just //%Variable Name%// to include variables as long as the variable exists and has a value and there is no corresponding text token, although generally it is better and clearer to use the longer form //​%Variable%Variable Name%//.
  
 +===== See Also =====
 +
 +- [[:Text Fields]]
 +- [[:Tokens]]
 +- [[manual:​Variables]]
token/Variable.1436954352.txt.gz · Last modified: 2015/07/15 05:59 by peternlewis