Setting up a Form within a Workflow

This article walks through the basic steps of setting up a Form within a Workflow.

Table of contents:

  1. Where do I find the Form in a Workflow?
  2. How do I start building a Form?
  3. How do I add fields to an existing Form?
  4. How do I make a field Mandatory or Hidden?
  5. How do I delete a Form field?
  6. How do I delete a Form section?
  7. How do I add a Section Description?
  8. How do I edit fields in a Section?
  9. How do I edit Section visibility?
  10. How do I set the Card Name?

Where do I find the Form in a Workflow?

On the first Workflow Phase, click the menu icon (three vertical dots) and then select "Edit this Phase" as shown below. 

Gatekeeper 2020-09-10 12-48-52Then, navigate to the "Form" tab along the right-hand side.

Gatekeeper 2020-09-10 12-51-57

How do I start building a Form?

From the Form tab, simply click "ADD SECTION" to start building the Form. 

Gatekeeper 2020-09-10 12-55-34

The Form Section builder will open, which allows for flexible construction including a large range of field options such as:

  • Workflow Only Fields - these fields live only in the Workflow and are primarily used to drive the form experience and build automated Workflow transitions based on a specific input. 
  • Predefined Fields - these fields are housed in either the core Gatekeeper record or the corresponding Custom Metadata Group, and can be pulled into the Workflow as needed: 
    • Core Metadata
    • Custom Metadata Groups
    • Attached file with Expiry Date

Ensure that a "Section Name" has been added and specify any Predefined data fields before clicking on "Save". To create a Form Section for Workflow Only Fields, leave the "Predefined" option blank. 

Gatekeeper 2020-09-10 13-12-14

Please keep the following considerations in mind when configuring Sections:

Section Name - Freeform text, will be shown and formatted as a heading on the Form

Predefined - Dropdown, can be used to pull in standard metadata fields to the Form

Custom Data Group - Dropdown (hidden until "Predefined" is set), allows for the use of Custom Data Groups if present

Description - Freeform text, add if useful and be sure to check "Display Description"

 

If any "Predefined" options are selected (Supplier, Contract, File with Expiry), the form will be populated with all the related fields. The below example displays Gatekeeper core Contract fields. 

Gatekeeper 2020-09-10 14-09-47

How do I add fields to an existing Form?

From any Section where visible, click the available "ADD FIELD" option. 

Gatekeeper 2020-09-10 14-18-12

Then, simply enter a Label along with any other the specifics before selecting "Save". 

Gatekeeper 2020-09-10 14-24-08

Any newly created Workflow form fields should now appear in the appropriate Section. 

Gatekeeper 2020-09-10 14-25-47

Here's how the new "Request Priority" field would display on the Form:

How do I make a field Mandatory or Hidden?

For each field,  you have the following checkbox options:

  1. Mandatory - You can set this field to be required for Form/Phase completion on a field by field basis, or for all fields in the Section by choosing the first "Mandatory" checkbox. 
  2. Hidden - You can select this option to hide the field from your Form/Phase completion on a field by field basis, or for all fields in the Section by choosing the first "Hidden" checkbox. 

Note: You cannot have a field set to Hidden and Mandatory at the same time. In this case, selecting the second option will deselect the first automatically. 


Gatekeeper 2020-09-10 14-16-08

How do I delete a Form field?

If a Form field is available for deletion, clicking the "Edit" (three dots) icon to the right of the field will reveal a trash can icon. Gatekeeper will ask if you are sure before you select "Delete". 

Gatekeeper 2020-09-10 14-48-03

How do I delete a Form section?

If a Form section is available for deletion you can do this by clicking the trash can icon to the right of the form visibility rules. Gatekeeper will ask if you are sure before you select "Delete". 

 

How do I add a Section Description?

When creating the Section, ensure that a Description is included and "Display Description" is checked before hitting "Save". 

Gatekeeper 2020-09-10 13-21-54

To edit or add the Description for an existing Section, click on the "Edit" icon to the right-hand side.

Gatekeeper 2020-09-10 13-26-21

The Description will display on the Form as highlighted in light yellow below: 

Gatekeeper 2020-09-10 13-28-48

How do I edit fields in a Section?

To edit any of the fields housed in a Gatekeeper Form Section, just select the Edit icon (three dots) to the right of the appropriate field. 

Gatekeeper 2020-09-10 13-42-37

Click the pencil/paper icon to modify the Form field.

Gatekeeper 2020-09-10 13-44-50

From the corresponding screen, designate any of the following:

  • Label - This is how the field will be labelled in the Form and throughout the Workflow process
  • Set as card name - This determines the Card Name as shown in the Workflow
  • Type  - Choose from an available Gatekeeper field type. For more detailed information regarding field Types, click here

Note: The Type for any Gatekeeper field is locked once created and cannot be changed. This option will be restricted unless a new field is being added. 

  • Description - This offers a place to house a description of this field Gatekeeper for informational purposes. To display a description on the Form, we recommend editing the Section Description instead. 
  • Text - This is the text appearing when a user hovers over the "i" icon (only visible on the Form if Text has been added).
  • Link - A URL can be added here if desired, recommended to use a shortened link for user experience.
  • Link Text - Link Text must be provided if a Link is entered above. This is the plain text description of the Link and should remain brief. 

Gatekeeper 2020-09-10 14-05-40Here's how the "Contract Name" field would display on the Form based on the above configuration. 

Screen Shot 2020-09-10 at 2.02.14 PM

Be sure to click "Save" when done. 

How do I edit Section visibility?

Each Section of a form can be set as:

  • Read only
  • Hidden
  • Editable
  • Custom

Note: Section visibility can be set independently in each phase of any Workflow.

Gatekeeper 2020-09-10 13-33-55

The "Custom" option offers the flexibility to build tailored visibility criteria. Just click the "ADD" button to get started. 

Gatekeeper 2020-09-10 14-35-48

How do I set the Card Name?

Typically, we see the card name being the Contract Title or Supplier Name. To set the card name:

1. Find the field within the first Phase's Gatekeeper Form Section and select the Edit icon (three dots) to the right as shown below

Gatekeeper 2020-09-10 13-42-37

2. Click the pencil/paper icon to modify the Form field settings

Gatekeeper 2020-09-10 13-44-50

Check the box that says "Set as card name" and click "Save".

Gatekeeper 2020-09-10 14-32-23

 

Please read this article if you would like to understand how to now make your Form Public.