GQL full-text search

You're viewing help content for version:

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":

From the toolbar of the Assets console, click or tap the Search icon to display the Omni Search box.

With the cursor in the Omni Search box, press Enter.

Click or tap the GlobalNav icon to display the Filters & Options panel.

In the search field, specify the value "Target." To limit your search to a specific folder, click or tap the Browse icon and select the folder. In this case, the match is searched for only within the folder and the child folders under it.

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.

Note:

GQL full-text search works for full-text predicates only.

PROPERTY	SEARCH FORMAT (FACET VALUE)
Title	title:John
Creator	creator:John
Contributor	contributor:John
Location	location:India
Description	description:"Sample Image"
Creator tool	creatortool:"Adobe Photoshop 7.0"
Copyright Owner	copyrightowner:"Adobe Systems"
Contributor	contributor:John
Usage Terms	usageterms:"CopyRights Reserved"
Created	created:YYYY-MMDDTHH: MM:SS.000+05:30..YYYY-MMDDTHH: MM:SS.000+05:30
Expires Date	expires:YYYY-MMDDTHH: MM:SS.000+05:30..YYYY-MMDDTHH: MM:SS.000+05:30
On time	ontime:YYYY-MMDDTHH: MM:SS.000+05:30..YYYY-MMDDTHH: MM:SS.000+05:30
Off time	offtime:YYYY-MMDDTHH: MM:SS.000+05:30..YYYY-MMDDTHH: MM:SS.000+05:30
Range of time(expires dateontime,offtime)	facet field : lowerbound..upperbound
Path	/content/dam/<folder name>
PDF Title	pdftitle:"Adobe Document"
Subject	subject:"Training"
Tags	tags:"Location And Travel"
Type	type:"image\png"
Width of image	width:lowerbound..upperbound
Height of image	height:lowerbound..upperbound
Person	person:John

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)

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)

title:Scott*

To display assets with property values ending with a specific string (for example: title is Scott Reynolds)

title:*Reynolds

To display assets with a property value that contains a specific string (for example: title = Basel Meeting Room)

title:*Meeting*

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*

Note:

The properties path,limit,size and orderby can't be ORed with any other properties.

The keyword for user generated properties is the Field Label value for that property in property editor form with spaces removed and in lower case .

Note:

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.