Differences

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

--- token:MacroNameForUUID [2015/07/15 10:39] – created peternlewis
+++ token:MacroNameForUUID [2017/09/07 04:14] (current) – peternlewis
@@ Line 1: / Line 1: @@
-The //%MacroNameForUUID%**uuid**%// token returns the name of the macro or macro group with the specified **UUID**.  If the macro does not exist, then this will return the empty string so you can use it as a simple test for the existence of a particular macro.
+====== MacroNameForUUID Token ======
+This [[:Tokens|token]] returns the name of the macro or macro group with the specified **UUID**.  If the macro does not exist, then this will return "Not Found" so you can use it as a simple test for the existence of a particular macro.
+===== How To Use =====
+==== General Form ====
+**The general form of this token is**:\\
+`%MacroNameForUUID%<UUID>%`\\
+where `<UUID>` is the explicit Macro Universal ID, like "4ADD4CEB-D07C-4095-B06B-D01C48E3D82C"
+You can put this token in any [[:Actions|Action]] that has a text field, like a [[action:Display_Text|Display Text Action]] or a [[action:Set_Variable_to_Text|Set Variable To Text Action]], like this:
+{{:token:km-7.2-macronameforuuid-action.png?nolink|}}
+==== Using with a Variable ====
+**However, if you want to use the UUID that is in a Keyboard Maestro Variable**, then it will require two Actions, because this token does not directly support the use of Variables:
+  - Set a Variable to the MacroNameForUUID token with a Variable token for the UUID, as text, so that the MacroNameForUUID token is not evaluated, but the Variable token is evaluated
+      * For example:\\  `%%MacroNameForUUID%%%Variable%myUUID%%%`
+      * When the Action is executed, the Variable will be:\\  `%MacroNameForUUID%4ADD4CEB-D07C-4095-B06B-D01C48E3D82C%`
+  - Filter that Variable to process the token, now that the Variable has been evaluated.
+{{:token:km-7.2-macronameforuuid-with-var.png?nolink|}}
+The result of these Actions is:
+{{:token:km-7.2-macronameforuuid-results.png?nolink|}}
+===== See Also =====
+==== Actions ====
+* [[action:Filter|Filter]] (Process Text Tokens)
+* [[:Actions|See all Actions]]
+=== Tokens ===
+* [[token:ExecutingMacro|%ExecutingMacro%]]
+* [[token:ExecutingMacroGroup|%ExecutingMacroGroup%]]
+* [[token:ExecutingMacroUUID|%ExecutingMacroUUID%]]
+* [[token:ExecutingThisMacro|%ExecutingThisMacro%]]
+* [[token:ExecutingThisMacroGroup|%ExecutingThisMacroGroup%]]
+* [[token:ExecutingThisMacroUUID|%ExecutingThisMacroUUID%]]
+* [[:Tokens|See all Tokens]]
+==== Forum ====
+- [[https://forum.keyboardmaestro.com/t/macro-get-selected-macro-uuid-and-name-without-the-clipboard/4330|MACRO: Get Selected Macro UUID (and name) (without the clipboard)]]
+- [[https://forum.keyboardmaestro.com/search?q=MacroNameForUUID|Keyboard Maestro Forum topics about MacroNameForUUID]]