Skip to main content

3. Automate your business process

Build a project approval form, route requests by profit rate, and add approved projects to a data list.

This tutorial walks through a project approval workflow. You’ll build a submission form, set up the approval tasks, and save approved requests to the Projects data list.


When a process is the best flow

Use an approval form when requests follow a defined sequence with named reviewers and a clear outcome. The submission form collects the details. The workflow assigns tasks, evaluates decisions, and carries out actions such as adding a record. Understand approval form


Take action: Automate your business process

In the application from the previous stage, create a project approval process that sends each request to the applicant’s line manager, then to the project management office (PMO). After both approve, the estimated profit rate determines whether the department head or the CFO reviews it. Final approval adds the project to the Projects data list. Create your data list

Before building, check that your test applicant has a line manager and a manager assigned to their organization. Confirm that the PMO user group and CFO job position have test assignees.


Step 1: Create a new approval form

  1. Open the application. Select Add resource, then Approval form. The form creation menu also supports importing a form, using AI, or starting from a template. For this walkthrough, choose Blank form. Application resources

  2. Name the form Project Approval Form. Enter a unique Id, such as PRO_AF, add a description, and select a page layout.

  3. Select OK. When prompted, open the form designer. Create a new approval form


Step 2: Add the form header

Open the controls panel with +. Under General, drag a Title control to the canvas and enter New project approval form. Set its size to Large and center it. Duplicate the control for a short instruction line, set the copy to Small, and place a Divider below it. Use Preview to check the layout. Overview of the approval form designer


Step 3: Add project related fields

  1. Add a Text Box for Project Name. Under Content → Basic → Associated Variable, set a field ID such as field_projectname. Under Validation, turn on Required.

  2. Add a Date Range control and name its two associated variables Start Date and End Date, for example field_startdate and field_enddate. Set the control to Required. The first date can be the same as or earlier than the second. Preview both cases and confirm that a reversed date range is blocked. Date Range

  3. Add a Text Area for Brief Introduction. To place field titles above their inputs, open the Page tab in the controls panel and select Vertical under Appearance.


Step 4: Add project cost related fields

Add a Grid for the financial information. Add two Currency controls for Contract Price and Estimated Cost and make both required. Set a validation rule that flags a contract price of zero or below.

Add a Calculation control with an associated variable named Rate of profit. In its expression editor, calculate (Contract Price − Estimated Cost) ÷ Contract Price using the two variables. With a contract price of 100,000 and a cost of 80,000, the numeric result is 0.2, or 20%. Save the form.


Step 5: Design the approval workflow

Open Workflow at the top of the approval form designer. The Start action uses the submission form. The Assignment Task actions use the task form that reviewers open to make their decisions. Overview of the workflow designer

5.1 Add the first Assignment Task

  1. Drag an Assignment Task onto the canvas, open its settings, and name it Line Manager Approval. Set Task Type to Approval Task.

  2. In the assignee editor, choose Expression and select Instance Context → Applicant → Line Manager. Insert the expression, confirm it, then select Add and Save to assign it. Add assignee with Assignee Editor

  3. Under Task Form, select + Create a Task Form. Choose Copy from an existing form, choose Project Approval Form, and name the copy Approval Task Form. Select it in the task settings and check that it shows the project fields and approval buttons. Configure approval buttons on a task form

5.2 Add the second Assignment Task

Add another approval task named PMO Approval. In the assignee expression, choose User group → PMO → All user. Add the expression to the selected assignees, save, and select Approval Task Form.

This example uses Parallel assignment and First Decision under Completion Condition. PMO members receive the task together, and the first approval or rejection determines its result. Assignment Task Action · Manage user groups

The Completion Condition settings for an approval task, with First Decision selected.

5.3 Connect Steps with Arrows

Add an End with Rejection action. Drag a connector from Start to Line Manager Approval. Connect the manager’s task to PMO Approval and to End with Rejection. Select each connector and open its Condition Editor. Set the line to PMO Approval to Approved and the other line to Rejected. Save both conditions.

Select another Arrow which is connected from the first assignment task to the second assignment task. Then, open the condition editor to select "Approved", and click "Save" button to close this window.

5.4 Add Inclusive Gateway

  1. Connect the Approved outcome of PMO Approval to an Inclusive Gateway. Connect its Rejected outcome to End with Rejection.

  2. Add two approval tasks named Dept Head Approval and CFO Approval. Associate both with Approval Task Form. Assign the department head via Instance Context → Applicant → Organization → Manager. For the CFO task, choose Job position and select CFO. Manage job positions

  3. In the gateway’s outgoing connectors, compare the Rate of profit workflow variable as a Number. Set the department head condition to >= 0.2 and the CFO condition to < 0.2.

An inclusive gateway takes every outgoing path whose condition matches. These two conditions route each valid rate to one reviewer. A rate of exactly 20% goes to the department head. Inclusive Gateway Action

5.5 Save the approved project to the Projects data list.

Add a Set Data List action named Create new project. Select the Projects data list, set Execute Type to Add, and open Field Settings. Select each target field and choose its value in the expression editor.

  • Project Name comes from the Project Name workflow variable.

  • Description comes from Brief Introduction.

  • Owner comes from Instance Context → Applicant.

  • Start Date and End Date come from their corresponding workflow variables.

If your Projects list has other required fields, supply their values as well. Set Data List Action

5.6 Set the rest Conditions to complete the design

Connect the Approved outcome of each final task to Create new project. Connect each Rejected outcome to End with Rejection. Then connect Create new project to End and save the workflow.


Step 6: Publish your business process

Review the submission form, task form, assignees, outgoing conditions, and field mappings. In the approval form designer, click Publish and confirm in the dialog.


Step 7: Test and modify the process

  1. After publishing, select Click to access the form and submit a sample request. Check that the line manager and PMO receive their respective tasks.

  2. Run approved requests at 19%, 20%, and 21%. Verify that 19% goes to the CFO and the other two go to the department head. Check that each final approval adds one Projects record with the expected applicant and form values.

  3. Reject requests at the line manager, PMO, and final review in separate test runs. Verify that each request ends as rejected and the Projects list gains no record from it.

  4. If you need to change the process, select Edit in Designer, save and publish the revision, and repeat the relevant test with a new request.

Did this answer your question?