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

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 2 minutes de lecture

    • Pour intégrer une ServiceNow instance, une application de transporteur tierce doit inclure 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 fournir les détails relatifs au transporteur.

    Prenez en compte les éléments suivants lorsque vous créez le script include :
    • Assurez-vous que le script include 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 depuissur 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 client en fonction du ServiceNow 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: ‘’
}
	]

    Structure du script include ITAMShipmentIntegration

    Script include ITAM Shipment Integration

    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 appelle la fonction de post-traitement.

    Fonction processResponse

    Remarque :
    L’application Gestion des ressources informatiques définit la logique métier au sein de cette fonction et elle ne doit pas être modifiée.
    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 relatifs au transporteur suivants :
    • 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