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


---

# CatalogItemVariableSetM2M - 범위 지정됨

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

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

CatalogItemVariableSetM2M API에는 스크립트를 사용하여 M2M(서비스 카탈로그 항목 변수 세트)을 만들고 수정할 수 있는 메서드가 있습니다.

이 API는 `sn_sc` 네임스페이스에서 실행됩니다.

## CatalogItemVariableSetM2M - create(부울 standardUpdate) {#ariaid-title2}

정의된 카탈로그 항목 변수 세트 M2M을 삽입합니다.
{#r_CatalogItemVariableSetM2M-create_Boolean__table_rrn_wwd_ns__entry__3}

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

{#r_CatalogItemVariableSetM2M-create_Boolean__table_rrn_wwd_ns} {#r_CatalogItemVariableSetM2M-create_Boolean__table_srn_wwd_ns__entry__2}

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

{#r_CatalogItemVariableSetM2M-create_Boolean__table_srn_wwd_ns}  
이 예에서는 표준 직원 질문 변수 세트를 iPhone 6s 카탈로그 항목에 추가하고 카탈로그 변수 세트 테이블 \[io_set_item\]에 이를 연결하는 기록을 생성합니다.

    var cat_item_sys_id = 'bd6fa75a4f334200086eeed18110c79e'; // catalog item - iPhone 6s
    var variable_set_sys_id = 'e01cab1a4f334200086eeed18110c71f'; // variable set - Standard Employee Questions
    var app_scope = 'global'; // sys_id id in case of scoped app
    var varset = new sn_sc.CatalogItemVariableSetM2M();
    var attr = {
        'variable_set': variable_set_sys_id, // required
        'sc_cat_item': cat_item_sys_id, // required
        'sys_scope': app_scope, // optional
        'order': 10 // optional
    };
    varset.setAttributes(attr);
    var m2mRec = varset.create(true);
    gs.info('Variable set added to catalog item and M2M record created in table io_set_item with sys_id ' + m2mRec);

출력:

    Variable set added to catalog item and M2M record created in table io_set_item with sys_id c5c87af187eb30103a730f2d0ebb3578

## CatalogItemVariableSetM2M - deleteRecord(부울 standardUpdate) {#ariaid-title3}

정의된 카탈로그 항목 변수 세트 M2M을 삭제합니다.
{#r_CatalogItemVariableSetM2M-deleteRecord_Boolean__table_v2c_1xd_ns__entry__3}

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

{#r_CatalogItemVariableSetM2M-deleteRecord_Boolean__table_v2c_1xd_ns} {#r_CatalogItemVariableSetM2M-deleteRecord_Boolean__table_w2c_1xd_ns__entry__2}

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

{#r_CatalogItemVariableSetM2M-deleteRecord_Boolean__table_w2c_1xd_ns}  
이 예에서는 iPhone 6s 카탈로그 항목에서 표준 직원 질문 변수 세트를 제거하고 카탈로그 변수 세트 테이블 \[io_set_item\]에서 이를 연결하는 기록을 삭제합니다.

    var vset = new GlideRecord('io_set_item');
    vset.addQuery('sc_cat_item', 'bd6fa75a4f334200086eeed18110c79e'); // catalog item - iPhone 6s
    vset.addQuery('variable_set', 'e01cab1a4f334200086eeed18110c71f'); // variable set - Standard Employee Questions
    vset.query();
    if (vset.next()) {
        var varset = new sn_sc.CatalogItemVariableSetM2M(vset.getUniqueValue()); // pass sys_id of io_set_item record
        varset.deleteRecord(true);  
    }

## CatalogItemVariableSetM2M - read(객체 열, 부울 standardUpdate) {#ariaid-title4}

카탈로그 항목 변수 세트 M2M 속성 값의 매핑을 반환합니다.
{#r_CatalogItemVariableSetM2M-read_Object_Boolean__table_uxc_fxd_ns__entry__3}

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

{#r_CatalogItemVariableSetM2M-read_Object_Boolean__table_uxc_fxd_ns} {#r_CatalogItemVariableSetM2M-read_Object_Boolean__table_vxc_fxd_ns__entry__2}

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

{#r_CatalogItemVariableSetM2M-read_Object_Boolean__table_vxc_fxd_ns}  
이 예시에서는 iPhone 6s 카탈로그 항목에 사용되는 모든 변수 세트를 읽습니다.

    var vset = new GlideRecord('io_set_item');
    vset.addQuery('sc_cat_item', 'bd6fa75a4f334200086eeed18110c79e'); // catalog item - iPhone 6s
    vset.query();
    while (vset.next()) {
        var varset = new sn_sc.CatalogItemVariableSetM2M(vset.getUniqueValue()); // pass sys_id of io_set_item record
        //add the fields you want to read from the record
        var attr = {
            'sys_name': '', // optional
            'sys_scope': '', // optional
            'order': '' // optional
        };
        var m2mRec = varset.read(attr, true);
        gs.info(JSON.stringify(m2mRec));
    }

출력:

    {"sys_name":"HTML Description.iPhone 6s","sys_scope":"global","order":"10"}
    {"sys_name":"Standard Employee Questions.iPhone 6s","sys_scope":"global","order":"20"}

## CatalogItemVariableSetM2M - setAttributes(객체 속성) {#ariaid-title5}

이 카탈로그 항목 변수 세트 M2M에 대한 속성 값을 정의합니다.
{#r_CatalogItemVariableSetM2M-setAttributes_Map__table_tyz_qxd_ns__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 속성 | 객체 | 열 이름을 값에 매핑하는 객체입니다. |
[표 7. 매개변수]

{#r_CatalogItemVariableSetM2M-setAttributes_Map__table_tyz_qxd_ns} {#r_CatalogItemVariableSetM2M-setAttributes_Map__table_uyz_qxd_ns__entry__2}

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

{#r_CatalogItemVariableSetM2M-setAttributes_Map__table_uyz_qxd_ns}  
이 예에서는 표준 직원 질문 변수 세트를 iPhone 6s 카탈로그 항목에 추가하고 카탈로그 변수 세트 테이블 \[io_set_item\]에 레코드를 만듭니다.

    var cat_item_sys_id = 'bd6fa75a4f334200086eeed18110c79e'; // catalog item - iPhone 6s
    var variable_set_sys_id = 'e01cab1a4f334200086eeed18110c71f'; // variable set - Standard Employee Questions
    var app_scope = 'global'; // sys_id id in case of scoped app
    var varset = new sn_sc.CatalogItemVariableSetM2M();
    var attr = {
        'variable_set': variable_set_sys_id,
        'sc_cat_item': cat_item_sys_id,
        'sys_scope': app_scope,
        'order': 10
    };
    varset.setAttributes(attr);
    var m2mRec = varset.create(true);
    gs.info('Variable set added to catalog item and M2M record created in table io_set_item with sys_id ' + m2mRec);

출력:

    Variable set added to catalog item and M2M record created in table io_set_item with sys_id c5c87af187eb30103a730f2d0ebb3578

## CatalogItemVariableSetM2M - update(객체 columnValues, 부울 standardUpdate) {#ariaid-title6}

현재 카탈로그 항목 변수 세트 M2M을 세트 값으로 업데이트합니다.
{#r_CatalogItemVariableSetM2M-update_Object_Boolean__table_dj1_cyd_ns__entry__3}

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

{#r_CatalogItemVariableSetM2M-update_Object_Boolean__table_dj1_cyd_ns} {#r_CatalogItemVariableSetM2M-update_Object_Boolean__table_ej1_cyd_ns__entry__2}

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

{#r_CatalogItemVariableSetM2M-update_Object_Boolean__table_ej1_cyd_ns}  
이 예에서는 iPhone 6s 카탈로그 항목에 대한 표준 직원 질문 변수 세트의 순서를 업데이트합니다.

    var vset = new GlideRecord('io_set_item');
    vset.addQuery('sc_cat_item', 'bd6fa75a4f334200086eeed18110c79e'); // catalog item - iPhone 6s
    vset.addQuery('variable_set', 'e01cab1a4f334200086eeed18110c71f'); // variable set - Standard Employee Questions
    vset.query();
    if (vset.next()) {
        var varset = new sn_sc.CatalogItemVariableSetM2M(vset.getUniqueValue()); // pass sys_id of io_set_item record
        var attr = {
            'order': '30' // update order to 30
        };
        varset.update(attr, true);
        var readAttr = {
            'sys_name': '',
            'order': '' 
        };
        var m2mRec = varset.read(readAttr, true); // read the record to confirm the update 
        gs.info(JSON.stringify(m2mRec));
    }

출력:

    {"sys_name":"Standard Employee Questions.iPhone 6s","order":"30"}