Upgrading Custom Search Forms upgrading-custom-search-forms
In AEM 6.2, the location where Customized Search Forms are stored in the repository has changed. Upon upgrading, they are moved from their location in 6.1 at:
- /apps/cq/gui/content/facets
to a new location under:
- /conf/global/settings/cq/search/facets
Because of this, manual adjustments are required after an upgrade in order for the forms to continue to function.
This applies to new Search Forms and default Forms that have been customized.
For more information, see the documentation on Search Facets.
Changing the resourceType property changing-the-resourcetype-property
Unless stated otherwise, most of the adjustments that need to be done after the upgrade require changing the sling:resourceType property for the configured custom Search Forms. This is needed so that the property points to the correct location of the rendering script.
You can change the property by doing the following:
- Open CRXDE Lite by going to
https://server:port/crx/de/index.jsp - Browse to the location of the node that needs to be adjusted, as specified in the List of Custom Search Forms below.
- Click the node. In the right properties pane, click and modify the sling:resourceType property.
- Finally, save the changes by pressing the Save All button.
List of Custom Search Forms list-of-custom-search-forms
Below you will find a list of all cusom Search Forms and the modifications they require after the upgrade. They refer to the names in /conf/global/settings/cq/search/facets/sites/items.
Fulltext Predicate with node name “fulltext” fulltext-predicate-with-node-name-fulltext
In AEM 6.1, the standard fulltext predicate was part of the search form. In 6.2, the fulltext field has been replaced by the OmniSearch. This predicate is skipped programmatically and can be removed.
Action: Remove the node entirely.
Other Fulltext Predicates other-fulltext-predicates
Action: Adjust the resourceType property (add “/coral” like in the 6.2 location indicated above).
Path Browser Predicates path-browser-predicates
Action: Adjust the resourceType property (add “/coral” like in the 6.2 location indicated above).
Tags Predicates tags-predicates
Action: Adjust the resourceType property (add “/coral” like in the 6.2 location indicated above).
Page Status Predicate page-status-predicate
The Page Status has been replaced by two Options Property Predicates, one for publish and one for LiveCopy status.
Actions:
-
Remove the
pagestatuspredicatenode -
Copy node
/libs/settings/cq/search/facets/sites/jcr:content/items/publishstatuspredicate- to
/conf/global/settings/cq/search/facets/sites/jcr:content/items
-
Copy node
/libs/settings/cq/search/facets/sites/jcr:content/items/livecopystatuspredicate- to
/conf/global/settings/cq/search/facets/sites/jcr:content/items
-
Make sure you set
listOrderproperty for theanalyticspredicatenode to “8”. This is needed to avoid conflicts.
Date Range Predicates date-range-predicates
Action: Adjust the resourceType property (add “/coral” like in the 6.2 location indicated above).
Hidden Filter hidden-filter
Action: Nothing to adjust.
Analytics Predicate analytics-predicate
Action: Adjust the resourceType property (add “/coral” like in the 6.2 location indicated above).
Range Predicate range-predicate
Action: Adjust the resourceType property (add “/coral” like in the 6.2 location indicated above).
Options Property Predicate options-property-predicate
Action: Adjust the resourceType property (add “/coral” like in the 6.2 location indicated above).
Slider Range Predicate slider-range-predicate
Action: Adjust the resourceType property (add “/coral” like in the 6.2 location indicated above).
Components Predicate components-predicate
Action: Adjust the resourceType property (add “/coral” like in the 6.2 location indicated above).
Author Predicate author-predicate
Action: Adjust the resourceType property (add “/coral” like in the 6.2 location indicated above).
Templates Predicate templates-predicate
Action: Adjust the resourceType property (add “/coral” like in the 6.2 location indicated above).
Assets Admin Search Rail assets-admin-search-rail
The nodes below refer to the names in /conf/global/settings/dam/search/facets/assets/items
Fulltext Predicate with node name “fulltext” fulltext-predicate-with-node-name-fulltext-1
In 6.1 the standard fulltext predicate was part of the search form. In 6.2 the fulltext field has been replaced by OmniSearch. This predicate is skipped programmatically and can be removed.
Action: Remove the above mentioned node.
Path Browser Predicates path-browser-predicates-1
Action: Adjust the resourceType property (add “/coral” like in the 6.2 location indicated above).
Mime Type Predicates mime-type-predicates
Action: Adjust the resourceType property (add “/coral” like in the 6.2 location indicated above).
File Size Predicates file-size-predicates
Action: Adjust resourceType as shown in the 6.2 location above.
Asset Last Modified Predicates asset-last-modified-predicates
Action: Adjust the resourceType property (add “/coral” like in the 6.2 location indicated above).
Publish Predicate publish-predicate
Actions:
-
Adjust the
resourceTypeproperty (add “/coral” like in the 6.2 location indicated above) -
Add an
optionPaths(of type String) property with the value:/libs/dam/options/predicates/publish -
Add
singleSelectproperty with boolean valuetrue.
Status Predicates status-predicates
Action: Adjust the resourceType property (add “/coral” like in the 6.2 location indicated above)
Expiry Status Predicates expiry-status-predicates
Action: Adjust the resourceType property (add “/coral” like in the 6.2 location indicated above)
Metadata Validity Predicates metadata-validity-predicates
Action: Adjust the resourceType property (add “/coral” like in the 6.2 location indicated above)
Rating Predicates rating-predicates
Action: Adjust the resourceType property (add “/coral” like in the 6.2 location indicated above)
Orientation Predicate orientation-predicate
Actions:
-
Adjust the
resourceTypeproperty (add “/coral” like in the 6.2 location indicated above) -
Add a
fieldLabelproperty with the same value as thetextproperty on the same node. -
Add an
emptyTextproperty with the value same as thetextproperty on the same node. -
Add a
rootPathproperty with the same value same as theoptionPathsproperty on the same node.
Style Predicate style-predicate
Actions:
-
Adjust the
resourceTypeproperty (add “/coral” like in the 6.2 location indicated above) -
Add a
fieldLabelproperty with the same value as thetextproperty on the same node. -
Add an
emptyTextproperty with the value same as thetextproperty on the same node. -
Add a
rootPathproperty with the same value same as theoptionPathsproperty on the same node.
Video Format Predicates video-format-predicates
Action: Adjust the resourceType property (add “/coral” like in the 6.2 location indicated above)
Mainasset Predicate mainasset-predicate
Action: Adjust the resourceType property (add “/coral” like in the 6.2 location indicated above)