CGI 매개 변수

CGI 매개 변수

CGI 매개 변수 검색

검색 양식 코드는 사이트의 HTML( Design > Auto-Complete > Form Source)을 복사하여 붙여넣을 수 있도록 제공됩니다.

자세한 내용은 검색 양식의 HTML 코드를.

검색 양식 자체에 나열되거나 스크립트에서 나열되는 매개 변수를 설정할 수도 있습니다. 아래 나열된 매개 변수 외에 백엔드 검색 매개 변수를 사용하여 검색을 제어할 수도 있습니다.

백엔드 검색 CGI 매개 변수를 참조하십시오.

검색 요청은 기본 URL로 구성됩니다. 기본 URL은 고객이 검색하는 계정과 연결된 계정에 대해 원하는 검색 결과를 반환하는 방법을 가리키는 CGI 매개 변수 집합(키-값 쌍)을 나타냅니다.

기본 URL은 특정 계정 및 단계 또는 라이브 환경과 연결됩니다. 계정 관리자에서 기본 URL에 대해 여러 별칭을 요청할 수 있습니다. 예를 들어 Megacorp라는 회사는 계정과 연결된 2개의 기본 URL을 가질 수 있습니다.https://search.megacorp.comhttps://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 매개 변수는 해당 번호가 매겨진 x 매개 변수로 표현되는 패싯에서 검색하는 용어를 정의합니다.
예를 들어 크기 및 색상이라는 두 개의 패싯이 있는 경우 q1=small;x1=size;q2=red;x2=color와 같은 요소를 가질 수 있습니다. 이 매개 변수는 sp_q_exact_# 백엔드 검색 매개 변수에 매핑됩니다.
백엔드 검색 CGI 매개 변수를 참조하십시오.
x# q#=string 세그먼트(지정된 필드 내에서 검색)는 번호가 매겨진 q 및 x 매개 변수를 통해 수행됩니다. q 매개 변수는 해당 번호가 매겨진 x 매개 변수로 표현되는 패싯에서 검색하는 용어를 정의합니다.
예를 들어 크기 및 색상이라는 두 개의 패싯이 있는 경우 q1=small;x1=size;q2=red;x2=color와 같은 요소를 가질 수 있습니다. 이 매개 변수는 sp_x_# 백엔드 검색 매개 변수에 매핑됩니다.
백엔드 검색 CGI 매개 변수를 참조하십시오.
컬렉션 collection=string 검색에 사용할 컬렉션을 지정합니다. 이 매개 변수는 sp_k 백엔드 검색 매개 변수에 매핑됩니다. 백엔드 검색 CGI 매개 변수를 참조하십시오.
count 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 매개 변수의 값에 필드 이름을 사용하면 해당 필드별로 결과가 정렬되고 관련성별로 하위 정렬됩니다. 이 기능을 활성화하려면 Settings > Metadata > Definitions를 클릭합니다. 정의 페이지에서 Add New Field을 클릭하거나 특정 필드 이름에 대해 Edit을 클릭합니다. Sorting 드롭다운 목록에서 Ascending 또는 Descending 중 하나를 선택합니다. 이 매개 변수는 sp_s 백엔드 검색 매개 변수에 매핑됩니다.
백엔드 [검색 CGI 매개 변수를 참조하십시오].(/docs/search-promote/using/appendices/c-cgiparameters.html?lang=ko#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 and 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

쿼리 문자열에서 문자 수가 넘는 모든 단어에 대해 자동 와일드카드 확장을 적용하도록 지정합니다. 즉, sp_e=5 은 "query" 또는 "number"와 같이 5자 이상의 단어가 와일드카드 문자 '*'로 확장되도록 지정하여 "query*" 또는 "number*"를 검색하는 것과 동일한 검색을 수행합니다. 문자 수가 적은 단어는 확장되지 않으므로 "word"에 대한 검색에는 자동 와일드카드 확장이 없습니다.

11

sp_e_#

sp_e_#= number

문자 수가 많은 해당 sp_q_# 쿼리 문자열에서 모든 단어에 대해 자동 와일드카드 확장을 적용하도록 지정합니다. 즉, sp_e_2=5 은 "query" 또는 "number"와 같이 sp_q_2 쿼리 문자열에 5개 이상의 문자가 있는 단어가 와일드카드 문자 ' * '로 확장되도록 지정하여 "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= 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 매개 변수를 사용하는 일반적인 예

다음 링크 쿼리는 검색 쿼리로서 "음악"을 사용하여 검색을 시작하고 모든 기본 매개 변수를 사용합니다. 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 매개 변수 사용에 대한 자세한 예

다음 양식 쿼리는 결과 10에서 시작하는 25 결과를 표시합니다. 요약이 표시되지 않고 정렬 순서는 날짜별로 지정되며 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>

이 페이지에서는