ServiceNow SDK를 사용하여 애플리케이션 변환

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 6분

    • 을 사용하여 ServiceNow SDK소스 코드에서 개발을 지원하도록 기존 애플리케이션을 변환합니다.

    시작하기 전에

    을 사용하여 ServiceNow SDK 인스턴스에 인증합니다 ServiceNow . 자세한 내용은 ServiceNow SDK 를 사용하여 인스턴스에 ServiceNow인증 문서를 참조하십시오.

    필요한 역할: 관리자

    이 태스크 정보

    를 사용하여 ServiceNow IDE 생성되지 않았거나 ServiceNow SDK 소스 코드의 개발을 지원하기 위해 변환해야 하는 기존 애플리케이션입니다. 애플리케이션을 변환하면 소스 코드에서 개발하는 데 필요한 파일과 디렉터리가 추가됩니다. 기존 애플리케이션 메타데이터를 코드로 ServiceNow Fluent 변환할지 여부를 선택할 수 있습니다. 인스턴스에 애플리케이션을 빌드하고 설치할 때까지 인스턴스에서 애플리케이션이 변경되지 않습니다.

    이 절차에서는 명령줄 인터페이스(CLI)를 ServiceNow SDK 사용합니다. 명령줄 도구에서 now-sdk --help 를 입력하여 사용 가능한 명령 및 전역 옵션에 대한 정보를 가져옵니다. 명령 및 해당 매개변수에 대한 추가 정보를 보려면 명령과 --help 또는 -h를 입력합니다. 예를 들어 now-sdk auth --help입니다. CLI에 대한 자세한 내용은 다음 문서를 참조하십시오 ServiceNow SDK CLI.

    프로시저

    1. 애플리케이션에 대한 로컬 디렉터리를 생성합니다.
    2. Visual Studio Code에서 디렉터리를 엽니다.
    3. 애플리케이션 디렉터리에서 통합 터미널 창을 엽니다.
    4. init 명령을 사용하여 인스턴스 또는 로컬 디렉터리에서 기존 애플리케이션을 변환합니다.

      --from 매개변수를 사용하여 인스턴스의 애플리케이션 sys_id 또는 소스 코드에서 개발을 지원하도록 변환할 애플리케이션이 포함된 로컬 디렉터리에 대한 경로를 제공합니다.

      npx @servicenow/sdk init --from <sys_id or path>
      예:
      npx @servicenow/sdk init --from aadfdd904748a6500ff14ee4316d4369
      주:
      npx 명령을 사용하면 전역이 아닌 애플리케이션 디렉터리에 설치됩니다ServiceNow SDK.
    5. 프롬프트에서 package.json 파일에 사용되는 애플리케이션 패키지의 이름을 입력합니다.

      패키지 이름은 노드 패키지 관리자(npm) 패키지 명명 표준을 준수해야 합니다.

      다음 예시에서는 인스턴스에서 애플리케이션을 다운로드하고 해당 sys_id 사용하여 변환합니다.
      $ npx @servicenow/sdk init --from aadfdd904748a6500ff14ee4316d4369
[now-sdk] Bootstrapping a new ServiceNow application project...
[now-sdk] Please provide the missing required fields:
? NPM package name:  example-app
[now-sdk] Access Token has expired, refreshing token
[now-sdk] Downloading application package for aadfdd904748a6500ff14ee4316d4369 from https://myinstance.service-now.com
[now-sdk] Unzipping downloaded package...
[now-sdk] Successfully downloaded and unzipped application aadfdd904748a6500ff14ee4316d4369
[now-sdk] Summary of downloaded metadata files
Metadata: 13 (Total: 13)
  Copied To Metadata Directory::
    1. dictionary/x_snc_example_app_mytable.xml
    2. package_inventory.csv
    3. sys_app_aadfdd904748a6500ff14ee4316d4369.xml
    4. update/sys_db_object_7030a5d04748a6500ff14ee4316d4338.xml
    5. update/sys_dictionary_x_snc_example_app_mytable_null.xml
    6. update/sys_documentation_x_snc_example_app_mytable__en.xml
... and 7 more

[now-sdk] Successfully converted application.
[now-sdk] Install the required dependencies with your preferred package manager before running "$now-sdk build".
          Ex: Run "npm install" if using npm.

      이 애플리케이션은 기본 애플리케이션 구조를 사용하여 로컬에서 사용할 수 있으며 소스 코드 개발을 지원합니다. 기존 애플리케이션 메타데이터는 메타데이터 디렉터리에 다운로드됩니다. 응용 프로그램 구조에 대한 자세한 내용은 소스 코드로 응용 프로그램 빌드 항목의 섹션을 참조하십시오 애플리케이션 구조 .

    6. 선호하는 패키지 관리자를 사용하여 필요한 타사 종속성을 설치합니다.
      예를 들어 노드 패키지 관리자(npm)를 사용하는 경우 npm install을 실행합니다.
    7. 옵션: 변환 명령을 사용하여 기존 애플리케이션 메타데이터(XML)를 코드로 ServiceNow Fluent 변환합니다.

      --from 매개변수를 사용하여 코드로 ServiceNow Fluent 변환할 메타데이터 XML이 포함된 로컬 디렉터리 또는 파일에 대한 경로를 제공합니다.

      now-sdk transform [--from <path>] [--directory <package path>] [--preview <flag>] [--auth <alias>]
      팁:
      --preview 매개 변수를 true로 설정하여 변경 내용을 저장하지 않고 명령줄에서 변환된 ServiceNow Fluent 코드를 미리 볼 수 있습니다.
      예:
      now-sdk transform --from metadata/update --auth devuser1
      애플리케이션 메타데이터는 src/fluent/generated 디렉터리의 코드에 ServiceNow Fluent 정의되고 지정된 디렉터리에서 제거됩니다.
      주:
      메타데이터 스냅샷[sys_metadata_link] 및 UX 자산[sys_ux_lib_asset]과 같은 제한된 수의 메타데이터 유형은 코드로 ServiceNow Fluent 표현할 수 없으며 변환되지 않습니다. 이러한 메타데이터 형식은 애플리케이션의 메타데이터 디렉터리에 메타데이터 XML 파일로 남아 있습니다.
    8. build 명령을 사용하여 애플리케이션을 빌드합니다. 
      now-sdk build
    9. 옵션: 설치 명령을 사용하여 인스턴스에서 애플리케이션을 업데이트합니다. 
      now-sdk install --auth <alias>

    결과

    변환된 애플리케이션은 소스 코드에서의 개발을 지원하는 데 필요한 파일 및 디렉터리와 함께 로컬 디렉터리에 추가됩니다. 애플리케이션을 성공적으로 설치하면 인스턴스에서 업데이트됩니다. 애플리케이션 설치에 대한 자세한 내용은 다음 문서를 참조하십시오 ServiceNow SDK 를 사용하여 애플리케이션 및 설치배포. 변환된 애플리케이션을 설치한 후 사용자 지정 애플리케이션 기록[sys_app]의 패키지 JSON 필드에 애플리케이션의 package.json 파일 경로가 포함됩니다.

    애플리케이션을 변환한 후 추가된 새 애플리케이션 메타데이터는 transform 명령을 사용할 때 src/fluent/generated 디렉터리의 소스 코드로 자동 변환됩니다. 메타데이터가 로컬 애플리케이션에 XML과 소스 코드로 존재하는 경우 인스턴스에 설치할 때 XML 버전이 우선합니다.

    다음에 수행할 작업

    Visual Studio Code에서 자세한 를 사용하여 ServiceNow Fluent소스 코드에서 애플리케이션 개발을 시작하고, 사용자 지정 JavaScript 모듈을 작성하거나, 타사 라이브러리를 추가하십시오. 내용은 다음 문서를 참조하십시오ServiceNow SDK를 사용하여 애플리케이션 개발.