를 사용하여 애플리케이션 생성 ServiceNow SDK

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기6분
  • 범위가 지정된 애플리케이션을 생성하거나 하여 소스 코드에서 ServiceNow SDK개발하십시오.

    시작하기 전에

    필요한 역할: 관리자

    이 태스크 정보

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

    프로시저

    1. 애플리케이션을 추가할 디렉터리에서 시스템의 명령줄 도구를 엽니다.
    2. create 명령을 사용하여 안내 프롬프트 세트에 따라 애플리케이션을 생성합니다.
      now-sdk create
      주:
      create 명령을 사용하여 파라미터를 수동으로 지정하려면 --interactive 파라미터를 false로 설정하고 필요한 범위 이름 및 애플리케이션 이름 파라미터를 제공합니다. 자세한 내용은 ServiceNow SDK CLI 항목에서 create 명령을 참조하십시오.
    3. 다음과 같은 일련의 프롬프트에 응답합니다.
      표 1. 만들기 명령에 대한 대화형 프롬프트
      프롬프트 설명
      인스턴스에 연결 인스턴스를 인증하고 애플리케이션을 생성하는 동안 제공하는 애플리케이션 범위가 유효한지 확인할지 여부에 대한 옵션입니다.
      • 예: 애플리케이션이 로컬로 작성되기 전에 범위 이름의 유효성이 검증됩니다.
      • 아니요: 생성 중에 범위 이름의 유효성이 확인되지 않으므로 인스턴스에 배포하기 전에 범위 이름이 유효한지 확인해야 합니다.
      인스턴스 자격 증명 인스턴스에 인증하기 위해 자격 증명을 만들거나 선택하는 옵션입니다. 자격 증명을 추가하려면 다음 단계를 완료하십시오.
      1. 새 자격 증명 추가를 선택합니다.
      2. 다음과 같은 일련의 프롬프트에 응답합니다.
        • 애플리케이션 배포를 위한 대상 호스트는< 인스턴스 URL입니다>
        • 인스턴스로 인증할 사용자 이름: <username>
        • 인스턴스로 인증하기 위한 암호: <password>
        • 이 자격 증명에 대한 별칭: <alias>

      자격 증명을 이미 구성한 경우 기존 별칭 및 연결된 인스턴스 목록에서 선택할 수 있습니다.

      ServiceNow 애플리케이션의 이름 애플리케이션의 이름입니다.
      NPM 패키지 이름 package.json 파일에 사용되는 애플리케이션 패키지의 이름입니다.

      패키지 이름은 NPM 패키지 명명 표준을 준수해야 합니다.

      sys_app과 관련된 설명 애플리케이션에 대한 짧은 설명입니다.
      범위 이름 애플리케이션의 범위입니다.

      범위 이름은 인스턴스에서 고유해야 하며, x_<prefix>로 시작해야 하고, 18자 이하여야 합니다. 자세한 내용은 네임스페이스 식별자 문서를 참조하십시오.

      프로젝트 템플릿 모듈에서 JavaScript 또는 TypeScript를 사용할지 여부를 지정하는 옵션입니다. 이 옵션은 package.jsonnow.config.json 파일의 구성을 결정하고 TypeScript 프로젝트에 대한 tsconfig.json 파일을 추가합니다.
      • 자바스크립트: 응용 프로그램은 src / server 디렉토리에서 모듈로 .js 파일을 빌드하도록 구성되어 있습니다.
      • 타입스크립트: 애플리케이션은 src/server 디렉터리에서 모듈로 .ts 파일을 빌드하도록 구성되어 있습니다.
      Fluent 또는 JS 모듈 프로젝트 구조? 기본 애플리케이션 구성을 결정하는 애플리케이션의 유형입니다.
      • 유창한: 기본 애플리케이션 구성은 , JavaScript 모듈 및 타사 라이브러리를 사용하도록 ServiceNow Fluent설정되어 있습니다.
      • 모듈: 기본 애플리케이션 구성은 JavaScript 모듈 및 타사 라이브러리만 사용하도록 설정되어 있습니다.
      애플리케이션에 샘플 테이블을 추가하시겠습니까? 애플리케이션에서 샘플 테이블을 생성하기 위한 옵션입니다.
      • 예: <scope>_to_do 라는 샘플 테이블이 생성됩니다.
      • 아니요: 애플리케이션에 샘플 테이블이 생성되지 않았습니다.
      애플리케이션을 즉시 배포하시겠습니까? 애플리케이션을 만든 직후 인스턴스에 배포하는 옵션입니다.
      • 예: 애플리케이션이 성공적으로 생성되면 인스턴스에 배포됩니다. 오프라인 상태인 경우 애플리케이션이 배포되지 않습니다.
      • 아니요: 애플리케이션이 로컬에서 생성되지만 인스턴스에 배포되지는 않습니다. 나중에 애플리케이션을 빌드하고 인스턴스에 배포해야 합니다. 자세한 내용은 다음을 사용하여 애플리케이션 빌드 및 배포 ServiceNow SDK 문서를 참조하십시오.
      $ now-sdk create
      [now-sdk] Bootstrapping a new ServiceNow application project...
      ==========================================
      
      Create nowSDK Application
      
      ==========================================
      
      ? Connect to an instance (helps ensure the created app is valid)?  yes
      [now-sdk] Listing all credentials: 
      ? Instance credentials:  Add new credentials
      ? Target host for application deployment https://<instance>.service-now.com
      [now-sdk] Authenticating to instance "https://<instance>.service-now.com".
      ? The username to authenticate with the instance admin
      ? The password to authenticate with the instance
      [now-sdk] Attempting to log into instance https://<instance>.service-now.com as admin.
      [now-sdk] Successfully authenticated to instance https://<instance>.service-now.com.
      [now-sdk] Storing credentials for instance "https://<instance>.service-now.com" with alias undefined.
      ? Alias for these credentials devuser2
      [now-sdk] Successfully stored credentials for instance "https://<instance>.service-now.com" with alias undefined.
      ? Name of ServiceNow Application:  My Example App
      ? NPM package name:  my-example-app
      ? Description associated with sys_app:  A custom ServiceNow application
      ? Scope name:  x_snc_myexapp
      ? Project template:  Javascript
      ? Fluent or JS Module project structure?  Fluent
      ? Add a sample table to the application?  yes
      ? Deploy application immediately?  yes

    결과

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

    애플리케이션이 빌드되어 인스턴스에 배포된 경우 CLI는 애플리케이션에 대한 URL을 반환합니다(예: https://myinstance.service-now.com/sys_app.do?sys_id=<sysID>).

    다음에 수행할 작업

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