Skip to main content

Field Changed

The Field Changed trigger activates when the value of a specified field changes, regardless of where it's changed (that is, whether it's from a new item running through the module or a field being updated in the module's business report).

The conditions available in this trigger are detailed in Conditions.

field_changed_trigger_panel.png

Name the Trigger

Select the trigger title or the blue pencil 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 blue pencil 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 + Add field to select the field to monitor for changes. The Search data field dropdown displays.

    field_changed_activate_trigger_when.png
  2. Select the Search data field dropdown and select a field from the list of available fields. Select the close icon , close_x.png, beside the dropdown to clear the field selection.

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

    field_changed_activate_trigger_when_dropdown.png

    To open the Fields panel to create or edit fields, select Manage fields.

    field_changed_activate_trigger_when_manage_fields.png
  3. To add another field, select + Add field again and repeat the process.

    If you include multiple fields in the condition, they act as an OR statement, meaning only one of the fields must change for the trigger to activate.

Run Settings

Select the checkbox to enable the trigger to activate if the form's inner-items are submitted.

field_changed_run_settings.png

And Only If

In addition to activating the trigger when specified fields change, you can include additional conditions. This is useful if only certain kinds of changes should activate a trigger (for example, if the trigger is monitoring for changes in an opportunity stage field in Salesforce, but you only want the module to run when the opportunity amount is above a certain amount).

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. This creates a compound match condition.

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.