Run a chain within another chain

To run an existing chain as part of another chain, add a Run Chain event. With this event, you can use chains independently or as modular components within other chains. When you run a chain as a Run Chain event, you can use its output with a later command in the parent chain.

Note: If you include multiple Run Chain events in a chain and need to pass variables between chains, start the later chain with a Runtime Input trigger event.

Step 1. Add the event to the chain

1. In Chain Builder, from the Chains  device_hub tab, click Edit  create for the chain.
2. Click Chain Events  event, and move Run Chain  device_hub to where the event should occur in the chain.
3. Drag a link to the event from its preceding node.

Step 2. Set up the chain to run

1. Select the event's node, and click Edit  create.
   
2. Under Basic Info, enter a unique name and description to help identify the event.
3. To run the chain repeatedly within the other chain, enable Iterations, and set up the iterator.
4. Select the chain to run.

Step 3. Add a skip condition (if necessary)

To run the chain based on branching logic, you can set up a skip condition and automatically return a specific result.

1. Under Skip skip_next, choose whether to automatically return a result of info  check_circle, warning  warning, or error  error for the event's chain when skipped.
   
2. To specify when to skip the event, build the conditional logic as a group you add rules and other groups of rules to, each joined with an AND or OR.
   • If all conditions must be true to skip, select AND.
   • If only one condition must be true, select OR.
     
     
   You can add rules based on various data types:

   Data Type	Description
   String	Two or more characters
   Integer	Any whole, non-decimal numeric value
   Date	Any date string or Date variable
   Float	Any numeric value
   JSON	JavaScript Object Notation; use Variable Transformation to parse objects

   To verify whether data meets the criteria to skip the command, pair it with an operator and value:
   • Is blank or Is not blank
   • Contains
   • Matches RegExp, for regular expression
   • Starts with or Ends with
   • = or !=
   • < or >
   • <= or >=
3. Click Save.

Note: Before you promote the parent chain to another environment, ensure the chain run by the event exists in that environment.