扩展资产搜索

您可以扩展Adobe Experience Manager Assets搜索功能。 开箱即用，Experience Manager Assets按字符串搜索资产。

搜索通过QueryBuilder界面完成，因此可以使用多个谓词自定义搜索。 可以在以下目录中叠加默认谓词集：/apps/dam/content/search/searchpanel/facets。

您还可以向Assets管理面板添加其他选项卡。

叠加

要叠加预配置的谓词，请将facets节点从/libs/dam/content/search/searchpanel复制到/apps/dam/content/search/searchpanel/，或在searchpanel配置中指定另一个facetURL属性（默认值为/libs/dam/content/search/searchpanel/facets.overlay.infinity.json）。

添加选项卡

您可以通过在Assets管理员界面中配置其他搜索选项卡来添加这些选项卡。 要创建其他选项卡：

1. 如果文件夹结构/apps/wcm/core/content/damadmin/tabs,尚不存在，请创建该文件夹结构，并从/libs/wcm/core/content/damadmin复制tabs节点并粘贴它。

2. 根据需要创建和配置第二个选项卡。

   注意

   创建第二个siteadminsearchpanel时，请务必设置id属性，以防止表单冲突。

创建自定义谓词

Assets 附带一组预定义谓词，可用于自定义资产共享页面。以这种方式自定义资产共享在创建和配置资产共享页面中有介绍。

除了使用预存在的谓词，Experience Manager开发人员还可以使用查询生成器API创建自己的谓词。

创建自定义谓词需要有关构件框架的基本知识。

最佳实践是复制现有谓词并对其进行调整。 示例谓词位于​/libs/cq/search/components/谓词​中。

示例：生成简单属性谓词

要构建属性谓词，请执行以下操作：

1. 在项目目录中创建组件文件夹，例如​/apps/geometrixx/components/titlepredicate。

2. 添加​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. 将 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. 为了使组件可用，您需要能够对其进行编辑。要使组件可编辑，请在 CRXDE 中添加主类型 cq:EditConfig 的 cq:editConfig 节点。为了删除段落，请添加带有单个值 DELETE 的多值属性 cq:actions。

5. 导航到浏览器，在示例页面（例如​press.html）上切换到设计模式，为谓词段落系统启用新组件（例如​left）。

6. 在​编辑​模式中，新组件现在可在Sidekick中使用（位于​搜索​组中）。 将组件插入​谓词​列并键入搜索词，例如​菱形，然后单击放大镜以开始搜索。

   注意

   搜索时，请务必准确键入术语，包括正确的大小写。

示例：生成简单的组谓词

要生成组谓词，请执行以下操作：

1. 在项目目录中创建组件文件夹，例如​/apps/geometrixx/components/picspredicate。

2. 添加​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. 添加​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. 为了使组件可用，您需要能够对其进行编辑。要使组件可编辑，请在 CRXDE 中添加主类型 cq:EditConfig 的 cq:editConfig 节点。为了删除段落，请添加带有单个值 DELETE 的多值属性 cq:actions。

5. 导航到浏览器，在示例页面（例如​press.html）上切换到设计模式，为谓词段落系统启用新组件（例如​left）。

6. 在​编辑​模式中，新组件现在可在Sidekick中使用（位于​搜索​组中）。 将组件插入​谓词​列。

已安装的谓词构件

以下谓词可用作预配置的ExtJS构件。

全文谓词

属性谓词

路径谓词

日期谓词

选项谓词

自定义搜索结果

在“资产共享”页面上显示搜索结果受所选镜头的约束。 Experience Manager Assets 附带一组预定义的镜头，可用于自定义资产共享页面。以这种方式自定义资产共享在创建和配置资产共享页面中有介绍。

除了使用预存的镜头外，Experience Manager开发者还可以创建自己的镜头。