---
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) 소요 시간: 8분

CatCategory API에는 스크립트를 사용하여 서비스 카탈로그 범주를 만들고 수정할 수 있는 메서드가 있습니다.

이 API는 `sn_sc` 네임스페이스에서 실행됩니다.  
중요사항:  
이 API에 접근할 수 있습니다. 그러나 권장되는 구현은 [서비스 카탈로그 REST API](https://servicenow-prod.fluidtopics.net/FtyzAJr7h~hmdkMji1GUZQ#c_ServiceCatalogAPI "서비스 카탈로그 API는 내에서 서비스 포털구성 및 작업에 액세스 서비스 카탈로그 하는 엔드포인트를 제공합니다.")입니다.

## CatCategory - availableForUserCriteria(문자열 작업, 배열 criteriaIDs) {#ariaid-title2}

현재 카탈로그 범주에 사용자 기준을 추가합니다 Available For .
{#r_CCS-availableForUserCriteria_S_A__table_oz2_pln_vz__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 작업 | 문자열 | 수행할 작업입니다. * <kbd class="ph userinput">추가</kbd>: 사용 가능 목록에 사용자 기준을 추가합니다. * <kbd class="ph userinput">삭제</kbd>: 사용 가능 목록에서 사용자 기준을 삭제합니다. {#r_CCS-availableForUserCriteria_S_A__ul_gc4_bs4_kpb} |
| 기준 ID | 배열 | 사용자 기준 sys_ids의 배열입니다. |
[표 1. 매개변수]

{#r_CCS-availableForUserCriteria_S_A__table_oz2_pln_vz} {#r_CCS-availableForUserCriteria_S_A__table_pz2_pln_vz__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 2. 반환]

{#r_CCS-availableForUserCriteria_S_A__table_pz2_pln_vz}  

    var item = new sn_sc.CatCategory("31bea3d53790200044e0bfc8bcbe5dec");
    item.availableForUserCriteria("add", ["0c441abbc6112275000025157c651c89"]);

## CatCategory - canView(부울 isMobile, 문자열 userSysId) {#ariaid-title3}

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

| 이름 | 유형 | 설명 |
|-|-|-|
| isMobile | 부울 | 모바일 장치 또는 데스크톱에서 사용자의 액세스를 확인할지 여부를 나타내는 플래그입니다. * true: 모바일용으로 확인합니다. * false: 데스크톱에 대해 확인합니다. |
| userSysId | 문자열 | 확인할 사용자의 Sys_id입니다. |
[표 3. 매개변수]

{#CCS-canView_B_S__table_j5n_smk_chb} {#CCS-canView_B_S__table_k5n_smk_chb__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 사용자가 연결된 범주를 볼 수 있는지 여부를 나타내는 플래그입니다. * true: 사용자가 범주를 볼 수 있습니다. * 아니오: 사용자가 범주를 볼 수 없습니다. {#CCS-canView_B_S__ul_iwk_ynk_chb} |
[표 4. 반환]

{#CCS-canView_B_S__table_k5n_smk_chb}  

    var scopedCategoryObj = new sn_sc.CatCategory('7b1262b9530033007444ddeeff7b12ae');
    scopedCategoryObj.canView(false, '62826bf03710200044e0bfc8bcbe5df1');

## CatCategory - create(부울 standardUpdate) {#ariaid-title4}

정의된 범주를 삽입합니다.
{#r_CatCategory-create_Boolean__table_afn_1b2_ns__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 표준 업데이트 | 부울 | 엔진과 워크플로우의 실행을 활성화할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 엔진과 워크플로우를 활성화합니다. * false: 엔진과 워크플로우를 활성화하지 않습니다. {#r_CatCategory-create_Boolean__ul_nnx_xwn_kpb} |
[표 5. 매개변수]

{#r_CatCategory-create_Boolean__table_afn_1b2_ns} {#r_CatCategory-create_Boolean__table_bfn_1b2_ns__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 삽입된 변수 기록의 Sys_id입니다. |
[표 6. 반환]

{#r_CatCategory-create_Boolean__table_bfn_1b2_ns}  

    var categoryCreate = new sn_sc.CatCategory();
    categoryCreate.setAttributes({"title" : "test a scoped category", "sc_catalog" : "e0d08b13c3330100c8b837659bba8fb4"});
    var categorySysId = categoryCreate.create();
    var isValidSysId = categorySysId.match(/^[0-9a-fA-F]{32}$/) == null ? false : true;
    global.Assert.assertEquals(true, isValidSysId,"CategorySysId: ["+ categorySysId +"] is not valid", true, isValidSysId);

## CatCategory - deleteRecord(부울 standardUpdate) {#ariaid-title5}

CatCategory 클래스가 처음에 인스턴스화된 범주 기록을 삭제합니다.
{#r_CatCategory-deleteRecord_Boolean__table_xzp_4b2_ns__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 표준 업데이트 | 부울 | 엔진과 워크플로우의 실행을 활성화할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 엔진과 워크플로우를 활성화합니다. * false: 엔진과 워크플로우를 활성화하지 않습니다. {#r_CatCategory-deleteRecord_Boolean__ul_nnx_xwn_kpb} |
[표 7. 매개변수]

{#r_CatCategory-deleteRecord_Boolean__table_xzp_4b2_ns} {#r_CatCategory-deleteRecord_Boolean__table_yzp_4b2_ns__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 8. 반환]

{#r_CatCategory-deleteRecord_Boolean__table_yzp_4b2_ns}  

    var categoryDelete = new sn_sc.CatCategory(categorySysId);
    categoryDelete.deleteRecord();
    var category = new sn_sc.CatCategory(categorySysId);
    values = category.read({"title" : "", "sc_catalog":""}, false);
    global.Assert.assertEquals("", values.title,"Category should title");

## 범주 - getID() {#ariaid-title6}

현재 범주의 sys_id 반환합니다.
{#CCS-getID__table_db4_h4d_sbb__entry__3}

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

{#CCS-getID__table_db4_h4d_sbb} {#CCS-getID__table_eb4_h4d_sbb__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 현재 범주의 Sys_id입니다. |
[표 10. 반환]

{#CCS-getID__table_eb4_h4d_sbb}  
예제:

    var cart = new sn_sc.CatCategory("2809952237b1300054b6a3549dbe5dd4");
    var categoryID = cart.getID();
    gs.info(categoryID);

출력:

    2809952237b1300054b6a3549dbe5dd4

## CatCategory - notAvailableForUserCriteria(String 작업, Array\[\] criteriaIDs) {#ariaid-title7}

카탈로그 범주에 사용자 기준을 추가합니다 Not Available For .
{#r_CCS-notAvailableForUserCriteria_S_A__table_yxb_1mn_vz__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 작업 | 문자열 | 수행할 작업입니다. * <kbd class="ph userinput">추가</kbd>: 사용 불가 목록에 사용자 기준을 추가합니다. * <kbd class="ph userinput">삭제</kbd>: 사용 불가 목록에서 사용자 기준을 삭제합니다. {#r_CCS-notAvailableForUserCriteria_S_A__ul_gc4_bs4_kpb} |
[표 11. 매개변수]

{#r_CCS-notAvailableForUserCriteria_S_A__table_yxb_1mn_vz} {#r_CCS-notAvailableForUserCriteria_S_A__table_zxb_1mn_vz__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 12. 반환]

{#r_CCS-notAvailableForUserCriteria_S_A__table_zxb_1mn_vz}  

    var item = new sn_sc.CatCategory("31bea3d53790200044e0bfc8bcbe5dec");
    item. notAvailableForUserCriteria("add", ["0c441abbc6112275000025157c651c89"]);

## CatCategory - read(객체 열, 부울 standardUpdate) {#ariaid-title8}

범주의 매핑을 반환합니다.
{#r_CatCategory-read_Object_Boolean__table_p2h_5b2_ns__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 열 | 객체 | 값을 원하는 열 집합입니다. |
| 표준 업데이트 | 부울 | 엔진과 워크플로우의 실행을 활성화할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 엔진과 워크플로우를 활성화합니다. * false: 엔진과 워크플로우를 활성화하지 않습니다. {#r_CatCategory-read_Object_Boolean__ul_nnx_xwn_kpb} |
[표 13. 매개변수]

{#r_CatCategory-read_Object_Boolean__table_p2h_5b2_ns} {#r_CatCategory-read_Object_Boolean__table_q2h_5b2_ns__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 열 이름을 값에 매핑합니다. |
[표 14. 반환]

{#r_CatCategory-read_Object_Boolean__table_q2h_5b2_ns}  

    var category = new sn_sc.CatCategory("a96277509f300200b407b89a442e704e");
    var values = category.read({"title" : ""}, true);
    gs.log(values.title);

## 범주 - setAttributes(객체 속성) {#ariaid-title9}

이 범주의 속성 값을 정의합니다.
{#r_CatCategory-setAttributes_Object__table_psn_512_ns__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 속성 | 객체 | 새 필드와 값 쌍의 속성입니다. |
[표 15. 매개변수]

{#r_CatCategory-setAttributes_Object__table_psn_512_ns} {#r_CatCategory-setAttributes_Object__table_qsn_512_ns__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 16. 반환]

{#r_CatCategory-setAttributes_Object__table_qsn_512_ns}  

    var categoryCreate = new sn_sc.CatCategory();
    categoryCreate.setAttributes({"title" : "test a scoped category", "sc_catalog" : "e0d08b13c3330100c8b837659bba8fb4"});
    var categorySysId = categoryCreate.create();
    var isValidSysId = categorySysId.match(/^[0-9a-fA-F]{32}$/) == null ? false : true;
    global.Assert.assertEquals(true, isValidSysId,"CategorySysId: ["+ categorySysId +"] is not valid", true, isValidSysId);

## CatCategory - setTableName(문자열 tableName) {#ariaid-title10}

이 범주의 테이블 이름을 정의합니다.
{#r_CatCategory-setTableName_String__table_vh4_3dl_qs__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| tableName | 문자열 | sc_category 확장되는 테이블의 이름입니다. |
[표 17. 매개변수]

{#r_CatCategory-setTableName_String__table_vh4_3dl_qs} {#r_CatCategory-setTableName_String__table_wh4_3dl_qs__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 18. 반환]

{#r_CatCategory-setTableName_String__table_wh4_3dl_qs}  

    var categoryRead = new sn_sc.CatCategory(categorySysId);
    categoryRead.setTableName("test_category");
    var values = categoryRead.read({"title" : "", "sc_catalog":"", "test": ""}, false);
    gs.info(categorySysId);
    gs.info(values.title);
    gs.info(values.test);
    global.Assert.assertEquals("testValue", values.test,"Category extends sc_category and stores its extended value");

## CatCategory - update(객체 columnValues, 부울 standardUpdate) {#ariaid-title11}

지정된 이름-값 쌍으로 현재 범주를 업데이트합니다.
{#r_CatCategory-update_Object_Boolean__table_dfz_fb2_ns__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| columnValues | 객체 | 열 이름을 값에 매핑합니다. |
| 표준 업데이트 | 부울 | 엔진과 워크플로우의 실행을 활성화할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 엔진과 워크플로우를 활성화합니다. * false: 엔진과 워크플로우를 활성화하지 않습니다. {#r_CatCategory-update_Object_Boolean__ul_nnx_xwn_kpb} |
[표 19. 매개변수]

{#r_CatCategory-update_Object_Boolean__table_dfz_fb2_ns} {#r_CatCategory-update_Object_Boolean__table_efz_fb2_ns__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 20. 반환]

{#r_CatCategory-update_Object_Boolean__table_efz_fb2_ns}  

    var categoryUpdate = new sn_sc.CatCategory(categorySysId);
    categoryUpdate.update({"title" : "test changed scoped category"}, true);
    values = categoryUpdate.read({"title" : "", "sc_catalog":""}, false);
    global.Assert.assertEquals("test changed scoped category", values.title,"Category should title");