---
sourceDocument: Xanadu API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ko-KR

ft:publication_title :

    - Xanadu API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# 클라이언트 스크립트

# 클라이언트 스크립트 {#ariaid-title1}

* 릴리스 버전: Xanadu
* 
* 업데이트 날짜 2024년 08월 01일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 4분

클라이언트 스크립트를 사용하면 클라이언트 기반 이벤트가 발생한 경우(예: 양식이 로드된 경우, 양식 제출 후 또는 필드 값이 변경된 경우) 시스템이 클라이언트(웹 브라우저)에서 JavaScript를 실행할 수 있습니다.

사용자가 양식을 사용하는 동안 클라이언트 스크립트를 사용하여 양식, 양식 필드 및 필드 값을 구성합니다. 클라이언트 스크립트는 다음을 수행할 수 있습니다.  
* 필드를 숨기거나 표시하기
* 필드를 읽기 전용 또는 쓰기 가능하게 만들기
* 사용자 역할에 따라 필드를 선택 또는 필수로 만들기
* 다른 필드의 값을 기준으로 한 필드의 값 설정
* 사용자 역할에 따라 선택 목록의 옵션을 수정합니다
* 필드의 값을 기준으로 메시지 표시
{#client-scripts__ul_zp5_n5y_vdb}

## 클라이언트 스크립트가 실행되는 위치 {#client-scripts__section_y1n_4z5_zz}

onCellEdit() 클라이언트 스크립트를 제외하고 클라이언트 스크립트는 양식 및 검색 페이지에만 적용됩니다. 양식의 필드 값을 제어하는 클라이언트 스크립트를 만드는 경우, 목록에 있을 때 필드 값을 제어하려면 이러한 다른 방법 중 하나를 사용해야 합니다.

* 접근 제어를 생성하여 필드 값을 편집할 수 있는 사용자를 제한합니다.
* 컨텐츠의 유효성을 검사하는 비즈니스 규칙을 만듭니다.
* 컨텐츠의 유효성을 검사하는 데이터 정책을 만듭니다.
* onCellEdit() 클라이언트 스크립트를 만들어 콘텐츠의 유효성을 검사합니다.
* 테이블에 대한 목록 편집을 비활성화합니다.
{#client-scripts__ul_nml_51t_d1b}  
주:  
클라이언트 스크립트는 애플리케이션에서 ServiceNow Mobile 지원되지 않습니다.

## 클라이언트 스크립트 양식 {#client-scripts__section_yjd_hvg_zz}

{#client-scripts__table_trz_nvg_zz__entry__2}

| 필드 | 설명 |
|-|-|
| 이름 | 클라이언트 스크립트의 이름입니다. |
| 테이블 | 클라이언트 스크립트가 적용되는 테이블입니다. |
| UI 유형 | 클라이언트 스크립트가 적용되는 대상 사용자 인터페이스입니다. |
| 유형 | onLoad() --- 시스템이 양식을 처음 렌더링할 때와 사용자가 데이터를 입력하기 전에 실행됩니다. 일반적으로 onLoad() 클라이언트 스크립트는 현재 양식의 클라이언트 측 조작을 수행하거나 기본 레코드 값을 설정합니다. onSubmit() --- 양식이 제출될 때 실행됩니다. 일반적으로 onSubmit() 스크립트는 폼에 있는 항목을 확인하고 제출이 맞는지 확인합니다. onSubmit() 클라이언트 스크립트는 false 값을 반환하여 양식 제출을 취소할 수 있습니다. onChange() --- 양식에서 특정 필드 값이 변경될 때 실행됩니다. onChange() 클라이언트 스크립트는 이러한 매개변수를 지정해야 합니다. * control: 값이 변경된 DHTML 위젯입니다. 주: control 모바일 및 서비스 포털에서 접근할 수 없습니다. * oldValue: 기록이 로드될 때 위젯이 갖는 값입니다. 주: HTML 필드 유형에 대한 이전 값은 반환되지 않습니다. * newValue: 변경 후 위젯이 갖는 값입니다. * isLoading: 양식 로드의 일부로 변경이 발생하는지 여부를 식별합니다. * isTemplate: 변경이 템플릿 로드의 일부로 발생하는지 여부를 식별합니다. {#client-scripts__ul_bsg_d2r_n4} onCellEdit() --- 목록 편집기가 셀 값을 변경할 때 실행됩니다. onCellEdit() 클라이언트 스크립트는 이러한 매개 변수를 지정해야 합니다. * sysIDs: 편집 중인 모든 항목의 sys_ids 배열입니다. * table: 편집 중인 항목의 테이블입니다. * oldValues: 편집 중인 셀의 이전 값입니다. * newValue: 편집 중인 셀의 새 값입니다. * callback: 다른 관련 셀 편집 스크립트의 실행을 계속하는 콜백입니다. true가 매개변수로 전달되면 다른 스크립트가 실행되거나 스크립트가 더 이상 없는 경우 변경이 커밋됩니다. false가 매개변수로 전달되면 추가 스크립트가 실행되지 않고 변경 내용이 커밋되지 않습니다. {#client-scripts__ul_qm5_z2r_n4} |
| 필드 이름 | 스크립트가 적용되는 필드의 이름입니다. 스크립트가 필드 값 변경(onChange 또는 onCellEdit 스크립트 유형)에 응답하는 경우에만 사용할 수 있습니다. |
| 애플리케이션 | 이 클라이언트 스크립트가 있는 애플리케이션입니다. |
| 활성 | 선택하면 클라이언트 스크립트를 사용할 수 있습니다. 클라이언트 스크립트를 사용하지 않으려면 이 필드의 선택을 취소합니다. |
| 상속됨 | 클라이언트 스크립트가 확장 테이블에 적용되는지 여부를 나타냅니다. |
| 전역 | true이면 클라이언트 스크립트가 테이블의 모든 뷰에서 실행됩니다. |
| 뷰 | 전역을 선택하지 않은 경우에만 표시됩니다. 클라이언트 스크립트가 실행될 뷰입니다. |
| 설명 | 클라이언트 스크립트의 기능과 목적을 설명하는 컨텐츠입니다. |
| 메시지 | getmessage('\[message\]')를 사용하여 지역화된 메시지로 클라이언트 스크립트에서 사용할 수 있는 텍스트 문자열(라인당 하나)입니다. 자세한 내용은 [클라이언트 스크립트 메시지 번역을](https://www.servicenow.com/docs/access?context=t_TranslateAClientScriptMessage&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US) 참조하세요. |
| 스크립트 | 클라이언트 스크립트를 포함합니다. |
| 스크립트 격리 | 새 클라이언트 스크립트는 직접 DOM 액세스가 비활성화된 엄격 모드에서 실행됩니다. jQuery, 프로토타입 및 window 객체에 대한 액세스도 비활성화됩니다. 스크립트별로 이 설정을 비활성화하려면 이 양식을 구성하고 스크립트 격리 확인란을 선택합니다. 모든 새 전역 범위 클라이언트 쪽 스크립트에 대해 이 기능을 비활성화하려면 시스템 속성 glide.script.block.client.globals를 아니오로 설정합니다. |
[ ]

{#client-scripts__table_trz_nvg_zz}