Erstellen einer Integrationsskripteinbindung für Drittanbieteranwendungen von Transportunternehmen

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 1 Minute Lesedauer

    • Zur Integration mit einer Instanz ServiceNow muss die Anwendung eines Drittanbieters über eine Skripteinbindung verfügen, die das Skript der Basisklasse ITAMShipmentIntegration in der Instanz ServiceNow erweitert, um die Sendungsverfolgungsnummer von der Instanz ServiceNow des Kunden zu erhalten und mit dem Transportunternehmen zu antworten -bezogene Details.

    Berücksichtigen Sie beim Erstellen der Skripteinbindung Folgendes:
    • Stellen Sie sicher, dass auf die Skripteinbindung vom Anwendungsbereich Asset-Management Common aus zugegriffen werden kann, indem Sie die folgenden Einstellungen im Datensatz der Anwendungsressource anpassen:
      • Legen Sie das Feld Zugänglich von auf Alle Anwendungsbereiche fest.
      • Legen Sie das Feld Anruferzugriff auf Keine fest, um sicherzustellen, dass der Anruferzugriff nicht eingeschränkt ist.
    • Der Code für die Kommunikation mit der Instanz ServiceNow des Kunden basierend auf der Nachverfolgungsnummer muss in der Funktion fetchShipmentInfo enthalten sein.
    • Wenn die API im Testmodus aufgerufen wird, um die Verbindung mit der Instanz ServiceNow des Kunden zu validieren, muss die zurückgegebene Antwort von der Methode fetchShipmentInfo ein JSON-Objekt mit dem HTTP-Antwortcode und der Antwortnachricht wie folgt sein:
      {
httpResponseCode: 200, httpResponseMessage: ‘SUCCESS’
}
    • Wenn Sie sich nicht im Testmodus befinden, fragen Sie die Sendungen ab, und rufen Sie die Methode processResponse mit dem folgenden Antwortformat auf:
      [
{
trackingNumber: ‘’,
deliveryDate: ‘’,
pickupDate: ‘’,
packageStatus: ‘’.
statusDetail: ‘’,
trackingURL: ‘’,
parcelWeight: ‘’,
deliveryServicesCost: ‘’,
currency: ‘’
}
	]

    Beispielcodes für Skripteinbindung ITAMShipmentIntegration

    Abbildung : 1. Beispiel für eine ITAMShipmentIntegration-Skripteinbindung mit der Standardfunktion processResponse, die von der Anwendung IT Asset Management bereitgestellt wird
    ITAMShipmentIntegration-Skripteinbindung mit der Funktion ITAM processResponse
    Abbildung : 2. Beispiel für eine ITAMShipmentIntegration-Skripteinbindung mit anwenderdefinierter processResponse-Funktion
    ITAMShipmentIntegration-Skripteinbindung mit anwenderdefinierter processResponse-Funktion

    Funktion „fetchShipmentInfo“

    Die Funktion fetchShipmentInfo empfängt die Nachverfolgungsnummern aus der Instanz ServiceNow des Kunden und ruft die API des Transportunternehmens auf, um die Versanddetails für alle Nachverfolgungsnummern abzurufen. Im Rahmen dieser Funktion müssen Sie die Geschäftslogik definieren, die es Ihren Kunden ermöglicht, basierend auf den Nachverfolgungsnummern mit den APIs Ihres Transportunternehmens zu kommunizieren. Diese Funktion verarbeitet die Antwort, die von der Transportunternehmen-API empfangen wird, und ruft die Nachverarbeitungsfunktion auf.

    processResponse-Funktion

    Die Funktion processResponse empfängt die Antwort von der API des Transportunternehmens und aktualisiert die Versanddatensätze mit den folgenden Details des Transportunternehmens:
    • Link für Transportunternehmen
    • Status des Transportunternehmens
    • Statusdetail des Transportunternehmens
    • Abholdatum des Transportunternehmens
    • Lieferdatum des Transportunternehmens
    • Währung
    • Lieferservicekosten
    • Paketgewicht

    Sie können entweder die Standardfunktion processResponse verwenden oder eine anwenderdefinierte Logik definieren, um die Versanddatensätze zu aktualisieren.