Gestion des expéditions d’actifs d’entreprise

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 2 minutes de lecture

    • Suivez et gérez vos expéditions d’actifs d’entreprise en temps réel en intégrant l’application Gestion des actifs d'entreprise à des transporteurs tiers à l’aide de l’infrastructure d’intégration Gestion des actifs IT .

    Vue d’ensemble de l’intégration du transporteur.

    Prérequis

    Avant de pouvoir intégrer l’application Gestion des actifs d'entreprise à un transporteur tiers, ce dernier doit remplir les conditions préalables suivantes :
    • Activer l’accès entre périmètres sur leur application tierce.
    • Créez un include de script qui étend le script ITAMShipmentIntegration de base afin de pouvoir vous connecter à l’application tierce et récupérer les détails de l’expédition en temps réel.
      • L’include de script doit être disponible dans le périmètre de l’application Gestion des actifs IT . Toutefois, l’accès pour l’appelant n’est pas restreint et les champs Accessible depuis doivent être disponibles dans Tous les périmètres de l’application.
      • La logique métier doit être implémentée dans la fonction fetchShipmentinfo pour permettre la communication avec l’API du transporteur en fonction des numéros de suivi. L’API du transporteur est requise pour se connecter à l’application tierce et pour récupérer les détails de l’expédition.
      • La fonction fetchShipmentinfo doit renvoyer un objet JSON avec le code de réponse HTTP et le message suivants :
        {
httpResponseCode: 200, httpResponseMessage: ‘SUCCESS’
}
      • Lorsque l’include de script est en mode test, le transporteur appelle l’API du transporteur pour valider votre connexion à son application tierce. Le transporteur peut alors soit vérifier et renvoyer la réponse, soit interroger les envois et invoquer la fonction processResponse en utilisant le format de réponse suivant :
        [
{
trackingNumber: ‘’,
deliveryDate: ‘’,
pickupDate: ‘’,
packageStatus: ‘’.
statusDetail: ‘’,
trackingURL: ‘’,
parcelWeight: ‘’,
deliveryServicesCost: ‘’,
currency: ‘’
}
	]
        Si le transporteur invoque la fonction processResponse, il doit renvoyer la réponse une fois la fonction terminée.
    • Créez un profil d’intégration avec le nom approprié, les détails de l’API du transporteur et les détails de connexion. Ce profil d’intégration vous permet de vous connecter à l’application tierce afin de récupérer les détails de l’expédition.
    • Si l’application tierce utilise la table Informations d’identification [discovery_credentials] ou toute autre ServiceNow table avec des ServiceNow champs Password2, fournissez une politique de carte d’accès KMF pour permettre l’accès à ces tables. Pour plus d’informations sur les stratégies de carte d’accès KMF, reportez-vous à la section Password2 encryption with the Key Management Framework (KMF).
    Une fois que le transporteur a rempli ces conditions préalables, vous devez remplir ces conditions préalables supplémentaires :
    • Si le profil d’intégration contient des détails de connexion via un alias de connexion et d’informations d’identification, mettez à jour ces détails si nécessaire afin de pouvoir vous authentifier et vous connecter à l’API de l’opérateur.
    • Associez le transporteur au profil d’intégration.