--- sourceDocument: Xanadu ServiceNow AI Platform Administration sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/xanadu/platform-administration Release : - xanadu ft:locale : - en-US ft:publication_title : - Xanadu ServiceNow AI Platform Administration ft:clusterId : - platadm bundleId : - platadm workflow : - Platform --- # Configure reference qualifiers # Configure reference qualifiers {#ariaid-title1} * Release version: Xanadu * * Updated August 1, 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read System administrators can configure reference qualifiers that enable filtering of the associated reference field. ## About this task This task walks you through creating a reference qualifier in the [system dictionary](https://servicenow-prod.fluidtopics.net/4a2v7eTS8qFMt~3PiE0b7w "View a list of all tables in columns in your instance from the system dictionary."). When creating a reference qualifier in the system dictionary, it not only applies to that table, but also to all the children of the table. Note: You can also create reference qualifiers on extended tables through [dictionary overrides](https://servicenow-prod.fluidtopics.net/Q4hINOapX8jcIphpqgbz_w "Dictionary overrides provide the ability to define a field on an extended table differently from the field on the parent table."). Dictionary overrides only impact the extended table and any of its children, not the parent table. ## Procedure 1. Navigate to the [reference field](https://servicenow-prod.fluidtopics.net/LCo0l1YQW~190gCBZheWsA "A reference field stores a reference to a field on another table. For example, the Caller field on the Incident table is a reference to the User [sys_user] table.") on the form or table on which you want to define a reference qualifier. 2. Right-click the reference field label and select Configure Dictionary. 3. Under Related Links, select Advanced view. The simple reference qualifier is available in both the default view and the advanced view. The dynamic and advanced reference qualifiers are available only in the advanced view. 4. In the Reference Specification section, verify that the table in the Reference field contains the table that you want associated with the reference field, or select another table if necessary. 5. From the Use reference qualifier choice list, select the reference qualifier to implement. 6. Configure the qualifier based on the type of reference qualifier. * Simple: [Build the condition](https://www.servicenow.com/docs/access?context=c_ConditionBuilder&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US) using the choice lists. * Dynamic: Either select an existing dynamic filter option or [Create a dynamic filter option](https://www.servicenow.com/docs/access?context=t_DynamicFilterOptions&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US). * Advanced: In the Reference qual field, enter an [Encoded query strings](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US), JavaScript that returns a query string, or the name of a [script include](https://servicenow-prod.fluidtopics.net/PW6rOKoD6s8GLCWIXG0WPA "This example shows how to use an advanced reference qualifier with JavaScript and a script include to restrict the incident Assignment group choices to only the groups that contain the user specified in the Assigned to field.") or [business rule](https://servicenow-prod.fluidtopics.net/J62G6tUMA~QDzDC8cKhNlA "This example shows how to use JavaScript and a business rule to restrict the incident Assigned to field choices to only the users with the itil_admin role.") to run. {#t_ConfigureReferenceQualifiers__choices_wvw_zgd_yz} 7. Complete the Reference Specification --- Additional Customization section, as appropriate. {#t_ConfigureReferenceQualifiers__table_kt2_mhd_yz__entry__2} | Field | Description | |-|-| | Reference key | [Identifies a field other than sys_ID](https://servicenow-prod.fluidtopics.net/RPFFpbJ6AMAkeO0BqsgNRg "By default, reference fields store the sys_id of the record in the database.") to use as the unique identifier for the reference field. | | Reference cascade rule | [Defines what happens to a record](https://servicenow-prod.fluidtopics.net/QDhlivHKsWanS1uCsoQR1Q "When a record is deleted, there are different options for how the deletion will affect records that reference the deleted record. You can configure what happens to records that reference a record when that record is deleted.") if the record it references is deleted. Possible options include: * None * Cascade * Clear * Delete * Delete no workflow * Restrict {#t_ConfigureReferenceQualifiers__ul_d5g_shj_xdb} | | Reference floats | Flag that determines whether to [Configure the edit option](https://www.servicenow.com/docs/access?context=t_ConfigureTheEditOption&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US) for one-to-many relationships. | | Dynamic creation | Flag that determines if the system should [create a new record](https://servicenow-prod.fluidtopics.net/5BBelP6aXrSdM7tvEKewaQ "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.") when a value for the reference field does not match an existing record. If you select this option, enter a script that specifies how to create the record in the Dynamic creation script field. | [ ] {#t_ConfigureReferenceQualifiers__table_kt2_mhd_yz} 8. Click Update. * **[Constrain the assigned to field by role](https://servicenow-prod.fluidtopics.net/J62G6tUMA~QDzDC8cKhNlA)** This example shows how to use JavaScript and a business rule to restrict the incident Assigned to field choices to only the users with the itil_admin role. * **[Constrain the assignment group field](https://servicenow-prod.fluidtopics.net/PW6rOKoD6s8GLCWIXG0WPA)** This example shows how to use an advanced reference qualifier with JavaScript and a script include to restrict the incident Assignment group choices to only the groups that contain the user specified in the Assigned to field.