Skip to main content

Update Field

The Update Field action updates the value of a field. Most fields can be updated using this action, including native Tonkean fields and fields from a connected data source.

You can update more than one field using a single action block, so there's no need to dedicate an Update Field action block to each field that needs to be updated.

update_field_overview.png

Name the Action Block

Select the action title or the blue pencil icon, blue_edit_pencil.png, and provide a descriptive title for the action.

Turn Action Block On or Off

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

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

turn_action_block_on_toggle.png

Select Field Name and Value

Select the Field Name dropdown to choose from all the available fields in the module.

In the Value field, select a value option:

  • Value - Assign a value manually or select the insert field button, insert_field.png, to choose from available fields. This can include a field from a data source, a form, or a formula field, for example.

    select_field_name_and_value.png
  • Empty Value - Remove the value from the field.

    select_field_name_and_value_empty.png
  • Multiple Values - Assign a value manually or select the insert field button, insert_field.png, to choose from available fields. Select + Add Another Value to add subsequent values with this same process.

    select_field_name_and_value_multi.png

Select + Add field to update to include another field.

select_field_name_and_value_add_field.png

Updater

Select the person responsible for updating the field.

  • Flow item's owner - The owner of the item in the workflow, which corresponds to the the basic field Owner. To set a value for the Owner field, add an Assign Owner action block earlier in the workflow or add a value manually by navigating to Business Reports > [Module Name], select the Owner column, and select Default Settings.

    updater_flow_item_owner.png
  • Specific person - Any person in your organization. This field allows one to many people. Select the field to see a list of available people or begin typing and the field will autofill suggestions.

    updater_specific_person.png
  • Email from field - Retrieve a person from a specified data source, form field, or other locations. Begin typing and the field will autofill suggestions or select the Insert Field button, insert_field.png, to select current fields, matched entities, flow items fields, or formula fields.

    updater_email_from_field.png
  • Default actor - By default, the creator of the module. You can specify the default actor by selecting the module settings icon, module_settings_cog.png, and updating the Actor field.

    updater_default_actor.png

What item to update

Select the item the assigned owner updates. This can include items in other modules.

This option should be reserved for advanced use cases.

  • Item in Flow (default) - Update the item in the current module workflow—the item generated by the intake source. This is the most common option.

    what_item_to_update.png
  • Custom Item - Update an item you specify. This can be an item in a separate module. If you select this option, the item specified here is updated every time the flow runs.

    what_item_to_update_custom_item.png
  • Item by Title - This option is identical to the Custom Item option, but allows you to select from existing items by name. Select the insert field button, insert_field.png, to choose from all available fields.

    what_item_to_update_item_by_title.png

Notification Settings

Select whether to send item update notifications. This only applies to the Production environment.

notification_settings.png