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
Faceting(在指定欄位內搜尋)是透過編號q和x參數來完成。 q參數會定義您在Facet中搜尋的詞語,如對應的編號x參數所示。
例如,如果您有兩個刻面,其名稱為size和color,則可以有q1=small;x1=size;q2=red;x2=color。 此參數會對應至後端 sp_q_exact_# 搜尋參數。
x 中的頁面載入要求#
q#=string
Faceting(在指定欄位內搜尋)是透過編號q和x參數來完成。 q參數會定義您在Facet中搜尋的詞語,如對應的編號x參數所示。
例如,如果您有兩個刻面,其名稱為size和color,則可以有q1=small;x1=size;q2=red;x2=color。 此參數會對應至後端 sp_x_# 搜尋參數。
集合
collection=string
指定要用於搜尋的系列。 此參數會對應至後端 sp_k 搜尋參數。 請參 閱後端搜尋CGI參數
計數
count=number
指定顯示的結果總計。 預設值定義於 Settings > Searching > Searches中。. 此參數會對應至後端 sp_c 搜尋參數。 請參 閱後端搜尋CGI參數
頁面
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_start_day、 sp_start_month、 sp_start_start_start_manth、 sp_start_start_year、 sp_start_start_year、sp_start_day、sp_end Day、sp_end Hadign等。用來判斷要搜尋的日期範圍。 只有在 您的搜尋表單包含依自訂範圍(透過 sp_date_range )或特定開始和結束日期範圍進行搜尋的選項時,才需要sp_d。
6
sp_d_#
sp_d_#=類型
指定要對相應的sp_q_#查詢執行的日期 範圍搜索的類 型。 "#"會以1到16之間的數字取代(例如, sp_d_8 ,套用至編號的查詢 sp_q_8 )。
可以將類型設為 any,這表示不執行日期範圍搜索、自定義,這表示 sp_date的值用於確定要搜索的日期,具體表示sp_date_date的值用於確定要搜索的日期,並指 sp_q_day_min_, sp_q_ q_min_min_最大月數q_max_month_q,最大月數q_max_year_q。 只有當您的搜尋表單 包含依自訂範圍(透過 sp_date_range_#)或依特定開始和結束日期範圍進行搜尋的選項時,才需要使用 sp_d_#。
7
sp_date_range
sp_date_range= number
指定要套用至搜尋的預先定義日期範圍。 大於或等於零的值會指定今天之前要搜尋的天數— 例如,值"0"指定"今天",值"1"指定"今天和昨天",值"30"指定"在過去30天內"等。
低於零的值會指定自訂範圍,如下所示:
-1 = "無",與指定無日期範圍相同。
-2 = "本週",在當周的週日到週六搜尋。
-3 = "上週",在當周前一週的星期日到星期六進行搜尋。
-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 = "無",與指定無日期範圍相同。
-2 = "本週",在當周的週日到週六搜尋。
-3 = "上週",在當周前一週的星期日到星期六進行搜尋。
-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*"。 字元數較少的字詞不會展開,因此搜尋「word」時不會自動擴充萬用字元。
11
sp_e_#
sp_e_#=數字
指定自動通配符擴展對來自具有多於數字字元的 sp_q_#查 詢字串的任何字進行。 換言之, sp_e_2=5指定 sp_q_2查詢字串中包含5個以上字元的字詞(例如「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 )。
例如,要搜索包含一個或多個「大」(其中項目表示為並行元資料行)大小為「大」的「紅色」項目的文檔,可以使用以下內容:
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=
產生報表時忽略搜尋。
使用此查詢可屏蔽某些後端搜索,如Did You Mean生成的搜索,或管理員在成員中心生成的搜索。 由於使用者不產生這些搜尋類型,因此不會顯示在各種Adobe Search&Promote報表中。
有效值 為sp_i=1 sp_i=2
16
sp_k
sp_k=字串
指定要用於搜尋的系列。 預設為無系列,表示搜尋應包含整個網站。
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,則使用精確 使用,或者使 用等 效的p_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_#的缺 省值與 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"。 1st, 2000」(位於名為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(三位數)格式的值被解釋為美國電話區域;DDDDD或DDDD-DDDD格式的值被解釋為美國的zipcode;DDDD的形式為±DDD.DDDD.DDDD被解釋為經緯度對。 每個值都需要符號。 例如,+38.6317+120.5509指定緯度38.6317,經度120.5509。
30
sp_q_max_referent_distance
sp_q_max_releated_distance _#
sp_q_max_relevant_distance= value
sp_q_max_relevant_distance_#= value
這些參數控制應用於鄰近搜索的相關性計算。 使用 sp_q_max_releated_distance 會影響主查詢 sp_q_max_releated_distance_# (其中 #被1到16的數字替換),這會影響給定的編號查詢。
sp_q_max_ releated_distance的預設值 為100。
鄰近元件的完美關聯分數代表距離0。 鄰近元件的最小相關性分數代表剛好超過指定 sp_q_max_releated_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 _q_min_year、 sp_sp_max_year、 sp_max_year和 sp_max_yearQ參數套用至主查詢(sp_q Main Query Q)。
數名 稱中的#會以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參數,則會自動選擇類型為Rank的欄位。
若要停用特定查詢的靜態排名,請為 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> search-field-value-list動態 刻面欄位。
預設值為 0。最大允許值是為指定索引定義的dynamic-facet欄位、dynamic-facet-field-count的目前數目。 小於0的整數值會視為0。 在dynamic-facet-field-count 上方指定的整數值 會限制為 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欄位清單。
依預設,會考慮所有動態Facet欄位。
43
sp_sfvl_df_include
sp_sfvl_df_include= < field_name >[|< field_name >||...
指定要包含在搜尋結果中的特定動態Facet欄位清單。
注意: sp_ sfvl_df_count參數 可決定要傳回的動態Facet欄位總數,包括透過 sp_sfvl_df_include指定的任何欄位 。 也就是說,使 用sp_sfvl_df_include不允許傳回動態Facet欄位的總計計數超過 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_建議_q
sp_sowlect_q=數
sp_ sowkent_q參 數決定要與Sowskent服務一起使用的 sp_q[_#] 參數。
sp_sowkent_q的預設值為 0,這表示搜尋引擎使用 sp_q的值來 判斷建議。
定sp_sowkent_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
指定應針對此特定查詢啟用或停用類似音效比對。
忽略「完全」的sp_w_control。 類似音效的比對已停用。
忽略「Alike」的sp_w_control。 相似音效比對已啟用
「Anything(其他)」的sp_w_control是1。 類似音效的比對已停用。
「Anything(其他)」的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=欄位
指定要搜索查詢字串的欄位。 任意表示搜尋所有欄位。 title表示僅搜尋標題欄位。 desc意指僅搜尋檔案說明欄位。 鍵表示僅搜尋檔案關鍵字。 body意指僅搜尋內文文字。 alt表示僅搜索替代文本。 url表示僅搜尋URL值。 target意指僅搜尋目標關鍵字。 在任何這些情況下,都會忽略對應 sp_q參數中的"text:"、"desc:"、"keys:"、"body:"、"alt:"、"url:"和"target:"欄位字首的使用者規格。 如 果sp_x不存 在,或者設定為空字串或任何字串,則允許使用標準用戶欄位前置詞。 有關欄位前置詞的詳細資訊,請參閱搜索提示說明。
請參閱 關於搜尋
如需使用sp_x參數的範例,請參閱進階搜 尋表單說 明範例。
您可以建立以sp_x=any設定,在「選項>元資料定義」下,搜索 「按預設搜索」設定為「按選項> 「元資料定義」的所有欄位 , 以執行搜索。 預定義和用戶定義欄位都可用作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 )之間的數字取代。 field-name是任何預先定義或使用者定義的欄位。
如果未為特定編 號的查詢提供 sp_x_#參數,則在「Metadata > Definitions」(通過查詢搜索)設定下,所有定義為「By Default Set」(預設設定)的欄位都將被搜索。
例如,提交下清單格會傳回所有包含"great"的檔案,其中也包含"Fitzgerald"(在"author"欄位中):
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參數的典型範例

下列連結查詢會以"Music"作為搜尋查詢,開始搜尋,並使用所有預設參數。 請注意,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>