튜토리얼 4부: 타사 라이브러리 설치 및 사용

노드 패키지 관리자(npm)에서 타사 라이브러리를 설치하고 JavaScript 모듈에서 사용합니다.

시작하기 전에

다음을 완료합니다. 자습서 3부: 코드로 ServiceNow Fluent 테이블 정의.

필요한 역할: 관리자

이 태스크 정보

타사 라이브러리를 설치하면 JavaScript 모듈의 기존 오픈 소스 기능을 사용하여 애플리케이션 개발을 가속화할 수 있습니다. 그런 다음 index.now.ts 파일의 비즈니스 규칙과 같이 소스 코드의 서버 측 스크립트 정의에서 타사 코드를 호출하는 JavaScript 모듈을 참조할 수 있습니다.

이 예에서는 Lodash 라이브러리를 설치하여 일반적인 JavaScript 유틸리티 및 메서드를 가져옵니다. 샘플 JavaScript 모듈의 showStateUpdate 함수에서 이러한 메서드 중 하나인 snakeCase를 사용하여 공백 대신 밑줄로 단어를 구분하는 메시지 문자열을 snake case로 표시합니다. index.now.ts 파일에서 샘플 비즈니스 규칙은 해당 스크립트에 showStateUpdate 함수를 사용하고 할 일 항목 [x_snc_hello_world_to_do] 테이블에서 기록이 업데이트된 후 실행되도록 구성됩니다.

프로시저

1. 애플리케이션의 Lodash 라이브러리에서 snakeCase 메서드를 설치합니다.
   1. 활동 표시줄에서 파일 탐색기 보기( )를 선택합니다.
   2. 애플리케이션의 package.json 파일을 엽니다.
   3. devDependencies 필드 뒤에 패키지 이름과 라이브러리 버전이 포함된 dependencies 필드를 추가합니다.

      },
          "dependencies": {
              "lodash.snakecase": "4.1.1"
          }
      }

   4. JavaScript 모듈에서 TypeScript를 사용하는 애플리케이션의 경우 lodash.snakecase 유형을 devDependencies 필드에 추가하여 라이브러리에 대한 유형 주석을 가져옵니다.

      "devDependencies": {
              "@types/lodash.snakecase": "4.1.1",
              "typescript": "5.5.4",
              "@servicenow/sdk": "2.2.4",
              "@servicenow/glide": "26.0.1",
              "eslint": "8.50.0",
              "@servicenow/eslint-plugin-sdk-app-plugin": "2.2.4"
          }

   5. 변경 내용을 저장합니다.
   6. 메시지가 표시되면 누락된 종속성 설치를 선택합니다.
      팁:

      종속성 설치 아이콘(종 )을 선택하거나 명령 팔레트에서 패키지 관리자: 종속성 설치 명령을 사용할 수도 있습니다.

      

      라이브러리는 node_modules 디렉터리에 모듈로 설치됩니다.
2. 애플리케이션의 JavaScript 모듈에서 Lodash 라이브러리의 코드를 사용합니다.
   1. 애플리케이션의 src/server 디렉터리로 이동합니다.
   2. 샘플 모듈script.ts 엽니다.
   3. addInfoMessage 메서드에서 Lodash의 snakeCase 메서드에 메시지 문자열을 래핑하여 스네이크 대/소문자로 변환합니다.

      gs.addInfoMessage(snakeCase(`state updated from "${previousState}" to "${currentState}"`))

   4. 2행에서 lodash 모듈의 snakeCase 메서드에 대한 가져오기를 추가합니다.

      import snakeCase from 'lodash.snakecase'

      주:

      모듈 코드에서 addInfoMessage 와 같은 메서드를 사용할 수 있도록 전역 Glide API도 가져옵니다.

      import { gs } from '@servicenow/glide'

   5. 변경 내용을 저장합니다.
3. 상태 표시줄에서 빌드 및 설치를 선택합니다.

   설치가 성공적으로 완료되면 Lodash 라이브러리가 EcmaScript 모듈 [sys_module] 테이블에 추가되고 script.ts 모듈이 EcmaScript 모듈 [sys_module] 테이블에서 업데이트됩니다.

결과

할 일 항목 [x_snc_hello_world_to_do] 테이블의 기록에 있는 필드를 업데이트하면 샘플 비즈니스 규칙이 실행되어 메시지가 스네이크 케이스로 표시되며 단어는 공백 대신 밑줄로 구분됩니다.

다음에 수행할 작업

계속 진행합니다 튜토리얼 5부: 다른 인스턴스에서 애플리케이션 클론.