Workflow Guide

Prev Next

As part of the form configuration, you can add workflows to the form. The Workflow tab displays the various events that can be added to each stage of the workflow, along with the order of actions for the workflow events.

Important Note

The fields available for a workflow may change based on the Event Type selected.

Draft Events

Draft events run when a user saves the form as a draft. You may need to first set up Draft Data Retention in order to enable drafts. The same Event Types for Submission Events are available for Draft Events.

The Draft Event Email type fields on the Workflow tab of a form.


Calendar Booking Events

Calendar Booking Events can be added to a form to ensure that the person filling out the form will be able to choose an available date and time upon submission.

Calendar booking event configuration form with provider, scheduling page, event details, and booking field mappings.


Payment Events

After setting up the Payments integration, you can add Payment Events to forms. Payment events allow users to process transactions as part of the form submission.

CivicPlus Pay event setup with payment gateway and total amount due options.


Submission Events

Submission events run when the user clicks the submit button. The same Event Types for Draft Events are available for Submission Events.

An example of an Email Submission Event on the Workflow tab of a form.

Event Types

The following Event Types are available:

  • Email: Send an email to a configured email address and optionally attach a PDF report of the form submission or a custom PDF

  • Excel: Add Row to Table: This workflow event will allow you to map form submission data into an Excel Table.

  • Freshdesk: Create Ticket: Create a ticket within the Freshdesk ticketing portal

  • Freshdesk: Add Note to Ticket: Update an existing ticket in the Freshdesk ticketing portal

  • HCMS: With Process Automation and Digital Services' integration to the CivicPlus HCMS, create and manage all your content and data from our integrated platform

  • Recreation Management: This Advanced Fillable Forms integration allows you to add your forms to the checkout process for Facilities and Activity Sessions in Rec.

  • Salesforce: Create Object Record: This workflow event will allow you to link to an existing Salesforce Object and add new records on form submission.

  • SharePoint: Create List Item: Link to an existing SharePoint List and add new rows populating the columns with form data

  • SharePoint: Store PDF: Store the submission PDF and any form attachments to a folder within your SharePoint site

  • Webhook Hosted API: Call a hosted API to link to any backend system

  • Webhook Custom URL: Process Automation and Digital Services will send a request to this URL on successful form submission. This is an advanced feature used for integration purposes

  • Micro Focus Content Manager: Use the Micro Focus Content Manager integration to post your form submission data to your Micro Focus backend system containers and assign actions


Approval Flow

Approval workflows ensure form submissions are reviewed by a specified approver before any approval events are triggered. Learn how to add an approval flow to a form.

Approval flow for pet license with options for approver group and settings.


Approval Events

Approval events run when the final step in an approval flow has been approved. The same Event Types for Draft and Submission Events are available for Approval Events.

The Email approval event fields on the Workflow tab of a form.


Additional Workflow Functionality

Reference Submission Data/Form Elements

Several event fields can be customized with content from the form. Select the plus sign icon next to a field for available values.

Email event configuration highlights the subject-line plus button for referencing form elements or submission metadata.

Choose an available Submission Metadata or form element from the dropdown.

Email workflow shows Submission Metadata options: Form ID, Form Name, External ID, date, timestamp.

In the example below, the submission event will pull the email address the submitter filled out in the Email element of the form and will send a confirmation email to that address.

The Email Subject Line field on an Email submission event pulls the Email element data from the form.

You can also use {USER:email} to pull the submitting user's email address. This will only be available if the submitting user has logged in when submitting the form.

User email element.

Conditional Logic

Similar to how conditional logic works for displaying hidden form elements, conditional logic can also be set on the workflow event. Meaning that the workflow event will only run when the configured conditions are met in the form. With this, you can add varied workflow events that can be used for several use cases, such as escalating emails and different payment paths.

Configuration settings for payment events with conditional rules based on submission time.


Using Sage AI Build

Sage Build mode is available on the form Workflow page so users can create and update workflow events with Sage instead of configuring them manually. You can view conversation history with Sage Build on the Summary tab of the form.

Sage AI assistant panel opens over a Pet License Renewal workflow, with Submission Events selected.