---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# 카탈로그 검색 - 범위 지정됨

# 카탈로그 검색 - 범위 지정됨 {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 2분

CatalogSearch API에는 카탈로그 항목을 검색할 수 있는 메서드가 있습니다.

범위가 지정된 애플리케이션에서 이 클래스를 사용하려면 `sn_sc` 네임스페이스 식별자를 사용하십시오. CatalogSearch API에 액세스하려면 기본적으로 활성화되어 있는 Service Catalog 범위 지정 API 플러그인(ID: com.glideapp.servicecatalog.scoped.api)이 필요합니다.

## 카탈로그 검색 - 카탈로그 검색() {#ariaid-title2}

CatalogSearch 클래스의 인스턴스를 만듭니다.
{#r_CSS-CatalogSearch__table_w4w_r1y_5z__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 1. 매개변수]

{#r_CSS-CatalogSearch__table_w4w_r1y_5z}  

    var catSearchGR = new sn_sc.CatalogSearch().search('', '', 'Apple', false, true);
    catSearchGR.query();
    while(catSearchGR.next()) {
      gs.info(catSearchGR.getValue('name'));
    }

## 카탈로그 검색 - 검색(문자열 catalogID, 문자열 categoryID, 문자열 용어, 부울 모바일, 부울 noDepthSearch) {#ariaid-title3}

검색어를 기반으로 카탈로그 항목을 검색합니다. 검색 범위를 카탈로그 범주 수준으로 좁힐 수 있습니다.
{#r_CSS-search_S_S_S_B_B__table_t55_3by_5z__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 카탈로그ID | 문자열 | 검색할 카탈로그의 식별자입니다. |
| 범주ID | 문자열 | 검색할 카탈로그 범주의 식별자입니다. |
| 학기 | 문자열 | 검색어입니다. |
| 모바일 | 부울 | 모바일에 노출된 카탈로그 항목이 검색되는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 모바일 카탈로그 항목을 검색합니다. * 아니오: 모바일 카탈로그 항목을 검색하지 않습니다. {#r_CSS-search_S_S_S_B_B__ul_ils_fwq_2pb} |
| noDepthSearch | 부울 | 하위 범주를 검색할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 하위 범주를 검색하지 않습니다. * false: 하위 범주를 검색합니다. {#r_CSS-search_S_S_S_B_B__ul_iqz_3wq_2pb} |
[표 2. 매개변수]

{#r_CSS-search_S_S_S_B_B__table_t55_3by_5z} {#r_CSS-search_S_S_S_B_B__table_u55_3by_5z__entry__2}

| 유형 | 설명 |
|-|-|
| GlideRecord | 검색 결과와 일치하는 sc_cat_item에서 GlideRecord를 반환합니다. |
[표 3. 반환]

{#r_CSS-search_S_S_S_B_B__table_u55_3by_5z}  
이 예는 모든 카탈로그와 모든 범주에서 ServiceNow라는 용어를 검색하는 방법을 보여줍니다.

    var now_GR = new sn_sc.CatalogSearch().search('', '', 'ServiceNow', false, false);
    now_GR.query();
    while(now_GR.next()) {
      gs.log(now_GR.name);
    }

출력:

    ServiceNow T-shirt