ServiceNow SDK 증권 시세 표시기

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 소요 시간: 11분

    • 명령줄 인터페이스(CLI)를 ServiceNow SDK 사용하여 로컬 애플리케이션과 인스턴스의 애플리케이션 간 변경 사항을 관리합니다.

    시스템의 명령줄 도구에서 now-sdk 를 입력하여 CLI를 시작하고 사용 가능한 명령 목록을 반환하거나 now-sdk [command] 를 ServiceNow SDK사용하여 .

    CLI에는 다음 명령과 전역 옵션이 포함되어 있습니다.

    표 1. 전역 옵션
    옵션 설명
    --버전 CLI의 버전을 반환합니다.
    --도움, -h 명령, 부속 명령 및 매개변수에 대한 정보를 반환합니다.

    업그레이드

    릴리스의 인스턴스에 사용할 최신 버전으로 업그레이드합니다 ServiceNow SDKXanadu .

    업그레이드해도 ServiceNow SDK 이전에 만들었거나 .ServiceNow SDK

    upgrade 명령의 구조는 다음과 같습니다.
    now-sdk upgrade [--debug <flag>]
    표 2. 선택적 매개변수
    매개변수 유형 설명 기본값
    --디버그, -d 부울 업그레이드 프로세스 중에 생성된 디버그 로그를 반환하는 옵션입니다. 거짓
    예:
    now-sdk upgrade --debug true

    인증

    인스턴스로 인증하고 시스템의 인스턴스에 액세스하기 위한 사용자 자격 증명을 저장, 업데이트 또는 확인합니다.

    auth 명령에는 save, clear, list 및 set-default 하위 명령과 다음 구조가 있습니다.
    now-sdk auth [<subcommand>]

    저장

    시스템의 장치 키체인 또는 자격 증명 관리자에 자격 증명을 저장합니다. 프롬프트에서 인스턴스에 인증하기 위한 암호를 입력합니다.

    save 부속 명령의 구조는 다음과 같습니다.
    now-sdk auth save [<alias>] [--host <hostname>] [--username <username>] [--default]
    표 3. 필수 매개변수
    매개변수 유형 설명 기본값
    별칭 문자열 호스트 및 사용자 자격 증명의 고유 식별자입니다.

    별명은 create, convert, fetch 및 deploy 명령을 사용한 인증에 사용할 수 있습니다.

    		 —
    --호스트 문자열 액세스할 대상 인스턴스이며 애플리케이션을 배포하고 가져올 대상 인스턴스입니다. 인스턴스는 릴리스에 Xanadu 있어야 합니다. —
    --사용자 이름 문자열 Now Platform 인스턴스에 인증할 사용자 이름입니다. 사용자에게 관리자 액세스 권한이 있어야 합니다. —
    표 4. 선택적 매개변수
    매개변수 유형 설명 기본값
    --기본값, -d 부울 별칭을 기본 별칭으로 설정하는 옵션입니다. 거짓

    예:

    now-sdk auth save devuser1 --host https://myinstance.service-now.com --username user1 --default

    지우기

    시스템의 장치 키체인 또는 자격 증명 관리자에서 자격 증명을 제거합니다.

    clear 부속 명령의 구조는 다음과 같습니다. 
    now-sdk auth clear [<alias>]
    표 5. 선택적 매개변수
    매개변수 유형 설명 기본값
    별칭 문자열 호스트 및 사용자 자격 증명의 고유 식별자입니다. 모두
    예:
    now-sdk auth clear devuser1

    목록

    시스템의 장치 키체인 또는 자격 증명 관리자에 저장된 자격 증명을 봅니다. 암호는 반환되지 않습니다.

    list 부속 명령의 구조는 다음과 같습니다. 
    now-sdk auth list [<alias>]
    표 6. 선택적 매개변수
    매개변수 유형 설명 기본값
    별칭 문자열 호스트 및 사용자 자격 증명의 고유 식별자입니다. 모두
    예:
    now-sdk auth list devuser1

    set-default (기본값 설정)

    기본적으로 명령에서 사용할 자격 증명을 설정합니다.

    set-default 부속 명령의 구조는 다음과 같습니다. 
    now-sdk auth set-default [<alias>]
    표 7. 필수 매개변수
    매개변수 유형 설명 기본값
    별칭 문자열 호스트 및 사용자 자격 증명의 고유 식별자입니다. —
    예:
    now-sdk auth set-default devuser1

    생성

    사용자 지정 범위가 지정된 애플리케이션을 만들고, 지정된 경우 인스턴스에 배포합니다.

    create 명령의 구조는 다음과 같습니다.
    now-sdk create <scopeName> <directory> [--appName <name>] [--packageName <name>] [--description <description>] [--sampleTable <flag>] [--offline <flag>] [--auth <alias>] [--interactive <flag>] [--open-browser <flag>] [--projectType <type>] [--template <type>]
    표 8. 필수 매개변수
    매개변수 유형 설명 기본값
    scopeName 문자열 애플리케이션의 범위입니다.

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

    		 —
    디렉터리 문자열 애플리케이션 디렉터리와 파일을 만들 로컬 디렉터리입니다. 현재 작업 디렉터리
    표 9. 선택적 매개변수
    매개변수 유형 설명 기본값
    --appName 문자열 애플리케이션의 이름입니다. —
    --패키지 이름 문자열 package.json 파일에 사용되는 애플리케이션 패키지의 이름입니다.

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

    		 —
    --묘사 문자열 애플리케이션에 대한 간단한 설명입니다. —
    --샘플 테이블 부울 애플리케이션에서 샘플 테이블을 만들기 위한 옵션입니다.

    예일 경우 <scope>_to_do라는 샘플 테이블이 작성됩니다.

    		 거짓
    --오프라인, -o 부울 인스턴스에 애플리케이션 배포를 건너뛰는 옵션입니다.

    예일 경우 범위 이름을 만드는 동안 유효성이 검사되지 않으므로 인스턴스에 배포하기 전에 범위 이름이 유효한지 확인해야 합니다.

    주:
    auth 매개변수가 설정되면 이 매개변수는 무시됩니다.
    		 거짓
    --인증, -a 문자열 인스턴스를 인증하는 데 사용할 자격 증명의 별칭입니다. 설정된 경우 기본 별칭입니다.
    --대화형, -i 부울 애플리케이션을 생성하기 위한 안내 프롬프트 세트에 응답하는 옵션입니다. 거짓
    --브라우저 열기, -b 부울 애플리케이션을 성공적으로 배포한 후 기본 브라우저에서 애플리케이션 기록을 여는 옵션입니다.
    주:
    오프라인 매개변수가 true로 설정되면 이 매개변수는 무시됩니다.
    		 거짓
    --projectType 문자열 생성할 애플리케이션의 유형을 지정하는 옵션입니다. 이 옵션은 응용 프로그램에서 JavaScript 모듈 및 타사 라이브러리를 사용 ServiceNow Fluent 할지(fluent) 또는 JavaScript 모듈 및 타사 라이브러리만 사용할지(module)에 따라 기본 응용 프로그램 구조를 결정합니다. 유창한
    --템플릿, -t 문자열 모듈에서 JavaScript 또는 TypeScript를 사용할지 여부를 지정하는 옵션입니다. 이 옵션은 package.json 및 now.config.json 파일의 구성을 결정하고 TypeScript 프로젝트용 tsconfig.json 파일을 추가합니다. 자바스크립트
    예:
    now-sdk create x_snc_example /path/to/app_folder --appName example-app --description example_app_description --sampleTable true --auth devuser1 --open-browser true --projectType fluent --template typescript

    변환

    에서 로컬 Visual Studio Code 로 수정을 지원하고 에서 애플리케이션 변경 내용을 인스턴스에 ServiceNow SDK배포할 수 있도록 인스턴스에서 기존 애플리케이션을 변환합니다.

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

    convert 명령의 구조는 다음과 같습니다.
    now-sdk convert <scopeName> <packageName> [<directory>] [--auth <alias>] [--projectType <type>] [--template <type>]
    표 10. 필수 매개변수
    매개변수 유형 설명 기본값
    scopeName 문자열 기존 애플리케이션의 범위입니다. —
    패키지 이름 문자열 —
    표 11. 선택적 매개변수
    매개변수 유형 설명 기본값
    디렉터리 문자열 애플리케이션 디렉터리와 파일을 만들 로컬 디렉터리입니다. 현재 작업 디렉터리
    --인증, -a 문자열 인스턴스를 인증하는 데 사용할 자격 증명의 별칭입니다. 설정된 경우 기본 별칭입니다.
    --projectType 문자열 생성할 애플리케이션의 유형을 지정하는 옵션입니다. 이 옵션은 응용 프로그램에서 JavaScript 모듈 및 타사 라이브러리를 사용 ServiceNow Fluent 할지(fluent) 또는 JavaScript 모듈 및 타사 라이브러리만 사용할지(module)에 따라 기본 응용 프로그램 구조를 결정합니다. 유창한
    --템플릿, -t 문자열 모듈에서 JavaScript 또는 TypeScript를 사용할지 여부를 지정하는 옵션입니다. 이 옵션은 package.json 및 now.config.json 파일의 구성을 결정하고 TypeScript 프로젝트용 tsconfig.json 파일을 추가합니다. 자바스크립트

    예:

    now-sdk convert x_snc_example example-app /path/to/app_folder --auth user1-dev --projectType fluent --template typescript

    가져오다

    인스턴스에서 애플리케이션 메타데이터를 다운로드하고 로컬 애플리케이션의 소스 코드 및 메타데이터 파일을 일치하도록 업데이트합니다.

    JavaScript 모듈에 대한 업데이트는 인스턴스에서 애플리케이션 메타데이터를 가져올 때 포함되지 않습니다.

    fetch 명령의 구조는 다음과 같습니다.
    now-sdk fetch [--directory <package path>] [--auth <alias>] [--debug <flag>]
    표 12. 선택적 매개변수
    매개변수 유형 설명 기본값
    --디렉토리 문자열 응용 프로그램의 경로입니다. 현재 작업 디렉터리
    --인증, -a 문자열 인스턴스를 인증하는 데 사용할 자격 증명의 별칭입니다. 설정된 경우 기본 별칭입니다.
    --디버그, -d 부울 가져오기 프로세스 중에 생성된 디버그 로그를 반환하는 옵션입니다. 거짓
    예: 
    now-sdk fetch --auth devuser1 --directory /path/to/package --debug true

    빌드

    소스 파일을 컴파일하고 배포 가능한 패키지를 생성합니다. 타사 라이브러리 종속성은 애플리케이션과 함께 설치할 수 있는 XML 파일로 변환됩니다.

    build 명령의 구조는 다음과 같습니다.
    now-sdk build <source> [--debug <flag>] [--generate-deletes <flag>] [--lint <flag>] [--optimize <flag>]
    표 13. 선택적 매개변수
    매개변수 유형 설명 기본값
    소스 문자열 애플리케이션의 package.json 파일 경로입니다.

    package.json는 응용 프로그램의 기본 디렉터리에 있어야 합니다.

    		 현재 작업 디렉터리
    --디버그, -d 부울 빌드 프로세스 중에 생성된 디버그 로그를 반환하는 옵션입니다. 거짓
    --생성 삭제 부울 빌드 간에 제거된 파일에 대한 삭제 레코드 업데이트를 생성하는 옵션입니다. 예
    --보풀 부울 빌드하기 전에 소스 파일을 린트하는 옵션입니다. 예
    --최적화, -o 부울 변경되지 않은 종속성 XML 파일을 다시 사용하여 패키징을 최적화하는 옵션입니다. 예
    예:
    now-sdk build /path/to/package --debug true --generate-deletes true --lint true --optimize true

    전개시키다

    인스턴스에 응용 프로그램을 배포합니다. deploy 명령을 사용하기 전에 build 명령을 사용하여 배포 가능한 패키지를 생성해야 합니다.

    deploy 명령의 구조는 다음과 같습니다.

    now-sdk deploy [--source <package path>] [--reinstall <flag>] [--auth <alias>] [--open-browser <flag>]
    표 14. 선택적 매개변수
    매개변수 유형 설명 기본값
    --근원 문자열 애플리케이션의 package.json 파일 경로입니다.

    package.json는 응용 프로그램의 기본 디렉터리에 있어야 합니다.

    		 현재 작업 디렉터리
    --다시 설치, -r 부울 인스턴스의 메타데이터가 배포 패키지의 메타데이터와 일치하는지 확인하기 위해 인스턴스에서 애플리케이션을 제거한 후 다시 설치하는 옵션입니다.
    경고:
    인스턴스에 있지만 로컬 애플리케이션에는 없는 메타데이터가 제거됩니다.

    필요하지 않은 EcmaScript Module [sys_module] 테이블에 이전 버전의 모듈이 있는 경우 reinstall 매개 변수(now-sdk deploy --reinstall true)를 사용하여 애플리케이션을 배포하면 테이블에서 이전 버전의 애플리케이션 모듈이 제거됩니다.

    		 거짓
    --인증, -a 문자열 인스턴스를 인증하는 데 사용할 자격 증명의 별칭입니다. 설정된 경우 기본 별칭입니다.
    --브라우저 열기, b 부울 애플리케이션을 성공적으로 배포한 후 기본 브라우저에서 애플리케이션 기록을 여는 옵션입니다. 거짓
    --정보, -i 부울 업데이트된 상태 및 기록 등 이 애플리케이션의 최근 배치에 대한 상세 정보를 반환하는 옵션입니다. 이 매개 변수를 사용하면 애플리케이션이 배포되지 않습니다. 거짓
    예: 
    now-sdk deploy --auth devuser1 --source /path/to/package --reinstall false --open-browser true