Macros
Macros provide reusable logic that can be called from automations.
AlphaWhen to use a macro
Use a macro when the same logic must be called from more than one automation or when a complex operation should have a defined input and output contract.
Definition
A macro has a name, script, input parameter definitions and output definitions. Callers provide parameter values and can use declared outputs after execution.
Parameters
Define only values that must be supplied by the caller. Use clear names and keep the expected value type consistent across call sites.
Outputs
Declare outputs that callers need after the macro completes. An undeclared or unset value should not be assumed to exist.
Usages
The Macros view can identify known callers. Review callers before changing a macro name, parameter or output.
Errors
A macro error is reported to its caller and follows the caller step's error behavior. Use logs and Runtime Inspector to identify the failing call.
Limitations
Changing a macro contract can break existing callers. Public Alpha versions may change script and serialization behavior.