Création d’un include de script d’intégration pour les applications des opérateurs tiers

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 2 minutes de lecture

    • Afin de s’intégrer à une ServiceNow instance, une application de transporteur tiers doit avoir un include de script 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 liés au transporteur.

    Lors de la création de l’include de script, tenez compte des points 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 ServiceNow du 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: ‘’
}
	]

    Script include ITAMShipmentIntegration Exemples de codes

    Figure 1. Exemple d’include de script ITAMShipmentIntegration avec la fonction processResponse par défaut fournie par l’application Gestion des actifs IT
    Script include ITAMShipmentIntegration avec ITAM Fonction processResponse
    Figure 2. Exemple d’include de script ITAMShipmentIntegration avec fonction processResponse personnalisée
    Include de script 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 appelle 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 les API de votre 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 liés au transporteur :
    • Lien du transporteur
    • État du transporteur
    • Détail de l'état du transporteur
    • Date de ramassage 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.