User Tools
token:ActionResult
Differences
This shows you the differences between two versions of the page.
| Next revision | Previous revision | ||
|
token:ActionResult [2015/07/15 06:19] peternlewis created |
token:ActionResult [2021/10/14 05:06] (current) peternlewis |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | The //%ActionResult%// token returns the success or failure of the immediate past action. | + | ====== ActionResult Token ====== |
| - | Note that this value is reset at the end of every action, so you must immediately text it or save it into a variable if you wish to preserve it. For example: | + | The **%ActionResult%** token returns text indicating the success or failure of the immediate past action. |
| + | |||
| + | If the immediately past action was successful, then “OK” is returned, otherwise, a message describing the reason for failure is returned. | ||
| + | |||
| + | ===== How To Use ===== | ||
| + | |||
| + | Note that this value is reset at the end of every action, so immediately after the Action, you must save the //[[token:ActionResult|%ActionResult%]]// token [[action:Set_Variable_to_Text|into a variable]], or use it in a control flow action, like a [[action:If_Then_Else|If/Then Action]]. | ||
| + | |||
| + | You can use this token for error handling, much like a traditional try/catch/on error construct. But you have to build your own test immediately after the action. Keyboard Maestro will **not** throw an error in most cases. | ||
| + | |||
| + | ===== Examples ===== | ||
| + | |||
| + | **Example #1** | ||
| * Action that Might Fail | * Action that Might Fail | ||
| + | * You may need to disable (uncheck) the Action Option for "Timeout Aborts Macro" | ||
| + | * You may want to change the timeout interval in the Option for "Set Action Timeout..." | ||
| * Set Variable “Reason” to text %ActionResult% | * Set Variable “Reason” to text %ActionResult% | ||
| - | or | + | **Example #2** |
| * Action that Might Fail | * Action that Might Fail | ||
| * If Text %ActionResult% is “Whatever” | * If Text %ActionResult% is “Whatever” | ||
| + | |||
| + | **Example #3** | ||
| + | |||
| + | Test if the [[action:Copy|Copy Action]] failed due to timeout (likely due to no selection) | ||
| + | |||
| + | {{:token:km-7.1-copy-options.png?nolink|}} | ||
| + | |||
| + | {{:token:km-7.1-test-action-result.png?nolink|}} | ||
| + | |||
| + | ===== See Also ===== | ||
| + | |||
| + | ---- | ||
| + | |||
| + | ==== Actions ==== | ||
| + | |||
| + | * [[action:Copy|Copy]] | ||
| + | * [[action:If Then Else|If Then Else]] | ||
| + | * [[action:Set Variable to Text|Set Variable to Text]] | ||
| + | * [[:Actions|See all Actions]] | ||
| + | |||
| + | ==== Tokens ==== | ||
| + | |||
| + | * [[:Tokens|See all Tokens]] | ||
| + | |||
| + | ---- | ||
| + | |||
| + | ==== Manual ==== | ||
| + | |||
| + | * [[:manual:Tips#Pay Attention to the Gear Icon|Pay Attention to the Gear Icon]] | ||
| + | |||
| + | ---- | ||
| + | |||
| + | ==== Forum ==== | ||
| + | |||
| + | - [[https://forum.keyboardmaestro.com/search?q=ActionResult|Keyboard Maestro Forum topics about %ActionResult% token]] | ||
| + | ==== Keywords ==== | ||
| + | |||
| + | Action Result, Action Results, Action Failure, Action Success | ||
token/ActionResult.1436955588.txt.gz · Last modified: 2015/07/15 06:19 by peternlewis
Page Tools
