Estendere la ricerca delle risorse extending-assets-search

Puoi estendere Adobe Experience Manager Assets funzionalità di ricerca. Pronti all’uso, 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. Puoi sovrapporre il set predefinito di predicati nella seguente directory: /apps/dam/content/search/searchpanel/facets.

Puoi anche aggiungere altre schede alla Assets pannello di amministrazione.

CAUTION
A partire da Experience Manager 6.4, Interfaccia classica è obsoleto. L’Adobe consiglia di utilizzare l’interfaccia utente touch. Per la personalizzazione, consulta facet di ricerca.

Sovrapposizione overlaying

Per sovrapporre i predicati preconfigurati, copia il facets nodo da /libs/dam/content/search/searchpanel a /apps/dam/content/search/searchpanel/ o specificane un altro facetURL proprietà in searchpanel (l'impostazione predefinita è /libs/dam/content/search/searchpanel/facets.overlay.infinity.json).

screen_shot_2012-06-05at113619am

NOTE
Per impostazione predefinita, la struttura di directory in /apps non esiste, quindi creala. Assicurati che i tipi di nodo corrispondano a quelli in /libs.

Aggiungi schede adding-tabs

Puoi aggiungere altre schede di ricerca configurandole nella sezione Assets interfaccia di amministrazione. Per creare schede aggiuntive:

  1. Creare la struttura di cartelle /apps/wcm/core/content/damadmin/tabs,se non esiste già, e copia il file tabs nodo da /libs/wcm/core/content/damadmin e incollalo.

  2. Crea e configura la seconda scheda, come desiderato.

    note note
    NOTE
    Quando crei un secondo siteadminsearchpanel, assicurati di impostare un id per evitare conflitti tra moduli.

Creare predicati personalizzati creating-custom-predicates

Assets viene fornito con un set di predicati predefiniti che possono essere utilizzati per personalizzare una pagina Condivisione risorse. Questa personalizzazione di una condivisione di risorse è descritta in creare e configurare una pagina Condivisione risorse.

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

La creazione di predicati personalizzati richiede conoscenze di base sulla Framework widget.

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

  1. Crea una cartella di componenti nella directory dei progetti, ad esempio: /apps/weretail/components/titlepredicate.

  2. 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"/>
    
  3. 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>
    
  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. 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).

  6. In entrata Modifica , il nuovo componente è ora disponibile nella barra laterale (disponibile nella Ricerca gruppo). Inserire il componente in Predicati e digita una parola di ricerca, ad esempio Rombo e 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:

  1. Crea una cartella di componenti nella directory dei progetti, ad esempio: /apps/weretail/components/picspredicate.

  2. 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"/>
    
  3. 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();
                        }
                    }
                });
            }
        });
    
  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. 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).

  6. In entrata Modifica , il nuovo componente è ora disponibile nella barra laterale (disponibile nella Ricerca gruppo). Inserire il componente in Predicati colonna.

Widget predicato installati installed-predicate-widgets

I seguenti predicati sono disponibili come widget ExtJS preconfigurati.

PredicatoTestoCompleto fulltextpredicate

Proprietà
Tipo
Descrizione
predicateName
Stringa
Nome del predicato. Impostazione predefinita fulltext
searchCallback
Funzione
Callback per l'attivazione della ricerca sull'evento keyup. Impostazione predefinita CQ.wcm.SiteAdmin.doSearch

PredicatoProprietà propertypredicate

Proprietà
Tipo
Descrizione
predicateName
Stringa
Nome del predicato. Impostazione predefinita property
propertyName
Stringa
Nome della proprietà JCR. Impostazione predefinita jcr:title
defaultValue
Stringa
Valore predefinito precompilato.

PathPredicate pathpredicate

Proprietà
Tipo
Descrizione
predicateName
Stringa
Nome del predicato. Impostazione predefinita path
rootPath
Stringa
Percorso directory principale del predicato. Impostazione predefinita /content/dam
pathFieldPredicateName
Stringa
Impostazione predefinita folder
showFlatOption
Booleano
Contrassegno per visualizzare la casella di controllo search in subfolders. Impostazione predefinita: true.

DatePredicate datepredicate

Proprietà
Tipo
Descrizione
predicateName
Stringa
Nome del predicato. Impostazione predefinita daterange
nomeproprietà
Stringa
Nome della proprietà JCR. Impostazione predefinita jcr:content/jcr:lastModified
defaultValue
Stringa
Valore predefinito precompilato

PredicatoOpzioni optionspredicate

Proprietà
Tipo
Descrizione
titolo
Stringa
Aggiunge un titolo superiore aggiuntivo
predicateName
Stringa
Nome del predicato. Impostazione predefinita daterange
nomeproprietà
Stringa
Nome della proprietà JCR. Impostazione predefinita jcr:content/metadata/cq:tags
comprimi
Stringa
Comprimi livello. Impostazione predefinita level1
triggerSearch
Booleano
Contrassegno flag per l’attivazione della ricerca al momento dell’assegno. Impostazione predefinita: false
searchCallback
Funzione
Callback per l'attivazione della ricerca. Impostazione predefinita CQ.wcm.SiteAdmin.doSearch
searchTimeoutTime
Numero
Timeout prima dell'attivazione di searchCallback. Valore predefinito: 800 ms

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 personalizzazione di una condivisione di risorse è descritta in Creazione e configurazione di una pagina di condivisione delle risorse.

Oltre ad utilizzare ottiche già esistenti, Experience Manager gli sviluppatori possono anche creare i propri obiettivi.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2