Skip to main content

Design the submission form

Design the submission form for a new approval request, connect its fields to variables, and test the saved layout before publishing.

Users with submission permission use the published submission form to start a request. For a project approval, the form might capture a project name, owner, dates, and a plan with several work items. Open the approval form in the application, select Edit in Designer, and use the form selector to open its submission form. Overview of the approval form designer


Design the form layout

Put the project details first, the project plan next, and the submission actions where applicants can find them.

Change the background color

In the controls panel, select Page. Choose a background color or image in the page settings. Preview the form to check that text and input fields are easy to read.

Change the content area settings

In Page → Content area, adjust the content width, background, and padding. Check both the content area and the page background when previewing your changes.


Add controls to the form

In Controls, drag the controls you need onto the canvas. Select a control to edit its properties or drag it to rearrange the page.

Default controls

  • Action panel provides Save as draft and Submit on a blank submission form. Choose left, center, or right alignment for the buttons. Action Panel

  • Workflow history shows workflow activity after submission. Workflow History

You can move either control. To restore one you removed, drag it back from Controls.

Pro Tip:

You can add more than one Action panel or Workflow history control. On a long form, place an Action panel at the top and another at the bottom so users can submit from either location.

Add header and/or footer

Drag a Title control from General to the top of the form. Enter a title such as Project Approval Form, then set its size and alignment. Add a short instruction or divider below the title, or place a help link in the footer.

Add form field controls

  1. Add a Text Box for the project name. Adding a field control creates a workflow variable that stores the value entered in the form.

  2. In the control properties, open Content → Basic → Associated Variable and select Edit. For this example, set Field ID to field_projectname and Field Name to Project Name. You can also find and edit both in the toolbar's Variables list.

  3. Turn on Sync Label when you want the field title to match the variable name. Check the displayed title after closing the dialog.

The Associated Variable dialog shows Field ID, Field Name, and the enabled Sync Label toggle.

Note

You can edit the visible Title independently. Changing the Title leaves the variable's Field Name and Field ID unchanged.

Add a Dropdown for Category, a User control for Project Owner, and Date Picker controls for Start Date and End Date. Set defaults and required fields where the control offers those options. Before renaming an existing Field ID, review any workflow, task form, or report that uses the variable. Form controls and associated variables


Display controls with multiple columns

Keep Project Name on a full row. Place related fields such as Start Date and End Date side by side where space allows.

1. Set custom width of each control

A new control typically uses the full row. Select the control, open Advanced, and set Width to Custom. Enter a pixel value or a percentage of its container. Preview the result on a narrow screen to check labels and input values.

2. Use Grid control to add multiple columns

Add a Grid below Project Name. In its Appearance settings, use + next to Columns, then drag Category, Project Owner, and the date controls into the grid. Use the caption or title setting to hide the grid heading if needed. A Section groups controls into columns, a Container controls direction and alignment, and Tab or Toggle groups split longer forms into parts. Grid


Add multiple items with Sub List

A Sub List stores multiple detail rows in the same approval request. Each row can have its own field values.

When to use this field

Use a Sub List when the main information is entered once and the details repeat. For a purchase order, enter the order and vendor once, then add a row per device. In a project approval, enter the project details once and use the Sub List for the work items.

Add the Sub List control to your form

  1. Drag a Sub List onto the form. Set its title to Project Plan, its variable ID to field_projectplan, and its variable name to Project Plan.

  2. In List Content → Fields, open Settings and select + Add Field. Add the three fields in the table below.

  3. Select the checkboxes in the first column for the fields you want to display, then choose OK. Expand a field to adjust Control Type or open Control Properties → Settings.

Field ID

Field Name

Type

field_workitem

Work Item

Text

field_startdate

Start Date

Date/Time

field_enddate

End Date

Date/Time

Add two test work items and check that their dates and values stay on the correct rows. SubList (Approval form only)


Save and Preview

  1. Select Save in the designer toolbar to store your changes.

  2. Select Preview at the bottom of the controls panel. Check defaults, required fields, and the Sub List. If you added conditional display or validation, preview cases that meet the condition and cases that do not.

  3. When testing the complete process, publish the approval form in a test application. Sign in as a test user with submission permission, save and reopen a draft, then submit it. Check the resulting task and the values displayed there. Publish your business process


Customize layout for multiple device

Use the desktop, tablet, and phone icons in the designer toolbar to switch views. Change device-specific properties only where the property shows a device icon, such as title size, alignment, or padding. On the phone layout, check that work-item inputs, validation messages, and Submit are visible and usable.

Did this answer your question?