关于模板

您可以使用​Templates​管理演示文稿模板和传输模板。

关于模板

您可以添加、编辑、复制、重命名或删除演示文稿模板和传输模板。 单击“模板”(Templates)表格中的现有模板名称后，该模板将在编辑器（或查看器）窗口中打开，您可以在该窗口中进行更改。

您可以从模板名称的“模板”(Templates)表格的下拉列表中，使用“历史记录”(History)功能还原您对模板所做的任何更改。

您可以通过选中模板表中模板的相应​Minimize​复选框来减少演示文稿模板的页面权重。 通过减少模板的页面权重，可动态地最小化内嵌JavaScript和CSS。 您还可以删除HTML中的多余空白。 最大程度地减少演示文稿模板的页面权重有助于更快地交付搜索结果。

单击文件名旁边的下拉列表，然后单击​Preview minimized，可以预览最小化的模板的外观。 如果最小化主演示文稿模板，请确保记住启用最小化（带有guided-include标记）模板，因为此选项不可继承。

即使将演示文稿模板最小化，您仍然可以编辑同一模板的“未最小化”版本。

您可以使用预搜索规则、后搜索规则和业务规则来确定何时使用其他演示模板之一。 通常有一条规则，如“对于每次搜索，将目标模板设置为xxxx”。 如果存在此类规则，则当您在“模板”(Templates)表格中更改“默认”(Default)模板时，该规则似乎不起作用。

请参阅关于预搜索规则。

请参阅关于搜索后规则。

请参阅关于Business Rules。

关于演示文稿模板

演示文稿模板是客户在您的网站上查看搜索结果时看到的HTML模板。

在您的表示层中，您可以有一个表示模板，用于显示来自不同来源的多个搜索的结果。 您可以根据需要定义任意数量的演示文稿模板，甚至可以使用include命令定义其他模板共享的演示文稿模板。 演示文稿模板是所有设计组件（如彩块化、菜单和痕迹导航）汇集在一起的位置。 要显示各种设计组件，必须使用演示文稿模板标签。

请参阅演示文稿模板标签

当您有多个演示文稿模板时，您可以在何种条件下定义使用各种演示文稿模板。 您可以根据传入的CGI参数和Cookie选择要使用的演示文稿模板。 或者，您可以根据之前搜索的结果切换您使用的演示文稿模板。

当您使用多个演示文稿模板时，请确保指明您希望最初显示搜索结果的模板。 可以使用“模板”(Templates)表格的​Default​列执行此操作。

关于传输模板

传输模板可以是XML或JSON模板，这些模板会将数据从后端搜索传递到引导搜索演示层。

默认情况下，您的帐户配置为使用XML传输模板。 但是，如果您希望使用JSON将数据传递到引导搜索，请与可以为您提供帮助的Adobe咨询部门联系。

在您的表示层中，您可以有一个表示多个搜索结果的表示模板。 每个搜索可以使用相同的传输模板或自定义传输模板将数据传递到表示层。 由于传输模板仅用于将数据传递到表示层，因此它不得具有用于显示搜索结果的任何HTML。 模板使用传输模板标记传递搜索结果和结果以填充彩块化。 在这些标记中，标准搜索模板标记用于显示实际值。

请参阅搜索模板标记。

特定于XML传输模板的标签

XML传输模板标签

描述

<guided-xml></guided-xml>

这些是表示层用来检测其必须从传输模板中解析的内容的根XML标签。

<general></general>

这组标签环绕搜索模板标签，这些标签根据结果集提供摘要数据。 通常，这些标记包含搜索标记，用于搜索结果总数、最低结果和最高结果。 您可以使用 general-field 标记定义所需的任意数量的附加全局字段。

示例

    <general>       <total><search-total /></total>       <lower><search-lower /></lower>       <upper><search-upper /></upper>       <general-field name="my_custom_field">Some global content</general-field>     </general>

<results></results>

这组标记包含在搜索结果周围，以便“向导式搜索”知道在哪里查找它们。

<result></result>

这组标签围绕每个搜索结果进行包装，以便“向导式搜索”可识别单个搜索结果开始和结束的内容的位置。

示例

    <results>       <search-results>         <result>           <index><search-index /></index>           <loc><search-cdata><search-url length="500" /></search-cdata></loc>         </result>       </search-results>     </results>

<attribute-table name="tablename">

通过此标签，您可以在多值列表中循环查看每个项目，以获得单个结果。 仅在结果中使用标记。 其主要用途是让您对属于结果字段的属性进行迭代。

示例

      <results>         <search-results>           <result>             <index><search-index /></index>             <loc><search-url /></loc>             <title><search-title /></title>             <attribute-table name="downloads">               <field name="download_title"><search-display-field name="download_title" /></field>               <field name="download_link" delimiter="|"><search-display-field name="download_link" /></field>             </attribute-table>           </result>         </search-results>       </results>

<facets></facets>

这组标记传递给填充彩块化的结果。

<facet name="name"></facet>

每个facet都必须有其自己的facet标签，其中name参数与facet名称匹配。 搜索标记在facet值的facet标记中使用。

请参阅关于Facet 。

示例

    <facets>       <facet name="brand">         <values><search-field-value-list name="brand" quotes="no" commas="yes" data="values" sortby="values" /></values>         <counts><search-field-value-list name="brand" quotes="no" commas="yes" data="counts" sortby="values" /></counts>       </facet>       <facet name="category">         <values><search-field-value-list name="category" quotes="no" commas="yes" data="values" sortby="values" /></values>         <counts><search-field-value-list name="category" quotes="no" commas="yes" data="counts" sortby="values" /></counts>       </facet>     </facets>

<suggestions></suggestions>

这组标签包含您的“您是否在意”建议，以便“向导式搜索”可识别哪些XML节点包含建议。

<suggestion></suggestion>

这组标签用每个“您的意思”建议换行。

示例

    <search-if-suggestions>       <suggestions>         <search-suggestions>           <suggestion>             <value><search-suggestion-text /></value>             <count><search-suggestion-result-count /></count>           </suggestion>         </search-suggestions>       </suggestions>     </search-if-suggestions>

JSON传输模板特定的标记

从搜索引擎传递JSON与XML的速度已知更快，因为它的有效负荷更小，分析器速度更快。 但是，使用JSON时请务必小心，以确保输出内容是严格的JSON，因为分析器不会原谅您。

如果您是JSON的新用户，则可以使用以下链接和示例来帮助您入门：

示例JSON模板

{
 "general":
 {
  "total" : "<search-total />",
  "lower" : "<search-lower />",
  "upper" : "<search-upper />",
  "rbt-trigger-list" : "<search-rbta-trigger-id-list>",
  "fields" :
  [
   {
    "name" : "seo_search_title",
    "value" : "<search-include file="seo/seo_search_title.tpl" />"
   },
   {
    "name" : "seo_search_keywords",
    "value" : "<search-include file="seo/seo_search_keywords.tpl" />"
   }
  ]
 },

 <search-if-suggestions>
 "suggestions":
  [
  <search-suggestions>
  {
   "suggestion":"<search-suggestion-text />",
   "count": "<search-suggestion-result-count>"
  }<search-if-not-last-suggestion>,</search-if-not-last-suggestion>
  </search-suggestions>
 ],
 </search-if-suggestions>

 "facets" :
 [
  {
   "name" : "leveli",
   "values" : [ <search-field-value-list name="leveli" quotes="yes" sortby="values" data="values" encoding="json"/>],
   "counts" : [<search-field-value-list name="leveli" quotes="no" sortby="values" data="results" />]
  },
  {
   "name" :"levelii",
   "values" : [<search-field-value-list name="levelii" quotes="yes" sortby="values" data="values" encoding="json"/>],
   "counts" : [<search-field-value-list name="levelii" quotes="no" sortby="values" data="results" />]
  },
  {
   "name" : "brand",
   "values" : [<search-field-value-list name="brand" quotes="yes" sortby="values" data="values" encoding="json"/>],
   "counts" : [<search-field-value-list name="brand" quotes="no" sortby="values" data="results" />]
  },
 ],
 "results" :
 [
  <search-results>
  {
   "fields" :
   [
    {
     "name" : "index",
     "value" : "<search-index />"
    },
    {
     "name" : "loc",
     "value" : "<search-display-field name="url" length="500" encoding="json"/>"
    },
    {
     "name" : "title",
     "value" : "<search-display-field name="title" encoding="json"/>"
    },
    {
     "name" : "img_url_thumbnail",
     "value" : "<search-display-field name="img_url_thumbnail" encoding="json"/>"
    },
    {
     "name" : "description",
     "value" : "<search-display-field name="description" encoding="json"/>"
    },
    {
     "name" : "mdi",
     "value" : "<SEARCH-RBTA-DISPLAY-MDI-FIELD>"
    }
   ]
  }<search-if-not-last>,</search-if-not-last>
  </search-results>
 ]
}

带结果属性表的JSON结果节示例

{
 "results" :
 [
  <search-results>
  {
   "fields" :
   [
    {
     "name" : "index",
     "value" : "<search-index />"
    },
    {
     "name" : "loc",
     "value" : "<search-display-field name="url" length="500" encoding="json"/>"
    }
   ],
   "tables" :
   [
    {
     "name" : "downloads",
     "fields" :
     [
      {
       "name" : "download_title",
       "value" : <search-display-field name="download_title" encoding="json"/>
      },
      {
       "name" : "download_link",
       "value" : <search-display-field name="download_link" encoding="json"/>
      }
     ]
    }
   ]
  }<search-if-not-last>,</search-if-not-last>
  </search-results>
 ]
}

具有关联字段的facet的JSON Facet部分示例

{
 facets" :
 [
  {
   "name" : "t1",
   "values" : [<search-field-value-list name="t1" quotes="yes" commas="yes" data="values" sortby="values" encoding="json" />],
   "counts" : [<search-field-value-list name="t1" quotes="yes" commas="yes" data="results" sortby="values" />],
   "custom-fields" :
   [
    {
     "name" : "taxonmyId",
     "value" : [<search-field-value-list name="tax1" quotes="yes" commas="yes" data="values" sortby="values" encoding="json" />]
    }
   ]
  }
 ]
}

用于已开槽彩块化的JSON彩块化部分示例

{
  "facets" :
  [
   {
    "name" : "fvalue0",
                  "dynamic" : 1,
                  "display-names" : [<search-field-value-list name="fname0" quotes="yes" commas="yes" data="values" sortby="values" encoding="json" />],
    "values" : [<search-field-value-list name="fvalue0" quotes="yes" commas="yes" data="values" sortby="values" encoding="json" />],
    "counts" : [<search-field-value-list name="fvalue0" quotes="no" commas="yes" data="results" sortby="values" />]
   }
  ]
}

添加新的演示文稿或传输模板文件

可以使用​Add Template​将演示文稿模板(.tmpl)或传输模板(.tpl)添加到Templates页面。

添加新演示文稿或传输模板文件

  1. 在产品菜单上，单击​Design > Templates。

  2. 在Templates页面上，单击​Add New Template。

  3. 在Add Template对话框中，设置所需的选项。

    选项 描述
    新文件名 指定要添加的模板的名称。 根据您选择的模板类型，相应的文件扩展名会自动添加到文件名中。 演示文稿模板具有.tmpl文件扩展名；传输模板具有.tpl文件扩展名。
    新模板类型 允许您选择要添加的演示文稿或传输模板。 请参阅关于模板。

    另请参阅编辑演示文稿或传输模板。

  4. 单击 Add.

  5. （可选）在Templates页面上，执行下列操作之一：

编辑演示文稿或传输模板

您可以使用模板编辑器视图和编辑演示文稿和传输模板文件的内容。

您可以编辑和测试分阶段演示和传输模板，而您的网站访客继续使用模板的实时版本。 您可以使用搜索域URL的分阶段版本测试分阶段模板。 例如，您可以通过运行一个将sp_t设置为传输模板名称的分阶段查询(sp_staged=1)来测试分阶段传输模板。 当您对布局的显示方式感到满意时，可以在模板编辑器中使用​Push Live​将模板实时推送。 模板生效后，站点访客开始使用它。

使用演示文稿模板标记引用可了解如何将演示文稿模板关联到向导式搜索组件，如彩块化、痕迹导航和菜单。

请参阅演示文稿模板标签

使用传输模板标记参考可进一步了解要在传输模板中使用的标记。

请参阅传输模板标签

To edit a presentation or a transport template

  1. 在产品菜单上，单击​Design > Templates。

  2. 在Templates页面上，单击演示文稿或传输模板文件名。

  3. 在Template Editor页面上，对标记和编码进行所需的更改。

    请注意您在Template Editor中所做的更改；没有“撤消”功能。 如果您做出了不想要的更改，并希望返回到文件的先前版本，则可以单击​Cancel​返回到模板表（假定您在此之前未保存任何更改）。 如果已保存更改，则可以在编辑器中使用​History​还原这些更改。

  4. （可选）单击​Insert Symbol​输入在美国英语键盘上没有相应键的特殊字符和符号。

  5. 单击 Save Changes.

  6. （可选）执行下列操作之一：

  7. 完成后，关闭“模板编辑器”页面；您将返回到“模板”页面。

复制演示文稿或传输模板文件

您可以使用​Copy Template​来节省时间，方法是复制现有的演示模板(.tmpl)或传输模板(.tpl)，然后将其添加到“模板”页面。

您必须更改模板名称、模板类型或两者。 如果您没有进行任何更改，则不会复制模板。

必须已添加模板，才能复制模板。

请参阅添加新演示文稿或传输模板文件。

复制演示文稿或传输模板文件

  1. 在产品菜单上，单击​Design > Templates。

  2. 在Templates页面中，在要复制的模板名称旁边的下拉列表中，单击​Copy。

  3. 在Copy Template对话框中，设置一个或多个所需选项。

  4. 单击 Copy.

  5. （可选）执行下列操作之一：

重命名演示文稿或传输模板文件

可以使用Rename Template更改现有演示文稿模板(.tmpl)或传输模板(.tpl)的名称。

如果需要，您还可以更改模板类型。

必须已添加模板才能重命名模板。

请参阅添加新演示文稿或传输模板文件。

重命名演示文稿或传输模板文件

  1. 在产品菜单上，单击​Design > Templates。

  2. 在Templates页面中，在要重命名的模板名称旁边的下拉列表中，单击​Rename。

  3. 在Rename Template对话框中，设置一个或多个所需选项。

  4. 单击 Rename.

  5. （可选）执行下列操作之一：

删除演示文稿或传输模板文件

可以使用​Delete Template​删除现有演示文稿模板(.tmpl)或传输模板(.tpl)。

您可能已经拥有实时推送的已分阶段模板的相应版本。 如果是，请确保使用​Staging​将已删除的模板实时推送，以便也从实时环境中删除它。 或者，您也可以在“模板”页上使用​Push Live。

请参阅关于暂存

请参阅实时推送舞台设置

必须已添加模板，才能删除模板。

请参阅添加新演示文稿或传输模板文件

删除演示文稿或传输模板文件

  1. 在产品菜单上，单击​Design > Templates。

  2. 在Templates页面中，在要删除的模板名称旁的下拉列表中，单击​Delete。

  3. 在Delete Template对话框中，单击​Delete.

  4. （可选）执行下列操作之一：

预览演示文稿模板将最小化

如果您选择将演示文稿模板的缩减页面权重最小化，则可以使用​Preview minimized​查看其效果。

如果最小化主演示文稿模板，请确保记住启用“包含”模板的最小化，因为此选项不可继承。

请参阅减少您的演示文稿模板的页面权重…

您必须已添加模板以将模板最小化到预览。

请参阅添加新演示文稿或传输模板文件

可以预览传输模板文件的XML代码。

请参阅预览传输模板文件的XML

要预览最小化的演示文稿模板

  1. 在产品菜单上，单击​Design > Templates。

  2. 在Templates页面的演示文稿模板名称旁的下拉列表中，单击​Preview minimized。

    使用“模板”(Templates)表格中的​Type​列，按“演示和传输”(Presentation and Transport)对模板进行排序。

  3. （可选）在Preview Minimized Template页面上，选中​Wrap lines​以读取定义窗口中的标记。

  4. 单击 Close.

  5. （可选）执行下列操作之一：

减少网站上演示文稿模板的页面权重

您可以使用模板表中的​Minimize​选项来减少演示文稿模板的页面权重。

通过减少模板的页面权重，可动态地最小化内嵌JavaScript和CSS。 您还可以删除HTML中的多余空白。 最大程度地减少演示文稿模板的页面权重有助于更快地交付搜索结果。

您还可以使用​Preview minimized​预览最小化的演示文稿模板的外观。

请参阅预览演示文稿模板最小化。

To reduce the page weight of a presentation template on your website

  1. 在产品菜单上，单击​Design > Templates。

  2. 在Templates页面的Minimize列下，选中要在您的网站上以最小化方式推送的一个或多个演示文稿模板文件所对应的框。

    使用Templates表中的​Type​列按演示和传输对模板进行排序。

  3. （可选）执行下列操作之一：

设置要在您的网站上使用的默认演示文稿模板文件

当您有多个演示文稿模板时，您可以指示最初用于显示搜索结果的模板。

您可以使用搜索前规则、搜索后规则和业务规则来确定何时应使用其他演示文稿模板之一。

请参阅关于预搜索规则。

请参阅关于搜索后规则。

请参阅关于Business Rules。

通常有一条规则，如“对于每次搜索，将目标演示文稿模板设置为xxxx”。 在采用此类规则的情况下，在“模板”页面上更改“默认”模板似乎不起作用。

To set the default presentation template file to use on your website

  1. 在产品菜单上，单击​Design > Templates。

  2. 在Templates页面的Default列下，单击要用作默认值的相应演示文稿模板文件的单选按钮。

    使用Templates表中的​Type​列按演示和传输对模板进行排序。

  3. （可选）执行下列操作之一：

预览传输模板文件的XML

可使用Preview查看已添加的传输模板的XML。

必须已添加传输模板以预览模板的XML。

请参阅添加新演示文稿或传输模板文件。

您可以预览最小化演示文稿模板文件，以视图其减少的页面权重。

请参阅预览演示文稿模板最小化。

预览传输模板文件的XML

  1. 在产品菜单上，单击​Design > Templates。

  2. 在Templates页面的传输模板名称旁的下拉列表中，单击​Preview。

    使用Templates表中的​Type​列按演示和传输对模板进行排序。

  3. 关闭查看窗口并返回site search/merchandising。

  4. （可选）执行下列操作之一：

在此页面上