--- 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) 소요 시간: 6분 스크립트 포함 API는 서버 측 스크립트에서 사용할 JavaScript 함수와 클래스를 저장하는 스크립트 포함 \[sys_script_include\]을 정의합니다. 주: 최신 ServiceNow Fluent API 설명서 및 예제는 [ServiceNow Fluent API 참조](https://servicenow.github.io/sdk/) 및 [ServiceNow SDK 예제 리포지토리](https://github.com/ServiceNow/sdk-examples) 는 의 위치에 있습니다 GitHub. 새 스크립트의 경우 코드 재사용을 지원하고 n 애플리케이션 범위 내에서타사 라이브러리 사용을 지원하기 위해 가능하면 스크립트 포함 대신 JavaScript 모듈을 사용합니다. JavaScript 모듈 지원 및 제한 사항에 대한 자세한 내용은 다음 문서를 참조하십시오 [JavaScript 모듈 및 타사 라이브러리](https://servicenow-prod.fluidtopics.net/BgHqCmt1oAyXsb0oVdi_9Q "JavaScript 모듈을 사용하여 코드 베이스를 최적화하고 관련 코드를 그룹화하거나 타사 라이브러리를 추가하고 애플리케이션 내에서 코드를 재사용합니다."). 스크립트 포함에 대한 일반적인 정보는 다음 문서를 참조하십시오 [Script includes](https://www.servicenow.com/docs/access?context=c_ScriptIncludes&version=australia&pubname=australia-api-reference&ft:locale=en-US). **관련 개념** * [ServiceNow Fluent](https://servicenow-prod.fluidtopics.net/LkgjsL6Ogxn6hUPsJ73QXQ "도메인별 프로그래밍 언어를 사용하여 소스 코드에서 애플리케이션 메타데이터를 정의합니다.ServiceNow Fluent") ## ScriptInclude 객체 {#ariaid-title2} 스크립트 포함 \[sys_script_include\]을 만들어 다른 스크립트에서 호출될 때 실행되는 서버 측 스크립트를 정의합니다. {#fluent-script-include-object__table_qyv_1pj_4fc__entry__3}{#fluent-script-include-object__now-id-desc2} | 이름 | 유형 | 설명 | |-|-|-| | $id | 문자열 또는 숫자 | 필수 메타데이터 객체의 고유 ID입니다. 애플리케이션을 빌드할 때 이 ID는 고유한 sys_id으로 해시됩니다. 자세한 내용은 [ServiceNow Fluent 언어 구성](https://servicenow-prod.fluidtopics.net/bd4_Ogu8TJjhKosNwonOfw "ServiceNow Fluent 언어 구문은 API를 사용하여 ServiceNow Fluent 소스 코드에서 개발하기 위한 추가 기능을 제공합니다.") 문서를 참조하십시오. 형식: `Now.ID['문자열' 또는 숫자]` | | 이름 | 문자열 | 필수 스크립트 포함의 이름입니다. 클래스를 정의하는 경우 이름은 클래스, 프로토타입 및 유형의 이름과 일치해야 합니다. 클래스가 없는(요청 시) 스크립트 포함을 사용하는 경우 이름은 함수 이름과 일치해야 합니다. | | 스크립트 | 스크립트 | 필수 다른 스크립트에서 호출할 서버 측 스크립트입니다. 스크립트는 단일 JavaScript 클래스 또는 전역 함수를 정의해야 합니다. 클래스 또는 함수 이름은 이름 속성과 일치해야 합니다. 이 속성은 인라인 JavaScript 또는 스크립트가 포함된 애플리케이션의 다른 파일에 대한 참조를 지원합니다. 체재: * 다른 파일의 텍스트 콘텐츠를 사용하려면 `Now.include('경로/대상/파일')` 형식을 사용하여 애플리케이션에서 파일을 참조합니다. 자세한 내용은 [ServiceNow Fluent 언어 구성](https://servicenow-prod.fluidtopics.net/bd4_Ogu8TJjhKosNwonOfw "ServiceNow Fluent 언어 구문은 API를 사용하여 ServiceNow Fluent 소스 코드에서 개발하기 위한 추가 기능을 제공합니다.") 문서를 참조하십시오. * 인라인 스크립트를 제공하려면 여러 줄의 코드에 문자열 리터럴 또는 템플릿 리터럴을 사용합니다( `'Script' 또는 'Script'`). {#fluent-script-include-object__ul_zr2_zvg_5fc} | | apiName | 문자열 | 범위를 벗어난 애플리케이션에서 스크립트 포함을 호출하는 데 사용되는 스크립트 포함의 내부 이름입니다. 기본값: \.\ | | 설명 | 문자열 | 스크립트 포함의 목적과 기능에 대한 설명입니다. | | clientCallable | 부울 | 클라이언트 측 스크립트에서 GlideAjax를 사용하여 스크립트 포함을 호출할 수 있는지 여부를 나타내는 플래그입니다. 스크립트 포함은 클라이언트 스크립트, 목록/보고서 필터, 참조 한정자에 사용하거나 URL의 일부로 지정된 경우에 사용할 수 있습니다. 클라이언트 호출 가능 스크립트 포함은 GlideAjax 에서 호출되며 사용자가 스크립트 포함과 연결된 ACL을 충족해야 합니다. 유효한 값은 다음과 같습니다. * true: 클라이언트 측 스크립트에서 스크립트 포함을 사용할 수 있습니다. * false: 클라이언트 측 스크립트에 스크립트 포함을 사용할 수 없습니다. {#fluent-script-include-object__ul_z4f_1dl_4fc} 기본값: false | | mobileCallable | 부울 | 모바일 장치에서 호출한 클라이언트 스크립트에서 스크립트 포함을 사용할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 모바일 장치에서 호출된 클라이언트 스크립트에 스크립트 포함을 사용할 수 있습니다. * false: 모바일 장치에서 호출된 클라이언트 스크립트에는 스크립트 포함을 사용할 수 없습니다. {#fluent-script-include-object__ul_ajt_ydl_4fc} 기본값: false | | sandbox호출 가능 | 부울 | 스크립트 샌드박스에서 호출된 스크립트에 스크립트 포함을 사용할 수 있는지 여부를 나타내는 플래그입니다(예: 쿼리 조건). 중요사항: 스크립트 포함은 필요한 경우에만 스크립트 샌드박스에서 사용할 수 있도록 해야 합니다. 유효한 값은 다음과 같습니다. * true: 스크립트 샌드박스에서 호출된 스크립트에 스크립트 포함을 사용할 수 있습니다. * false: 스크립트 샌드박스에서 호출된 스크립트에는 스크립트 포함을 사용할 수 없습니다. {#fluent-script-include-object__ul_mz3_22l_4fc} 기본값: false | | callerAccess | 문자열 | 스크립트 포함에 대한 교차 범위 접근을 허용하는 방법에 대한 옵션입니다. 자세한 내용은 [제한된 호출자 접근 권한 설정](https://servicenow-prod.fluidtopics.net/GWvfNuLgZBg47R2H4DckEQ "애플리케이션, 애플리케이션 자원(예: 접근 제어 역할, 비즈니스 규칙, UI 작업 또는 스크립트 포함) 또는 이벤트에 대한 교차 범위 액세스를 정의합니다. 이러한 설정을 사용하여 액세스 요청을 허용하거나 거부할 수도 있습니다.") 문서를 참조하십시오. 유효한 값은 다음과 같습니다. * 제한사항: 스크립트 포함에 대한 호출은 수동으로 승인해야 합니다. 액세스 요청은 요청됨 상태의 제한된 호출자 액세스 테이블에서 추적됩니다. * 추적: 스크립트 포함에 대한 호출이 자동으로 승인됩니다. 통화는 허용됨 상태의 제한된 호출자 접근 테이블에서 추적됩니다. {#fluent-script-include-object__ul_fjd_4hl_4fc} | | 접근 가능한 시작 | 문자열 | 스크립트 포함에 접근할 수 있는 애플리케이션을 지정합니다. 유효한 값은 다음과 같습니다. * public: 모든 애플리케이션 범위에서 스크립트 포함을 호출할 수 있습니다. * package_private: 스크립트 포함은 해당 애플리케이션 범위에서만 호출할 수 있습니다. {#fluent-script-include-object__ul_m5p_yfl_4fc} 기본값: package_private | | 활성 | 부울 | 스크립트 포함이 활성화되었는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 스크립트 포함을 호출할 수 있습니다. * 아니오: 스크립트 포함을 호출할 수 없습니다. {#fluent-script-include-object__ul_otz_jgl_4fc} 기본값: true | | 보호 정책 | 문자열 | 애플리케이션이 인스턴스에 설치된 후 다른 사용자가 스크립트 포함을 보거나 편집할 수 있는지 여부를 결정하는 정책입니다. 정의되지 않은 경우 다른 애플리케이션 개발자가 스크립트 포함을 사용자 지정할 수 있습니다. 유효한 값은 다음과 같습니다. * 읽기: 누구나 다운로드하거나 설치된 이 스크립트 포함에서 값을 읽을 수 있습니다. 누구도 스크립트 포함을 다운로드하거나 설치하는 인스턴스에서 스크립트 값을 변경할 수 없습니다. * 보호됨: 애플리케이션 개발자에게 지적 재산권 보호를 제공합니다. 스크립트 포함을 다운로드한 고객은 스크립트 필드의 내용을 볼 수 없습니다. 스크립트는 권한이 없는 사용자가 일반 텍스트로 볼 수 없도록 메모리에서 암호화됩니다. {#fluent-script-include-object__ul_o3h_nbz_j3c} | | $meta | 객체 | 애플리케이션 메타데이터의 메타데이터입니다. installMethod 속성을 사용하면 애플리케이션 메타데이터를 특정 상황에서만 로드되는 출력 디렉터리에 매핑할 수 있습니다. $meta: { installMethod: 'String' } installMethod에 유효한 값: * demo: 데모 데이터 로드 옵션을 선택한 경우 애플리케이션과 함께 설치할 metadata/unload.demo 디렉터리에 애플리케이션 메타데이터를 출력합니다. * 첫 번째 설치: 애플리케이션이 인스턴스에 처음 설치될 때만 설치할 메타데이터 /언로드 디렉터리에 애플리케이션 메타데이터를 출력합니다. {#fluent-script-include-object__ul_n3q_y3s_42c} | [표 1. 속성] {#fluent-script-include-object__table_qyv_1pj_4fc} 다음 예시에서 스크립트 포함은 SampleClass.server.js 파일의 스크립트를 사용합니다. import { ScriptInclude } from '@servicenow/sdk/core'; ScriptInclude({ $id: Now.ID['sample-script-include'], name: 'SampleScriptInclude', script: Now.include("./SampleClass.server.js"), description: 'some description', apiName: 'x_scope.SampleScriptInclude', callerAccess: 'tracking', clientCallable: true, mobileCallable: true, sandboxCallable: true, accessibleFrom: 'public', active: true, })