GQL Full-text Search
Explore the GQL full-text search feature in AEM Assets. Use it to search for assets based on specific metadata, such as title, description, and author name.
The GQL full-text search feature lets you search for assets based on specific metadata, such as title, description, author, and so on.
To search for an asset based on its metadata, for example title, specify the metadata keyword followed by its value in the search panel. The GQL full-text search feature will fetch only those assets whose metadata exactly match with the corresponding value you enter.
For example, to search for assets that have the title "Target," perform these steps:
- From the toolbar of the Assets user interface, click or tap the Search icon to display the Omnisearch box.
- With the cursor in the Omnisearch box, press Enter.
- Click or tap the GlobalNav icon to display the Filters panel.
- In the Omni Search box, specify the value "Target." To limit your search to a specific folder, click or tap the Browse icon in the Filters panel and select the folder. In this case, the match is searched for only within the folder and the subfolders under it.You can also perform full-text search on folder. In this case, you must specify a non-empty full-text search term.
- Press Enter . The AEM Assets user interface displays only those assets whose title exactly matches "Target."
The GQL full-text search feature lets you search assets based on the following:
- Complex query built by combining through an And operation, the values you specify for multiple metadata fields (properties)
- Multiple values for a single metadata field
- Substring matches
The GQL full-text search feature lets you search for assets based on the following metadata properties. Names of the properties (for example author, title, and so on) as well as values are case sensitive.
GQL full-text search works for full-text predicates only.
|PROPERTY||SEARCH FORMAT (FACET VALUE)|
|Creator tool||creatortool:"Adobe Photoshop 7.0"|
|Copyright Owner||copyrightowner:"Adobe Systems"|
|Usage Terms||usageterms:"CopyRights Reserved"|
|Range of time(expires dateontime,offtime)||facet field : lowerbound..upperbound|
|PDF Title||pdftitle:"Adobe Document"|
|Tags||tags:"Location And Travel"|
|Width of image||width:lowerbound..upperbound|
|Height of image||height:lowerbound..upperbound|
Here are some examples of search formats for complex queries:
- To display all assets with multiple facets fields (for example: title=John Doe and creator tool = Adobe Photoshop):
tiltle:"John Doe" creatortool : Adobe*
- To display all assets when the facets value is not a single word but a sentence (for example: title=Scott Reynolds)
- To display assets with multiple values of a single property (for example: title=Scott Reynolds or John Doe)
title:"Scott Reynolds" OR "John Doe"
- To display assets with property values starting with a specific string (for example: title is Scott Reynolds)
- To display assets with property values ending with a specific string (for example: title is Scott Reynolds)
- To display assets with a property value that contains a specific string (for example: title = Basel Meeting Room)
- To display assets that contain a particular string and have a specific property value (for example: search for string Adobe in assets having title=John Doe)
*Adobe* title:"John Doe "OR title:"John Doe" *Adobe*
The properties path, limit, size, and orderby can't be ORed with any other property.
The keyword for a user-generated property is its field label in the property editor in lowercase, with spaces removed.
If you write a JCR query to search for subassets only, the matched referenced assets are also displayed along with the matched subassets.
Full text search also supports operators such as -, ^, and so on. To search these letters as string literals, enclose the search expression in double quotes. For example, use "Notebook - Beauty" instead of Notebook - Beauty.
You can improve the relevance of keywords for particular assets to help boost searches based on the keywords. In other words, the images for which you promote specific keywords appear at the top of the search results when you search based on these keywords.
- From the Assets UI, open the properties page for the asset for which you want to promote a keyword.
- Switch to the Advanced tab and click/tap Add under Elevate for search keywords .
- In the Search Promote box, specify a keyword for which you want to boost the search for the image and then click/tap Add . In necessary, specify multiple keywords in the same way.
- Click/tap Save & Close .
- Search for the keyword using the Omnisearch box. The asset for which you promoted this keyword appears among the top search results.