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

클라이언트측 스크립트는 폼에 동적 효과와 유효성 검사를 추가할 수 있습니다. 스크립트는 서비스 카탈로그 항목이나 변수 세트에 적용하여 관리자가 다른 양식에서 사용 가능한 것과 동일한 기능을 사용할 수 있도록 합니다.

클라이언트 측 스크립트를 사용하여 다음을 수행할 수 있습니다.

* 변수 값을 가져오거나 설정합니다.
* 변수를 숨기거나 표시합니다.
* 변수를 필수로 설정할지 여부를 결정합니다.
* 양식 제출을 확인합니다.
* 카트에 항목을 추가합니다.
* 즉시 주문하십시오.
{#c_CatalogClientScriptCreation__ul_fs2_2c1_dq}

## 카탈로그 클라이언트 스크립트 고려 사항 {#ariaid-title2}

카탈로그 클라이언트 스크립트를 만들 때는 다음 사항을 고려해야 합니다.
* 카탈로그 클라이언트 스크립트는 사용자가 서비스 카탈로그에서 항목을 주문할 때 실행됩니다. 카탈로그 클라이언트 스크립트는 사용자가 해당 항목을 요청할 때 카탈로그 항목에 대한 변수 또는 변수 세트가 표시될 때도 실행할 수 있습니다.
* 카탈로그 클라이언트 스크립트를 사용하여 변수에 액세스할 수 있으려면 변수 이름이 있어야 합니다. 이름이 없는 변수는 사용 가능한 변수 목록에 나타나지 않습니다.
* 요청된 항목 또는 카탈로그 작업 양식에서 표준 클라이언트 스크립트를 사용하는 경우 변수와 이름이 같은 필드를 적어둡니다. 테이블 필드와 같은 이름의 변수가 모두 양식에 있는 경우 스크립트를 사용하여 액세스할 때 테이블 필드가 일치합니다. 이 경우 변수의 이름을 `variables.variable name`으로 지정하여 구체적으로 해결하십시오. 예: `g_form.setValue('variables.replacement', 'false');`
* 기록 생성자를 사용하여 서비스 카탈로그에서 다른 유형의 기록으로 변수를 전달하는 경우, 이러한 변수는 변경 요청 양식의 변경 변수 편집기 UI 포매터와 같은 변수 편집기를 통해 해당 기록에 표시됩니다. `setDisplay`, `setMandatory`, `setValue` 및 `getValue`와 같은 표준 클라이언트 스크립트 메서드를 사용하여 이러한 변수를 조작할 수 있습니다.
* 카탈로그 클라이언트 스크립트는 마법사에 포함된 카탈로그 항목에 사용할 수 있습니다.
* `g_form.refreshSlushbucket(fieldName)` API를 사용하여 목록 수집기 변수를 업데이트할 수 있습니다.

## 카탈로그 클라이언트 스크립트 차이점 {#ariaid-title3}

카탈로그 클라이언트 스크립트는 표준 클라이언트 스크립트와 매우 유사하지만 몇 가지 중요한 차이점이 있습니다.
* 스크립트에 대한 인시던트와 같은 테이블을 선택하는 대신, 카탈로그 항목이나 변수 세트를 선택합니다. 시스템에 카탈로그 항목 수가 많을 수 있으므로 표준 클라이언트 스크립트 양식에서 사용하는 선택 목록 대신 참조 필드를 사용하여 카탈로그 항목 또는 변수 세트를 선택해야 합니다.
* <var class="keyword varname">onChange()</var> 카탈로그 클라이언트 스크립트를 사용할 때는 필드 대신 특정 변수에 연결됩니다. 선택한 카탈로그 항목 또는 변수 세트에서 명명된 변수를 사용하여 변수 이름 선택 목록이 자동으로 채워집니다.
{#r_CatalogClientScriptDifferences__ul_dvh_llb_jbb}

## 카탈로그 클라이언트 스크립트 생성 {#ariaid-title4}

다음 절차에 따라 카탈로그 클라이언트 스크립트를 만드십시오.

### 프로시저

1. 다음으로 이동 모두서비스 카탈로그카탈로그 관리카탈로그 클라이언트 스크립트.  
   현재 사용자 지정 카탈로그 클라이언트 스크립트 목록이 나타납니다.
2. 새로 만들기를 클릭합니다.
3. 필드에 적절한 정보를 입력합니다(표 참조).  
   {#create-catalog-client-script__table_bw1_3g1_dq__entry__2}

   | 필드 | 설명 |
   |-|-|
   | 이름 | 카탈로그 클라이언트 스크립트의 고유한 이름을 입력합니다. |
   | 적용 대상 | 이 클라이언트 스크립트가 적용되는 항목 유형을 선택합니다. * 카탈로그 항목: 카탈로그 항목 필드를 활성화합니다. * 변수 세트: 변수 세트 필드를 활성화합니다. {#create-catalog-client-script__ul_nx1_3g1_dq} |
   | 활성 | 클라이언트 스크립트를 사용하려면 확인란을 선택합니다. 스크립트를 사용 중지하려면 확인란 선택을 취소합니다. |
   | UI 유형 | 이를 데스크톱, 모바일 또는 둘 다에 적용할지 여부입니다. |
   | 스크립트 | 서비스 카탈로그 항목에서 실행할 클라이언트 스크립트를 입력합니다. |
   | 유형 | 스크립트를 실행할 시기( onLoad 또는 onSubmit)를 선택합니다. |
   | 카탈로그 항목 또는 변수 세트 | 목록에서 카탈로그 항목 또는 변수 세트를 선택합니다. 사용 가능한 필드 이름과 옵션은 적용 대상 필드의 선택 항목에 따라 달라집니다. |
   | 카탈로그 항목 뷰에 적용 | 서비스 카탈로그의 주문 화면 내에 표시된 카탈로그 항목에 카탈로그 클라이언트 스크립트를 적용하려면 확인란을 선택합니다. 요청자 뷰에서 사용할 수 있습니다. |
   | 요청 항목에 적용 | 항목이 요청된 후 요청된 항목 양식에 카탈로그 클라이언트 스크립트를 적용하려면 이 확인란을 선택합니다. 이행자 뷰에서 사용할 수 있습니다. [VEditor](https://www.servicenow.com/docs/access?context=service-catalog-variable-editor&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US) 를 참조하십시오. |
   | 카탈로그 작업에 적용 | 항목에 대한 카탈로그 작업 양식이 표시될 때 카탈로그 클라이언트 스크립트를 적용하려면 확인란을 선택합니다. 이행자 뷰에서 사용할 수 있습니다. [VEditor](https://www.servicenow.com/docs/access?context=service-catalog-variable-editor&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US) 를 참조하십시오. |
   | 대상 기록에 적용 | 기록 생성자를 통해 작업 확장 테이블에 대해 생성된 기록에서 카탈로그 UI 정책을 지원하려면 이 확인란을 선택합니다. [기본 변수 편집기](https://www.servicenow.com/docs/access?context=service-catalog-variable-editor&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US) 를 참조하십시오 . |
   [ ]

   {#create-catalog-client-script__table_bw1_3g1_dq}
4. 제출을 클릭합니다.

## 카탈로그 클라이언트 스크립트 예시 {#ariaid-title5}

일반적인 작업을 수행하는 클라이언트 스크립트의 예입니다.  

### 변수 값 가져오기

다음 구문을 사용하여 카탈로그 변수의 값을 가져옵니다. 변수에는 이름이 있어야 합니다. `variable_name` 변수 이름으로 바꿉니다.

    g_form.getValue('variable_name');

### 사용자가 변수에 입력할 수 있는 문자 수 제한

항목이 주문될 때가 아니라 변수가 표시될 때 실행되는 스크립트의 예입니다.

    function onLoad(){
      var sd = g_form.getControl('short_description');
      sd.maxLength=80;
    }