Show Menu
主题×

CGI参数

CGI参数

搜索CGI参数

提供了搜索表单代码,您可以将其复制并粘贴到站点的HTML中( Design > Auto-Complete > Form Source )。
您还可以设置在搜索表单中或从脚本中列出的参数。 除了下面列出的参数之外,您还可以使用后端搜索参数来控制搜索。
搜索请求由基本URL组成。 基本URL指示客户正在搜索的帐户,以及一组CGI参数(键值对),这些参数指示如何为关联帐户返回所需的搜索结果。
基本URL与特定帐户以及分阶段或实时环境相关联。 您可以从客户经理处请求基本URL的多个别名。 例如,名为Megacorp的公司可能有两个基本URL与其帐户相关联: https://search.megacorp.com https://stage.megacorp.com 。 前者URL将搜索其实时索引,后者URL将搜索其分阶段索引。
支持三种格式的CGI参数。 默认情况下,您的帐户配置为使用分号分隔CGI参数,如下例所示:
https://search.megacorp.com?q=shoes;page=2
如果您愿意,您可以让客户经理将您的帐户配置为使用&符来分隔CGI参数,如下例所示:
https://search.megacorp.com?q=shoes&page=2
还支持第三种格式(称为SEO格式),其中正斜杠代替分隔符, / 等号如以下示例所示:
https://search.megacorp.com/q/shoes/page/2
每当使用SEO格式发送请求时,所有输出链接都将以相同的格式返回。
“向导式搜索”参数
示例
描述
q
q=string
指定搜索的查询字符串。 此参数映射到后端 sp_q 搜索参数。 请参阅 后端搜索CGI参数
q#
q#=string
分面(在给定字段内搜索)是通过编号q和x参数完成的。 q参数定义您在facet中搜索的术语,由相应的编号x参数表示。
例如,如果您有两个彩块化,分别命名为大小和颜色,则可以有类似q1=small;x1=size;q2=red;x2=color的功能。 此参数映射到后端 sp_q_exact_# 搜索参数。
x 不支持跨域跟踪#
q#=string
分面(在给定字段内搜索)是通过编号q和x参数完成的。 q参数定义您在facet中搜索的术语,由相应的编号x参数表示。
例如,如果您有两个彩块化,分别命名为大小和颜色,则可以有类似q1=small;x1=size;q2=red;x2=color的功能。 此参数映射到后端 sp_x_# 搜索参数。
collection(集合)
collection=string
指定用于搜索的集合。 此参数映射到后端 sp_k 搜索参数。 请参阅 后端搜索CGI参数
count(计数)
count=number
指定显示的结果总数。 默认值在 Settings > Searching >中定 Searches义。. 此参数映射到后端 sp_c 搜索参数。 请参阅 后端搜索CGI参数
page
page=number
指定返回的结果页。
rank=field
指定用于静态排名的排名字段。 该字段必须是关联度大于0的“排名”类型字段。 此参数映射到后端 sp_sr 参数。 请参阅 后端搜索CGI参数
排序
sort=number
指定排序顺序。
“0”是默认值,并按相关性得分排序;“1”按日期排序;“-1”不排序。 用户可以指定参数值的字段名 sp_s 称。 例如, sp_s=title 根据标题字段中包含的值对结果进行排序。 当字段名称用于参数的值时,结果将按该字 sp_s 段排序,然后按相关性进行子排序。 To enable this feature, click Settings > Metadata > Definitions. 在“定义”页面上,单 Add New Field 击或单 Edit 击特定字段名称。 在下 Sorting 拉列表中,选择或 Ascending 选 Descending项。 此参数映射到后端 sp_s 搜索参数。
请参阅 #。(../c-appendices/c-cgiparameters.md#reference_582E85C3886740C98FE88CA9DF7918E8)。

后端搜索CGI参数

通常,客户会与称为“向导式搜索”的表示层交互。 但是,理论上可以跳过“向导式搜索”层,并直接使用本页所述的CGI参数与后端核心搜索交互。
您可以从下表中选择后端搜索CGI参数:
单查询支持
多查询支持
示例
描述
1
sp_a
sp_a=字符串
指定帐号字符串。 此参数为必需参数,且必须是有效的帐号字符串。 您可以在“设置”>“帐户选项” >“帐户设 置”下查 找您的帐 户号 码字符串
2
sp_advanced
sp_advanced= 0或1
如果 sp_advanced=1随查询一起提交,则搜索模板中 <search-if-advanced>标签和 </search-if-advanced>标签之间的所有代码都将用于搜索表单。 将忽略 <search-if-not-advanced>标记和 </search-if-not-advanced>标 记之间的所有代码 。 如果 sp_advanced=0 (或任何其他值)已提交,则忽略<search-if-advanced>模板块,并使用<search-if-not-advanced>模板块。
3
sp_c
sp_c=数字
指定要显示的结果总数。 默认值为 10。
4
sp_context_field
sp_context_field= field
收集给定字段的上下文信息。 通过<search-context>模板标记将收集的信息输出 到搜索结果 中。 The default value is body .
5
sp_d
sp_d=类型
指定要执行的日期范围搜索的类型。 可能类型为任何,即不执行日期范围搜索,自定义,指示 sp_date_的值确定搜索日期,具体指 sp _start_day、 sp_start_month、 sp_start_month、 sp_start_sert_yer、 sp_end.sp_end用于确定要搜索的日期范围。 只有在 您的搜索表单包含按自定义范围(通过 sp_date_range)或特定开始和结束日期范围进行搜索的选项时,才需要sp_d
6
sp_d_#
sp_d_#=类型
指定要对相应的sp_q_#查询执行的日 期范围搜索的类 型。 将“#”替换为介于1到16之间的数字(例如, sp_d_8 ,应用于编号的 查询sp_q_8 )。
可以设 置类型,即不执行日期范围搜索,自定义,指示 sp_date_ #的值确定要搜索的日期,具体指示sp_q_date_ #的值表示sp_q_date_day_ day_min_min,sp_ q_min_min_sp_q,sp_ q_#应当使用max_month_q#和max_year_q#确定日期范围。 仅当您的搜索表单包含按自定义范围(通过 sp_date_range_#)或特定开始日期和结束日期范围进行搜索的选项时,才需要使用 sp_d_#。
7
sp_date_range
sp_date_range= number
指定要应用于搜索的预定义日期范围。 大于或等于零的值指定今天之前要搜索的天数— 例如,值“0”指定“今天”,值“1”指定“今天和昨天”,值“30”指定“过去30天内”,依此类推。
低于零的值指定自定义范围,如下所示:
-1 = "None",与指定无日期范围相同。
-2 = “本周”,从周日到周六搜索。
-3 = "Last week",搜索时间从当周前一周的星期日到星期六。
-4 = "本月",搜索日期为当月。
-5 = "上个月",搜索日期在当前月份前一个月内。
-6 =“今年”,其搜索日期为当年。
-7 = “去年”,其搜索日期在当前年度之前的一年。
8
sp_date_range_#
sp_date_range_#= number
指定要应用于相应sp_q_#查询的预 定义日期范 围。 将“#”替换为介于1到16之间的数字(例如, sp_date_range_8 ,应用于编号的 查询sp_q_8 )。
大于或等于零的值指定今天之前要搜索的天数。 例如,值0指定今天;值为1表示今天和昨天;值30指定在最近30天内,依此类推。
低于零的值指定自定义范围,如下所示:
-1 = "None",与指定无日期范围相同。
-2 = “本周”,从周日到周六搜索。
-3 = "Last week",搜索时间从当周前一周的星期日到星期六。
-4 = "本月",搜索日期为当月。
-5 = "上个月",搜索日期在当前月份前一个月内。
-6 =“今年”,其搜索日期为当年。
-7 = “去年”,其搜索日期在当前年度之前的一年。
9
sp_dedupe_field
sp_dedupe_field= fieldname
指定单个字段以在上消除重复项搜索结果。 该字段上的所有重复结果都将从搜索结果中删除。 例如,如果 sp_dedupe_field=title,则搜索结果中只显示给定标题的顶部结果(没有两个结果将具有相同的标题字段内容)。 对于多值(允许列表)类型字段,整个字段内容用于比较。 只能指定一个字段。 字段名称中不允许使用“表限定符”。
10
sp_e
sp_e=数字
指定对于查询字符串中具有多于数字字符的任何单词,应进行自动通配符扩展。 换句话说, sp_e=5指定具有5个或更多字符的单词(如“query”或“number”)应使用通配符“*”展开,使搜索与搜索“query*”或“number*”等效。 字符数较少的单词不会展开,因此搜索“单词”不会自动进行通配符扩展。
11
sp_e_#
sp_e_#=数字
指定对于来自具有多个数字字符的相应 sp_q_#查询字符串的任何单词 ,将自动进行通配符扩展。 换句话说, sp_e_2=5指定 sp_q_2查询字符串中包含五个或多个字符的单词(如“query”或“number”)应使用通配符“ * ”展开,使搜索等同于搜索“query*”或“number*”。 字符数较少的单词不会展开,因此在 sp_q_2中搜索“word”时 不会自动扩展通配符。
12
sp_end_day、sp_end_month、sp_end_year
sp_end_day= number ,sp_end_month= number , sp_end_year= number
这三个值指定了搜索的结束日期范围,并且必须作为一组提供。
13
sp_f
sp_f=字符串
指定查询参数字符串的字符集(如 sp_q )。 此字符串必须始终与包含搜索表单的页面的字符集匹配。
14
sp_field_table
sp_field_ table=table: field,field...
定义由给定字段组成的逻辑数据表。 例如,由“color”、“size”和“price”字段组成的名为“items”的表定义如下:
sp_field_table=items:color,size,price
逻辑表与选中“允许列表”的字段(在“设置”>“元数据” >“定义”下 )一起 有用 的方式是 “允许列表”。 所有以字段名称为值的CGI参数和模板标记都可以选择指定表名,后跟“.” 在字段名称之前(例如, sp_x_1=tablename.fieldname )。
例如,要搜索包含大小为“large”(其中项目表示为并行元数据行)的一个或多个“红色”项目的文档,可以使用以下内容:
sp_q_exact_1=red&sp_x_1=items.color& sp_q_exact_2=large&sp_x_2=items.size&sp_field_table=items:color,size,price
15
sp_i
sp_i= value
在生成报告时忽略搜索。
使用此查询可以遮住某些后端搜索,如“您的意思”生成的搜索,或管理员在成员中心生成的搜索。 由于最终用户不生成这些类型的搜索,因此它们不会显示在各种Adobe Search&Promote报告中。
有效值 为sp_i=1 sp_i=2
16
sp_k
sp_k=字符串
指定用于搜索的集合。 默认值为no collection,这意味着搜索应包括整个站点。
17
sp_l
sp_l=字符串
指定查询参数字符串的语言(如 sp_q )。 字 符串 应该是标准区域设置ID,其中包含ISO-639语言代码(可选),后跟ISO-3166国家/地区代码。 例如,英语为“en”或“en_US”,日语为“ja”或“ja_JP”。
18
sp_literal
sp_literal= 0或1
设置 sp_literal=1可临 时禁用可能解释查询中单词的所有功能。 使用此参数时,只有查询的字面单词匹配文档,而不考虑同义词、替代单词表单和类似声音匹配。
请注意, sp_literal=0没 有含义,如果使用,则忽略它。
19
sp_m
sp_m=数字
指定是否显示摘要。 1表示是,0表示否。 默认值为 1。
20
sp_n
sp_n=数字
指定开始搜索结果的结果数。 默认值为 1。
21
sp_not_found_page
sp_not_found_page= url
指定如果没有搜索结果,是否重定向到指定的URL。
22
sp_p
sp_p= any/all/phrase
指定要执行的默认搜索类型。 使用任何 从查询字符串中搜索包含任何单词的文档。 使用全 部表 示搜索包含查询字符串中所有单词的文档。 短语的使 用意 味着查询字符串被视为引用的短语,并且忽略所有用户类型的引号。
对于 语和 所有词,搜索词前的“+”和“-”规范被禁用,这些字符会被忽略。 如 果sp_p不存在,或 者设置为空字符串或任何字符串,则允许使用标准“+”和“-”字前缀。
有关在搜索中使用加号(“+”)和减号(“-”)的更多信息,请参阅搜索提示说明。
请参阅 关于搜索
有关使用sp_p参数的示例,请参阅示例高级 搜索表 单。
23
sp_p_#
sp_p_#= any/all/phrase
指定要使用相应的sp_q_#查询执行的 默认搜索类型 。 将“#”替换为介于1到16之间的数字(例如, sp_p_8应 用于编号的查询 sp_q_8 )。 使用任何 表示 返回包含查询字符串中任意单词的文档。 使用全 部表 示返回包含查询字符串中所有单词的文档。 短语的使 用意 味着将查询字符串视为完整短语(并忽略所有用户类型的引号)。
如果指定全部或 短语, 将忽略搜索词 前的任何加号和减号。 如 果忽略sp_p_# ,或将其设置为空字符串或任何 , 则允许使用标准“+”和“-”前缀。
24
sp_pt
sp_pt= exact/equivalent/compatible
指定要应用的目标匹配类型。 使用精确 表示仅 在与目标内容中的查询字符串完全匹配的文档中生成目标匹配项。 使用等 效项 与精确相同,只是词的顺序不重要。 使用兼容 性会 根据sp_p参数的值自动设置目标匹配 型。 如果所有短语(sp_p)或其他的短语(sp_ p)都使用,则使用, 或者使用其他的同 等的短 语(sp_p)。 sp_pt的默 认值是兼
25
sp_pt_#
sp_pt_#= exact/equivalent/compatible
指定要与相应的sp_q_#查询一起应用的目标 匹配类型 。 将“#”替换为介于1到16之间的数字(例如, sp_p_8应 用于编号的查询 sp_q_8 )。 使用精确 表示仅 在与目标内容中的查询字符串完全匹配的文档中生成目标匹配项。 使用等 效项 与使 用精确 一样,只是单词的顺序并不重要。 使用兼容 性时, 会根据相应sp_p_#参数的值自动设置目标 匹配类型 :如 果sp_p_# 是全部或短语,则使用精确值 ,否则 使用等 效值。 sp_pt_#的 默认值是兼容
26
sp_q
sp_q=字符串
指定搜索的查询字符串。 空字符串导致不显示任何结果。
27
sp_q_#
sp_q_#=文本
此参数允许在搜索表单上创建多个查询。 sp_ q_#参数包含 要在给定编号查询中使用的查询字符串。 搜索请求最多可引用16个不同的编号查询( sp_q_1 sp_q_16 )。
例如,提交以下表单将返回包含“great”和“books”字样的所有文档。
Search for: <input type="text" name="sp_q" value="great"> Search for: <input type="text" name="sp_q_1" value="books">
28
sp_q_day、sp_q_month、sp_q_year
sp_q _day_#, sp_q _month_#, sp_q _year_#
sp_q_day=整数值
sp_q_month=整数值
sp_q_year=整数值
sp_q_day_#=整数值
sp_q_month_#=整数值
sp_q_year_#=整数值
这些参数用于指定特定查询的确切日期。 sp_q_day sp_q_month sp_q_year参数应用于主查询( sp_q)。
#参 被替换为介于1到16之间的数字(例如, sp_q_day_6 ,它适用于编号的查询sp_q_6 )。 默认情况下,所有日期都会相对于格林威治标准时间进行搜索。
下面的代码部分允许用户在标有“Jan”的文档中搜索“orange”一词。 2000年10月1日”,位于用户定义的名为 PublishDate的字段中 :
<input type="hidden" name="sp_x_1" value="PublishDate"> Search for: <input type="text" name="sp_q" value="orange">On : <input type="text" name="sp_q_day_1" size="2" value="1"> Day<input type="text" name="sp_q_month_1" size="2" value="1"> Month <input type="text" name="sp_q_year_1" size="4" value="2000"> Year 
29
sp_q_location
sp_q_location_#
sp_q_location= latitude/longitude OR areacode OR zipcode
sp_q_location_#= latitude/longitude OR areacode OR zipcode
这些参数将位置与主查询或编号查询相关联。 使用 sp_q_location会影响主查询 sp_q_location_# (其中 #将替换为1到16之间的数字),从而影响给定的编号查询。 这些参数用于针对为每个站点页面索引的位置数据执行最小和/或最大距离接近度搜索。 值的格式决定其解释。
DDD(三位数字)形式的值被解释为美国电话区号;DDDDDD或DDDDD-DDDD形式的值解释为美国的zipcode;DDDDD表示为经纬度对。 每个值都需要符号。 例如,+38.6317+120.5509指定纬度38.6317,经度120.5509。
30
sp_q_max_relevent_distance
sp_q_max_relevant _distance _#
sp_q_max_relevant_distance= value
sp_q_max_relevant_distance_#= value
这些参数控制应用于邻近搜索的相关计算。 使用 sp_q_max_relevant_distance 会影响主查询 sp_q_max_relevant_distance_# (其中 #由1到16的数字替换),这会影响给定的编号查询。
sp_q_max_ relevant_distance的默认值 为100。
邻近组件的完美相关得分表示距离为0。 邻近组件的最低相关得分表示刚好超过指定 sp_q_max_relevant_distance_#值的距离
31
sp_q_min_day, sp_q_min_month, sp_q_min_year
sp_q_max_day, sp_q_max_month, sp_q_max_year
sp_q_min_day_#、sp_q_min_month_#、sp_q_min_year_#
sp_q_max_day_#、sp_q_max_month_#、sp_q_max_year_#
sp_q_min_day= integer value
sp_q_min_month= integer value
sp_q_min_year= integer value
sp_q_max_day= integer value
sp_q_max_month= integer value
sp_q_max_year= integer value
sp_q_min_day_#= integer value
sp_q_min_month_#= integer value
sp_q_min_year_#= integer value
sp_q_max_day_#= integer value
sp_q_max_month_#= integer value
sp_q_max_year_#= integer value
这些参数用于为特定查询设置最小和最大日期范围。 sp_ min_day sp_q_min_month、sp_q_min_year、 sp_q_min_year、 sp_day、sp_min_sp_year、 sp_max_year和sp_max_q将参数应用于主查询(sp_q)max_q(max_max)。
参数 称中的#将替换为介于1到16之间的数字(例如, sp_q_min_day_6应 用于编号的查询 sp_q_6 )。
只指定最小日期、最大日期或同时指定最小和最大日期是合法的。 但是,对于给定的最小值或最大值设置,必须指定所有三个日期参数(日、月和年)。 默认情况下,所有日期都会相对于格林威治标准时间进行搜索。
下面的代码部分允许用户在名为 PublishDate的用户定义字段中搜索日期介于2000年1月1日至2000年12月31日之间的文档中的“橙色”一词 :
<input type="hidden" name="sp_x_1" value="PublishDate">Search for: <input type="text" name="sp_q" value="orange">Between: <input type="text" name="sp_q_min_day_1" size="2" value="1"> Start Day<input type="text" name="sp_q_min_month_1" size="2" value="1"> Start Month <input type="text" name="sp_q_min_year_1" size="4" value="2000"> Start Year And: <input type="text" name="sp_q_max_day_1" size="2" value="31"> End Day <input type="text" name="sp_q_max_month_1" size="2" value="12"> End Month <input type="text" name="sp_q_max_year_1" size="4" value="2000"> End Year
32
sp_q_min, sp_q_max
sp_q _min_#, sp_q _max_#, sp_q _exact_#
sp_q_min=值
sp_q_max=值
sp_q_min_#=值
sp_q_max_#=值
sp_q_exact_#=value
这些参数指定要应用于主查询或编号查询的最小值(和/或最大值)。 使用 sp_q_min、sp _q_max和 sp_q_exact 会影响主查询( sp_q)。
将参 数名 中的#替换为介于1到16之间的数字(例如, sp_q_min_8应 用于编号的查询 sp_q_8 )。
使用 sp_q_exact_#是指定 sp_q_min_#和 sp_q_max_#的速记,其值相同 。 如 果指定了sp_q_exact_# ,则忽略任何相应的 sp_q_min_# sp_q_max_#参 数。
sp_q_ min_#、sp_q_max_# sp_q_exact_#参数可以选择指定多个“|”分隔的值。 例如,要搜索在“颜色”字段中包含绿色或红色值的文档,请执行以下操作: ...&sp_q_exact_1=green|red&sp_x_1=color
33
sp_q_nocp
sp_q _nocp _#
sp_q_nocp= 1或0
sp_q_nocp_#= 1或0
默认参数值为 0,表 示执行“公用短语”展开。
对于相应的搜 索查 询,当设置为1时,不执行“常用短语”展开。
使 用sp_q_nocp会 影响主搜索查询 参数sp_q 。 要将此参数应用于编号搜索查询,请将参 数名 中的#替换为相应的编号。 例如, sp_q_nocp_8应 用于编号的搜索查 询sp_q_8
34
sp_q_required
sp_q_required_#
sp_q_required= 1或0或-1
sp_q_required_#= 1或0或-1
此参数确定匹配是否必须(1)、(0)或不得(-1)出现在相应的查询中,以便在结果页上返回文档。
使用 sp_q_required会 影响主查询( sp_q )。
要应用于已编号的查询,请将参数名称中的 #替换为相应的编号(例如, sp_q_required_8 应用于已编号的查询 sp_q_8 )。 参数的默认值是1(必须匹配)。
要在用户定义的“平台”字段中搜索包含单词“calc”但不包含“mac”、“win”或“all”的文档,您的HTML搜索表单可能包含以下行:
<input type="hidden" name="sp_x_1" value="platform"> Search for: <input type="text" name="sp_q" value="calc"> Exclude: <input type="text" name="sp_q_1" value="mac win all"> <input type="hidden" name="sp_q_required_1" value="-1">
35
sp_redirect_if_one_result
sp_redirect_ if_one_result= 0 or 1
指定在仅有一个搜索结果时是否重定向到搜索结果URL。
36
sp_referrer
sp_referrer= url
指定搜索的引用URL。 对于搜索重写规则很有用,因为搜索结果链接回与搜索表单相同的站点。
默认值是浏览器提供的标准CGI HTTP_REFERRER值。
37
sp_ro
sp_ro=字 : 相关性
允许可选的搜索时间、每个字段名称、相关性控制。 参 数名 称中的ro表示“相关覆盖”。 该参数接受一个或多个字段名称,后跟冒号字符,后跟从0-10的相关值。
例如,要将字段名称“body”的相关值设置为10,当客户执行搜索时,该参数将显示如下:
sp_ro=body:10
或者,要在参数字符串中指定多个字段相关性覆盖,您可以使用管道分隔符。 例如,要将字段名称“body”和“title”的相关值设置为9,客户执行搜索时,该参数将显示如下:
sp_ro=body:9|title:9
注意: 指定关联搜索中未涉及的字段不起作用。 例如,如果设置 sp_ro=title:10 ,但未搜索标题字段名称,则 sp_ro参数 将不起作用。 换句话说,使用sp_ro参数指定字段名 称不会自 动搜索该字段;相反,它只会覆盖该字段的相关设置。
38
sp_s
sp_s=数字
指定排序顺序。 Zero(0)是默认值,它是按相关分数排序的方法。 一(1)表示按日期排序,-1表示不排序。
可以为sp_s参数的值指定 字段名 称。 例如, sp_s=title 会根据标题字段中包含的值对结果进行排序。 当字段名称用于 sp_s参数的值时, 结果将按该字段排序,然后按相关性子排序。
将引用字段的排序设置为启用此功 能的元数据的 升序>元数据定义的“设置”>“设置”中的“排序”或“降序”。
您还可以通过在搜索表单中多次设置 sp_s参数,将多个排序字 段分配给单个查询。 以下模板行设置要先按艺术家姓名、专辑名称和音轨名称排序的搜索结果。
<input type="hidden" name="sp_s" value="artist"> <input type="hidden" name="sp_s" value="album"> <input type="hidden" name="sp_s" value="track"> Search for: <input type="text" name="sp_q" value="Music Search">
还可以通过在字段名称之前指定表名限定符(例如items.price),对表匹配的字段数据进行排序。 有关表匹 配的详细信息,请参 阅sp_field_table参数。
如果按邻近度搜索,则可以通过指定“邻近输出字段”,根据邻近度对结果排序。
39
sp_sr
sp_sr=字段
指定用于静态排名的排名字段。 该字段必须是关联度大于0的“排名”类型字段。 如果没 有为查 询提供sp_sr参数,则会自动选择“排名”类型字段。
要禁用特定查询的静态排名,请为 sp_sr包含一个NULL值 (例如, <input type="hidden" name="sp_sr" value=""> )。
40
sp_sfvl_field
sp_sfvl_field=字符串
指定要与搜索模板中的 <search-field-value-list>标签一起使用的字 段的名称。
可指定多个 sp_sfvl_field参 数。
41
sp_sfvl_df_count
sp_sfvl_df_count= <integer_value>
请求此搜 索最多 为<integer_value> search-field-value-list动 态彩块化字段。
默认值为 0。允许的最大值是为给定索引定义的动态彩块化字段的当前数量,即动态彩块化字段计数。 小于0的整数值被视为0。 在dynamic-facet-field- count之上指定的整 数值被 dynamic-facet-field-count所限制 。 忽略非整数值;它们被视为默认值。
给定片段的搜索会以该片段的动态彩块化字段计数值的最大允许 sp_sfvl_df_count 作为上限 值。 在合并切片结果时, sp_sfvl_df_count的有效最大值 ,是所有切片上的 最大实际sp_sfvl_df_ count。
42
sp_sfvl_df_exclude
sp_sfvl_df_exclude= < field_name >[|< field_name >|...
指定要从此搜索考虑中排除的特定动态彩块字段列表。
默认情况下,会考虑所有动态Facet字段。
43
sp_sfvl_df_include
sp_sfvl_df_include= < field_name >[|< field_name >|...
指定要包含在搜索结果中的特定动态彩块化字段列表。
注意: sp_ sfvl_df_count参数确定要返回的动态彩块字段的总数,包括通过 sp_sfvl_df_include指定的任何字段 。 即,使用 sp_sfvl_df_include不允许返回的动态彩块化字段的总数超过 sp_sfvl_df_count
44
sp_staged
sp_staged= 0或1
如果 sp_staged=1随查 询一起提交,则运行的查询是分阶段搜索。
分阶段搜索使用当前分阶段的所有组件,包括索引和模板。
45
sp_start_day、sp_start_month、sp_start_year
sp_start_day=数字
sp_start_month=数字
sp_start_year=数字
这三个值指定搜索的开始日期范围,您将其作为一组提供。
46
sp__soutch_q
sp_soutch_q=数字
sp_suckest_q参 数确定要与建议服务一 起使用的sp_q[_#] 参数。
sp_suckest_q的默认值为0,这表示搜索引擎使用 sp_q的值 来确定建议。
置sp_suckest_q=1以 使用sp_q_1的值 确定建议,依此类推。
47
sp_t
sp_t=字符串
指定要使用的传输模板。
如果要通过对搜索帐户中的每个区域使用不同的搜索传输模板来控制网站中核心搜索结果的外观,此参数很有用。
默认传输模板为“search”。
48
sp_trace
sp_trace= 0或1
当设置为 sp_stage=1时, 在模拟器中启用核心搜索跟踪功能。
请参阅 关于模拟器
注意: 如果未指定此参数,则核心搜索不会收集跟踪信息,并且相关的核心搜索模板标签没有输出。
49
sp_w, sp_w_control
sp_w= sound-alike-enable
sp_w_control= sound-alike-control
指定应为此特定查询启用或禁用类似声音匹配。
忽略“Exact”的sp_w_control。 类似声匹配已禁用。
忽略“Alike”的sp_w_control。 类声匹配已启用
任何其他项的sp_w_control为1。 类似声匹配已禁用。
“其他任何内容”的sp_w_control是任何其他内容。 类声匹配已启用。
使 用sp_w_control参数可 以为最终用户控制类似声音匹配创建一个措辞负面或正面的复选框。
果使用sp_w_control=0 ,则使用一个措辞负面的复选框来设置 sp_w参 数,如下例所示:
<input type=hidden name="sp_w_control" value="0"><input type=checkbox name="sp_w" value="exact">No Sound-Alike matching
如果 使用sp_w_control=1 ,则使用措辞积极的复选框来设置 sp_w参数,如 下所示:
<input type=hidden name="sp_w_control" value="1"><input type=checkbox name="sp_w" value="alike">Sound-Alike matching
有关使用sp_w_control和sp_w参数的更多示例,请参阅示例高级搜索表 以获取更多 示例。
50
sp_x
sp_x=字段
指定要搜索查询字符串的字段。 any表示搜索所有字段。 标题是指仅搜索标题字段。 desc表示仅搜索文档描述字段。 键表示仅搜索文档关键字。 body表示仅搜索正文文本。 alt表示仅搜索替代文本。 url表示仅搜索URL值。 目标表示仅搜索目标关键字。 在任何情况下,忽略相应 sp_q参数中“text:”、“desc:”、“keys:”、“body:”、“alt:”、“url:”和“target:”字段前缀的用户规范。 如 果sp_x不存 在,或者设置为空字符串或任何字符串,则允许使用标准用户字段前缀。 有关字段前缀的详细信息,请参阅搜索提示说明。
请参阅 关于搜索
有关使用sp_x参数的示例,请参阅高级搜索 表单示例说 明。
您可以创建以sp_x= any Readitions > Metadata Definitions设置为Search By Default的所有字段搜索。 预定义的字段和用户定义的字段都可以用作sp_x参 数的 值。
还可以通过多次设置sp_x参数为单个查询分配 多个字 段。 以下模板行允许用户查询“Great Books”的“title”和“author”字段。
<input type="hidden" name="sp_x" value="title"><input type="hidden" name="sp_x" value="author">Search for: <input type="text" name="sp_q" value="Great Books">
51
sp_x_#
sp_x_#=字段名
此参数指定要在相应的sp_q_#查 询中搜索的字段 。 # 被替 换为介于1到16之间的数字(例如, sp_x_8 )。 字段名称是任何预定义或用户定义的字段。
如果没有为特定编 号的查询提供 sp_x#参数,则在“搜索”设置 > Metadata Definitions(搜索的元数据定义)下定义为“By Default”(按默认搜索)的所有字段。
例如,提交以下表单将返回所有包含单词“great”的文档,该单词在“author”字段中也包含单词“Fitzgerald”:
Search for: <input type="text" name="sp_q" value="great"><input type="hidden" name="sp_x_1" value="author">Search only documents written by: <input type="text" name="sp_q_1" value="Fitzgerald">
通过在单个搜索请求中提供同一 sp_x或sp_x_#参数的多个实例,可以将多个字段名与特定查询或编号查询相关联
例如,要在“body”和“keys”字段中搜索“flower”一词,可创建包含以下信息的搜索表单:
<input type="hidden" name="sp_x_1" value="body"><input type="hidden" name="sp_x_1" value="keys">Search for: <input type="text" name="sp_q_1" value="flower">

使用后端搜索CGI参数的典型示例

以下链接查询使用“音乐”作为搜索查询开始搜索,并使用所有默认参数。 请注意,URL将分为两行,以便可读。 在HTML中,此链接应全部在一行上。
<a href="https://search.atomz.com/search/?sp_q=Music&sp_a=sp99999999"> 
Testing...</a>

同一功能通常使用表单进行定义:
<form action="https://search.atomz.com/search/"> 
<input size=12 name="sp_q" value="Music"><br> 
<input type=hidden name="sp_a" value="sp99999999"> 
<input type=submit value="Search"><br> 
</form>

通常在启动搜索时应使用默认参数。 这样,第一页就会显示,并按相关性排序,客户可以选择其他页面和其他选项。 如果站点上的搜索表单包含集合选项,请将集合名称作为参数传递。

使用后端搜索CGI参数的详细示例

以下表单查询显示 25 从结果开始的结果 10 。 不显示摘要,排序顺序按日期排列,并使用名为的 support 集合。 仅返回日期在最近30天内的文档。
<form action="https://search.atomz.com/search/"> 
<input size=12 name="sp_q"><br> 
<input type=hidden name="sp_a" value="sp99999999"> 
<input type=submit value="Search"><br> 
<input type=hidden name=sp_n value=10> 
<input type=hidden name=sp_c value=25> 
<input type=hidden name=sp_m value=0> 
<input type=hidden name=sp_s value=1> 
<input type=hidden name=sp_k value="support"> 
<input type=hidden name=sp_date_range value=30> 
</form>