Skip to main content

Single Instance

Always perform an action once

The Single Instance attribute is available when configuring the following actions: Create Item , Output , Call Mesh , Message and Query .

alt text

If Single Instance is enabled or undefined, the action will always be performed once, regardless of whether the previous node outputs one item, many items, or none at all!

This is particularly useful for Call Mesh actions, as it guarantees the Mesh will be contacted, even in schedule workflows that trigger with no input items. Additionally, it means the data of multiple items can be sent in one go, without contacting the Mesh multiple times.

alt text

If Single Instance is explicitly disabled, the action is performed for each input item instead. To do this, you must select the field, disable the checkbox if necessary, and then select Save.

alt text

Example

The workflow below fetches a set of asset items, creates a job for each asset, and then adds those jobs to a new project. By default, the final Create Item action is performed for each input item, so a new project item is created for each job item.

alt text

With Single Instance enabled, the final Create Item action is performed once, for all input items simultaneously. As a result, only one project item is created, with all the jobs added to its Tasks attribute.

alt text