About Custom Queries
To guide end users in their research and help them discover materials in your digital collections, you can make predefined queries, called "Suggested Topics," available to them. Suggested Topics appear on the Home page, collection landing page, or Results pages.
Each Suggested Topic is a simple hyperlink that invokes a single, predefined query. To create a Suggested Topic that appears on the Home page, use the Website Configuration Tool global settings. To create a Suggested Topic that appears on the collection landing page, use the collection settings. Collection-level Suggested Topics will appear on the Results page of a single collection search. Global-level Suggested Topics will appear on the Results page of a cross-collection search.
To create a Suggested Topic:
- Using Advanced Search, define your search, see the results, add a sort and, when the results are right, copy and save the RESTful URL that displays in the browser address bar on the Results page.
- Then navigate in the Website Configuration Tool to UI Widgets > Suggested Topics.
- Enable Suggested Topics
- Click Add Suggested Topic.
- Enter a name for the predefined query.
- Paste the saved URL into the URL text box.
- Click Save Changes.
- Click Publish.
When you create a Suggested Topic, you need to check a few related settings in the Website Configuration Tool.
Results Page Settings:
Navigate in the Website Configuration Tool to Searching & Browsing > Results Pages.
Set the display of compound objects in results:
- To only show full compound objects within search results (not the individual pages), set Suppress pages of compound objects to Yes.
- To show the pages of compound objects in search results, set Suppress pages of compound objects to No.
Define the fields to display in results by setting Choose fields for display and the order they display in.
Set the results display to Grid or Thumbnail by setting Choose a Layout.
- Navigate in the Website Configuration Tool to Searching & Browsing > Search.
- Click More Search Configurations.
- Define the fields visible in Advanced Search by setting Choose advanced search fields.
Note: For users migrating from CONTENTdm 5, you will notice that the format of the queries has changed. CONTENTdm 6 uses RESTful URLs. For more information, see About URLs.
If you used CONTENTdm 5 Custom Queries and Results (CQR), note that Suggested Topics is the beginning of the evolution of CQR replacement. CONTENTdm 5 CQR will still work with CONTENTdm 6, with some constraints:
- Fields to be displayed in results are configured using Website Configuration Tool, not passed in via queries.
- Hierarchical, Bibliography and Title views have been deprecated given end-user feedback that Grid and Thumbnail views provided the information needed, with Facets to aid in refining searches.
- Search by Proximity ("near") has also been deprecated.
CQR functionality will be incorporated into the Website Configuration Tool in later releases. While the Website Configuration Tool evolves, try using Suggested Topics to provide custom search queries. If you prefer to use CQR to create a new query, you can do so and then use the Website Configuration Tool Suggested Topics option to paste that CQR URL into the Suggested Topic URL.