ReportCiStatusOutputJS : dans le champ d’application

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 2 minutes de lecture
  • L’API ReportCiStatusOutputJS fournit des méthodes qui renvoient des propriétés d’objet spécifiques pour la méthode reportCiIpAddressStatus de DiscoveryAPI, puis convertit les informations en une chaîne JSON.

    Cette classe s’exécute dans l’espace de noms sn_discovery .

    ReportCiStatusOutputJS : getCiOperationStatus()

    Renvoie l’état du CI analysé.

    Il s’agit d’un champ calculé basé sur le champ last_state de discovery_device_history table et le champ d’état dans la table discovery_status.

    Tableau 1. Paramètres
    Nom Type Description
    Aucun
    Tableau 2. Renvoie
    Type Description
    chaîne Les trois états possibles retournés par cette méthode sont :
    • Traitement : Discovery traite toujours la demande.
    • Réussite : un CI a été créé ou mis à jour.
    • Échec : aucun CI n’a été créé ou mis à jour, et le statut de découverte est Terminé ou Annulé.
    var ipResultObj = sn_discovery.DiscoveryAPI.reportCiIpAddressStatus(ipAddress, discoveryStatus);
    gs.info("ipResultObj(CiOperationStatus): " + ipResultObj.getCiOperationStatus());
    

    ReportCiStatusOutputJS : getCmdbCI()

    Renvoie la valeur du champ cmdb_ci de la table discovery_device_history pour le CI analysé.

    Tableau 3. Paramètres
    Nom Type Description
    Aucun
    Tableau 4. Renvoie
    Type Description
    chaîne Sys_id du CI créé ou mis à jour. Cette valeur peut être nulle dans le cas de résultats intermédiaires avant la création d’un CI.
    var ipResultObj = sn_discovery.DiscoveryAPI.reportCiIpAddressStatus(ipAddress, discoveryStatus);
    gs.info("ipResultObj(cmdb): " + ipResultObj.getCmdbCI());
    

    ReportCiStatusOutputJS : getDiscoveryState()

    Renvoie la valeur du champ État dans la table Statut de découverte [discovery_status].

    Les valeurs renvoyées par cette méthode sont utilisées pour calculer la valeur renvoyée par la méthode getCiOperationStatus()

    Tableau 5. Paramètres
    Nom Type Description
    Aucun
    Tableau 6. Renvoie
    Type Description
    chaîne Les états possibles renvoyés par cette méthode sont les suivants :
    • En cours de démarrage
    • Actifs
    • Terminé
    • Annulé
    var ipResultObj = sn_discovery.DiscoveryAPI.reportCiIpAddressStatus(ipAddress, discoveryStatus);
    gs.info("ipResultObj(discoveryState): " + ipResultObj.getDiscoveryState());
    

    ReportCiStatusOutputJS : getIpAddress()

    Renvoie la valeur du champ source dans la table discovery_device_history pour le CI analysé.

    Tableau 7. Paramètres
    Nom Type Description
    Aucun
    Tableau 8. Renvoie
    Type Description
    chaîne Adresse IP du CI analysé.
    var ipResultObj = sn_discovery.DiscoveryAPI.reportCiIpAddressStatus(ipAddress, discoveryStatus);
    gs.info("ipResultObj(IpAddress): " + ipResultObj.getIpAddress());

    ReportCiStatusOutputJS : getIssues()

    Renvoie la valeur du champ Problèmes dans la table discovery_device_history pour le CI analysé.

    Tableau 9. Paramètres
    Nom Type Description
    Aucun
    Tableau 10. Renvoie
    Type Description
    entier Nombre de problèmes dans cette découverte pour ce CI.
    var ipResultObj = sn_discovery.DiscoveryAPI.reportCiIpAddressStatus(ipAddress, discoveryStatus);
    gs.info("ipResultObj(issues): " + ipResultObj.getIssues());

    ReportCiStatusOutputJS : toJson()

    Sérialise l’objet ReportCiStatusOutputJS .

    Cette méthode lève l’exception Impossible de sérialiser l’objetIllegalArgumentException, e lorsque la méthode est incapable de sérialiser l’objet. Le e est l’objet d’exception, qui fournit le message et la trace d’exception.

    Tableau 13. Paramètres
    Nom Type Description
    Aucun
    Tableau 14. Renvoie
    Type Description
    chaîne Instance sérialisée de l’objet ReportCiStatusOutputJS dans une chaîne JSON.
    var ipResultObj = sn_discovery.DiscoveryAPI.reportCiIpAddressStatus(ipAddress, discoveryStatus);
    gs.info("ipResultObj(json): " + ipResultObj.toJson());