Single User Form Control
  • Updated on 03 Mar 2017
  • 2 minutes to read
  • Print
  • Dark
    Light

Single User Form Control

  • Print
  • Dark
    Light

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 .
2018-02-09_160310-1024x519.png

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.
2018-02-09_160603-1024x519.png

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.
2018-02-09_160932-1024x519.png

Then, we Name the Flow and click CREATE to proceed to the Flow Designer.
2018-02-09_161052-1024x519.png

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.
2018-02-09_161113-1024x519.png

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.
2018-02-09_161237-1024x519.png

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 .
2018-02-09_161432-1024x519.png

This completes our Flow Design . We can click Debug Flow link on the Top Panel of the Flow Designer to test our Flow .
2018-02-09_161632-1024x519.png

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 .
2018-02-09_161727-1024x519.png

Then, we fill in all the fields and click Done to submit our Form . Our Flow executes to the End Step with no issues.
2018-02-09_161734-1024x519.png

Was this article helpful?