Création d’un include de script d’intégration pour les applications de transporteur tiers

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 2 minutes de lecture

    • Afin de s’intégrer à une ServiceNow instance, une application de transporteur tierce doit avoir un script include qui étend le script ITAMShipmentIntegration de classe de base sur son ServiceNow instance pour recevoir le numéro de suivi de l’expédition de l’instance ServiceNow du client et répondre avec les détails relatifs au transporteur.

    Lors de la création de l’include de script, prenez en compte les éléments suivants :
    • Assurez-vous que l’include de script est accessible à partir du périmètre de l’application Gestion des actifs commun en ajustant les paramètres suivants sur l’enregistrement de ressource d’application :
      • Définissez le champ Accessible depuis sur Tous les périmètres de l’application.
      • Définissez le champ Accès pour l’appelant sur Aucun pour vous assurer que l’accès de l’appelant n’est pas restreint.
    • Le code de communication avec l’instance du ServiceNow client en fonction du numéro de suivi doit être inclus dans la fonction fetchShipmentInfo .
    • Lorsque l’API est invoquée en mode test pour valider la connexion avec l’instance du ServiceNow client, la réponse de retour de la méthode fetchShipmentInfo doit être un objet JSON avec le code de réponse HTTP et le message de réponse, comme suit :
      {
httpResponseCode: 200, httpResponseMessage: ‘SUCCESS’
}
    • Lorsque vous n’êtes pas en mode test, interrogez les expéditions et appelez la méthode processResponse avec le format de réponse suivant :
      [
{
trackingNumber: ‘’,
deliveryDate: ‘’,
pickupDate: ‘’,
packageStatus: ‘’.
statusDetail: ‘’,
trackingURL: ‘’,
parcelWeight: ‘’,
deliveryServicesCost: ‘’,
currency: ‘’
}
	]

    Exemple de codes d’exemple de script include ITAMShipmentIntegration

    Figure 1. Exemple d’include de script ITAMShipmentIntegration avec la fonction processResponse par défaut fournie par l’application Gestion des ressources informatiques
    Script include ITAMShipmentIntegration avec la fonction ITAM processResponse
    Figure 2. Exemple de script include ITAMShipmentIntegration avec fonction processResponse personnalisée
    Script include ITAMShipmentIntegration avec fonction processResponse personnalisée

    Fonction fetchShipmentInfo

    La fonction fetchShipmentInfo reçoit les numéros de suivi de l’instance ServiceNow du client et invoque l’API du transporteur pour récupérer les détails de l’expédition pour tous les numéros de suivi. Dans cette fonction, vous devez définir la logique métier qui permet à vos clients de communiquer avec vos API de transporteur en fonction des numéros de suivi. Cette fonction traite la réponse reçue de l’API du transporteur et invoque la fonction de post-traitement.

    Fonction processResponse

    La fonction processResponse reçoit la réponse de l’API du transporteur et met à jour les enregistrements d’expédition avec les détails suivants relatifs au transporteur :
    • Lien du transporteur
    • État du transporteur
    • Détail sur l'état du transporteur
    • Date de prélèvement du transporteur
    • Date de livraison du transporteur
    • Devise
    • Coût des services de livraison
    • Poids du colis

    Vous pouvez utiliser la fonction processResponse par défaut ou définir une logique personnalisée pour mettre à jour les enregistrements d’expédition.