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

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 읽기7분

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

    개요

    에서 또는 Desktop에서 로컬로 를 사용하여 ServiceNow IDENow Platform 코드에서 범위가 지정된 응용 프로그램을 만들 수 있습니다ServiceNow SDK.Visual Studio Code

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

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

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

    ServiceNow IDE 와 비교ServiceNow SDK

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

    소스 통제의 애플리케이션에 대해 다른 개발자와 공동 작업을 합니다.

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

    소스 통제의 애플리케이션에 대해 다른 개발자와 공동 작업을 합니다.
    소스 통제 가장 일반적인 Git 기능을 지원하고 선택한 Git 공급자와 통합합니다.

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

    		 전체 지원
    애플리케이션 변환 또는 ServiceNow SDK로 만든 ServiceNow IDE 범위가 지정된 애플리케이션만 지원합니다.

    변환된 응용 프로그램은 ServiceNow IDE.

    		 또는 ServiceNow SDK로 생성 ServiceNow IDE 되지 않은 기존 범위가 지정된 애플리케이션 변환 지원
    ServiceNow Fluent 전체 지원 전체 지원
    JavaScript 모듈 및 타사 라이브러리 전체 지원 전체 지원

    애플리케이션 구조

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

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

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

    테이블 스키마, 비즈니스 규칙 등 기존 ServiceNow 애플리케이션과 동일한 디렉터리 구조로 구성된 애플리케이션의 애플리케이션 메타데이터(XML)를 포함하는 디렉터리입니다.

    주:
    애플리케이션 메타데이터는 XML 파일에서 편집하면 안 됩니다. 소스 코드 또는 Now Platform.
    node_modules
    애플리케이션이 의존하는 타사 Node.js 모듈이 포함된 디렉터리입니다.
    소스
    예제 파일을 포함하여 응용 프로그램의 소스 코드를 포함하는 디렉터리입니다. 이 디렉터리에는 다음과 같은 하위 디렉터리가 포함되어 있습니다.
    • fluent: 애플리케이션 메타데이터(.now.ts)를 정의하기 위한 소스 코드 파일이 포함된 디렉터리입니다. 생성된 서브디렉토리에는 로 생성된 ServiceNow Fluent애플리케이션 파일이 포함되어 있습니다.
    • server: 서버 측 스크립트와 함께 사용할 JavaScript 모듈 코드(.js 또는 .ts)가 포함된 디렉터리입니다.
    대상
    인스턴스에 업로드할 배포 가능 패키지가 들어 있는 디렉터리입니다. 이 디렉토리는 ServiceNow SDK.
    .eslintrc.json
    ESLint 구성을 포함하는 파일입니다. ESLint는 응용 프로그램 코드에서 문제를 식별하고 수정하는 데 도움이 됩니다.
    .gitignore
    Git에서 무시할 디렉터리 또는 파일 목록이 포함된 파일입니다. 이러한 파일은 소스 제어에서 추적되지 않습니다.
    now.config.json
    애플리케이션 구성을 포함하는 ServiceNow 파일입니다. now.config.json 파일은 응용 프로그램의 기본 디렉터리에 있어야 합니다.
    다음 매개변수를 추가하여 애플리케이션의 디렉터리 구조를 구성할 수 있습니다. 예: 
    {
  "scope": "x_snc_example_app",
  "scopeId": "2f8400eb07426110f736e28f69d3017a",
  "metadataDir": "metadata",
  "appOutputDir": "dist/app",
  "sourceDir": "src",
  "fluentDir": "src/fluent",
  "serverModulesDir": "src/server", 
  "packOutputDir": "target",
  "transpiledSourceDir": "dist/modules",
  "maxInlineScriptLines": 15,
  "ignoreTransformTableList": ["ua_table_licensing_config", "sys_embedded_help_role"]
}
    표 1. 지원되는 now.config.json 매개변수
    매개변수 설명
    metadataDir 응용 프로그램의 메타데이터를 XML 파일로 포함하는 디렉터리입니다.

    기본값: 메타데이터
    appOutputDir (영문) 애플리케이션을 빌드할 때 패키징할 빌드 아티팩트를 출력할 디렉터리입니다. 이 디렉토리는 ServiceNow SDK.

    기본값: dist/app
    소스 디렉토리 애플리케이션의 소스 코드가 포함된 디렉터리입니다.

    기본값: src
    fluentDir 소스 코드에서 응용 프로그램 메타데이터를 정의하는 Fluent 파일(.now.ts)이 포함된 ServiceNow 디렉터리입니다.

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

    기본값: src/server
    packOutputDir (영문) 애플리케이션을 빌드할 때 인스턴스에 업로드할 zip 파일을 출력할 디렉터리입니다. 이 디렉토리는 ServiceNow SDK.

    기본값: target
    transpiledSourceDir 트랜스파일된 JavaScript 파일이 들어있는 디렉터리입니다.

    기본값: 매개변수의 sourceDir 값
    maxInlineScriptLines 스크립트가 별도의 파일로 자동 이동되기 전에 소스 코드에 script 태그를 사용하여 정의된 인라인 스크립트의 최대 줄 수입니다. 스크립트 파일은 소스 코드의 script 속성에서 참조됩니다.

    기본값: 10
    ignoreTransformTableList (영문) 애플리케이션 메타데이터를 소스 코드로 변환할 때 무시할 테이블입니다.
    package-lock.json
    종속성 및 해당 버전에 대한 전체 정보를 포함하는 자동 업데이트된 파일입니다. 이 파일은 ServiceNow SDK.
    package.json

    애플리케이션 및 사용자 지정 또는 외부 공급업체 모듈 종속성에 대한 정보가 포함된 파일입니다. package.json 파일은 응용 프로그램의 기본 디렉터리에 있어야 합니다.

    관련 애플리케이션 및 기능

    자바스크립트 API
    응용 프로그램의 기능을 변경하기 위해 작성하거나 응용 프로그램을 만들 때 작성하는 스크립트에서 JavaScript API를 사용합니다.