Show Menu
화제×

CGI 매개 변수

CGI 매개 변수

CGI 매개 변수 검색

검색 양식 코드는 사이트의 HTML( Design > Auto-Complete > Form Source )을 복사하여 붙여넣을 수 있도록 제공됩니다.
검색 양식 자체에 나열되거나 스크립트에서 나열되는 매개 변수를 설정할 수도 있습니다. 아래 나열된 매개 변수 외에 백엔드 검색 매개 변수를 사용하여 검색을 제어할 수도 있습니다.
백엔드 검색 CGI 매개 변수를 참조하십시오.
검색 요청은 기본 URL로 구성됩니다. 기본 URL은 고객이 검색하는 계정과 연결된 계정에 대해 원하는 검색 결과를 반환하는 방법을 나타내는 CGI 매개 변수(키-값 쌍) 세트를 나타냅니다.
기본 URL은 특정 계정 및 단계 또는 라이브 환경과 연결됩니다. 계정 관리자에서 기본 URL에 대해 여러 별칭을 요청할 수 있습니다. 예를 들어 Megacorp라는 회사는 계정과 연결된 두 개의 기본 URL을 가질 수 있습니다. https://search.megacorp.com https://stage.megacorp.com Adobe 이전 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 매개 변수는 패싯에서 검색하는 용어를 해당 번호가 매겨진 x 매개 변수로 나타냅니다.
예를 들어, 크기와 색상이라는 두 개의 패싯이 있는 경우 q1=small;x1=size;q2=red;x2=color와 같은 것을 사용할 수 있습니다. 이 매개 변수는 sp_q_exact_# 백엔드 검색 매개 변수에 매핑됩니다.
백엔드 검색 CGI 매개 변수를 참조하십시오.
x#
q#=string
Faceting(주어진 필드 내에서 검색)은 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=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_582E85C3886740C98CA9DF7918E8)

백엔드 검색 CGI 매개 변수

일반적으로 고객은 Guided Search라는 프레젠테이션 레이어와 상호 작용합니다. 하지만 이 페이지에 설명된 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= 유형
수행할 날짜 범위 검색 유형을 지정합니다. 유형의 가능한 값은 모두 해당됩니다. 즉, 날짜 범위 검색을 수행하지 않고, custom을 수행한다는 것을 의미하며, sp_date_date_ specific의 값을 사용하여 날짜를 검색해야 함을 나타냅니다. 이것은 sp_date_date_ specific의 값을 사용해야 한다는 것을 나타냅니다. 즉, 은 sp_date_start_start_Start_Sp의 값을 결정하며, Sp_start_End_Sp의 값을 결정하며, Cue_Cue_Cue_Cend_Cue_Cue의를를를를를를를를를를를를를를를를를를를를를를를를를를를를를를를를를를를를를를를를를를를를를를 End_End_End_End_End_Cue_Cue 검색할 날짜 범위를 결정하는 데 사용됩니다. sp_d 는 검색 양식에 사용자 지정 범위( sp_date_range를 통해)나 특정 시작 및 종료 날짜 범위에 따라 검색하는 옵션이 포함된 경우에만 필요합니다 .
6
sp_d_#
sp_d_#= type
해당 sp_q_# 쿼리에 대해 수행할 날짜 범위 검색 유형을 지정합니다. "#"은 1과 16 사이의 숫자로 대체됩니다(예: sp_d_8 은 번호가 매겨진 쿼리 sp_q_8 ).
원하는 유형으로 유형을 설정할 수 있습니다. 즉, 날짜 범위 검색을 수행하지 않습니다. custom은 sp_date_range_# 값이 검색 날짜를 결정하는 데 사용되었음을 나타내고, 구체적인 값을 나타내는, 즉 sp_date_range_# 값이 사용되었음을 나타내며, 이 값은 SP_q_min_min_day를에, SP_cq에 포함됨을 나타내고, min_cq를를 를 _ max_q_month, max_year_year_를 사용하여 날짜 범위를 결정해야 합니다. 검색 양식에 사용자 지정 범위( sp_date_range_#)나 특정 시작 및 종료 날짜 범위에 따라 검색할 수 있는 옵션이 포함된 경우에만 sp_d_# 사용이 필요합니다.
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 = "Last year"로 이 값은 현재 연도 이전 년 내의 날짜를 검색합니다.
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 = "Last year"로 이 값은 현재 연도 이전 년 내의 날짜를 검색합니다.
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는 sp_q_2 쿼리 문자열에서 "query" 또는 "number"와 같은 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= 문자열
쿼리 매개 변수 문자열( 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=tabename.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=
보고서를 생성할 때 검색을 무시합니다.
이 쿼리를 사용하여 사용자가 생성한 검색이나 관리자가 멤버 센터에서 생성하는 검색과 같은 특정 백엔드 검색을 마스크 처리할 수 있습니다. 최종 사용자는 이러한 유형의 검색을 생성하지 않으므로 다양한 Adobe Search&Promote 보고서에 표시되지 않습니다.
유효한 값은 sp_i=1 sp_i=2 입니다.
16
sp_k
sp_k= 문자열
검색에 사용할 컬렉션을 지정합니다. 기본값은 컬렉션이 아닙니다. 즉, 검색에는 전체 사이트가 포함되어야 합니다.
검색 양식에서 컬렉션 사용을 참조하십시오.
17
sp_l
sp_l= 문자열
쿼리 매개 변수 문자열( sp_q )의 언어를 지정합니다. ISO-639 언어 코드 뒤에 선택적으로 ISO-3166 국가 코드가 따르는 표준 로케일 ID가 문자열이어야 합니다. 예를 들어, 영어의 경우 "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은 yes, 0은 no입니다. 기본값은 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
적용할 대상 일치 유형을 지정합니다. 정확한 정확성을 사용하면 타겟 컨텐츠 내의 쿼리 문자열과 정확히 일치하는 문서에서만 yield target이 일치함을 의미합니다. 단어의 순서가 중요하지 않다는 점을 제외하면 이와 같은 의미의 사용은 정확히 일치합니다. 호환을 사용하면 sp_p 매개 변수의 값을 기반으로 대상 일치 유형이 자동으로 설정됩니다. 이 사용은 sp_p 구문이 모두 정확히 사용되고, 그 외의 경우에는 그에 상응하는 구문이 모두 사용된 경우에 사용됩니다. sp_pt의 기본값은 호환됩니다 .
25
sp_pt_#
sp_pt_#= exact/equivalent/compatible
해당 sp_q_# 쿼리에 적용할 대상 일치 유형을 지정합니다. "#"은 1과 16 사이의 숫자로 대체됩니다(예: sp_p_8 은 번호가 매겨진 쿼리 sp_q_8 ). 정확한 정확성을 사용하면 타겟 컨텐츠 내의 쿼리 문자열과 정확히 일치하는 문서에서만 yield target이 일치함을 의미합니다. 단어의 순서가 중요하지 않다는 점을 제외하고, 이와 같은 단어의 사용은 정확한 것과 같습니다. 호환되는 유형을 사용하면 해당 sp_p_# 매개 변수의 값을 기반으로 대상 일치 유형이 자동으로 설정됩니다. exact sp_p_# 이 모두 또는 구문인 경우 사용되며, 그 외에는 이에 상응하는 것이 사용됩니다. sp_pt_#의 기본값은 호환됩니다 .
26
sp_q
sp_q= 문자열
검색에 대한 쿼리 문자열을 지정합니다. 빈 문자열을 사용하면 결과가 표시되지 않습니다.
27
sp_q_#
sp_q_#= text
이 매개 변수를 사용하면 검색 양식에 여러 쿼리를 만들 수 있습니다. 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_day , sp_q_month sp_q_year 매개 변수가 기본 쿼리( sp_q)에 적용됩니다.
# 매개 변수는 1과 16 사이의 숫자로 바뀝니다(예: 번호가 매겨진 쿼리 sp_q_6 에 적용되는 sp_q_day_6). 기본적으로 모든 날짜는 그리니치 평균 시간을 기준으로 검색됩니다.
다음 코드 섹션에서는 "Jan"이라는 이름의 문서에서 "주황색"이라는 단어를 검색할 수 있습니다. PublishDate라는 사용자 정의 필드의 첫 번째, 2000" :
<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(3자리) 형식의 값은 미국 전화 번호로 해석됩니다.DDDD 또는 DDDDD-DDD 형식의 값은 US zipcode로 해석됩니다.그리고 DD.DDD DDD.DDD 형식의 값은 위도/경도 쌍으로 해석됩니다. 각 값에 대해 기호가 필요합니다. 예를 들어 +38.6317+120.5509는 위도 38.6317, 경도 120.5509를 지정합니다.
30
sp_q_max_related_distance
sp_q_max_related_distance _#
sp_q_max_relevant_distance= value
sp_q_max_relevant_distance_#= value
이러한 매개 변수는 근접 검색에 적용되는 관련성 계산을 제어합니다. sp_q_max_related_distance 를 사용하면 기본 쿼리인 sp_q_max_related_distance_ #(여기서 # 가 1에서 16까지의 숫자로 대체됨)에 영향을 주고, 지정된 번호가 지정된 쿼리에 영향을 줍니다.
sp_q_max_related_distance의 기본값은 100 입니다.
근접 구성 요소에 대한 완벽한 연관성 점수는 0의 거리를 나타냅니다. 근접 구성 요소에 대한 최소 관련성 점수는 지정된 sp_q_max_related_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, _q_min_ month, _q_min_ , sp_day_day, _q_max_q_max_month, andMax_q max_month, andSp_max_yearSP의 기본 쿼리( sp_q 기본 쿼리)에 매개 변수가 적용됩니다.
매개 변수 이름의 #은 1과 16 사이의 숫자로 바뀝니다(예: sp_q_min_day_6 은 번호가 매겨진 쿼리 sp_q_6 ).
최소 날짜, 최대 날짜 또는 최소 및 최대 날짜 모두를 지정하는 것은 합법적입니다. 그러나 지정된 최소 또는 최대 세트의 경우 세 개의 날짜 매개 변수(일, 월 및 년)를 모두 지정해야 합니다. 기본적으로 모든 날짜는 그리니치 평균 시간을 기준으로 검색됩니다.
다음 코드 섹션에서는 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_# 매개 변수는 선택적으로 여러 개의 "|" 구분 값을 지정할 수 있습니다. 예를 들어 "color" 필드 내에서 녹색 또는 빨간색 값이 포함된 문서를 검색하려면 다음을 수행합니다. ...&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), 5월 또는 (-1)이 발생하지 않아야 하는지 여부를 결정합니다.
sp_q_required의 사용은 기본 쿼리( sp_q )에 영향을 줍니다.
번호가 매겨진 쿼리에 적용하려면 매개 변수 이름의 #을 해당 번호로 바꿉니다(예: sp_q_required_8 은 번호가 매겨진 쿼리 sp_q_8 에 적용). 매개 변수의 기본값은 1(일치해야 함)입니다.
사용자 정의 "platform" 필드에 "calc"라는 단어를 포함하지만 HTML에 "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= 필드 :연관성
필드 이름당 검색 시간, 연관성 컨트롤을 선택적으로 사용할 수 있습니다. 매개 변수 이름의 로는 "관련성 재정의"를 나타냅니다. 매개 변수는 하나 이상의 필드 이름을 허용하며, 그 다음에 콜론 문자를 사용하고 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= number
정렬 순서를 지정합니다. 0은 기본값이며 관련성 점수로 정렬하는 수단입니다. 하나는 날짜별로 정렬하는 것을 의미하고 -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 dynamic-facet 필드를 요청합니다.
기본값은 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 > |...
이 검색에 대해 제외할 특정 동적 패싯 필드 목록을 지정합니다.
기본적으로 모든 동적 패싯 필드가 고려됩니다.
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= number
sp_start_month= number
sp_start_year= number
이 세 개의 값은 검색에 대한 시작 날짜 범위를 지정하고 세트로 제공합니다.
46
sp_추천_q
sp_suggest_q= number
sp_suggest_q 매개 변수는 sp_q[_#] 매개 변수를 확인하여 제안 서비스와 함께 사용할 수 있습니다.
sp_suggest_q의 기본값은 0입니다. 즉, 검색 엔진은 sp_q 값을 사용하여 제안을 결정합니다.
sp_ suggest_q=1을 설정하여 sp_q_1 값을 사용하여 제안 등을 결정합니다.
47
sp_t
sp_t= 문자열
사용할 전송 템플릿을 지정합니다.
이 매개 변수는 검색 계정의 각 영역에 대해 다른 검색 전송 템플릿을 사용하여 웹 사이트 전체에서 핵심 검색 결과의 모양을 제어하려는 경우 유용합니다.
기본 전송 템플릿은 "검색"입니다.
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은 무시됩니다. 유사한 검색은 비활성화되어 있습니다.
'동일함'에 대한 sp_w_control이 무시되었습니다. 유사 일치 사용
다른 항목에 대한 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_#= field-name
이 매개 변수는 해당 sp_q_# 쿼리에서 검색할 필드를 지정합니다. # 는 1~16 사이의 숫자(예: sp_x_8 )로 바뀝니다. 필드 이름은 사전 또는 사용자 정의 필드입니다.
특정 번호가 있는 쿼리에 대해 _x_# 매개 변수가 제공되지 않으면 [설정] > [메타데이터 검색]에 설정된 기본 검색으로 정의된 모든 필드가 해당 쿼리에 의해 검색되는 SP 의 [기본 설정] > [메타데이터 검색됨]에 설정되어 있습니다.
예를 들어, 다음 양식을 제출하면 "작성" 필드에 "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>