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


---

# CatalogClientScript - 범위 지정됨

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

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

CatalogClientScript API에는 카탈로그 클라이언트 스크립트 기록을 생성, 수정 또는 삭제할 수 있는 메서드가 있습니다.

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

## 카탈로그 클라이언트 스크립트 - 카탈로그 클라이언트 스크립트() {#ariaid-title2}

CatalogClientScript 클래스의 인스턴스를 만듭니다.
{#r_CCSS-CatalogClientScript__table_hlv_q2c_1z__entry__3}

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

{#r_CCSS-CatalogClientScript__table_hlv_q2c_1z}  

    var catalogClientScript = new sn_sc.CatalogClientScript();

## CatalogClientScript - addScript(문자열 스크립트) {#ariaid-title3}

카탈로그 클라이언트 스크립트에 스크립트를 추가합니다.
{#r_CCSS-addScript_S__table_m1v_1ds_sy__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 스크립트 | 문자열 | 카탈로그 클라이언트 스크립트에 추가할 스크립트입니다. |
[표 2. 매개변수]

{#r_CCSS-addScript_S__table_m1v_1ds_sy} {#r_CCSS-addScript_S__table_n1v_1ds_sy__entry__2}

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

{#r_CCSS-addScript_S__table_n1v_1ds_sy}  
이 예제에서는 이 메서드를 호출하는 방법을 보여줍니다.

    var catalogClientScript = new sn_sc.CatalogClientScript();
    catalogClientScript.addScript("function onLoad(){Enter the script}");

## CatalogClientScript - appliesToCatalogItem(부울 플래그) {#ariaid-title4}

카탈로그 클라이언트 스크립트가 카탈로그 항목에서 실행되는지 여부를 지정합니다.
{#r_CCSS-appliesToCatalogItem_B__table_zsm_rzr_sy__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 플래그 | 부울 | 예일 경우 카탈로그 클라이언트 스크립트가 카탈로그 항목에서 실행됩니다. 속성이 false인 경우 카탈로그 클라이언트 스크립트가 카탈로그 항목에서 실행되지 않습니다. |
[표 4. 매개변수]

{#r_CCSS-appliesToCatalogItem_B__table_zsm_rzr_sy} {#r_CCSS-appliesToCatalogItem_B__table_atm_rzr_sy__entry__2}

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

{#r_CCSS-appliesToCatalogItem_B__table_atm_rzr_sy}  

    var catalogClientScript = new sn_sc.CatalogClientScript();
    catalogClientScript.appliesToCatalogItem(true);

## CatalogClientScript - appliesToCatalogTask(부울 플래그) {#ariaid-title5}

카탈로그 클라이언트 스크립트가 카탈로그 작업에서 실행되는지 여부를 지정합니다.
{#r_CCSS-appliesToCatalogTask_B__table_tqp_n2s_sy__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 플래그 | 부울 | 예일 경우 카탈로그 클라이언트 스크립트가 카탈로그 작업에서 실행됩니다. 속성이 false인 경우 카탈로그 클라이언트 스크립트가 카탈로그 작업에서 실행되지 않습니다. |
[표 6. 매개변수]

{#r_CCSS-appliesToCatalogTask_B__table_tqp_n2s_sy} {#r_CCSS-appliesToCatalogTask_B__table_uqp_n2s_sy__entry__2}

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

{#r_CCSS-appliesToCatalogTask_B__table_uqp_n2s_sy}  
이 예제에서는 이 메서드를 호출하는 방법을 보여줍니다.

    var catalogClientScript = new sn_sc.CatalogClientScript();
    catalogClientScript.appliesToCatalogTask(true);

## CatalogClientScript - appliesToRequestedItem(부울 플래그) {#ariaid-title6}

카탈로그 클라이언트 스크립트가 요청된 항목에서 실행되는지 여부를 지정합니다.
{#r_CCSS-appliesToRequestedItem_B__table_rsq_p1s_sy__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 플래그 | 부울 | 예일 경우 카탈로그 클라이언트 스크립트가 요청된 항목에 대해 실행됩니다. 속성이 false인 경우 카탈로그 클라이언트 스크립트가 요청된 항목에 대해 실행되지 않습니다. |
[표 8. 매개변수]

{#r_CCSS-appliesToRequestedItem_B__table_rsq_p1s_sy} {#r_CCSS-appliesToRequestedItem_B__table_ssq_p1s_sy__entry__2}

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

{#r_CCSS-appliesToRequestedItem_B__table_ssq_p1s_sy}  
이 예제에서는 메서드를 호출하는 방법을 보여 줍니다.

    var catalogClientScript = new sn_sc.CatalogClientScript();
    catalogClientScript.appliesToRequestedItem(true);

## CatalogClientScript - appliesToTargetRecord(부울 플래그) {#ariaid-title7}

카탈로그 클라이언트 스크립트가 요청된 항목에서 실행되는지 여부를 지정합니다.
{#r_CCSS-appliesToTargetRecord_B__table_hwy_44l_5z__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 플래그 | 부울 | 예일 경우, 카탈로그 클라이언트 스크립트는 대상 기록에서 실행됩니다. 속성이 false인 경우 카탈로그 클라이언트 스크립트가 대상 기록에서 실행되지 않습니다. |
[표 10. 매개변수]

{#r_CCSS-appliesToTargetRecord_B__table_hwy_44l_5z} {#r_CCSS-appliesToTargetRecord_B__table_iwy_44l_5z__entry__2}

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

{#r_CCSS-appliesToTargetRecord_B__table_iwy_44l_5z}  
이 예제에서는 메서드를 호출하는 방법을 보여 줍니다.

    var catalogClientScript = new sn_sc.CatalogClientScript();
    catalogClientScript.appliesToTargetRecord(true);

## CatalogClientScript - create(부울 standardUpdate) {#ariaid-title8}

정의된 카탈로그 클라이언트 스크립트를 catalog_script_client 테이블에 삽입합니다.
{#r_CCSS-create_B__table_kj1_xbs_kx__entry__3}

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

{#r_CCSS-create_B__table_kj1_xbs_kx} {#r_CCSS-create_B__table_lj1_xbs_kx__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 카탈로그 클라이언트 스크립트의 Sys_id입니다. |
[표 13. 반환]

{#r_CCSS-create_B__table_lj1_xbs_kx}  
이 예제에서는 메서드를 호출하는 방법을 보여 줍니다.

    var catalogClientScript = new sn_sc.CatalogClientScript();
    catalogClientScript.setAttributes({"name": "My Catalog Item", "applies_to": "item", "ui_type": "desktop", "type": "onLoad"});
    catalogClientScript.appliesToCatalogItem(true);
    catalogClientScript.appliesToRequestedItem(true);
    catalogClientScript.appliesToCatalogTask(true);
    catalogClientScript.appliesToTargetRecord(true);
    var catalogClientScriptId = catalogClientScript.create();
    gs.info(catalogClientScriptId);

출력:

    039c516237b1300054b6a3549dbe5dfc

## CatalogClientScript - deleteRecord(문자열 sys_id, 부울 standardUpdate) {#ariaid-title9}

정의된 카탈로그 클라이언트 스크립트를 삭제합니다.
{#r_CCSS-deleteRecord_S_B__table_jdv_hsz_qy__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| sys_id | 문자열 | 카탈로그 클라이언트 스크립트의 Sys_id입니다. |
| 표준 업데이트 | 부울 | 엔진과 워크플로우의 실행을 활성화할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 엔진과 워크플로우를 활성화합니다. * false: 엔진과 워크플로우를 활성화하지 않습니다. {#r_CCSS-deleteRecord_S_B__ul_nnx_xwn_kpb} |
[표 14. 매개변수]

{#r_CCSS-deleteRecord_S_B__table_jdv_hsz_qy} {#r_CCSS-deleteRecord_S_B__table_kdv_hsz_qy__entry__2}

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

{#r_CCSS-deleteRecord_S_B__table_kdv_hsz_qy}  
다음 예시는 카탈로그 클라이언트 스크립트를 삭제하는 방법을 보여줍니다.

    var sys_id = "039c516237b1300054b6a3549dbe5dfc"; 
    var catalogClientScript = new sn_sc.CatalogClientScript();
    catalogClientScript.deleteRecord("039c516237b1300054b6a3549dbe5dfc");

## CatalogClientScript - setAttributes(맵 속성) {#ariaid-title10}

카탈로그 클라이언트 스크립트의 속성 값을 정의합니다.
{#r_CCSS-setAttributes_M__table_fyy_tyr_sy__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 속성 | 맵 | 필드와 값 쌍에 대한 매핑이 있는 JSON 객체입니다. |
[표 16. 매개변수]

{#r_CCSS-setAttributes_M__table_fyy_tyr_sy} {#r_CCSS-setAttributes_M__table_gyy_tyr_sy__entry__2}

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

{#r_CCSS-setAttributes_M__table_gyy_tyr_sy}  
이 예제에서는 메서드를 호출하는 방법을 보여 줍니다.

    var catalogClientScript = new sn_sc.CatalogClientScript();
    catalogClientScript.setAttributes({"name": "My Catalog Item", "applies_to": "catalog_item", "ui_type": "desktop", "type": "onLoad"});

## CatalogClientScript - setCatalogItem(문자열 sys_id) {#ariaid-title11}

카탈로그 항목을 카탈로그 클라이언트 스크립트와 연결합니다.
{#r_CCSS-setCatalogItem_S__table_v3g_zds_sy__entry__3}

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

{#r_CCSS-setCatalogItem_S__table_v3g_zds_sy} {#r_CCSS-setCatalogItem_S__table_w3g_zds_sy__entry__2}

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

{#r_CCSS-setCatalogItem_S__table_w3g_zds_sy}  
이 예시에서는 카탈로그 항목을 현재 카탈로그 클라이언트 스크립트와 연결하는 방법을 보여줍니다.

    var catalogClientScript = new sn_sc.CatalogClientScript();
    catalogClientScript.setCatalogItem("039c516237b1300054b6a3549dbe5dfc");

## CatalogClientScript - setOnChangeVariable(문자열 sys_id) {#ariaid-title12}

변수 값이 업데이트되면 카탈로그 클라이언트 스크립트를 실행합니다.
{#r_CCSS-setOnChangeVariable_S__table_m3r_3cs_sy__entry__3}

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

{#r_CCSS-setOnChangeVariable_S__table_m3r_3cs_sy} {#r_CCSS-setOnChangeVariable_S__table_n3r_3cs_sy__entry__2}

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

{#r_CCSS-setOnChangeVariable_S__table_n3r_3cs_sy}  
이 예제에서는 메서드를 호출하는 방법을 보여 줍니다.

    var catalogClientScript = new sn_sc.CatalogClientScript();
    catalogClientScript.setOnChangeVariable("039c516237b1300054b6a3549dbe5dfc");

## CatalogClientScript - setVariableSet(문자열 sys_id) {#ariaid-title13}

변수 세트를 카탈로그 클라이언트 스크립트와 연결합니다.
{#r_CCSS-setVariableSet_S__table_cvz_tbs_sy__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| sys_id | 문자열 | 변수 세트의 Sys_id입니다. |
[표 22. 매개변수]

{#r_CCSS-setVariableSet_S__table_cvz_tbs_sy} {#r_CCSS-setVariableSet_S__table_dvz_tbs_sy__entry__2}

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

{#r_CCSS-setVariableSet_S__table_dvz_tbs_sy}  
이 예제에서는 메서드를 호출하는 방법을 보여 줍니다.

    var catalogClientScript = new sn_sc.CatalogClientScript();
    catalogClientScript.setVariableSet("039c516237b1300054b6a3549dbe5dfc");