Estendere la ricerca delle risorse extending-assets-search
È possibile estendere le funzionalità di ricerca di Adobe Experience Manager Assets. Experience Manager Assets cerca le risorse per stringhe.
La ricerca viene eseguita tramite l'interfaccia QueryBuilder, in modo che la ricerca possa essere personalizzata con diversi predicati. È possibile sovrapporre il set predefinito di predicati nella seguente directory: /apps/dam/content/search/searchpanel/facets
.
È inoltre possibile aggiungere ulteriori schede al pannello di amministrazione Assets.
Sovrapposizione overlaying
Per sovrapporre i predicati preconfigurati, copiare il nodo facets
da /libs/dam/content/search/searchpanel
a /apps/dam/content/search/searchpanel/
o specificare un'altra proprietà facetURL
nella configurazione searchpanel
(l'impostazione predefinita è /libs/dam/content/search/searchpanel/facets.overlay.infinity.json
).
/apps
non esiste, quindi creala. Assicurarsi che i tipi di nodo corrispondano a quelli in /libs
.Aggiungi schede adding-tabs
È possibile aggiungere ulteriori schede di ricerca configurandole nell'interfaccia di amministrazione Assets. Per creare schede aggiuntive:
-
Creare la struttura di cartelle
/apps/wcm/core/content/damadmin/tabs,
se non esiste già, copiare il nodotabs
da/libs/wcm/core/content/damadmin
e incollarlo. -
Crea e configura la seconda scheda, come desiderato.
note note NOTE Quando crei un secondo siteadminsearchpanel
, assicurati di impostare una proprietàid
per evitare conflitti di modulo.
Creare predicati personalizzati creating-custom-predicates
Assets include un set di predicati predefiniti che è possibile utilizzare per personalizzare una pagina Condivisione risorse. Questa modalità di personalizzazione di una condivisione risorse è descritta in creare e configurare una pagina Condivisione risorse.
Oltre a utilizzare i predicati preesistenti, gli sviluppatori di Experience Manager possono anche creare i propri predicati utilizzando API Query Builder.
La creazione di predicati personalizzati richiede conoscenze di base sul framework Widgets.
La best practice prevede di copiare un predicato esistente e regolarlo. I predicati di esempio sono in /libs/cq/search/components/predicates.
Esempio: creare un predicato di proprietà semplice example-build-a-simple-property-predicate
Per creare un predicato di proprietà:
-
Creare una cartella di componenti nella directory dei progetti, ad esempio /apps/weretail/components/titlepredicate.
-
Aggiungi content.xml:
code language-xml <?xml version="1.0" encoding="UTF-8"?> <jcr:root xmlns:sling="https://sling.apache.org/jcr/sling/1.0" xmlns:cq="https://www.day.com/jcr/cq/1.0" xmlns:jcr="https://www.jcp.org/jcr/1.0" jcr:primaryType="cq:Component" jcr:title="Title Predicate" sling:resourceSuperType="foundation/components/parbase" allowedParents="[*/parsys]" componentGroup="Search"/>
-
Aggiungi
titlepredicate.jsp
.code language-java <%-- Sample title predicate component --%><%@ page import="java.util.Calendar" %><% %><%@include file="/libs/foundation/global.jsp"%><% // A unique id is necessary in case this predicate is inserted multiple times on the same page String elemId = "cq-predicate-" + Long.toString(Calendar.getInstance().getTimeInMillis()); %><div class="predicatebox"> <div class="title">Title</div> <%-- The wrapper for the form elements. All items are appended to this wrapper. --%> <div id="<%= elemId %>" class="content"></div> </div><script type="text/javascript"> CQ.Ext.onLoad(function() { var predicateName = "property"; var propertyName = "jcr:content/metadata/dc:title"; var elemId = "<%= elemId %>"; // Get the page wide available QueryBuilder. var qb = CQ.search.Util.getQueryBuilder(); // createId adds a counter to the predicate name - useful in case this predicate // is inserted multiple times on the same page. var id = qb.createId(predicateName); // Hidden field that defines the property to search for; in our case this // is the "dc:title" metadata. The name "property" (or "1_property", "2_property", and so on.) // indicates the server to use the property predicate // (com.day.cq.search.eval.JcrPropertyPredicateEvaluator). qb.addField({ "xtype": "hidden", "renderTo": elemId, "name": id, "value": propertyName }); // The visible text field. The name has to be like the one of the hidden field above // plus the ".value" suffix. qb.addField({ "xtype": "textfield", "renderTo": elemId, "name": id + ".value" }); // Depending on the predicate, additional parameters let you configure the // predicate. Here we add an operation parameter to create a "like" query. // Again note the name set to the id and a suffix. qb.addField({ "xtype": "hidden", "renderTo": elemId, "name": id + ".operation", "value": "like" }); }); </script>
-
Per rendere disponibile il componente, devi essere in grado di modificarlo. Per rendere modificabile un componente, in CRXDE aggiungi un nodo cq:editConfig di tipo principale cq:EditConfig. Per rimuovere i paragrafi, aggiungi una proprietà con più valori cq:actions che presenta un singolo valore DELETE.
-
Passa al browser e, nella pagina di esempio (ad esempio, press.html), passa alla modalità progettazione e abilita il nuovo componente per il sistema paragrafo predicato (ad esempio, left).
-
In modalità Modifica, il nuovo componente è ora disponibile nella barra laterale (nel gruppo Ricerca). Inserire il componente nella colonna Predicati e digitare una parola di ricerca, ad esempio Rombo, quindi fare clic sulla lente di ingrandimento per avviare la ricerca.
note note NOTE Durante la ricerca, accertati di digitare esattamente il termine, comprese le lettere maiuscole e minuscole corrette.
Esempio: creare un predicato di gruppo semplice example-build-a-simple-group-predicate
Per creare un predicato di gruppo:
-
Crea una cartella di componenti nella directory dei progetti, ad esempio /apps/weretail/components/picspredicate.
-
Aggiungi content.xml:
code language-xml <?xml version="1.0" encoding="UTF-8"?> <jcr:root xmlns:sling="https://sling.apache.org/jcr/sling/1.0" xmlns:cq="https://www.day.com/jcr/cq/1.0" xmlns:jcr="https://www.jcp.org/jcr/1.0" jcr:primaryType="cq:Component" jcr:title="Image Formats" sling:resourceSuperType="foundation/components/parbase" allowedParents="[*/parsys]" componentGroup="Search"/>
-
Aggiungi titlepredicate.jsp:
code language-java <%-- Sample group predicate component --%><%@ page import="java.util.Calendar" %><% %><%@include file="/libs/foundation/global.jsp"%><% // A unique id is necessary in case this predicate is inserted multiple times on the same page. String elemId = "cq-predicate-" + Long.toString(Calendar.getInstance().getTimeInMillis()); %><div class="predicatebox"> <div class="title">Image Formats</div> <%-- The wrapper for the form elements. All items are append to this wrapper. --%> <div id="<%= elemId %>" class="content"></div> </div><script type="text/javascript"> CQ.Ext.onLoad(function() { var predicateName = "property"; var propertyName = "jcr:content/metadata/dc:format"; var elemId = "<%= elemId %>"; // Get the page wide available QueryBuilder. var qb = CQ.search.Util.getQueryBuilder(); // Create a unique group ID; will return for example, "1_group". var groupId = qb.createGroupId(); // Hidden field that defines the property to search for - in our case "dc:format" - // and declares the group of predicates. "property" in the name ("1_group.property") // indicates to the server to use the "property predicate" // (com.day.cq.search.eval.JcrPropertyPredicateEvaluator). qb.addField({ "xtype": "hidden", "renderTo": "<%= elemId %>", "name": groupId + "." + predicateName, // 1_group.property "value": propertyName }); // Declare to combine the multiple values using OR. qb.add(new CQ.Ext.form.Hidden({ "name": groupId + ".p.or", // 1_group.p.or "value": "true" })); // The options var options = [ { "label":"JPEG", "value":"image/jpeg"}, { "label":"PNG", "value":"image/png" }, { "label":"GIF", "value":"image/gif" } ]; // Build a checkbox for each option. for (var i = 0; i < options.length; i++) { qb.addField({ "xtype": "checkbox", "renderTo": "<%= elemId %>", // 1_group.property.0_value, 1_group.property.1_value, and so on. "name": groupId + "." + predicateName + "." + i + "_value", "inputValue": options[i].value, "boxLabel": options[i].label, "listeners": { "check": function() { // Submit the search form when checking/unchecking a checkbox. qb.submit(); } } }); } });
-
Per rendere disponibile il componente, devi essere in grado di modificarlo. Per rendere modificabile un componente, in CRXDE aggiungi un nodo cq:editConfig di tipo principale cq:EditConfig. Per rimuovere i paragrafi, aggiungi una proprietà con più valori cq:actions che presenta un singolo valore DELETE.
-
Passa al browser e, nella pagina di esempio (ad esempio, press.html), passa alla modalità progettazione e abilita il nuovo componente per il sistema paragrafo predicato (ad esempio, left).
-
In modalità Modifica, il nuovo componente è ora disponibile nella barra laterale (nel gruppo Ricerca). Inserire il componente nella colonna Predicati.
Widget predicato installati installed-predicate-widgets
I seguenti predicati sono disponibili come widget ExtJS preconfigurati.
PredicatoTestoCompleto fulltextpredicate
fulltext
keyup
. Impostazione predefinita: CQ.wcm.SiteAdmin.doSearch
PredicatoProprietà propertypredicate
property
jcr:title
PathPredicate pathpredicate
path
/content/dam
folder
search in subfolders
. Impostazione predefinita: true.DatePredicate datepredicate
daterange
jcr:content/jcr:lastModified
PredicatoOpzioni optionspredicate
daterange
jcr:content/metadata/cq:tags
level1
CQ.wcm.SiteAdmin.doSearch
Personalizzare i risultati della ricerca customizing-search-results
La presentazione dei risultati della ricerca in una pagina Condivisione risorse è regolata dall’obiettivo selezionato. Experience Manager Assets viene fornito con un set di obiettivi predefiniti che possono essere utilizzati per personalizzare una pagina Condivisione risorse. Questa modalità di personalizzazione di una condivisione risorse è descritta in Creazione e configurazione di una pagina di condivisione risorse.
Oltre a utilizzare obiettivi preesistenti, gli sviluppatori di Experience Manager possono creare obiettivi personalizzati.