외부 운송업체 애플리케이션에 대한 통합 스크립트 포함 생성

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 2분
  • 외부 공급업체 운송업체 애플리케이션에는 인스턴스와 ServiceNow 통합하기 위해 고객의 ServiceNow 인스턴스에서 배송 추적 번호를 받고 운송업체 관련 세부 정보로 응답할 수 있도록 인스턴스의 ServiceNow 기본 클래스 ITAMShipmentIntegration 스크립트를 확장하는 스크립트 포함이 있어야 합니다.

    스크립트 포함을 만들 때 다음 사항을 고려하십시오.
    • 애플리케이션 자원 기록에서 다음 설정을 조정하여 공통 애플리케이션 범위에서 스크립트 포함에 액세스할 수 자산 관리 있는지 확인합니다.
      • 다음에서 접근 가능 필드를 모든 애플리케이션 범위로 설정합니다.
      • 호출자 접근 필드를 없음 으로 설정하여 호출자 접근이 제한되지 않도록 합니다.
    • 추적 번호를 기반으로 고객의 ServiceNow 인스턴스와 통신하는 코드는 fetchShipmentInfo 함수 내에 포함되어야 합니다.
    • 고객 ServiceNow 인스턴스와의 연결을 확인하기 위해 테스트 모드에서 API를 호출하는 경우 fetchShipmentInfo 메서드의 반환 응답은 다음과 같이 HTTP 응답 코드 및 응답 메시지가 있는 JSON 개체여야 합니다.
      {
      httpResponseCode: 200, httpResponseMessage: ‘SUCCESS’
      }
      
    • 테스트 모드가 아닌 경우 배송을 쿼리하고 다음 응답 형식을 사용하여 processResponse 메서드를 호출합니다.
      [
      {
      trackingNumber: ‘’,
      deliveryDate: ‘’,
      pickupDate: ‘’,
      packageStatus: ‘’.
      statusDetail: ‘’,
      trackingURL: ‘’,
      parcelWeight: ‘’,
      deliveryServicesCost: ‘’,
      currency: ‘’
      }
      	]
      

    ITAMShipmentIntegration 스크립트 포함 샘플 코드

    그림 1. 샘플 ITAMShipmentIntegration 스크립트에는 애플리케이션에서 제공하는 IT 자산 관리 기본 processResponse 함수가 포함되어 있습니다.
    ITAM processResponse 함수가 포함된 ITAMShipmentIntegration 스크립트 포함
    그림 2. 샘플 ITAMShipmentIntegration 스크립트에는 사용자 지정 processResponse 함수가 포함되어 있습니다.
    사용자 지정 processResponse 함수가 포함된 ITAMShipmentIntegration 스크립트 포함

    fetchShipmentInfo 함수

    fetchShipmentInfo 함수는 고객 인스턴스에서 추적 번호를 ServiceNow 수신하고 운송업체 API를 호출하여 모든 추적 번호에 대한 배송 상세 정보를 가져옵니다. 이 함수 내에서 고객이 추적 번호를 기반으로 운송업체 API와 통신할 수 있도록 하는 비즈니스 논리를 정의해야 합니다. 이 함수는 이동 통신사 API에서 수신한 응답을 처리하고 후처리 함수를 호출합니다.

    processResponse 함수

    processResponse 함수는 운송업체 API에서 응답을 수신하고 다음과 같은 운송업체 관련 상세 정보로 배송 기록을 업데이트합니다.
    • 운송업체 링크
    • 운송업체 상태
    • 운송업체 상태 상세 정보
    • 운송업체 픽업 날짜
    • 운송업체 배송 날짜
    • 통화
    • 배송 서비스 비용
    • 소포 무게

    기본 processResponse 함수를 사용하거나 사용자 지정 논리를 정의하여 배송 기록을 업데이트할 수 있습니다.