의 애플리케이션에서 JavaScript 모듈 생성 및 사용 ServiceNow IDE

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 4분
  • JavaScript 모듈로 재사용 가능한 코드 블록을 정의하여 코드베이스 최적화ServiceNow IDE에서 .

    시작하기 전에

    애플리케이션을 생성, 변환 또는 복제하여 작업 공간에 추가합니다. 자세한 내용은 에서 애플리케이션 추가 ServiceNow IDE 문서를 참조하십시오.

    주:
    모듈에서 TypeScript를 사용하려면 애플리케이션을 생성할 때 TypeScript를 템플릿 유형으로 선택합니다.

    필요한 역할: 관리자

    이 태스크 정보

    몇 가지 제한 사항을 포함하여 범위가 지정된 애플리케이션에서 JavaScript 모듈 사용에 대한 지원에 대한 자세한 내용은 문서를 참조하십시오 JavaScript 모듈 및 타사 라이브러리. JavaScript 모듈을 만드는 데 사용되는 구문에 대한 일반적인 정보는 MDN Web Docs 웹 사이트의 JavaScript 모듈 페이지를 참조하십시오.

    주:
    를 사용하면 코드용 Now Assist코드 자동 완성 기술을 사용하여 모듈 스크립트에 대한 코드 제안을 생성할 수 있습니다. 자세한 내용은 Generate code with autocomplete 문서를 참조하십시오.

    프로시저

    1. 다음으로 이동 모두 > 앱 개발 > ServiceNow IDE.
    2. 애플리케이션이 있는 작업 공간을 엽니다.
    3. 활동 표시줄에서 파일 탐색기 보기( 파일 탐색기)를 선택합니다.
    4. 애플리케이션의 src/server 디렉터리에서 재사용하려는 모듈 코드를 포함하는 JavaScript 또는 TypeScript 파일을 만듭니다.
    5. 옵션: 서버 API 또는 스크립트 포함을 임포트하여 모듈에서 호출합니다.

      Glide API는 @servicenow/glide 패키지 또는 패키지의 네임스페이스에서 임포트할 수 있습니다. 스크립트 포함은 해당 애플리케이션 범위 또는 @servicenow/Glide 패키지의 전역 범위에서 임포트할 수 있습니다.

      예:
      import { API } from "@servicenow/glide";
      import { API } from "@servicenow/glide/<namespace>";
      import { ScriptInclude } from "@servicenow/glide/<scope>";
      import { global } from "@servicenow/glide/global";
    6. 모듈에서 export 문과 함께 익스포트할 코드를 식별합니다.

      명명된 익스포트 또는 기본 익스포트를 사용할 수 있습니다. 명명된 익스포트는 변수, 상수, 함수 또는 클래스일 수 있지만 기본 익스포트는 함수 또는 클래스일 수 있습니다.

      다음 예는 모듈에서 여러 기능(함수 및 변수)에 대해 명명된 익스포트를 추가하는 한 가지 방법입니다.
      export { myFunction, myVariable };
      
    7. 익스포트한 모듈의 코드를 다른 모듈이나 서버 측 스크립트에 사용합니다.
      파일단계
      모듈
      1. src/server 디렉터리에서 JavaScript 모듈을 만들거나 엽니다.
      2. import 문을 사용하여 모듈 코드를 임포트합니다.
        다음 예는 모듈에서 내보낸 기능을 임포트하는 한 가지 방법입니다.
        import { feature } from "path/to/module";
        
        주:
        한 TypeScript 파일에서 다른 TypeScript 파일로 코드를 임포트하려면 .ts 파일 확장명을 포함해야 합니다. 예를 들어 './module.ts'에서 { feature }를 임포트합니다.
      3. 이 모듈의 모듈 코드를 호출하여 재사용합니다.
      소스 코드의 서버 측 스크립트
      1. 비즈니스 규칙과 같은 서버 측 스크립트를 포함하는 애플리케이션 메타데이터의 정의를 소스 코드(.now.ts 파일)로 만들거나 엽니다.
      2. 스크립트 속성에서 모듈 코드를 임포트하고 호출하여 재사용합니다.
        기능을 임포트하거나 인라인 스크립트를 제공할 수 있습니다.
        • 익스포트한 함수, 함수 표현식 또는 기본 함수를 임포트합니다. 예:
          script: FunctionExport,
        • 인라인 스크립트는 require 문을 사용하여 모듈 코드를 임포트해야 합니다. 예:
          script: `
              const { process } = require('./dist/modules/server/handler.js')
              process(request, response)`,

        소스 코드의 서버 측 스크립트에 대한 자세한 내용은 다음 문서를 참조하십시오 ServiceNow Fluent API 참조.

      서버 측 스크립트 기록
      1. 비즈니스 규칙과 같은 서버 측 스크립트에 대한 기록을 엽니다.
      2. require 문을 사용하여 모듈 코드를 임포트합니다.
        다음 예는 스크립트에서 내보낸 기능을 임포트하는 한 가지 방법입니다.
        const { feature } = require("path/to/module");
        
      3. 이 스크립트의 모듈 코드를 호출하여 다시 사용합니다.
    8. 변경 내용을 저장합니다.
    9. 상태 표시줄에서 빌드 및 설치를 선택합니다.

      빌드 및 배포

      편집기에 열려 있는 활성 파일에 따라 빌드할 애플리케이션이 결정됩니다. 열려 있는 파일이 없으면 메시지가 표시되면 빌드할 애플리케이션을 선택합니다.

      빌드가 완료되면 모듈이 EcmaScript 모듈 [sys_module] 테이블에 추가됩니다.

    다음에 수행할 작업

    JavaScript 모듈에서 타사 라이브러리를 사용하려면 다음 문서를 참조하십시오 의 애플리케이션에서 타사 라이브러리 사용 ServiceNow IDE.