- 06 May 2021
- 2 Minutes to read
Editing Data Objects in a Wizard Property Grid
- Updated on 06 May 2021
- 2 Minutes to read
The Wizard Property Grid Form Control allows designers to create a wizard for defining data objects' properties easily. By defining the Form's data input as a data object, the Wizard Property Grid automatically includes all fields, in their proper formats, related to editing the object. For example, if an Account object is defined as the input for a Wizard Property Grid, the wizard that displays to the user will contain all of the fields that can be changed on a user account record, including text fields, date pickers, checkboxes, and drop-down lists.
The example flow will display a form that can edit a single Account object. This account's properties display in three sections within a wizard property grid. Navigate between these sections using a Previous button and a Next button. In the first section in the wizard, the Previous button will not display. On the final section in the wizard, the Next button's label will change to Done.
- Begin in a Designer Folder, select CREATE FLOW in the Global Action Bar.
- In the resulting dialog, select Flow, name the Flow, then select CREATE.
- In the Flow Designer, select the Start step. In the Properties panel, under FLOW INPUTS > Flow Input Data, select Show Editor.
- In the Data Definitions dialog, name the data "Account" and select the Type's Account. Select CLOSE.
- In the Toolbox panel, in the Favorite Steps category, drag a Show Form step to the workspace.
- Select PICK OR CREATE in the Properties panel.
- Select CREATE under Create New.
- Choose Form. Name the Form. Select CREATE.
- In the Form Designer, navigate to the Toolbox, expand the DATA > PROPERTY GRID category. Drag and drop a Wizard Property Grid onto the Form.
- Drag and drop a Wizard Next Button and a Wizard Previous Buttononto the Form from the same DATA > PROPERTY GRID category. The wizard property grid component uses two buttons to navigate between sections. The first button will be the Wizard Next Button. When the object being described by the wizard property grid has no more sections to display after the current one, its label changes to Done. The Wizard Previous Button will not display on the first section.
- Select the Wizard Property Grid and navigate to the Properties panel. Under INPUT DATA > Next Button, select Done. For INPUT DATA > Previous Button, select Previous.
- Under INPUT DATA > Type, choose Account.
- Define Input Data Name as "Account" and Output Data Name as "Data".
- Save and Close (X) the Form Designer.
- Back in the Flow Designer, connect the outcome path of the Form to the End step.
- Select the Show Form step, in the Properties panel, under INPUTS > Account, select Account from the Flow.
- In the Flow Designer, select Debug in the top action panel.
- When the Flow runs the user is prompted to select an account to fill the fields.
- The first section is the Data section, the next is the Settings section, and the final section is Person Info.
- The fields within these sections can be edited and saved if the Flow is set up to save the changes.