Erstellen einer Integrationsskripteinbindung für Anwendungen von Drittanbietern

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 1 Minute Lesedauer

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

    Berücksichtigen Sie Folgendes, wenn Sie die Skripteinbindung erstellen:
    • Stellen Sie sicher, dass die Skripteinbindung über den Anwendungsbereich Asset-Management Common zugänglich ist, 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 zur Validierung der Verbindung mit der Instanz ServiceNow des Kunden aufgerufen wird, sollte die Rückgabeantwort der Methode fetchShipmentInfo ein JSON-Objekt mit dem HTTP-Antwortcode und der Antwortnachricht sein, wie folgt:
      {
httpResponseCode: 200, httpResponseMessage: ‘SUCCESS’
}
    • Wenn Sie sich nicht im Testmodus befinden, fragen Sie die Lieferungen ab und rufen Sie die Methode processResponse mit dem folgenden Antwortformat auf:
      [
{
trackingNumber: ‘’,
deliveryDate: ‘’,
pickupDate: ‘’,
packageStatus: ‘’.
statusDetail: ‘’,
trackingURL: ‘’,
parcelWeight: ‘’,
deliveryServicesCost: ‘’,
currency: ‘’
}
	]

    Struktur der ITAMShipmentIntegration-Skripteinbindung

    Skripteinbindung für ITAM-Versandintegration

    Funktion „fetchShipmentInfo“.

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

    processResponse-Funktion

    Hinweis:
    Die Anwendung IT Asset Management definiert die Geschäftslogik innerhalb dieser Funktion und sollte nicht geändert werden.
    Die Funktion processResponse empfängt die Antwort von der Transportunternehmen-API und aktualisiert die Versanddatensätze mit den folgenden Details zum Transportunternehmen:
    • Link für Transportunternehmen
    • Status des Transportunternehmens
    • Statusdetail des Transportunternehmens
    • Abholdatum des Transportunternehmens
    • Lieferdatum des Transportunternehmens
    • Währung
    • Lieferservicekosten
    • Paketgewicht