를 사용하여 애플리케이션 작성 또는 변환 ServiceNow SDK

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 읽기4분
  • 범위가 지정된 응용 프로그램을 만들거나 기존 응용 프로그램을 변환하여 소스 코드로 개발합니다 ServiceNow SDK.

    시작하기 전에

    using npm을 설치하거나 업그레이드합니다 ServiceNow SDK . 자세한 내용은 ServiceNow SDK 설치 또는 ServiceNow SDK 업그레이드 문서를 참조하십시오.

    필요한 역할: admin

    이 태스크 정보

    이 절차에서는 CLI(명령줄 인터페이스)를 ServiceNow SDK 사용합니다. 명령 및 사용 가능한 매개변수에 대한 자세한 내용은 을 참조하십시오 ServiceNow SDK 증권 시세 표시기.

    프로시저

    1. 응용 프로그램을 추가하려는 디렉터리에서 시스템의 명령줄 도구를 엽니다.
    2. ServiceNow SDK시작합니다.
      now-sdk
      ServiceNow SDK 사용 가능한 명령에 대한 정보를 반환합니다.
      팁:
      명령에 대한 추가 정보를 보려면 명령과 --help 또는 -h 매개 변수를 입력합니다. 예: now-sdk auth --help.
    3. 비프로덕션 ServiceNow 인스턴스에 인증합니다.
      인스턴스는 릴리스에 Xanadu 있어야 합니다.
      1. auth 명령과 함께 별칭을 사용하여 사용자 자격 증명을 저장합니다.
        now-sdk auth save [<alias>] [--host <instance url>] [--username <admin username>]

        자격 증명은 시스템의 장치 키체인 또는 자격 증명 관리자에 저장됩니다.

        이 별칭을 기본 별칭으로 설정하려면 명령에 --default 또는 -d 파라미터를 추가합니다.

        예:
        now-sdk auth save devuser1 --host https://myinstance.service-now.com --username user1 --default
      2. 프롬프트에서 암호를 입력합니다.
    4. 범위가 지정된 애플리케이션을 작성하거나 기존 애플리케이션을 .ServiceNow SDK
      옵션단계
      범위가 지정된 애플리케이션 생성
      1. create 명령을 사용하여 안내 프롬프트 세트에 따라 애플리케이션을 생성합니다.
        now-sdk create <scopeName> --interactive
        예:
        now-sdk create x_snc_example --interactive
        주:
        범위 이름은 인스턴스에서 고유해야 하고, x_<prefix>로 시작해야 하며 12자 이하여야 합니다. 자세한 내용은 네임스페이스 식별자 문서를 참조하십시오.
      2. 다음 프롬프트에 응답합니다.
        • 범위가 지정된 애플리케이션의 이름: <애플리케이션 이름>
        • sys_app과 관련된 설명: <description>
        • 프로젝트 템플릿이란 무엇입니까? TypeScript 또는 JavaScript 선택
        • NPM 패키지 이름: <package name>
        • 애플리케이션에 샘플 테이블을 추가하시겠습니까? [예/아니오]
        • Fluent 또는 JS 모듈 프로젝트 구조를 만드시겠습니까? Fluent 또는 모듈 선택

          이 옵션은 응용 프로그램에서 JavaScript 모듈 및 타사 라이브러리를 사용 ServiceNow Fluent 할지(fluent) 또는 JavaScript 모듈 및 타사 라이브러리만 사용할지(module)에 따라 기본 응용 프로그램 구조를 결정합니다.

      기존 애플리케이션 변환 convert 명령을 사용하여 인스턴스에서 범위가 지정된 기존 애플리케이션을 변환합니다.
      now-sdk convert <scopeName> <packageName> --projectType <type>

      --projectType 파라미터를 사용하여 생성할 애플리케이션의 유형을 지정합니다. 이 옵션은 응용 프로그램에서 JavaScript 모듈 및 타사 라이브러리를 사용 ServiceNow Fluent 할지(fluent) 또는 JavaScript 모듈 및 타사 라이브러리만 사용할지(module)에 따라 기본 응용 프로그램 구조를 결정합니다.

      예:
      now-sdk convert x_snc_example example-app --projectType fluent

      응용 프로그램을 변환하면 로컬에서 사용하는 ServiceNow SDK 데 필요한 파일과 디렉터리가 추가되고 프로젝트 형식에 따라 응용 프로그램 메타데이터 ServiceNow Fluent 가 소스 코드 또는 XML 파일로 다운로드됩니다. 애플리케이션은 인스턴스에서 변경되지 않습니다.

    결과

    기본 애플리케이션 구조로 범위가 지정된 애플리케이션은 로컬에서 사용할 수 있습니다. 응용 프로그램 구조에 대한 자세한 내용은 소스 코드로 응용 프로그램 빌드 항목의 애플리케이션 구조 섹션을 참조하십시오.

    애플리케이션이 빌드되어 인스턴스에 배포된 경우 CLI는 애플리케이션에 대한 URL을 반환합니다(예시: https://myinstance.service-now.com/sys_app.do?sys_id=<sysID>. 생성 중에 인스턴스에서 애플리케이션을 빌드 및 등록하지 않기로 선택한 경우 그렇게 할 때까지 애플리케이션이 인스턴스에 배포되지 않습니다. 자세한 내용은 를 사용하여 응용 프로그램을 빌드하고 배포합니다. ServiceNow SDK 문서를 참조하십시오.

    다음에 수행할 작업

    Visual Studio Code, 를 사용하여 ServiceNow Fluent소스 코드로 애플리케이션 개발을 시작하거나, 사용자 지정 JavaScript 모듈을 작성하거나, 타사 라이브러리를 추가합니다.