actions

Send Report > Battery Level Report

The "Send Report > Battery Level Report" action will send a complete battery level report (for Z-Wave devices only) to the specified email address. You can send the report to multiple addresses (separate each address with a comma) and the "Email Address" field supports Indigo substitutions. For example, if you have the target email address in an Indigo variable, the substitution string would be %%v:12345678%% (replace the number with your variable's ID.)

Modify Numeric Variable

The "Modify Numeric Variable" action item is used to change the value of an Indigo variable based on a mathematical formula. The variable value must be a real number and the formula must use one or more of the following arithmetic operations:

• Addition (+)
• Subtraction (-)
• Multiplication (*)
• Division (/)
• Exponents (**)

Example 1:

Value = 13
Formula = * 2 + 1
Result = 27

Example 2:

Value = 16
Formula = **2
Result = 256

The Formula field also supports Indigo substitutions. Therefore, constructions like the following are also possible:

Example 3:

Value = 1
Formula = + %%v:12345678%% (where the value of the referenced variable is 5).
Result = 6

Example 4:

Value = 1
Formula = + %%d:12345678%%:slider_value%% (where the value of the referenced device state is 75).
Result = 76

The "Modify Numeric Variable" action item was added with v1.0.26 of the plugin.

Modify Time Variable

The "Modify Time Variable" action item is used to change the value of Indigo variables that have a POSIX timestamp format. In other words, the plugin is expecting the value of the variable to match this format:
2019-11-20 13:14:15.123456 Any other time or date format will not be accepted.

You can indicate whether you would like the modifiers to be added to or subtracted from the variable value. The default modifier is addition.

You can indicate the days, hours, minutes, and seconds that you want to use to modify the initial variable value.
For example, selecting an 'Add' modifier and entering an hours value of 1, will increase the variable value by 1 hour.

Example 1:

[Add]
Days = 0
Hours = 1
Minutes = 0
Seconds = 0

Initial Value: 2019-05-26 02:57:24.974913
Result: 2019-05-26 03:57:24.974913

Example 2:

[Subtract]
Days = 1
Hours = -1
Minutes = 0
Seconds = 0

Initial Value: 2019-05-26 02:57:24.974913
Result: 2019-05-27 01:57:24.974913

The "Modify Time Variable" action item was added with v1.0.26 of the plugin.

Network Quality Report

The "Network Quality Report" action item executes the Network Quality Report plugin menu item. This action is provided as a convenience in instances where you want to run the menu item report based on a schedule or other event. The results of the text are output to the Indigo Events log, and are not retained.

Update Network Quality Device

The Update Network Quality Device action item is required in order to cause any configured Network Quality Devices to update their states.

Test Action Return

The "Test Action Return" action is an action that can be used to test a call to a plugin action and test reply values to that call (the "Test Action Return" action is hidden in Indigo's UI, so it won't appear in Action menus). It is intended for testing code and is not useful in a day-to-day environment.

The action expects a return_value parameter which designates the type of return you want to receive: None, int, float, str, tuple, dict, or list.

A note about collections: by definition, any collections returned as a result of an indigo.executeAction call will either be an indigo.Dict or indigo.List. As a result, a call for a tuple return value will return an indigo.List object.

Call Using indigo.executeAction:

Calling the "Test Action Return" action from code is straightforward:

plugin_id = "com.fogbert.indigoplugin.multitool"
plugin = indigo.server.getPlugin(plugin_id)
reply = plugin.executeAction("test_action_return", props={'return_value': 'dict'})
indigo.server.log(f"{reply}")

See the Indigo documentation for more information on using the indigo.executeAction command.