Single User Form Control

Last Updated: 03/28/2018 Introduced in Version: 4.0

This tutorial demonstrates how to create and use Single User Control on the Form in Decisions 4.0. Single User Control is User Defined Control that can be reused on different Forms. This type of a control represents a Form without Actions that can be embedded into regular Form. This is useful when we need to create different Forms that have common set of controls that can be grouped into one Form Control.

Example:

In this example we are going to create a Single User Form Control (Person Info), and use it on the Form in a simple Flow.

We begin in the Designer Folder with clicking Create Form > Create User Control > Single on the Folder Actions Panel. Then, we Name our Control and click CREATE to continue to the Form Designer.

 

Form Designer opens… And, we build our Custom Form Control as desired. In this case we use Text Box controls and Labels to build a simple Form with First Name, Last Name, State, City, and ZIP fields. Note, that we are not able to add Action Controls like Button here because it is not a Form but a Control. It will use parent Form Actions to output data. When we finished designing this Control, we can save it and close Form Designer to continue.

Next, we are going to create a simple Flow with a Form. Back in the Designer Folder we click Create Flow on the Folder Actions Panel.

Then, we Name the Flow and click CREATE to proceed to the Flow Designer.

In the Flow Designer we add Show Form step from the Favorite Steps category. In the resulting window we Name the Form and click Create to proceed to the Form Designer.

 

In the Form Designer we add Button control from Actions category for User to be able to submit our Form.

Then, we add our Person Info User Control from User Controls > [Existing User Controls] > [Current Folder] category.

Our Custom User Form Control is added and displayed on our Form. This completes our Form design. We can save the Form and close Form Designer.

Back in the Flow Designer we connect the outcome from our Show Form step to the End Step in our Flow. Then, we define Inputs to our Form. They are the fields of our Custom Form Control. In this example we just Ignore all Inputs.

This completes our Flow Design. We can click Debug Flow link on the Top Panel of the Flow Designer to test our Flow.

Our Form pops up in the debugger. From this perspective we can’t tell that all fields on this Form is one control that can be reused on other Forms.

Then, we fill in all the fields and click Done to submit our Form. Our Flow executes to the End Step with no issues.

Additional Resources