소스 코드로 애플리케이션 빌드

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기7분

    • 익숙한 개발 도구 및 프로세스를 사용하여 소스 코드에서 사용자 지정 애플리케이션을 생성하고 개발합니다.

    소스 코드의 빌드 개요

    on 을 Now Platform 사용하여 ServiceNow IDE 코드에서 범위가 지정된 응용 프로그램을 만들거나 데스크톱ServiceNow SDK에서 Visual Studio Code 로컬로 .

    두 개발 환경 중 하나에서 도메인별 프로그래밍 언어인 를 사용하여 ServiceNow Fluent애플리케이션을 구성하는 메타데이터를 정의합니다. ServiceNow Fluent 에는 다양한 유형의 메타데이터를 정의하기 위한 API가 포함되어 있습니다.

    or ServiceNow SDK를 ServiceNow IDE 사용하면 JavaScript 모듈을 만들고 애플리케이션에서 타사 라이브러리를 사용하여 범위가 지정된 애플리케이션 내의 스크립트에서 코드 재사용을 최적화할 수도 있습니다.

    소스 코드에서 응용 프로그램을 개발하고 유지 관리하면 친숙한 개발 환경에서 작업하고, 복잡한 응용 프로그램을 만들고 수정하고, 소스 제어에서 코드를 보다 쉽게 관리하고, 빌드 시 오류를 포착할 수 있습니다.

    의 ServiceNow IDE 비교 및 ServiceNow SDK

    기능 ServiceNow IDE ServiceNow SDK
    개발 환경 온라인 ServiceNow 인스턴스 로컬 개발 및 오프라인 작업 기능
    사용자 인터페이스 웹용 IDE 기반 Visual Studio Code Visual Studio Code 바탕 화면
    공동 작업 코드 또는 포함된 Now Platform 사용자 인터페이스에서 사용자의 변경 내용을 실시간으로 볼 수 있습니다.

    소스 제어의 응용 프로그램에 대해 다른 개발자와 공동 작업을 수행합니다.

    		 CLI를 ServiceNow SDK 통해 변경 사항을 가져오고 인스턴스에 배포하여 다른 사용자와 공동 작업합니다.

    소스 제어의 응용 프로그램에 대해 다른 개발자와 공동 작업을 수행합니다.
    소스 통제 가장 일반적인 Git 기능과 선택한 Git 제공자와의 통합을 지원합니다.

    인스턴스당 리포지토리당 하나의 동시 분기입니다.

    		 전체 지원
    애플리케이션 변환 ORServiceNow SDK를 사용하여 ServiceNow IDE 만들어지지 않은 범위가 지정된 기존 애플리케이션 변환 지원 ORServiceNow SDK를 사용하여 ServiceNow IDE 만들어지지 않은 범위가 지정된 기존 애플리케이션 변환 지원
    ServiceNow Fluent 전체 지원 전체 지원
    JavaScript 모듈 및 타사 라이브러리 전체 지원 전체 지원

    애플리케이션 구조

    소스 코드 파일 및 ServiceNow SDK 메타데이터 XML 파일을 사용하거나 사용하여 만든 사용자 지정 범위가 지정된 애플리케이션입니다ServiceNow IDE. package.json 및 now.config.json 파일은 애플리케이션 구조를 정의하며, 이는 Node.js 애플리케이션 또는 노드 패키지 관리자(npm) 패키지의 구조와 유사합니다.

    그림 1. 에서 작성된 애플리케이션의 기본 구조 ServiceNow IDE
    에서 작성된 애플리케이션의 구조 ServiceNow IDE

    기본적으로 애플리케이션에는 다음과 같은 디렉터리와 파일이 포함됩니다. now.config.json 파일에서 필요에 맞게 애플리케이션 구조의 특정 측면을 수정할 수 있습니다.

    .지금
    빌드 및 배포 프로세스에 대한 캐싱 및 메트릭 정보를 포함하는 디렉터리입니다.
    DIST/앱
    패키징할 빌드 아티팩트가 포함된 디렉터리입니다.
    메타데이터

    테이블 스키마 및 비즈니스 규칙과 같은 애플리케이션의 애플리케이션 메타데이터(XML)가 포함된 디렉터리로, 기존 ServiceNow 애플리케이션과 동일한 디렉터리 구조로 구성되어 있습니다.

    주:
    애플리케이션 메타데이터는 XML 파일에서 편집하면 안 됩니다. 소스 코드 또는 에서 Now Platform애플리케이션 메타데이터를 편집합니다.
    node_modules
    애플리케이션이 종속된 외부 공급업체 Node.js 모듈이 포함된 디렉터리입니다.
    src
    예제 파일을 포함하여 애플리케이션의 소스 코드가 포함된 디렉터리입니다. 이 디렉토리에는 다음 하위 디렉토리가 포함됩니다.
    • fluent: .now.ts 파일에 코드를 포함하는 ServiceNow Fluent 디렉터리입니다. 생성된 하위 디렉토리에는 로 ServiceNow Fluent변환된 애플리케이션 파일이 포함되어 있습니다.
    • server: .js 또는 .ts 파일에 JavaScript 모듈 코드를 포함하는 디렉터리입니다.
    대상
    인스턴스에 업로드할 배포 가능 패키지가 포함된 디렉터리입니다.
    .eslintrc.json
    ESLint 구성을 포함하는 파일입니다. ESLint는 애플리케이션 코드의 문제를 식별하고 수정하는 데 도움이 됩니다.
    .gitignore
    Git에서 무시할 디렉터리 또는 파일 목록이 포함된 파일입니다. 이러한 파일은 소스 제어에서 추적되지 않습니다.
    now.config.json
    애플리케이션 구성을 포함하는 ServiceNow 파일입니다. now.config.json 파일은 애플리케이션의 기본 디렉터리에 있어야 합니다.
    다음 매개변수를 추가하여 애플리케이션의 디렉터리 구조를 구성할 수 있습니다. 예: 
    {
  "scope": "x_snc_example_app",
  "scopeId": "2f8400eb07426110f736e28f69d3017a",
  "name": "ExampleApp"
  "metadataDir": "metadata",
  "appOutputDir": "dist/app",
  "fluentDir": "src/fluent",
  "serverModulesDir": "src/server",
  "modulePaths": {
      "src/server/*.ts": "dist/server/*.js",
    },
  "ignoreTransformTableList": ["ua_table_licensing_config", "sys_embedded_help_role"]
}
    표 1. 지원되는 now.config.json 매개변수
    매개변수 설명
    메타데이터 디렉터리 애플리케이션의 메타데이터를 XML 파일로 포함하는 디렉터리입니다.

    기본값: metadata
    appOutputDir 애플리케이션을 빌드할 때 패키징할 빌드 아티팩트를 출력할 디렉터리입니다.

    기본값: dist/app
    fluentDir 소스 코드에서 애플리케이션 메타데이터를 정의하는 Fluent 파일(.now.ts)이 포함된 ServiceNow 디렉터리입니다.

    기본값: src/fluent
    서버모듈디렉터리 서버측 스크립트에서 사용하기 위해 JavaScript 모듈로 빌드할 JavaScript 또는 TypeScript 파일이 포함된 디렉터리입니다.

    기본값: src/server
    모듈 경로 모듈의 소스 디렉터리를 모듈의 출력 디렉터리에 매핑합니다. 이 매개변수는 TypeScript 소스 파일을 JavaScript 모듈로 컴파일하는 데 사용됩니다. 자세한 내용은 JavaScript 모듈에서 TypeScript 사용 ServiceNow SDK 문서를 참조하십시오.

    tsconfigPath 매개변수를 사용하는 경우에는 이 매개변수가 필요하지 않습니다.
    tsconfig경로 애플리케이션의 tsconfig.json 파일이 기본 디렉터리에 없는 경우 해당 파일의 경로입니다. 예: './src/tsconfig.json'.

    modulePaths 매개 변수를 사용하는 경우에는 이 매개 변수가 필요하지 않습니다.
    ignoreTransformTableList 애플리케이션 메타데이터를 소스 코드로 변환할 때 무시해야 하는 테이블입니다.
    package-lock.json
    종속성 및 해당 버전에 대한 전체 정보를 포함하는 자동 업데이트된 파일입니다. 이 파일은 .ServiceNow SDK
    package.json

    애플리케이션 및 사용자 지정 또는 외부 공급업체 모듈 의존성에 대한 정보가 포함된 파일입니다. package.json 파일은 애플리케이션의 기본 디렉터리에 있어야 합니다. 인스턴스에서 package.json 경로는 사용자 지정 애플리케이션 기록[sys_app]의 패키지 JSON 필드에 <scope>/<package-name>/<version>/package.json 형식으로 지정됩니다.

    tsconfig.json

    TypeScript 파일을 JavaScript 모듈로 컴파일하고 유형 정의를 위해 TypeScript 구성 및 옵션을 포함하는 파일입니다.

    관련 애플리케이션 및 기능

    JavaScript API
    애플리케이션의 기능을 변경하거나 애플리케이션을 생성할 때 작성하는 스크립트에 JavaScript API를 사용합니다.