All Collections
Workflow Manager
Create a Workflow Trigger in a Project
Create a Workflow Trigger for Forms in a Project
Create a Workflow Trigger for Forms in a Project

This article helps you understand how to create a workflow trigger for forms in a project.

Updated over a week ago

Pre-requisites:

  • Required role privilege 'Manage Workflow Rules' on the project where a workflow trigger needs to be created.

Steps to create a workflow trigger event on a form is as mentioned below:

You have an option to configure a workflow trigger for forms right after publishing a workflow from the workflow designer. In such a case, you will get a prompt message stating 'Do you want to configure a Trigger now?'. Here, click on 'Yes' option and follow the steps as below - from step number 3 onwards.

1. Navigate to 'Workflows' tab and select the project.

2. Click on 'Create Trigger' button to start creating a trigger event.

Alternately, right click on project name and select 'Create Trigger' option.

3. Enter required details for all the mandatory fields in 'Configure Trigger' screen:

3.1. Name - Name of the trigger.

3.2. Priority - At any given point of time, only one running workflow is allowed. Below are the key factors to be considered while setting the priority of a workflow:

  • A new workflow can get kicked off only when the earlier workflow is completed.

  • To decide which trigger gets precedence when there are multiple triggers with matching conditions, you can use the priority field. The trigger with higher priority will be kicked off first, then the triggers with lesser priorities will be kicked off one by one.

  • All the triggers will execute which are configured with system tasks event, while only one trigger will execute which is configured with workflow definition event.

  • If there are more than one triggers with matching conditions and priority, then any one of them will get kicked off. In case this particular trigger fails, the next trigger with matching condition would be initiated right away.

3.3. Description - A brief description about the trigger to be created.

3.4. Context - Select the trigger context as 'App'.

3.5. App Type - If the selected task context is 'App', you will be required to choose a form type from a list of active form types.

Controller based form types are not supported in workflow. For any non controller based form type that was converted to controller based after the workflow was configured, workflow won't execute for that particular form type.

3.6. Trigger Conditions - You can create various trigger conditions using 'AND' / 'OR' (Logical Operators).

Workflow triggers for forms can currently be created only based on 'App Status' that are enabled in relevant form settings.

Rule is the single logical statement created based on one or more conditions defined by the user.

The trigger is executed based on this statement under different matching conditions. You can see the actual rule (statement) that will get applied based on the conditions defined for workflow trigger just like below:

Different brackets and text colors used to present the applied rule can make it easy for you to understand how the workflow trigger would actually get applied based on the conditions entered, irrespective of the complexity of the rule.

Working of logical operators:-

------------------------------------------------------------------------------------------------------------------

<Condition 1> <logical operator (AND)> <Condition 2>

Description:- For 'AND' logical operator, both conditions must be satisfied (true).

<Condition 1> <logical operator (OR)> <Condition 2>

Description:- For 'OR' logical operator, any condition should be satisfied (true).

------------------------------------------------------------------------------------------------------------------

If I want the workflow to trigger when a new form is created having 'Open' status. I need to select:

Condition One: Form type is equal to 'Request For Information' AND
Condition Two: When form status is 'Open'

You can use such combinations of logical operator to cover a business process.

Click here for detailed help on how to use independent system tasks.

3.7. Trigger Event - Select appropriate event which should trigger the workflow (as configured by user). Trigger event for forms can be:

3.8. Task Mode - Select the task mode for which this trigger will be used.

  • Post - An event which is executed after completion of desired event i.e. creation of an app. Post task mode is currently available for all form events.

  • Post (Sync) - An event which is executed in sync after completion of desired event i.e. creation of an app. Post task mode is currently available for following form events:
    Create App, Create Response

3.9. Task Type - Select the type of task to be performed based on the selected trigger event and task mode.

3.10 Task - Select relevant system task if this trigger is for an independent system task or select relevant workflow definition if this trigger is for a workflow.

4. Click on 'Create' to complete creating a trigger event for the workflow on selected form.


Check: FAQs


Did this answer your question?