Query variables in SharePoint Server
적용 대상:
2013 2016 2019 Subscription Edition SharePoint in Microsoft 365
참고: 이 문서는 최신 Microsoft Search 환경 및 API에는 적용되지 않습니다. 최신 검색에 대한 자세한 내용은 프로필 쿼리 변수를 참조하세요.
쿼리 변수
다음 표에서는 Microsoft 365의 SharePoint Server 및 SharePoint에 대한 쿼리 변수와 사용 방법에 대한 예제를 보여 줍니다.
사이트 및 사이트 모음 속성
| 쿼리 변수 | 정의 |
|---|---|
| {Site} 또는 {Site.URL} |
쿼리를 실행한 사이트의 URL입니다. 예를 들어 이 값은 관리 속성 Path의 콘텐츠를 쿼리하는 데 사용할 수 있습니다. |
| {Site.ID} |
쿼리를 실행한 사이트의 GUID입니다. 이 값은 관리 속성 WebId의 값에 해당합니다. |
| {Site.LCID} |
쿼리를 실행한 사이트의 사이트 설정에서 국가별 설정에 의해 지정된 로캘의 숫자 값입니다. |
| {Site.Locale} |
쿼리를 실행한 사이트의 ll-cc 형식 언어(예: en-us)입니다. |
| {Site.<property>} |
사용자 지정 속성을 비롯하여 쿼리를 실행한 사이트(SPWeb)의 속성 모음에 포함된 속성입니다. |
| {SiteCollection} 또는 {SiteCollection.URL} |
쿼리를 실행한 사이트 모음의 URL입니다. 예를 들어 이 값은 관리 속성 Path의 콘텐츠를 쿼리하는 데 사용할 수 있습니다. |
| {SiteCollection.ID} |
쿼리를 실행한 사이트 모음의 GUID입니다. 이 값은 관리 속성 SiteID의 값에 해당합니다. |
| {SiteCollection.LCID} |
쿼리를 실행한 사이트 모음의 사이트 설정에서 국가별 설정에 의해 지정된 로캘의 숫자 값입니다. |
| {SiteCollection.Locale} |
쿼리를 실행한 사이트 모음의 ll-cc 형식 언어(예: en-us)입니다. |
| {SiteCollection.<property>} |
사용자 지정 속성을 비롯하여 쿼리를 실행한 사이트 모음(SPSite)에 있는 루트 사이트(SPWeb)의 속성 모음에 포함된 속성입니다. |
페이지, URL 토큰, 쿼리 문자열 및 요청 속성
| 쿼리 변수 | 정의 |
|---|---|
| {Page} 또는 {Page.URL} |
쿼리를 실행한 페이지의 URL입니다. 예를 들어 이 값은 관리 속성 Path의 콘텐츠를 쿼리하는 데 사용할 수 있습니다. |
| {Page.UsageAnalyticsId} |
사용 현황 분석용 항목 ID입니다. |
| {Page.<FieldName>} |
쿼리를 실행한 페이지에 있는 필드의 값입니다. 예를 들어 쿼리를 실행한 페이지에 "ContentOwner"라는 사이트 열이 포함된 경우 {Page.ContentOwner}를 지정하면 "ContentOwner" 값을 쿼리할 수 있습니다. |
| {URLToken.<integer>} |
페이지 URL의 값입니다. 정수는 오른쪽에서 왼쪽으로 계산한 URL의 값 위치입니다. 예를 들어 페이지의 http://www.contoso/audio/mp3/1010101경우 쿼리 변수 {URLToken.1}은 URL의 마지막 값인 1010101 쿼리합니다. 쿼리 변수 {URLToken.3}은 URL의 끝에서 세 번째 속성인 audio를 쿼리합니다. URL에 대해 끝에서 9번째까지의 값을 쿼리할 수 있습니다. |
| {QueryString.<ParameterName>} |
현재 페이지 URL에서 쿼리 문자열의 값입니다. 예를 들어 현재 페이지의 URL에 ItemNumber=567과 같은 쿼리 문자열이 포함된 경우 {QueryString.ItemNumber}를 지정하면 값 567이 반환됩니다. |
| {요청.<PropertyName>} |
현재 http 요청의 값(예: {Request.Url})입니다. |
사용자 속성
| 쿼리 변수 | 정의 |
|---|---|
| {User} 또는 {User.Name} |
쿼리를 실행한 사용자의 표시 이름입니다. 예를 들어 이 값은 관리 속성 Author의 콘텐츠를 쿼리하는 데 사용할 수 있습니다. |
| {User.Email} |
쿼리를 실행한 사용자의 전자 메일 주소입니다. 예를 들어 이 값은 관리 속성 WorkEmail의 콘텐츠를 쿼리하는 데 사용할 수 있습니다. |
| {User.SID} |
쿼리를 실행한 사용자의 SID입니다. |
| {User.LCID} |
쿼리를 실행한 사용자의 프로필에 정의된 로캘의 숫자 값입니다. |
| {User.PreferredContentLanguage} |
쿼리를 실행한 사용자의 프로필에 기본 설정 콘텐츠 언어로 지정된 언어입니다. |
| {User.PreferredDisplayLanguage} |
쿼리를 실행한 사용자의 프로필에 기본 설정 표시 언어로 지정된 언어입니다. |
| {User.<property>} |
사용자 지정 속성을 비롯하여 쿼리를 실행한 사용자의 사용자 프로필에 포함된 모든 속성(예: SPS-Interests)입니다. |
| {User.Audiences} (SharePoint에만 해당) |
관리 속성 ModernAudienceAadObjectIds에 대한 필터링을 대상으로 하는 최신 SharePoint 대상 그룹과 함께 사용됩니다. 예: ModernAudienceAadObjectIds:{User.Audiences}. |
용어 및 용어 집합 속성
| 쿼리 변수 | 정의 |
|---|---|
| {Term}/{Term.ID}/{Term.IDNoChildren} |
접두사가 #0인 현재 사이트 탐색 노드의 GUID(예: #083e99dcb-7907-4dc9-abc8-b5614a284f1c)입니다. 예를 들어 이 값은 제품 카탈로그 사이트 모음에서 관리 속성 owstaxIdMetadataAllTagsInfo 또는 owstaxIdProductCatalogItemCategory의 콘텐츠를 쿼리하는 데 사용할 수 있습니다. |
| {Term.IDWithChildren} |
접두사가 #인 현재 사이트 탐색 노드의 GUID(예: #83e99dcb-7907-4dc9-abc8-b5614a284f1c)입니다. 이 변수는 현재 사이트 탐색 용어로 태그가 지정된 모든 항목 또는 현재 사이트 탐색 용어의 하위 항목을 반환합니다. 예를 들어 이 값을 사용하여 제품 카탈로그 사이트 모음에서 관리 속성 owstaxIdProductCatalogItemCategory의 콘텐츠를 쿼리할 수 있습니다. 이 값을 사용하여 관리 속성 owstaxidmetadataalltagsinfo의 콘텐츠를 쿼리할 수는 없습니다. |
| {Term.Name} |
사이트 탐색 노드의 레이블(예: Audio)입니다. |
| {Term.<property>} |
사용자 지정 속성을 비롯하여 용어의 속성 모음에 포함된 모든 속성입니다. |
| {TermSet} 또는 {TermSet.ID} |
현재 사이트 탐색에 사용되는 용어 집합의 GUID입니다. |
| {TermSet.Name} |
현재 사이트 탐색에 사용되는 용어 집합의 레이블입니다. |
목록 및 목록 항목 속성
| 쿼리 변수 | 정의 |
|---|---|
| {List} |
현재 목록의 URL입니다. |
| {List.<property>} |
현재 목록의 모든 속성입니다. |
| {ListItem} |
현재 목록 항목의 URL입니다. |
| {ListItem.<property>} |
현재 목록 항목의 모든 속성입니다. |
기타 속성
| 쿼리 변수 | 정의 |
|---|---|
| {Today+/- <일> 수의 정수 값} |
쿼리를 실행한 날짜에 지정된 일 수를 더하거나 빼서 계산하는 날짜입니다. 날짜 형식은 YYYY-MM-DD입니다. 예를 들어 이 값은 관리 속성 LastModifiedTime의 콘텐츠를 쿼리하는 데 사용할 수 있습니다. |
| {SearchBoxQuery} |
페이지의 검색 상자에 입력된 쿼리 값입니다. |
| {CurrentDisplayLanguage} |
MUI를 기반으로 하는 ll-cc 형식의 현재 표시 언어입니다. |
| {CurrentDisplayLCID} |
MUI를 기반으로 하는 ll-cc 형식의 현재 표시 언어에 해당하는 숫자 값입니다. |
값의 공백 처리
검색 쿼리에서는 공백 문자를 사용하여 사용자가 입력하는 쿼리 값을 토큰화합니다. 쿼리 변수를 공백이 포함된 값으로 확장하면 전체 값이 큰따옴표로 묶입니다. 예를 들어 author:{User} 쿼리의 경우 확장된 값은 author:"John Smith"가 됩니다.
여러 값을 연결하는 등의 경우 값을 큰따옴표로 묶지 않으려면 쿼리 변수에 이스케이프 문자를 사용하면 됩니다. 예: customProperty:"{\User.Name}; {\User.ZipCode}"는 customProperty:"John Smith; 98109".
여러 값이 포함된 쿼리 변수
여러 값을 반환하는 쿼리 변수도 있습니다. 값을 여러 개 반환하는 쿼리 변수에는 {|ManagedProperty:{QueryVariable}} 구문을 사용해야 합니다. 모든 쿼리 변수 값은 비트 OR 연산을 사용하여 결합됩니다. 예를 들어 사용자의 관심사를 분류하는 데 사용되는 용어 집합이 있다고 가정해 보겠습니다. 모든 사용자는 User Profile Service 응용 프로그램에서 다중값 속성 SPS-Interests를 사용하여 하나 이상의 관심사를 가지도록 구성됩니다. 여기서 현재 사용자의 관심사를 반환하는 쿼리를 실행하려면 {|owstaxIdMetadataAllTagsInfo:{User.SPS-Interests}} 구문을 사용할 수 있습니다. 현재 사용자가 두 가지 관심사(축구(#0f95d1fdf-781f-42f4-99f9-c656c1341b2e)와 농구(#0c2cff933-9377-4692-aa98-ce59768aa38b)를 갖도록 구성된 경우 쿼리는 (59768aa38b)로 변환됩니다. owstaxIdMetadataAllTagsInfo:#0f95d1fdf-781f-42f4-99f9-c656c1341b2e) OR (owstaxIdMetadataAllTagsInfo:#0c2cff933-9377-4692-aa98-ce59768aa38b) .
여러 값을 사용하는 경우 몇 가지 제한이 적용됩니다. 먼저, 값이 여러 개인 경우 OR 연산자({|)만 지원됩니다. AND 연산자는 지원되지 않습니다. 또한 여러 값을 사용하는 경우에는 관리되는 메타데이터 유형의 열만 정상적으로 작동합니다. 사용자, 그룹, 선택 유형의 열과 같이 여러 값을 포함할 수 있는 기타 유형의 열에서는 항목이 구분된 문자열로 확장됩니다.