Servicely Administration
Reference Qualifiers
1 min
a reference qualifier filters the available records shown on a reference field’s selection for example, if you need to restrict the available options on a form’s field referencing the location table, you would need to configure a reference qualifier for that reference field for equivalent functionality on the service catalog, please refer to reference filter docid 01hgnetwa vhssq15nimw create a reference qualifier to create, navigate to application > field > reference qualifiers and populate the following field name description sample value name name of the reference qualifier incident location based on selected company table table that has the field this reference qualifier applies to incident field field on the table that this reference qualifier applies to, e g out of box there is an incident’s field named location that is referencing location table, and we are using it as an example here location active if set to “yes”, this reference qualifier is applied to the nominated field yes target table \[auto populated] table referenced by the field the reference qualifier runs configured query/condition on this table location description extra information about the reference qualifier for administrative purposes locations shown are the ones for the company selected on the incident record advanced if yes, script is required no condition condition builder, runs on the target table (in this example, location), not the table that has the reference field that this qualifier is for script when you need to qualify based on another field’s values on a record or any other condition that condition builder above does not support, you will need to select “advanced” as “yes” and then populate the script field on the script like the condition builder, also runs on the target table (in this example, location) the current record being viewed, is accessible with all the current values to the fields, as an object called “current” you will need to return a table record query it should be noted the script below returns table api query to run against the location reference field’s referenced table, i e table named location when you edit an incident record and click on the location reference field, the reference qualifier will run and “current” in the script below refers to the incident record therefore, for context, the script is looking for company value of the incident record the example to the right results in when viewing or working on an incident, if the incident’s company field has been populated, the incident’s location field will only show locations that have their selectable field set as yes and company the same as the incident’s company if the incident does not have company populated, the incident’s location field will show locations that have selectable as yes for more information about table record query, please visit table api (server)