---
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


---

# CatalogJS - 범위 지정됨

# CatalogJS - 범위 지정됨 {#ariaid-title1}

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

CatalogJS API는 카탈로그별 속성을 확인하고 검색하는 메서드를 제공합니다.

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

## CatalogJS - 카탈로그(GlideRecord now_GR) {#ariaid-title2}

지정된 Glide 기록 객체에 대한 카탈로그 클래스의 인스턴스를 만듭니다.
{#CJS-Catalog_G__table_og2_g1c_5bb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| now_GR | 객체 | sc_catalog 테이블을 가리키는 Glide 기록입니다. |
[표 1. 매개변수]

{#CJS-Catalog_G__table_og2_g1c_5bb}  
이 예시에서는 카탈로그 클래스의 새 인스턴스를 만드는 방법을 보여줍니다.

    var now_GR = new GlideRecord('sc_catalog');
     now_GR.addQuery('sys_id','e0d08b13c3330100c8b837659bba8fb4');
     now_GR.query();
     var catalog = new sn_sc.Catalog(now_GR);

## CatalogJS - 카탈로그(문자열 sys_id) {#ariaid-title3}

지정된 sys_id을 사용하여 카탈로그 클래스의 인스턴스를 만듭니다.
{#CJS-Catalog_S__table_tf1_gbc_5bb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| sys_id | 문자열 | 카탈로그의 Sys_id입니다. |
[표 2. 매개변수]

{#CJS-Catalog_S__table_tf1_gbc_5bb}  
이 예시에서는 지정된 syst_id로 카탈로그 클래스의 인스턴스를 만드는 방법을 보여줍니다.

    new sn_sc.Catalog(catalog_sys_id);
    var catalog = new sn_sc.Catalog("31bea3d53790200044e0bfc8bcbe5dec");

## CatalogJS - canView(부울 모바일, 문자열 userId) {#ariaid-title4}

사용자가 모바일 장치 또는 데스크톱에서 현재 범주를 볼 수 있는지 여부를 결정합니다.
{#CJS-canView_B__table_mnl_2lz_sbb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 모바일 | 부울 | 사용자가 모바일 뷰 또는 데스크톱 뷰에서 현재 카탈로그를 볼 수 있는지 여부를 확인할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 모바일 뷰 * false: 데스크톱 뷰 {#CJS-canView_B__ul_qfp_cb4_kpb} |
| userID | 문자열 | 옵션입니다. 카탈로그를 볼 수 있는지 확인할 사용자의 Sys_id입니다. 기본값: 현재 사용자 |
[표 3. 매개변수]

{#CJS-canView_B__table_mnl_2lz_sbb} {#CJS-canView_B__table_nnl_2lz_sbb__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 사용자가 카탈로그를 볼 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 사용자가 카탈로그를 볼 수 있습니다. * false: 사용자가 카탈로그를 볼 수 없습니다. {#CJS-canView_B__ul_wbn_mb4_kpb} |
[표 4. 반환]

{#CJS-canView_B__table_nnl_2lz_sbb}  
예제:

    var catalog = new sn_sc.Catalog("e0d08b13c3330100c8b837659bba8fb4");
    gs.info(catalog.canView(true));

출력:

    true

## CatalogJS - getAvailableCatalog() {#ariaid-title5}

사용 가능한 활성 카탈로그를 반환합니다.
활성 카탈로그가 하나만 있는 경우 메서드는 해당 카탈로그를 반환합니다. 그렇지 않으면 사용자가 볼 수 있는 카탈로그 목록에서 만든 가장 빠른 카탈로그를 반환합니다. 사용할 수 있는 카탈로그가 없으면 메서드는 null을 반환합니다.
{#CJS-getAvailableCatalog__table_m31_rmz_sbb__entry__3}

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

{#CJS-getAvailableCatalog__table_m31_rmz_sbb} {#CJS-getAvailableCatalog__table_n31_rmz_sbb__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 사용자가 볼 수 있는 가장 빠른 카탈로그를 가리키는 객체이거나 사용할 수 있는 카탈로그가 없으면 null입니다. |
[표 6. 반환]

{#CJS-getAvailableCatalog__table_n31_rmz_sbb}  
이 예시에서는 현재 사용자가 사용할 수 있는 카탈로그를 반환합니다.

    var catalog = sn_sc.Catalog.getAvailableCatalog()

## CatalogJS - getBackgroundColor() {#ariaid-title6}

카탈로그 배경색을 반환합니다.
{#CJS-getBackgroundColor__table_etj_mrz_sbb__entry__3}

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

{#CJS-getBackgroundColor__table_etj_mrz_sbb} {#CJS-getBackgroundColor__table_ftj_mrz_sbb__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 카탈로그의 배경색입니다. |
[표 8. 반환]

{#CJS-getBackgroundColor__table_ftj_mrz_sbb}  
이 예에서는 연결된 카탈로그의 배경색을 반환합니다.

    var catalog = new sn_sc.Catalog("0f910a2ac3112200b12d9f2974d3ae3c");
    gs.info("Catalog background: " + catalog.getBackgroundColor());

출력:

    Catalog background: white

## CatalogJS - getCatalogCount() {#ariaid-title7}

카탈로그 테이블에서 활성 상태인 카탈로그 수를 반환합니다.
{#CJS-getCatalogCount__table_ez1_znz_sbb__entry__3}

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

{#CJS-getCatalogCount__table_ez1_znz_sbb} {#CJS-getCatalogCount__table_fz1_znz_sbb__entry__2}

| 유형 | 설명 |
|-|-|
| 정수 | 카탈로그 테이블에서 사용할 수 있는 카탈로그 수입니다. |
[표 10. 반환]

{#CJS-getCatalogCount__table_fz1_znz_sbb}  
예제:

    console.log(sn_sc.Catalog.getCatalogCount());

출력:

    3

## CatalogJS - getCategories() {#ariaid-title8}

현재 카탈로그의 범주를 반환합니다.
{#CJS-getCategories__table_nwt_l4z_sbb__entry__3}

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

{#CJS-getCategories__table_nwt_l4z_sbb} {#CJS-getCategories__table_owt_l4z_sbb__entry__2}

| 유형 | 설명 |
|-|-|
| 배열 목록 | 현재 카탈로그의 범주를 반환합니다. |
[표 12. 반환]

{#CJS-getCategories__table_owt_l4z_sbb}  
이 예시에서는 현재 카탈로그 객체에서 사용할 수 있는 범주를 반환합니다.

    var catalog=new sn_sc.Catalog("e0d08b13c3330100c8b837659bba8fb4");
    console.log(catalog.getCategories());

출력:

    0 : {header_image: "", sys_id: "e15706fc0a0a0aa7007fc21e1ab70c2f", description: "Your IT gateway. Report issues and submit requests.", title: "Can We Help You?"} 
    1 : {header_image: "", sys_id: "95fc11615f1211001c9b2572f2b477c6", description: "Services offered by different departments in the organization", title: "Departmental Services"} 
    2 : {header_image: "", sys_id: "900682363731300054b6a3549dbe5d5f", description: "Desktop computers for your work area.", title: "Desktops"} 
    3 : {header_image: "", sys_id: "d2f716fcc611227a015a142fa0b262c1", description: "Order new furniture, and fixtures, or request for cubicle modifications can also be ordered here.", title: "Furniture and Decor"} 
    4 : {header_image: "", sys_id: "d258b953c611227a0146101fb1be7c31", description: "Order from a variety of hardware to meet your business needs, including phones, tablets and laptops.", title: "Hardware"} 

## CatalogJS - getCategoryIds() {#ariaid-title9}

현재 카탈로그의 범주 sys_ids 지정합니다.
{#CJS-getCategoryIds__table_ivv_3pz_sbb__entry__3}

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

{#CJS-getCategoryIds__table_ivv_3pz_sbb} {#CJS-getCategoryIds__table_jvv_3pz_sbb__entry__2}

| 유형 | 설명 |
|-|-|
| 배열 목록 | 현재 카탈로그의 범주 sys_ids 반환합니다. |
[표 14. 반환]

{#CJS-getCategoryIds__table_jvv_3pz_sbb}  
이 예에서는 현재 카탈로그에서 사용할 수 있는 범주의 sys_ids 반환합니다.

    var catalog=new sn_sc.Catalog("e0d08b13c3330100c8b837659bba8fb4");
    console.log(catalog.getCategoryIds());

출력:

    0:"e15706fc0a0a0aa7007fc21e1ab70c2f"
    1 : "95fc11615f1211001c9b2572f2b477c6"
    2 : "900682363731300054b6a3549dbe5d5f"
    3 : "d2f716fcc611227a015a142fa0b262c1"

## CatalogJS - getDescription() {#ariaid-title10}

현재 카탈로그에 대한 설명을 반환합니다.
{#CJS-getDescription__table_g5q_3qz_sbb__entry__3}

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

{#CJS-getDescription__table_g5q_3qz_sbb} {#CJS-getDescription__table_h5q_3qz_sbb__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 카탈로그 설명입니다. |
[표 16. 반환]

{#CJS-getDescription__table_h5q_3qz_sbb}  
이 예시에서는 현재 카탈로그의 이름을 반환합니다.

    var catalog=new sn_sc.Catalog("e0d08b13c3330100c8b837659bba8fb4");
    console.log(catalog.getDescription());

출력:

    Service Catalog - IT Now

## CatalogJS - getDesktopImageSRC() {#ariaid-title11}

카탈로그 데스크톱 이미지 파일 이름을 반환합니다.
{#CJS-getDesktopImageSRC__table_zdf_csz_sbb__entry__3}

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

{#CJS-getDesktopImageSRC__table_zdf_csz_sbb} {#CJS-getDesktopImageSRC__table_a2f_csz_sbb__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 카탈로그 데스크톱 이미지 파일 이름입니다. |
[표 18. 반환]

{#CJS-getDesktopImageSRC__table_a2f_csz_sbb}  
이 예에서는 현재 카탈로그 데스크톱 이미지 파일 이름을 반환합니다.

    var catalog=new sn_sc.Catalog("e0d08b13c3330100c8b837659bba8fb4");
    console.log(catalog.getDesktopImageSRC());

출력:

    adbcc271475211002ee987e8dee49001.iix

## CatalogJS - getGr() {#ariaid-title12}

현재 카탈로그의 GlideRecord를 반환합니다.
{#CJS-getGr__table_vdd_rqz_sbb__entry__3}

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

{#CJS-getGr__table_vdd_rqz_sbb} {#CJS-getGr__table_wdd_rqz_sbb__entry__2}

| 유형 | 설명 |
|-|-|
| GlideRecord | 현재 카탈로그의 GlideRecord입니다. |
[표 20. 반환]

{#CJS-getGr__table_wdd_rqz_sbb}  
이 예에서는 지정된 카탈로그에 대한 GlideRecord를 반환합니다.

    var catalog = new sn_sc.Catalog("e0d08b13c3330100c8b837659bba8fb4");
    data.history = catalog.getGr();

## CatalogJS - getHeaderIconSRC() {#ariaid-title13}

현재 카탈로그의 헤더 아이콘을 반환합니다.
{#CJS-getHeaderIconSRC__table_xsg_5rz_sbb__entry__3}

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

{#CJS-getHeaderIconSRC__table_xsg_5rz_sbb} {#CJS-getHeaderIconSRC__table_ysg_5rz_sbb__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 카탈로그 헤더 아이콘. |
[표 22. 반환]

{#CJS-getHeaderIconSRC__table_ysg_5rz_sbb}  
이 예시에서는 카탈로그 헤더 아이콘의 이름을 가져오는 방법을 보여줍니다.

    var catalog=new sn_sc.Catalog("e0d08b13c3330100c8b837659bba8fb4");
    gs.info(catalog.getHeaderIconSRC());

출력:

    service_catalog_header.png

## CatalogJS - getID() {#ariaid-title14}

현재 카탈로그의 sys_id 반환합니다.
{#CJS-getID__table_xqx_xpz_sbb__entry__3}

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

{#CJS-getID__table_xqx_xpz_sbb} {#CJS-getID__table_yqx_xpz_sbb__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 현재 카탈로그의 Sys_id입니다. |
[표 24. 반환]

{#CJS-getID__table_yqx_xpz_sbb}  
이 예시에서는 현재 카탈로그의 sys_id 반환합니다.

    var catalog=new sn_sc.Catalog("e0d08b13c3330100c8b837659bba8fb4");
    console.log(catalog.getId());

출력:

    e0d08b13c3330100c8b837659bba8fb4

## CatalogJS - getTitle() {#ariaid-title15}

현재 카탈로그의 제목을 반환합니다.
{#CJS-getTitle__table_fxp_mxz_sbb__entry__3}

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

{#CJS-getTitle__table_fxp_mxz_sbb} {#CJS-getTitle__table_gxp_mxz_sbb__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 현재 카탈로그의 제목입니다. |
[표 26. 반환]

{#CJS-getTitle__table_gxp_mxz_sbb}  
이 예에서는 현재 카탈로그의 제목을 반환합니다.

    var catalog=new sn_sc.Catalog("e0d08b13c3330100c8b837659bba8fb4");
    gs.info(catalog.getTitle());

출력:

    Service Catalog

## CatalogJS - hasCategories() {#ariaid-title16}

현재 카탈로그에 범주가 있는지 여부를 지정합니다.
{#CJS-hasCategories__table_kwh_lsz_sbb__entry__3}

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

{#CJS-hasCategories__table_kwh_lsz_sbb} {#CJS-hasCategories__table_lwh_lsz_sbb__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 현재 카탈로그에 범주가 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 카탈로그에 범주가 있습니다. * false: 카탈로그에 범주가 없습니다. {#CJS-hasCategories__ul_l1q_qn4_kpb} |
[표 28. 반환]

{#CJS-hasCategories__table_lwh_lsz_sbb}  
이 예시에서는 현재 카탈로그에 범주가 포함되어 있는지 확인하는 방법을 보여줍니다.

    var catalog=new sn_sc.Catalog("e0d08b13c3330100c8b837659bba8fb4");
    gs.info(catalog.hasCategories());

출력:

    false

## CatalogJS - hasItems() {#ariaid-title17}

현재 카탈로그에 카탈로그 항목이 있는지 여부를 지정합니다.
{#CJS-hasItems__table_abg_5wz_sbb__entry__3}

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

{#CJS-hasItems__table_abg_5wz_sbb} {#CJS-hasItems__table_bbg_5wz_sbb__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 현재 카탈로그에 카탈로그 항목이 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 카탈로그에 카탈로그 항목이 있습니다. * false: 카탈로그에 카탈로그 항목이 없습니다. {#CJS-hasItems__ul_l1q_qn4_kpb} |
[표 30. 반환]

{#CJS-hasItems__table_bbg_5wz_sbb}  
예제:

    var catalog=new sn_sc.Catalog("e0d08b13c3330100c8b837659bba8fb4");
    gs.info(catalog.hasItems());

출력:

    true

## CatalogJS - isWishlistEnabled() {#ariaid-title18}

현재 카탈로그에 희망 목록을 사용할 수 있는지 여부를 지정합니다.
{#CJS-isWishlistEnabled__table_emb_xk2_sbb__entry__3}

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

{#CJS-isWishlistEnabled__table_emb_xk2_sbb} {#CJS-isWishlistEnabled__table_fmb_xk2_sbb__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 현재 카탈로그가 희망 목록을 지원하는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 카탈로그가 희망 목록을 지원합니다. * false: 카탈로그에서 희망 목록을 지원하지 않습니다. {#CJS-isWishlistEnabled__ul_l1q_qn4_kpb} |
[표 32. 반환]

{#CJS-isWishlistEnabled__table_fmb_xk2_sbb}  
이 예시는 현재 카탈로그에 희망 목록을 사용할 수 있는지 확인하는 방법을 보여줍니다.

    var catalog = new sn_sc.Catalog("e0d08b13c3330100c8b837659bba8fb4");
    gs.info(catalog.isWishlistEnabled());

출력:

    true