Skip to main content

Form Filled

The Form Filled trigger activates when a selected Tonkean form is submitted by a user.

The conditions available in this trigger are detailed in Conditions.

form_filled_trigger_panel.png

Name the Trigger

Select the trigger title or the edit icon, blue_edit_pencil.png, and provide a descriptive title for the trigger.

Turn Trigger Block On or Off

By default, trigger blocks are enabled and turned on. Select the toggle in the top right of the trigger panel to disable or turn it off.

When building a module, remember you can toggle triggers on and off rather than deleting them.

turn_trigger_off_toggle.png

Change Trigger Type

To change the trigger type, select the edit icon, blue_edit_pencil.png, and select the new trigger type from the Change Type To dropdown.

change_trigger_type_pencil_icon.png

Activate Trigger When

  1. Select the Search Form dropdown and select a form from the list of available forms. Select the close icon , close_x.png, beside the dropdown to clear the form selection.

    Forms must already exist in your module to appear in this dropdown. For information about creating forms, see Create and Manage Forms.

    form_filled_select_form_dropdown.png

    If you need to create a new form for the trigger, select either + Add Create Form or + Add Update Form to create the necessary form.

  2. To add another form to the same trigger, select + Add form. An additional Select Form dropdown displays.

    form_filled_add_form.png

Run Settings

Select the relevant checkbox to enable the trigger to activate under various conditions:

  • Run also on inner items - Trigger conditions evaluate on inner items in addition to parent items.

  • Evaluate trigger conditions when a new item is created - Trigger conditions evaluate when a new item is added to the module.

field_changed_run_settings.png

And Only If

In addition to activating the trigger when the form is submitted, you can include additional conditions.

If you want a certain set of actions to run any time a form is submitted, do not add any additional conditions.

Select the dropdown to choose to run the trigger when All or At least one of the conditions are met. This option defaults to All.

field_changed_activate_trigger_when_condition.png

Select a primary field, a condition, and a qualifying value as the condition that activates the trigger:

  1. Select Search data field to select a field. The field dropdown displays.

    match_coditions_trigger_search_data_field.png
  2. Select a field from the dropdown. This is the primary field that the module is checking and can be a field from a data source, a Tonkean form, or any custom field you've created.

    match_coditions_trigger_search_data_field_dropdown.png
  3. Select the condition field. This field defines how a value is matched or compared to the primary field.

    For definitions for all available conditions, see Conditions.

    match_coditions_trigger_operator.png
  4. Enter a value. This is the qualifying value that is compared to the primary field, based on the selected condition. Depending on field type of the item, this value may be predefined or you may have the option to enter free text.

    match_coditions_trigger_value_field.png

To add another And Only If condition, select + AND and repeat the process.

field_changed_trigger_and_condition.png

Add a Condition Group

In addition to defining individual conditions that activate a trigger, you can create a condition group that combines several related conditions. Condition groups allow you to organize complex conditions for the sake of visibility (for example, you might have three AND conditions that must be met and five OR conditions that can be met, which can be organized in two separate groups).

  1. In the Activate Trigger When section, select + AND. The condition options dropdown displays.

    condition_group_add_and.png
  2. Select New Condition Group. A new condition group section displays.

    condition_group_select.png
  3. Select the default name, New Conditions Group, or the pencil icon, blue_edit_pencil.png, to rename the condition group.

    condition_group_rename_group.png
  4. Select the dropdown to choose to run the trigger when All or At least one of the conditions are met. This option defaults to All.

    Selecting All makes the condition inclusive, adding an + AND button to the bottom of the section, while selecting At least one makes the conditions exclusive, adding an + OR button.

    condition_group_all_or_at_least_one.png
  5. Follow the process of adding a new condition as described in Set New Condition.