Ampliación de la búsqueda de recursos extending-assets-search
Puede ampliar las funciones de búsqueda de Adobe Experience Manager Assets. Fuera de la caja, Experience Manager Los recursos buscan recursos por cadenas.
La búsqueda se realiza a través de la interfaz de QueryBuilder para que la búsqueda se pueda personalizar con varios predicados. Puede superponer el conjunto predeterminado de predicados en el siguiente directorio: /apps/dam/content/search/searchpanel/facets
.
También puede agregar fichas adicionales al Experience Manager Panel de administración de recursos.
Superposición overlaying
Para superponer los predicados preconfigurados, copie el facets
nodo de /libs/dam/content/search/searchpanel
a /apps/dam/content/search/searchpanel/
o especificar otro facetURL
en la configuración del panel de búsqueda (el valor predeterminado es /libs/dam/content/search/searchpanel/facets.overlay.infinity.json
).
apps
no existe y debe crearse. Asegúrese de que los tipos de nodo coinciden con los de / libs
.Adición de pestañas adding-tabs
Puede agregar fichas de búsqueda adicionales configurándolas en la sección Experience Manager Administrador de recursos. Para crear pestañas adicionales:
-
Crear la estructura de carpetas
/apps/wcm/core/content/damadmin/tabs,
si aún no existe, y copie latabs
nodo de/libs/wcm/core/content/damadmin
y péguelo. -
Cree y configure la segunda pestaña como desee.
note note NOTE Cuando cree un segundo panel siteadminsearchpanel, asegúrese de establecer un id
para evitar conflictos de formularios.
Creación de predicados personalizados creating-custom-predicates
Experience Manager Assets viene con un conjunto de predicados predefinidos que pueden utilizarse para personalizar una página de uso compartido de recursos. La personalización de un recurso compartido de esta forma se explica en Creación y configuración de una página de uso compartido de recursos.
Además de usar predicados preexistentes, Experience Manager los desarrolladores también pueden crear sus propios predicados utilizando API del generador de consultas.
La creación de predicados personalizados requiere conocimientos básicos sobre Marco de utilidades.
La práctica recomendada es copiar un predicado existente y ajustarlo. Los predicados de ejemplo se encuentran en /libs/cq/search/components/predicates
.
Ejemplo: Crear un predicado de propiedad simple example-build-a-simple-property-predicate
Para crear un predicado de propiedad:
-
Cree una carpeta de componentes en el directorio de proyectos, por ejemplo
/apps/geometrixx/components/titlepredicate
. -
Añadir
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"/>
-
Añadir
titlepredicate.jsp
.code language-xml <%-- 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>
-
Para que el componente esté disponible, hace falta poder editarlo. Para hacer que un componente sea editable, en CRXDE, agregue un nodo
cq:editConfig
de tipo principalcq:EditConfig
. Para poder eliminar párrafos, agregue una propiedad de varios valorescq:actions
con un único valor de ELIMINAR. -
Vaya al explorador y a la página de muestra (por ejemplo,
press.html
) cambiar al modo de diseño y activar el nuevo componente para el sistema de párrafos predicado (por ejemplo, left). -
En Editar , el nuevo componente ya está disponible en la barra de tareas (que se encuentra en la Buscar grupo). Inserte el componente en el Predicados y escriba una palabra de búsqueda, por ejemplo, Diamante y haga clic en la lupa para iniciar la búsqueda.
note note NOTE Al buscar, asegúrese de escribir el término exactamente, incluidas las mayúsculas y minúsculas correctas.
Ejemplo: Crear un predicado de grupo simple example-build-a-simple-group-predicate
Para crear un predicado de grupo:
-
Cree una carpeta de componentes en el directorio de proyectos, por ejemplo
/apps/geometrixx/components/picspredicate
. -
Añadir
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"/>
-
Añadir
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 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(); } } }); } });
-
Para que el componente esté disponible, hace falta poder editarlo. Para hacer que un componente sea editable, en CRXDE, agregue un nodo
cq:editConfig
de tipo principalcq:EditConfig
. Para poder eliminar párrafos, agregue una propiedad de varios valorescq:actions
con un solo valor deDELETE
. -
Vaya al explorador y a la página de muestra (por ejemplo,
press.html
) cambiar al modo de diseño y activar el nuevo componente para el sistema de párrafos predicado (por ejemplo, left). -
En Editar , el nuevo componente ya está disponible en la barra de tareas (que se encuentra en la Buscar grupo). Inserte el componente en el Predicados para abrir el Navegador.
Widgets de predicados instalados installed-predicate-widgets
Los siguientes predicados están disponibles como widgets preconfigurados de ExtJS.
Predicado de texto completo fulltextpredicate
fulltext
keyup
. El valor predeterminado es CQ.wcm.SiteAdmin.doSearch
PropertyPredicate propertypredicate
property
jcr:title
PathPredicate pathpredicate
path
/content/dam
folder
search in subfolders
. El valor predeterminado es true.DatePredicate datepredicate
daterange
jcr:content/jcr:lastModified
OptionsPredicate optionspredicate
daterange
jcr:content/metadata/cq:tags
level1
CQ.wcm.SiteAdmin.doSearch
Personalización de resultados de búsqueda customizing-search-results
La presentación de los resultados de búsqueda en una página Uso compartido de recursos se rige por la lente seleccionada. Experience Manager Assets viene con un conjunto de objetivos predefinidos que se pueden utilizar para personalizar una página de uso compartido de recursos. La personalización de un recurso compartido de esta forma se explica en Creación y configuración de una página de uso compartido de recursos.
Además de usar lentes preexistentes, Experience Manager los desarrolladores también pueden crear sus propias lentes.