Erweitern der Asset-Suche extending-assets-search
Sie können die Suchfunktionen von Adobe Experience Manager Assets erweitern. Standardmäßig sucht Experience Manager Assets anhand von Zeichenfolgen nach Assets.
Die Suchfunktion wird über die QueryBuilder-Schnittstelle durchgeführt und lässt sich mit mehreren Eigenschaften anpassen. Sie können den Standardsatz der Eigenschaften im folgenden Verzeichnis überlagern: /apps/dam/content/search/searchpanel/facets
.
Sie können dem Admin-Bedienfeld von Assets auch zusätzliche Registerkarten hinzufügen.
Überlagerung overlaying
Um die vorkonfigurierten Eigenschaften zu überlagern, kopieren Sie den facets
-Knoten aus /libs/dam/content/search/searchpanel
nach /apps/dam/content/search/searchpanel/
oder geben Sie eine weitere facetURL
-Eigenschaft in searchpanel
der Konfiguration des Suchfensters an (standardmäßig /libs/dam/content/search/searchpanel/facets.overlay.infinity.json
).
/apps
nicht vorhanden und muss erstellt werden. Stellen Sie sicher, dass die Knotentypen den Typen unter /libs
entsprechen.Hinzufügen von Registerkarten adding-tabs
Sie können zusätzliche Suchregisterkarten hinzufügen, indem Sie sie in der Admin-Benutzeroberfläche von Assets konfigurieren. So erstellen Sie weitere Registerkarten:
-
Erstellen Sie die Ordnerstruktur
/apps/wcm/core/content/damadmin/tabs,
, falls noch nicht vorhanden, kopieren Sie den Knotentabs
aus/libs/wcm/core/content/damadmin
und fügen Sie ihn ein. -
Erstellen und konfigurieren Sie die zweite Registerkarte wie gewünscht.
note note NOTE Achten Sie bei Erstellung eines zweiten siteadminsearchpanel
auf die Festlegung einerid
-Eigenschaft, um Formularkonflikte zu vermeiden.
Erstellen benutzerdefinierter Eigenschaften creating-custom-predicates
Assets umfasst einen Satz vordefinierter Eigenschaften, mit denen eine Asset-Freigaben-Seite angepasst werden kann. Das Anpassen einer Asset-Freigabe auf diese Weise wird unter Erstellen und Konfigurieren einer Asset-Freigaben-Seite beschrieben.
Experience Manager-Entwicklerinnen und -Entwickler können neben den bereits vorhandenen Prädikaten auch eigene Prädikate erstellen. Hierfür können sie die QueryBuilder-API verwenden.
Um benutzerdefinierte Eigenschaften erstellen zu können, benötigen Sie Grundlagenkenntnisse über das Widget-Framework.
Es sich als Best Practice erwiesen, eine vorhandene Eigenschaft zu kopieren und anzupassen. Beispieleigenschaften finden Sie unter /libs/cq/search/components/predicates.
Beispiel: Einfaches Eigenschaftsprädikat erstellen example-build-a-simple-property-predicate
So erstellen Sie ein Eigenschaftsprädikat:
-
Erstellen Sie einen Komponentenordner in Ihrem Projektverzeichnis, z. B. /apps/weretail/components/titlepredicate.
-
Fügen Sie content.xml hinzu:
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"/>
-
Fügen Sie
titlepredicate.jsp
hinzu.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>
-
Sie müssen die Komponente bearbeiten, um sie verfügbar zu machen. Um eine Komponente bearbeiten zu können, fügen Sie in CRXDE den Knoten cq:editConfig des primären Typs cq:EditConfig hinzu. Damit Sie Absätze entfernen können, fügen Sie die Eigenschaft cq:actions mit mehreren Werten mit dem einzelnen Wert LÖSCHEN hinzu.
-
Navigieren Sie zu Ihrem Browser und wechseln Sie auf Ihrer Beispielseite (z. B. press.html) in den Design-Modus. Aktivieren Sie Ihre neue Komponente für das Absatzsystem der Eigenschaft (z. B. links).
-
Im Modus Bearbeiten ist die neue Komponente jetzt im Sidekick verfügbar (in der Suchgruppe). Fügen Sie die Komponente in die Spalte Eigenschaften ein, geben Sie einen Suchbegriff – z. B. Raute – ein und klicken Sie auf das Lupensymbol, um die Suche zu starten.
note note NOTE Stellen Sie beim Suchen sicher, dass der Begriff korrekt eingegeben wird und auch die Groß-/Kleinschreibung stimmt.
Beispiel: Einfache Gruppeneigenschaft erstellen example-build-a-simple-group-predicate
So erstellen Sie eine Gruppeneigenschaft:
-
Erstellen Sie einen Komponentenordner in Ihrem Projektverzeichnis, z. B. /apps/weretail/components/picspredicate.
-
Fügen Sie content.xml hinzu:
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"/>
-
Fügen Sie titlepredicate.jsp hinzu:
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(); } } }); } });
-
Sie müssen die Komponente bearbeiten, um sie verfügbar zu machen. Um eine Komponente bearbeiten zu können, fügen Sie in CRXDE den Knoten cq:editConfig des primären Typs cq:EditConfig hinzu. Damit Sie Absätze entfernen können, fügen Sie die Eigenschaft cq:actions mit mehreren Werten mit dem einzelnen Wert LÖSCHEN hinzu.
-
Navigieren Sie zu Ihrem Browser und wechseln Sie auf Ihrer Beispielseite (z. B. press.html) in den Design-Modus. Aktivieren Sie Ihre neue Komponente für das Absatzsystem der Eigenschaft (z. B. links).
-
Im Modus Bearbeiten ist die neue Komponente jetzt im Sidekick verfügbar (in der Suchgruppe). Fügen Sie die Komponente in die Spalte Eigenschaften ein.
Installierte Eigenschaften-Widgets installed-predicate-widgets
Die folgenden Prädikate sind als vorkonfigurierte ExtJS-Widgets verfügbar.
FulltextPredicate fulltextpredicate
fulltext
keyup
. Standardwert ist CQ.wcm.SiteAdmin.doSearch
PropertyPredicate propertypredicate
property
jcr:title
PathPredicate pathpredicate
path
/content/dam
folder
search in subfolders
. Standardwert ist „true“.DatePredicate datepredicate
daterange
jcr:content/jcr:lastModified
OptionsPredicate optionspredicate
daterange
jcr:content/metadata/cq:tags
level1
CQ.wcm.SiteAdmin.doSearch
Anpassen der Suchergebnisse customizing-search-results
Die Darstellung von Suchergebnissen in einer Asset-Freigaben-Seite wird durch die ausgewählte Linse geregelt. Experience Manager Assets umfasst einen Satz vordefinierter Linsen, mit denen Sie eine Asset-Freigaben-Seite anpassen können. Diese Art der Anpassung einer Asset-Freigabe wird unter Erstellen und Konfigurieren einer Asset-Freigaben-Seite beschrieben.
Zusätzlich zu den bereits vorhandenen Linsen können Experience Manager-Entwicklerinnen und -Entwickler auch eigene Linsen erstellen.