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 (searching within a given field) is done by number q and x parameters. q 매개 변수는 패싯에서 검색하는 용어를 해당 번호가 지정된 x 매개 변수로 나타냅니다.
예를 들어 크기와 색상으로 이름이 지정된 두 개의 패싯이 있는 경우 q1=small;x1=size;q2=red;x2=color와 같은 것을 사용할 수 있습니다. 이 매개 변수는 sp_q_exact_# 백엔드 검색 매개 변수에 매핑됩니다.
x#
q#=string
Faceting (searching within a given field) is done by number q and x parameters. q 매개 변수는 패싯에서 검색하는 용어를 해당 번호가 지정된 x 매개 변수로 나타냅니다.
예를 들어 크기와 색상으로 이름이 지정된 두 개의 패싯이 있는 경우 q1=small;x1=size;q2=red;x2=color와 같은 것을 사용할 수 있습니다. 이 매개 변수는 sp_x_# 백엔드 검색 매개 변수에 매핑됩니다.
컬렉션
collection=string
검색에 사용할 컬렉션을 지정합니다. 이 매개 변수는 sp_k 백엔드 검색 매개 변수에 매핑됩니다. 백엔드 검색 CGI 매개 변수를 참조하십시오 .
카운트
count=number
표시되는 결과의 총 개수를 지정합니다. 기본값은 Settings > Searching > Searches에서 정의됩니다.. 이 매개 변수는 sp_c 백엔드 검색 매개 변수에 매핑됩니다. 백엔드 검색 CGI 매개 변수를 참조하십시오 .
page
page=number
반환되는 결과 페이지를 지정합니다.
계급
rank=field
정적 등급에 사용할 등급 필드를 지정합니다. 이 필드는 0보다 큰 연관성이 있는 등급 유형의 필드여야 합니다. 이 매개 변수는 백엔드 매개 변수에 sp_sr 매핑됩니다. 백엔드 검색 CGI 매개 변수를 참조하십시오 .
sort
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 매개 변수

일반적으로 고객은 Guided Search라는 프레젠테이션 레이어와 상호 작용합니다. 하지만 이 페이지에 설명된 CGI 매개 변수를 사용하여 검색 안내 레이어를 건너뛰고 백엔드 코어 검색과 직접 상호 작용할 수는 이론적으로 가능합니다.
다음 표에서 백엔드 검색 CGI 매개 변수를 선택할 수 있습니다.
단일 쿼리 지원
다중 쿼리 지원
설명
1
sp_a
sp_a= string
계정 번호 문자열을 지정합니다. 이 매개 변수는 필수이며 올바른 계정 번호 문자열이어야 합니다. 설정 > 계정 옵션 > 계정 설정 아래에서 계정 번호 문자열 을 찾을 수 있습니다 .
2
sp_advanced
sp_advanced= 0 or 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= number
표시할 결과의 총 개수를 지정합니다. 기본값은 10입니다.
4
sp_context_field
sp_context_field= field
해당 필드에 대한 컨텍스트 정보를 수집합니다. 수집된 정보는 템플릿 태그를 통해 검색 결과로 <search-context> 출력됩니다. 기본값은 body 입니다.
5
sp_d
sp_d= type
수행할 날짜 범위 검색 유형을 지정합니다. 유형에 사용할 수 있는 값은 모두 있습니다. 즉, 날짜 범위 검색, 사용자 지정을 수행하지 sp_date_range 않습니다. 즉, 의 값을 사용하여 검색할 날짜를 결정해야 하고, 값이 sp_start_day , sp_start_month sp_start_year , sp_end_day sp_end_month 값을 사용하여 검색할 날짜 범위 sp_end_year 를 결정합니다. sp_d 은 검색 양식에 사용자 지정 범위(예:)로 또는 특정 시작 및 종료 날짜 범위로 검색하는 옵션이 포함되어 있는 경우에만 sp_date_range 필요합니다.
6
sp_d_#
sp_d_#= type
해당 sp_q_# 쿼리를 수행하기 위한 날짜 범위 검색 유형을 지정합니다. "#"은 1과 16 사이의 숫자(예: 번호 매기기 쿼리에 적용)로 대체됩니다 sp_d_8 sp_q_8 .
원하는 날짜 범위 검색, 사용자 지정, 즉 날짜 범위 검색 type 을 수행하지 않고, 그 값이 검색 날짜를 결정하는 데 사용된다는 것을 나타내는 사용자 지정, 날짜 범위 sp_date_range_# 를 정하 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_d_# sp_date_range_# 로 검색하는 옵션이 포함되어 있는 경우에만 사용할 수 있습니다.
7
sp_date_range
sp_date_range= number
검색에 적용할 사전 정의된 날짜 범위를 지정합니다. 0보다 크거나 같은 값은 오늘 이전에 검색할 일 수를 지정합니다. 예를 들어, "0"은 "today"를, "1"은 "today 및 yesterday"를, "30"은 "지난 30일 이내"를 지정합니다.
0보다 작은 값은 다음과 같이 사용자 지정 범위를 지정합니다.
-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보다 크거나 같은 값은 오늘 이전에 검색할 일 수를 지정합니다. 예를 들어 0의 값은 오늘 값을 지정합니다.값 1은 오늘 및 어제,값이 30이면 지난 30일 이내에 지정되는 등
0보다 작은 값은 다음과 같이 사용자 지정 범위를 지정합니다.
-1 = "없음"으로, 날짜 범위를 지정하지 않는 것과 같습니다.
-2 = "이번 주" - 현재 주의 일요일부터 토요일까지 검색합니다.
-3 = "지난 주"로, 현재 주 전 일요일에서 토요일까지 검색합니다.
-4 = "이번 달" - 현재 월 내의 날짜를 검색합니다.
-5 = "지난 달"이며, 현재 월 이전 달 내에 날짜를 검색합니다.
-6 = "올해" - 현재 연도 내의 날짜를 검색합니다.
-7 = "지난 해"로, 현재 연도 이전 연도 내의 날짜를 검색합니다.
9
sp_dedupe_field
sp_dedupe_field= fieldname
검색 결과를 중복 해제할 단일 필드를 지정합니다. 해당 필드의 중복 결과는 모두 검색 결과에서 제거됩니다. 예를 들어, 예를 들어, 지정된 제목 sp_dedupe_field=title 에 대한 상위 결과만 검색 결과에 표시됩니다(두 개의 결과 중 제목 필드 컨텐츠가 동일하지는 않음). 다중 값(허용 목록) 유형 필드의 경우 전체 필드 내용을 비교하는 데 사용합니다. 하나의 필드만 지정할 수 있습니다. 필드 이름에 "테이블 한정자"를 사용할 수 없습니다.
10
sp_e
sp_e= number
쿼리 문자열에서 문자 수가 넘는 모든 단어에 대해 자동 와일드카드 확장이 수행되도록 지정합니다. 즉, "query" 또는 "number"와 같이 5자 이상의 문자를 포함하는 단어가 와일드카드 문자 '*'로 확장되도록 지정하여 "query*" 또는 "number*"를 검색하는 것과 동일한 검색을 수행합니다. sp_e=5 문자 수가 적은 단어는 확장되지 않으므로 "word"를 검색하면 자동 와일드카드 확장이 되지 않습니다.
11
sp_e_#
sp_e_#= number
문자 수가 많은 해당 sp_q_# 쿼리 문자열에서 모든 단어에 대해 자동 와일드카드 확장이 이루어지도록 지정합니다. 즉, 쿼리 문자열에서 "쿼리" 또는 "number"와 같은 5개 이상의 문자를 포함하는 단어가 와일드카드 문자 ' sp_e_2=5 sp_q_2 * '로 확장되도록 지정하여 "query*" 또는 "number*"를 검색하는 것과 동일한 검색을 수행합니다. 문자 수가 적은 단어는 확장되지 않으므로 "word"에서 검색하면 자동 와일드카드 확장이 sp_q_2 수행되지 않습니다.
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= string
쿼리 매개 변수 문자열(예: 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"인 하나 이상의 "red" 항목이 포함된 문서를 검색하려면 항목을 다음과 같이 사용할 수 있습니다.
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=1 sp_i=2
sp_k= string
sp_l= string
sp_q string
sp_literal= 0 or 1
sp_literal=1
sp_literal=0
sp_m= number
sp_n= number
sp_not_found_page= url
sp_p= any/all/phrase
any all phrase
phrase all sp_p
sp_p
sp_p_#= any/all/phrase
sp_q_# sp_p_8 sp_q_8 any all phrase
all phrase sp_p_# any
sp_pt= exact/equivalent/compatible
exact equivalent compatible sp_p exact sp_p all phrase equivalent sp_pt compatible
sp_pt_#= exact/equivalent/compatible
sp_q_# sp_p_8 sp_q_8 exact equivalent exact compatible sp_p_# exact sp_p_# equivalent sp_pt_# compatible
sp_q= string
sp_q_#= text
sp_q_# sp_q_1 sp_q_16
Search for: <input type="text" name="sp_q" value="great"> Search for: <input type="text" name="sp_q_1" value="books">
sp_q_day= integer value
sp_q_month= integer value
sp_q_year= integer value
sp_q_day_#= integer value
sp_q_month_#= integer value
sp_q_year_#= integer value
sp_q_day sp_q_month sp_q_year sp_q
# sp_q_day_6 sp_q_6
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 
sp_q_location= latitude/longitude OR areacode OR zipcode
sp_q_location_#= latitude/longitude OR areacode OR zipcode
sp_q_location sp_q_location_# #
sp_q_max_relevant_distance= value
sp_q_max_relevant_distance_#= value
sp_q_max_relevant_distance sp_q_max_relevant_distance_# #
sp_q_max_relevant_distance
sp_q_max_relevant_distance_#
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_q_min_day sp_q_min_month sp_q_min_year sp_q_max_day sp_q_max_month sp_q
# sp_q_min_day_6 sp_q_6
PublishDate
<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
sp_q_min= value
sp_q_max= value
sp_q_min_#= value
sp_q_max_#= value
sp_q_exact_#=value
sp_q_min sp_q_max sp_q_exact sp_q
# 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
sp_q_nocp= 1 or 0
sp_q_nocp_#= 1 or 0
0
1
sp_q_nocp sp_q # sp_q_nocp_8 sp_q_8
sp_q_required= 1 or 0 or -1
sp_q_required_#= 1 or 0 or -1
sp_q_required sp_q
# sp_q_required_8 sp_q_8
<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">
sp_redirect_ if_one_result= 0 or 1
sp_referrer= url
ro
sp_ro=body:10
sp_ro=body:9|title:9
sp_ro=title:10 title sp_ro sp_ro
sp_s= number
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">
sp_field_table
sp_sr= field
sp_sr
sp_sr <input type="hidden" name="sp_sr" value="">
sp_sfvl_field= string
search-field-value-list
sp_sfvl_field
search-field-value-list
dynamic-facet-field-count dynamic-facet-field-count
sp_sfvl_df_count dynamic-facet-field-count sp_sfvl_df_count sp_sfvl_df_count
sp_sfvl_df_count sp_sfvl_df_include sp_sfvl_df_include sp_sfvl_df_count
sp_staged= 0 or 1
sp_staged=1
sp_start_day= number
sp_start_month= number
sp_start_year= number
sp_suggest_q= number
sp_suggest_q sp_q[_#]
sp_suggest_q sp_q
sp_suggest_q=1 sp_q_1
sp_t= string
sp_trace= 0 or 1
sp_stage=1
sp_w= sound-alike-enable
sp_w_control= sound-alike-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
sp_x= field
sp_q sp_x
sp_x
sp_x=any sp_x
sp_x
<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">
sp_x_#= field-name
sp_q_# # sp_x_8
sp_x_#
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_#
<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>