Estendi ricerca risorse

È possibile estendere le funzionalità di ricerca Adobe Experience Manager Assets. Experience Manager Assets consente di cercare le risorse in base alle stringhe.

La ricerca viene eseguita tramite l'interfaccia QueryBuilder, in modo da personalizzare la ricerca con diversi predicati. Potete sovrapporre il set predefinito di predicati nella seguente directory: /apps/dam/content/search/searchpanel/facets.

Potete anche aggiungere ulteriori schede al pannello di amministrazione Assets.

Sovrapposizione

Per sovrapporre i predicati preconfigurati, copiate il nodo facets da /libs/dam/content/search/searchpanel a /apps/dam/content/search/searchpanel/ o specificate un'altra proprietà facetURL nella configurazione searchpanel (l'impostazione predefinita è /libs/dam/content/search/searchpanel/facets.overlay.infinity.json).

Aggiungi schede

È possibile aggiungere ulteriori schede di ricerca configurandole nell'interfaccia di amministrazione Assets. Per creare schede aggiuntive:

1. Create la struttura di cartelle /apps/wcm/core/content/damadmin/tabs,se non esiste già, quindi copiate il nodo tabs da /libs/wcm/core/content/damadmin e incollatelo.

2. Create e configurate la seconda scheda, come desiderato.

   NOTA

   Quando si crea una seconda siteadminsearchpanel, assicurarsi di impostare una proprietà id per evitare conflitti tra i moduli.

Creare predicati personalizzati

Assets viene fornito con un set di predicati predefiniti che possono essere utilizzati per personalizzare una pagina Condivisione risorse. La personalizzazione di una condivisione di risorse in questo modo è descritta in creazione e configurazione di una pagina di condivisione di risorse.

Oltre a utilizzare i predicati preesistenti, Experience Manager gli sviluppatori possono anche creare i propri predicati utilizzando l'API Query Builder.

La creazione di predicati personalizzati richiede conoscenze di base sul framework dei widget.

La procedura ottimale consiste nel copiare e regolare un predicato esistente. I predicati di esempio si trovano in /libs/cq/search/components/predicates.

Esempio: Creare un predicato di proprietà semplice

Per creare un predicato di proprietà:

1. Create una cartella di componenti nella directory dei progetti, ad esempio /apps/geometrixx/components/titlepredicate.

2. Aggiungi content.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"/>
   

3. Aggiungi titlepredicate.jsp.

   <%--
   
     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 will be 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: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" etc.)
           // 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 allow to 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>
   

4. 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.

5. Passate al browser e nella pagina di esempio (ad esempio, press.html) passate alla modalità di progettazione e abilitate il nuovo componente per il sistema paragrafo predicato (ad esempio, left).

6. In modalità Edit, il nuovo componente è ora disponibile nella barra laterale (nel gruppo Search). Inserite il componente nella colonna Predicati e digitate una parola di ricerca, ad esempio Diamond, quindi fate clic sulla lente di ingrandimento per avviare la ricerca.

   NOTA

   Durante la ricerca, accertarsi di digitare esattamente il termine, compreso il caso corretto.

Esempio: Creare un predicato di gruppo semplice

Per creare un predicato di gruppo:

1. Create una cartella di componenti nella directory dei progetti, ad esempio /apps/geometrixx/components/picspredicate.

2. Aggiungi content.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"/>
   

3. Aggiungi titlepredicate.jsp:

   <%--
   
     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 will be 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 e.g. "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 etc.
                   "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();
                       }
                   }
               });
           }
       });
   

4. 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.

5. Passate al browser e nella pagina di esempio (ad esempio, press.html) passate alla modalità di progettazione e abilitate il nuovo componente per il sistema paragrafo predicato (ad esempio, left).

6. In modalità Edit, il nuovo componente è ora disponibile nella barra laterale (nel gruppo Search). Inserire il componente nella colonna Predicati.

Widget predicato installati

I seguenti predicati sono disponibili come widget ExtJS preconfigurati.

FulltextPredicate

PropertyPredicate

PathPredicate

DatePredicate

OptionsPredicate

Personalizzare i risultati della ricerca

La presentazione dei risultati della ricerca in una pagina Condivisione risorse è regolata dall’obiettivo selezionato. Experience Manager Assets viene fornito con una serie di obiettivi predefiniti che possono essere utilizzati per personalizzare una pagina Condivisione risorse. La personalizzazione di una condivisione di risorse in questo modo è descritta in Creazione e configurazione di una pagina di condivisione di risorse.

Oltre a utilizzare ottiche preesistenti, gli sviluppatori Experience Manager possono anche creare ottiche proprie.