article

When the Create Tokens activity receives an incoming token, it will create one or more new tokens and automatically send them to a different activity or sub flow (referred to here as the destination activity). This activity is similar to the Run Sub Flow activity, except this activity does not hold on to the entering token once the created tokens are released. This activity is also not restricted to only sending tokens to a sub flow or Start activity. Tokens can be created in any activity to include activities in other General Process Flows.

Consider reading Sub Process Flows for more in-depth information about:

• How Sub Flows Work
• Creating Internal Sub Flows
• Creating External Sub Flows
• Linking to Sub Flows
• Multiple Start or Finish Activities

When this activity is first created, a red exclamation mark shows up to the right of the activity notifying you that a link to another activity or Process FlowSub Flow object is required for this activity to function. This link may be a direct pointer which can be created by clicking on the exclamation mark and then clicking on an activity or Sub Flow object, or the reference may be dynamic by setting the value for the Destination property.

Connectors

The Create Tokens activity can have any number of connectors out. Created tokens will exit this activity based upon the Destination. The entering token will always exit through the first connector out (or the next activity if part of a stacked block). See Adding and Connecting Activities for more information.

Properties

The following image shows the available properties for the Create Tokens activity:

Each of these properties will be explained in the following sections.

• Name You can change the name of the activity using the Name box. See Name for more information about this property.
• Font The Font button opens a window to edit the activity's background color and font properties. See Font for more information about this property.
• Statistics The Statistics button opens the activity's statistics window. See Statistics for more information about this property.
• Destination Indicates the destination activity that the newly created tokens will be automatically sent to. This can be the index of a connector, a connector name, or an activity. Unlike the Run Sub Flow activity, the destination is not restricted to being a Start activity or a Sub Flow. This activity can send the newly created tokens to any activity, whether it be in a sub flow, a General process flow, or any activity in the same process flow. See Linking to Sub Flows for information about linking to a sub flow from this property.
• Quantity The number of tokens that will be created every time the Create Tokens activity receives an entering token.
• Create AsDefines the relationship of the original token to the created token(s).
  • Independent Tokens - Created tokens will have no association with the original token.
  • Child Tokens - Created tokens will be child tokens of the original token.
  • Sibling Tokens - Created tokens will be sibling tokens of the original token. In other words, they will have the same parent as the original token.
• Label AccessFor information on Label Access, see the Label Access section of the Sub Process Flows page.