Split step

1. From the Toolbox click the Logic category then click and drag the Split step onto the canvas.
   
2. Select the added step and click the expand / collapse toggle to expand the Configuration Panel. You can also double click the step to expand the panel.
   
3. In this example, Task and Decision steps are used to configure the actions and outcomes.
4. Click and drag the Approved line from the Decision step to the Split step to connect them. The orange dots are ports and in this case represent the split parallel paths.
   
When you configure a Split step, yellow dots show on the step. These yellow dots are known as "ports". Typically, you would connect a line to a port to define the workflow's 'flow'. Ports are used to connect incoming lines as well as outgoing lines. A step has a maximum of 12 ports. When you configure a step, keep the 12-port limit in mind; you can use up to 12 ports to connect to and from the step. If you created more than 12 paths in the Split step, you won't be able to connect all of the paths in the step since there is a maximum of 12 ports in total.
You need to cater for both incoming and outgoing lines, and make sure the total does not exceed 12 ports. For example: If you connect one incoming line from another step, 11 of the 12 ports are still available for connecting outgoing lines. If you connect two incoming lines, 10 ports are still available for outgoing lines.

5. Select the Split step and expand the Configuration Panel.
   
6. Select the Paths tab. From here edit the path names, add additional paths, and configure the logic and rules for the paths.
   

The table below explains the options available on this tab within the Paths section:

Option	Explanation	How to Use
Paths	By default, two paths display. The paths do not have conditional logic added to them. You can change the path names based on your workflow requirements.	Select a path and edit the value.
Add icon	Use this icon to add additional paths.	Click Add to add a path.
Trash bin	Use this icon to delete a path.	Select required path and click Trash bin icon to delete it.

7. To change the path names click in the path field and change the name.
   
8. To add additional paths, click the Add icon.
   
9. To delete a path, select the path you want to delete and click the Trash bin icon.
   
10. You can choose from two options on the Logic section of the Paths tab, depending on your workflow logic. Use this section to add logic to the paths or configure a Split Rule.
    

The following table explains the available options:

Option	Explanation	How to Use
Follow All Paths	This option is the default.	Select the Follow All Paths radio button.
Custom Logic	Use this option to: Specify which paths are followed when this step is evaluated Specify whether one or more lines are followed When you do not want to duplicate logic or add inverse logic for mutually exclusive lines.	Select the Custom Logic radio button. Click the Split Rule link to expand the Rules Designer to create a custom path split rule.

11. Select the Custom Logic radio button to enable the Split Rule option. To view or configure the rule, click Split Rule.
    
12. The Rules Designer displays and you can configure the Split rule.
    
For more information on how to configure rules, see the Rules Designer topic.

ExampleIn this example, the Split Rule is configured based on a workflow field called Amount. If the amount is greater than 1001, Manager Approval is followed. If it is less than or equal to 1000, the Automatic Approval path is followed.


13. Click the arrow to collapse the Rules Designer.
    
14. With the step selected, select the Properties tab. Use this tab to change and add more detail.
    

The following table explains the options available on this tab:

Option	Explanation	How to Use
Title / Name	By default, each step on the canvas has a step title. You can change this title to suit your workflow logic and show it on the canvas by checking the Show Label box.	Enter a value into the Title/Name field.
Reset link	Use the link to reset any changes to the title.	Click the Reset link to reset the Title/Name field to default value.
Show Label	Allows you to see the step label on the canvas. The label shows the value of the title.	Check the check box to display step label on the canvas.
Description	Allows you to add a detailed description for the step.	Enter a value into the Create Newfield.
Notes	Allows you to add additional notes for the step.	Enter a value into the Notes field.

15. Click the Errors tab.
    

Different types of exceptions can occur on a step, such as:

Type	Description
Known exceptions	Any SmartWizard or standard wizard that has Boolean options for handling known exceptions have these options displayed as check boxes in the Known exceptions section of the Exceptions tab.
Unhandled exceptions	Any unknown runtime exceptions.

The tab contains the following unhandled exception:

Exception	Explanation	How to Use
Log Exception	Logs the exception to the error log.	Check the box to log the exception.

16. Click and drag the path ports to create Placeholder step. You can replace these placeholders with relevant steps at a later point..
    

17. Your changes are automatically saved.

When working with the Split step keep the following considerations in mind:

• The Split step is not dependent on another step
• The Split step has to have at least one incoming and one outgoing line
• A Split step cannot be added into a multi-step
• You cannot apply escalations, expected durations, or exception rules to a Split step
• By default, the Split step has no label. To display the label on the canvas, check the Show Label check box on the Properties tab.
• If you need to combine paths at a later point, use the Merge step