Keyboard Maestro Wiki

User Tools

Site Tools

Trace: • Path • ICUDateTime • Set_Variable_to_Text
action:Set_Variable_to_Text

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
action:Set_Variable_to_Text [2017/07/15 15:50] – Fix error in dynamic variable per @peternlewis JMichaelTXaction:Set_Variable_to_Text [2023/09/15 09:44] (current) – peternlewis
Line 2: Line 2:
  
 The Set Variable to Text action allows you to set a selected variable to plain text, by either typing in the text box, or selecting a [[:Tokens|Token]]. The Set Variable to Text action allows you to set a selected variable to plain text, by either typing in the text box, or selecting a [[:Tokens|Token]].
 +
 +Alternatively (v9.0+), you can Prepend the text to the variable, or Append the text to the variable by selecting from the action (gear) ⚙ menu.
  
 {{:action:set-variable-text-token-popup.png?nolink|}} {{:action:set-variable-text-token-popup.png?nolink|}}
  
----+You can (v11.0+) set a specific array entry within the action. You can delete the entry by setting it to `%Delete%`.
  
 ===== Examples ===== ===== Examples =====
 +
 ==== Set To Text You Type ==== ==== Set To Text You Type ====
  
Line 23: Line 26:
  
 ==== Combine Multiple Variables and Text ==== ==== Combine Multiple Variables and Text ====
 +
 There is no need to use any operators when combining text with multiple variables or other tokens.  Just enter the text and variables/tokens as you would like them to appear in the Variable being set by this Action. There is no need to use any operators when combining text with multiple variables or other tokens.  Just enter the text and variables/tokens as you would like them to appear in the Variable being set by this Action.
  
 {{:action:set-variable-text-combine-var.png?nolink|}} {{:action:set-variable-text-combine-var.png?nolink|}}
  
----+==== Append to Variable ==== 
 + 
 +You can append directly to a variable with the //Append// variant of the action: 
 + 
 +{{append-variable-with-text.png?nolink&512x157| Append to Variable }} 
 + 
 +or equivalently using text tokens to expand the variable: 
 + 
 +{{set-append-variable-with-text.png?nolink&512x157| Set Append to Variable }} 
 + 
 +==== Set Second Line of Variable ==== 
 + 
 +You can specify an array entry of the variable to set. By default, entries are comma separated, but you can specify an specific separator after the closing square bracket (`]`), 
 + 
 +{{ set-second-line-of-variable-example.png?nolink&512x310 | Set Second Line of Variable Example }}
  
 ===== Setup ===== ===== Setup =====
Line 59: Line 77:
  
 **This requires two steps (two Actions):** **This requires two steps (two Actions):**
-  - //Set Variable to Text Action// (this action) to dynamically determine a standard variable token based on one or more variables, which optional text.+ 
 +{{:action:set-variable-text-dynamic-var.png?nolink|}} 
 + 
 +**The Steps Are** 
 +  * **STEP 1.**\\  //Set Variable to Text Action// (this action) to dynamically determine a standard variable token based on one or more variables, which optional text.
     * In the text area of the Action, enter a special form of the Token entity, where you will embed another Variable token, and optionally text.     * In the text area of the Action, enter a special form of the Token entity, where you will embed another Variable token, and optionally text.
     * For example: `%%Variable%%myVar%Variable%myVarNum%%%`     * For example: `%%Variable%%myVar%Variable%myVarNum%%%`
       * Note the use of two percent symbols (`%%`) in places where you want the result to be one `%`.       * Note the use of two percent symbols (`%%`) in places where you want the result to be one `%`.
-      * Here is how this text will be processed when the Action executes: <code>+      * Here is how this text will be processed when the Action executes:\\  .<code>
 %%Variable%%myVar%Variable%myVarNum%%% %%Variable%%myVar%Variable%myVarNum%%%
  
Line 77: Line 99:
 %Variable%myVar2% %Variable%myVar2%
 </code> </code>
-    * This is the variable we want to get the results of, so we will need another Action to get it. +    * This is the variable we want to get the results of, so we will need another Action to get it.\\     
-  - [[action:Filter_Variable|Filter Variable Action]] using the //Process Tokens// option. +  * **STEP 2.**\\  [[action:Filter|Filter Action]] using the //Process Tokens// option.
- +
-{{:action:set-variable-text-dynamic-var.png?nolink|}} +
- +
----+
  
 ==== Dynamic Determination in Variable Name Block ==== ==== Dynamic Determination in Variable Name Block ====
 +
 Since the Variable Name block of the //Set Variable to Text// Action accepts tokens, we can just use it directly if we just need to concatenate two more more Variables, with optional text. Since the Variable Name block of the //Set Variable to Text// Action accepts tokens, we can just use it directly if we just need to concatenate two more more Variables, with optional text.
   * For example: `%Variable%myPrefix%%Variable%myFieldName%`   * For example: `%Variable%myPrefix%%Variable%myFieldName%`
Line 94: Line 113:
 ===== See Also ===== ===== See Also =====
  
----- +==== Actions ====
- +
-=== Actions ===+
  
 +* Prepend Text to Variable
 +* Set Variable to Text
 +* Append Variable with Text
 * [[action:Set Variable to Calculation|Set Variable to Calculation]] * [[action:Set Variable to Calculation|Set Variable to Calculation]]
 * [[action:Set Variable to Keychain Password|Set Variable to Keychain Password]] * [[action:Set Variable to Keychain Password|Set Variable to Keychain Password]]
Line 103: Line 123:
 * [[:Actions|See all Actions]] * [[:Actions|See all Actions]]
  
----- 
 ==== Forum ==== ==== Forum ====
  
action/Set_Variable_to_Text.1500133813.txt.gz · Last modified: by JMichaelTX
Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki