클라이언트 스크립트 API - ServiceNow Fluent

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 5분

    • 클라이언트 스크립트 API는 클라이언트 기반 이벤트가 발생한 경우(예: 양식이 로드될 때, 양식 제출 후 또는 필드 값이 변경될 때) 클라이언트(웹 브라우저)에서 JavaScript를 실행하는 클라이언트 측 스크립트 [sys_script_client]를 정의합니다.

    클라이언트 스크립트에 대한 일반 정보는 다음 문서를 참조하십시오 Client scripts.

    ClientScript 객체

    사용자가 양식을 사용하는 동안 클라이언트 스크립트 [sys_script_client]를 만들어 양식, 양식 필드 및 필드 값을 구성합니다.

    표 1. 속성
    이름 유형 설명
    $id 문자열 또는 숫자 필수 메타데이터 객체의 고유 ID입니다. 애플리케이션을 빌드할 때 이 ID는 고유한 sys_id으로 해시됩니다. 자세한 내용은 ServiceNow Fluent 언어 구성 문서를 참조하십시오.

    형식: Now.ID['문자열' 또는 숫자]
    테이블 문자열 필수 클라이언트 스크립트가 실행되는 테이블의 이름입니다.
    이름 문자열 필수 클라이언트 스크립트의 이름입니다.
    활성 부울 클라이언트 스크립트를 사용할 수 있는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 스크립트를 사용할 수 있습니다.
    • false: 스크립트를 사용할 수 없습니다.

    기본값: true
    적용확장됨 부울 클라이언트 스크립트가 지정된 테이블에서 확장된 테이블에 적용되는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 스크립트가 확장 테이블에 적용됩니다.
    • false: 확장된 테이블에는 스크립트가 적용되지 않습니다.

    기본값: false
    uiType 문자열 클라이언트 스크립트가 적용되는 사용자 인터페이스입니다.
    유효한 값은 다음과 같습니다.
    • 데스크톱
    • mobile_or_service_portal
    • 모두

    기본값: 데스크톱
    설명 문자열 클라이언트 스크립트의 기능 및 목적에 대한 설명입니다.
    메시지 문자열 getmessage("[message]")를 사용하여 지역화된 메시지로 클라이언트 스크립트에서 사용할 수 있는 텍스트 문자열입니다. 자세한 내용은 클라이언트 스크립트 메시지 번역을 참조하세요.
    isolateScript 부울 스크립트가 직접 DOM, jQuery, 프로토타입 및 창 객체에 대한 접근이 꺼진 엄격 모드에서 실행되는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 스크립트를 격리하고 엄격 모드에서 실행하지 마십시오.
    • false: 스크립트를 엄격 모드로 실행합니다.

    기본값: false
    스크립트 스크립트 브라우저에서 실행되는 클라이언트 측 스크립트입니다. 이 속성은 인라인 JavaScript 또는 스크립트가 포함된 애플리케이션의 다른 파일에 대한 참조를 지원합니다.
    체재:
    • 다른 파일의 텍스트 컨텐츠를 사용하려면 Now.include('path/to/file') 형식을 사용하여 애플리케이션의 파일을 참조하십시오. 자세한 내용은 ServiceNow Fluent 언어 구성 문서를 참조하십시오.
    • 인라인 스크립트를 제공하려면 여러 줄의 코드에 문자열 리터럴 또는 템플릿 리터럴을 사용합니다( 'Script' 또는 'Script').
    전역 부울 클라이언트 스크립트가 실행되는 테이블 뷰를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 스크립트가 모든 뷰에서 실행됩니다.
    • false: 지정된 뷰에서만 스크립트가 실행됩니다.

    기본값: true
    뷰 문자열 클라이언트 스크립트가 실행되는 테이블의 뷰입니다. 이 속성은 전역 속성이 false로 설정된 경우에만 적용됩니다.
    유형 문자열 실행 시기를 정의하는 클라이언트 스크립트의 유형입니다. 지원되는 유형에 대한 자세한 내용은 다음 문서를 참조하십시오 Client scripts.
    유효한 값은 다음과 같습니다.
    • onCellEdit: 목록 편집기에서 셀 값을 변경할 때 실행됩니다.
    • onChange: 양식에서 특정 필드 값이 변경될 때 실행됩니다.
    • onLoad: 시스템이 양식을 처음 렌더링할 때와 사용자가 데이터를 입력하기 전에 실행됩니다. 일반적으로 onLoad() 클라이언트 스크립트는 현재 양식의 클라이언트 측 조작을 수행하거나 기본 기록 값을 설정합니다.
    • onSubmit: 양식이 제출될 때 실행됩니다. 일반적으로 onSubmit() 스크립트는 양식에 있는 항목을 확인하고 제출이 타당한지 확인합니다. onSubmit() 클라이언트 스크립트는 false 값을 반환하여 양식 제출을 취소할 수 있습니다.
    필드 문자열 클라이언트 스크립트가 적용되는 테이블의 필드입니다. 이 속성은 type 속성이 onChange 또는 onCellEdit로 설정된 경우에만 적용됩니다.
    $meta 객체 애플리케이션 메타데이터의 메타데이터입니다.
    installMethod 속성을 사용하면 애플리케이션 메타데이터를 특정 상황에서만 로드되는 출력 디렉터리에 매핑할 수 있습니다.
    $meta: {
      installMethod: 'String'
}
    installMethod에 유효한 값:
    • demo: 데모 데이터 로드 옵션을 선택한 경우 애플리케이션과 함께 설치할 metadata/unload.demo 디렉터리에 애플리케이션 메타데이터를 출력합니다.
    • 첫 번째 설치: 애플리케이션이 인스턴스에 처음 설치될 때만 설치할 메타데이터 /언로드 디렉터리에 애플리케이션 메타데이터를 출력합니다.
    		 
    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) 
}