Servicely Capability
Catalog
Reference Filter
3 min
a reference filter is a reusable configuration that filters the available records shown on a service catalog reference or multi reference type question (for more information on service catalog and questions, please refer to catalog item) as an example, if you need to restrict the available options on a service catalog question referencing the location table to only locations in a certain country, you will need to configure a reference filter for the location table that has that restriction and then have the relevant catalog question(s) have it populated for equivalent functionality for regular forms like incident, cmdb, etc, please refer to the reference qualifiers docid\ qmqk0uzxcbsr2te3vyo2q article creating a reference filter to create, navigate to application > field > reference filters and populate the following field name description sample value name name of the reference filter location must be selectable table table that has the field this reference filter runs on (this will make it available for questions that reference this table) location active if active, this reference filter is applicable to the catalog question referencing it yes condition condition builder, runs on the nominated table note this is evaluated together with what you return in the script field (if any) script when you need to qualify based on another catalog question’s answer on a catalog form or any other condition that condition builder does not support, you will need to populate the script field on the script the current catalog form being populated is accessible with all the current answers to the questions, as an object called “current” such as current \<questionname> you will need to return a table record query note this is evaluated together with what you configure on the condition field (if any) in the example provided, it will look for selectable locations and ones that match the country they selected in a catalog question with the name “country” for more information about table record query, please visit table api (server) linking a service catalog question to a reference filter once a reference filter is configured, it can then be used on one or more service catalog question(s) that is referencing the table that the reference filter is for e g if your reference filter is for the location table, then the filter can be applied on catalog questions of type reference, that references the location table to do that navigate to the catalog question record you want to configure to be filtered on the “reference filter” question, pick the reference filter you had just configured and save your changes below shows a sample screenshot of how it looks like on the catalog question configuration form