subflow - run nested workflow

Note

This article is about a specific action.
On how to call actions in general, refer to Calling actions.

Overview

This action executes and independent workflow as a natural step. Failure criteria for the step are the same as for any workflow: some action failed, workflow source file not found, etc.

Parameters

Name	Type	Description
path	string required	Path to the workflow definition file.
context	mapping optional keys: string values: any	Context mapping to be merged into the workflow. Merging is recursive: when both workflow and parameter-provided context fields on a certain level are mappings, the result is them combination of them, giving preference to the parameter-provided value. Otherwise, parameter-provided value prevails.

Outcomes injection

If a nested action yields an outcome, the subflow action itself also produces an outcome with the same value, but in a nested namespace:

[main workflow]
  ├─> [subflow "MySubFlow"]
  │     └─> [action "NestedAction"] ─> (yields "foo"="bar")
  └─> (may refer to "out.MySubFlow.NestedAction.foo", which equals "bar")