---
sourceDocument: 호주 애플리케이션 빌드 또는 수정
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/application-development

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 애플리케이션 빌드 또는 수정

ft:clusterId :

    - cadev

bundleId :

    - cadev

workflow :

    - Development, Data, and Analytics


---

# 클라이언트 스크립트 API

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

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

클라이언트 스크립트 API는 클라이언트 기반 이벤트가 발생한 경우(예: 양식이 로드될 때, 양식 제출 후 또는 필드 값이 변경될 때) 클라이언트(웹 브라우저)에서 JavaScript를 실행하는 클라이언트 측 스크립트 \[sys_script_client\]를 정의합니다.
주:  
최신 ServiceNow Fluent API 설명서 및 예제는 [ServiceNow Fluent API 참조](https://servicenow.github.io/sdk/) 및 [ServiceNow SDK 예제 리포지토리](https://github.com/ServiceNow/sdk-examples) 는 의 위치에 있습니다 GitHub.

클라이언트 스크립트에 대한 일반 정보는 다음 문서를 참조하십시오 [Client scripts](https://www.servicenow.com/docs/access?context=client-scripts&version=australia&pubname=australia-api-reference&ft:locale=en-US).
**관련 개념**   

* [ServiceNow Fluent](https://servicenow-prod.fluidtopics.net/LkgjsL6Ogxn6hUPsJ73QXQ "도메인별 프로그래밍 언어를 사용하여 소스 코드에서 애플리케이션 메타데이터를 정의합니다.ServiceNow Fluent")

## ClientScript 객체 {#ariaid-title2}

사용자가 양식을 사용하는 동안 클라이언트 스크립트 \[sys_script_client\]를 만들어 양식, 양식 필드 및 필드 값을 구성합니다.
{#client-script-object-now-ts__table_vy2_525_jq__entry__3}{#client-script-object-now-ts__now-id-desc2}

| 이름 | 유형 | 설명 |
|-|-|-|
| $id | 문자열 또는 숫자 | 필수 메타데이터 객체의 고유 ID입니다. 애플리케이션을 빌드할 때 이 ID는 고유한 sys_id으로 해시됩니다. 자세한 내용은 [ServiceNow Fluent 언어 구성](https://servicenow-prod.fluidtopics.net/bd4_Ogu8TJjhKosNwonOfw "ServiceNow Fluent 언어 구문은 API를 사용하여 ServiceNow Fluent 소스 코드에서 개발하기 위한 추가 기능을 제공합니다.") 문서를 참조하십시오. 형식: `Now.ID['문자열' 또는 숫자]` |
| 테이블 | 문자열 | 필수 클라이언트 스크립트가 실행되는 테이블의 이름입니다. |
| 이름 | 문자열 | 필수 클라이언트 스크립트의 이름입니다. |
| 활성 | 부울 | 클라이언트 스크립트를 사용할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 스크립트를 사용할 수 있습니다. * false: 스크립트를 사용할 수 없습니다. {#client-script-object-now-ts__ul_cxj_srr_4bc} 기본값: true |
| 적용확장됨 | 부울 | 클라이언트 스크립트가 지정된 테이블에서 확장된 테이블에 적용되는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 스크립트가 확장 테이블에 적용됩니다. * false: 확장된 테이블에는 스크립트가 적용되지 않습니다. {#client-script-object-now-ts__ul_q5n_ltz_pbc} 기본값: false |
| uiType | 문자열 | 클라이언트 스크립트가 적용되는 사용자 인터페이스입니다. 유효한 값은 다음과 같습니다. * 데스크톱 * mobile_or_service_portal * 모두 {#client-script-object-now-ts__ul_pxn_sdf_1gc} 기본값: 데스크톱 |
| 설명 | 문자열 | 클라이언트 스크립트의 기능 및 목적에 대한 설명입니다. |
| 메시지 | 문자열 | getmessage("\[message\]")를 사용하여 지역화된 메시지로 클라이언트 스크립트에서 사용할 수 있는 텍스트 문자열입니다. 자세한 내용은 [클라이언트 스크립트 메시지 번역](https://www.servicenow.com/docs/access?context=t_TranslateAClientScriptMessage&version=australia&pubname=australia-platform-administration&ft:locale=en-US)을 참조하세요. |
| isolateScript | 부울 | 스크립트가 직접 DOM, jQuery, 프로토타입 및 창 객체에 대한 접근이 꺼진 엄격 모드에서 실행되는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 스크립트를 격리하고 엄격 모드에서 실행하지 마십시오. * false: 스크립트를 엄격 모드로 실행합니다. {#client-script-object-now-ts__ul_s1q_c5z_pbc} 기본값: false |
| 스크립트 | 스크립트 | 브라우저에서 실행되는 클라이언트 측 스크립트입니다. 이 속성은 인라인 JavaScript 또는 스크립트가 포함된 애플리케이션의 다른 파일에 대한 참조를 지원합니다. 체재: * 다른 파일의 텍스트 콘텐츠를 사용하려면 `Now.include('경로/대상/파일')` 형식을 사용하여 애플리케이션에서 파일을 참조합니다. 자세한 내용은 [ServiceNow Fluent 언어 구성](https://servicenow-prod.fluidtopics.net/bd4_Ogu8TJjhKosNwonOfw "ServiceNow Fluent 언어 구문은 API를 사용하여 ServiceNow Fluent 소스 코드에서 개발하기 위한 추가 기능을 제공합니다.") 문서를 참조하십시오. * 인라인 스크립트를 제공하려면 여러 줄의 코드에 문자열 리터럴 또는 템플릿 리터럴을 사용합니다( `'Script' 또는 'Script'`). {#client-script-object-now-ts__ul_zr2_zvg_5fc} |
| 전역 | 부울 | 클라이언트 스크립트가 실행되는 테이블 뷰를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 스크립트가 모든 뷰에서 실행됩니다. * false: 지정된 뷰에서만 스크립트가 실행됩니다. {#client-script-object-now-ts__ul_mvv_l5h_qbc} 기본값: true |
| 뷰 | 문자열 | 클라이언트 스크립트가 실행되는 테이블의 뷰입니다. 이 속성은 전역 속성이 false로 설정된 경우에만 적용됩니다. |
| 유형 | 문자열 | 실행 시기를 정의하는 클라이언트 스크립트의 유형입니다. 지원되는 유형에 대한 자세한 내용은 다음 문서를 참조하십시오 [Client scripts](https://www.servicenow.com/docs/access?context=client-scripts&version=australia&pubname=australia-api-reference&ft:locale=en-US). 유효한 값은 다음과 같습니다. * onCellEdit: 목록 편집기에서 셀 값을 변경할 때 실행됩니다. * onChange: 양식에서 특정 필드 값이 변경될 때 실행됩니다. * onLoad: 시스템이 양식을 처음 렌더링할 때와 사용자가 데이터를 입력하기 전에 실행됩니다. 일반적으로 onLoad() 클라이언트 스크립트는 현재 양식의 클라이언트 측 조작을 수행하거나 기본 기록 값을 설정합니다. * onSubmit: 양식이 제출될 때 실행됩니다. 일반적으로 onSubmit() 스크립트는 양식에 있는 항목을 확인하고 제출이 타당한지 확인합니다. onSubmit() 클라이언트 스크립트는 false 값을 반환하여 양식 제출을 취소할 수 있습니다. {#client-script-object-now-ts__ul_nvk_wdf_1gc} |
| 필드 | 문자열 | 클라이언트 스크립트가 적용되는 테이블의 필드입니다. 이 속성은 type 속성이 onChange 또는 onCellEdit로 설정된 경우에만 적용됩니다. |
| $meta | 객체 | 애플리케이션 메타데이터의 메타데이터입니다. installMethod 속성을 사용하면 애플리케이션 메타데이터를 특정 상황에서만 로드되는 출력 디렉터리에 매핑할 수 있습니다. $meta: { installMethod: 'String' } installMethod에 유효한 값: * demo: 데모 데이터 로드 옵션을 선택한 경우 애플리케이션과 함께 설치할 metadata/unload.demo 디렉터리에 애플리케이션 메타데이터를 출력합니다. * 첫 번째 설치: 애플리케이션이 인스턴스에 처음 설치될 때만 설치할 메타데이터 /언로드 디렉터리에 애플리케이션 메타데이터를 출력합니다. {#client-script-object-now-ts__ul_n3q_y3s_42c} |
[표 1. 속성]

{#client-script-object-now-ts__table_vy2_525_jq}  

    import { ClientScript } from '@servicenow/sdk/core'

    export const cs = ClientScript({
       $id: Now.ID['my_scripts'], 
       name: 'my_scripts',
       table: 'incident',
       active: true, 
       appliesExtended: false, 
       global: true,
       uiType: 'all', 
       messages: '', 
       isolateScript: false, 
       type: 'onLoad',
       script: Now.include('../client/client-script.js'),
    })

클라이언트 스크립트는 스크립트 속성에서 참조하는 client-script.js 파일에 정의됩니다. 예:

    function onLoad() { 
        const x = 'util' g_form.addInfoMessage(x) 
    }