Enable dynamic creation for reference fields

  • Release version: Zurich
  • Updated July 31, 2025
  • 1 minute to read

    • When dynamic creation is enabled, entering a nonexistent value in a reference field creates a new record on the referenced table instead of returning an error.

    Before you begin

    Role required: personalize_dictionary

    About this task

    By default, a user must enter a value in a reference field that matches an existing record in the table that the reference field refers to. For example, the Caller field in an Incident must have a value that is an existing user. You can enable dynamic creation to create a new record on the referenced table when a user enter a nonexistent value in a reference field instead of returning an error.

    Procedure

    1. Right-click the field label in the form and select Configure Dictionary.
    2. Populate the following fields (you may need to configure the Dictionary form):
      • dynamic_creation: Select the check box.
      • dynamic_creation_script: Enter a script that dynamically creates the record.
    3. Click Update.
      Examples:

      You could use the following dynamic_creation_script to create a record on the referenced table.

      current.name = value;
current.insert();
      Note:
      The parent object can be used to access anything from the parent record.
      You could create a script include named MyUserReferenceCreator with the following contents:
      var MyUserReferenceCreator = Class.create();
MyUserReferenceCreator.prototype = {
    initialize: function() {
    },
 
    create: function(current, value) {
        current.name=value;
        return current.insert();
    },
 
    type: 'MyUserReferenceCreator'
}

      When the script include is created, the following dynamic_creation_script generates a new location for an invalid reference field value:

      new MyUserReferenceCreator().create(current, value);