Field Interactions

Field Interactions allow you to use a custom API to trigger a series of actions when data in a field is entered or changed. These can be used on record fields as well as Understanding Custom Objects fields.

Accessing the Interactions Manager

Field interactions are managed within the Interactions Manager.

1. At the left of the screen, select Menu.

2. Select Admin > Interactions Manager.
   

How Field Interactions Work

Field interactions are configured per field and execute based on an event type. Key behaviors to be aware of:

• Edit forms only: Field interactions are currently only supported on edit forms.

• Form load behavior: Interactions load when the entity's edit form loads and the configured field is present. If a field has been hidden through field mappings, its interaction will not load.

• Field dependencies: Interactions can alter other fields on the same form, allowing you to create dependencies between form inputs. For example, populating or locking a field based on a value entered elsewhere.

• Event types: Each interaction is executed based on a defined event type. The most common are on change (fires when the field value is modified) and on init (fires when the form first loads).

Examples of Field Interactions

The ways you can use field interactions include:

• Performing simple field validations

  Example: Checking email addresses contain @ and . characters.

• Modifying how information is displayed

  Example: Making fields read-only for selected usertypes, or hiding fields based on values entered in other fields.

• Performing custom calculations based on field data

  Example: Calculating the amounts entered in two fields and auto-populating a third field with the total.

You can find more information on field interactions in our Developer Documentation.

Mobile App Support

Most field interactions are supported in the Bullhorn mobile app. However, not all interactions work as expected on mobile due to the differences in the UI. Be sure to test any interactions thoroughly on mobile before announcing them to users.

Limiting an Interaction to Desktop Only

If you want a field interaction to run only in the Bullhorn web application and not in the mobile app, wrap the existing interaction code in the following if statement:

if (API.globals.platform !== "MOBILE") {
    // existing interaction
}

This check evaluates the platform at runtime. If the user is accessing Bullhorn from the mobile app, the interaction is skipped. If they are accessing Bullhorn from a web browser, the interaction runs as normal.

Developer Assistance

Many of our Systems Integration partners can help with developing field interactions. For a full list of partners who can assist with setting up field interactions, visit our Marketplace Partner Listing and filter by category “Implement & Integrate".

Bullhorn can also assist with configuring Field Interactions via a paid customization through our Professional Services team. Please reach out to your account manager for more information.