CIUtils : global

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 1 minute de lecture
  • L’include de script CIUtils est une classe utilitaire qui fournit des méthodes pour travailler avec les éléments de configuration (CI).

    Par défaut, lors du parcours des relations CI, le système utilise une profondeur maximale de 10. Vous pouvez remplacer cette valeur en modifiant la propriété glide.relationship.max_depth .

    Le nombre maximum d’articles retournés est de 1000. Vous pouvez remplacer cette valeur en modifiant la propriété glide.relationship.threshold .

    La classe CIUtils est disponible pour les scripts côté serveur.

    CIUtils : servicesAffectedByCI(String CI_sys_id)

    Détermine quels services aux entreprises sont affectés par l’élément de configuration (CI) spécifique.

    Tableau 1. Paramètres
    Nom Type Description
    CI_sys_id Chaîne L’sys_id d’un élément de configuration (cmdb_ci) à vérifier.
    Tableau 2. Renvoie
    Type Description
    Tableau Tableau de valeurs de sys_id pour cmdb_ci enregistrements en aval de l’élément spécifié ou affectés par celui-ci.

    Cet exemple affiche les noms des services affectés par les éléments CI avec le nom = lnux100.

    var CIUtil = new CIUtils();
     
    //get a server record
    var server = new GlideRecord("cmdb_ci_server");
    server.addQuery("name", "lnux100");
    server.query();
    if (server.next()) {
      //get the affected services, array of ids
      var serviceIds = CIUtil.servicesAffectedByCI(server.getUniqueValue());
      for (var i=0; i < serviceIds.length; i++) {
        //get the service record
        var service = new GlideRecord("cmdb_ci_service");
        service.get(serviceIds[i]);
        gs.print(service.getDisplayValue());
      }
    }
    Sortie :
    Client Services
    IT Services
    Bond Trading

    CIUtils : servicesAffectedByTask(tâche GlideRecord)

    Détermine quels services d’entreprise sont affectés par la tâche spécifiée.

    Tableau 3. Paramètres
    Nom Type Description
    tâche GlideRecord Tâche GlideRecord, par exemple, incident, change_request ou problème.
    Tableau 4. Renvoie
    Type Description
    Tableau Liste des valeurs de sys_id pour les CI en aval (ou affectés par) l’élément de configuration référencé par le champ cmdb_ci de la tâche.

    Cet exemple affiche les noms des services affectés par l’incident INC00050.

    var CIUtil = new CIUtils();
     
    //get an incident record
    var inc = new GlideRecord("incident");
    inc.addQuery("number", "INC00050");
    inc.query();
    if (inc.next()) {
      //get the affected services, array of ids
      var serviceIds = CIUtil.servicesAffectedByTask(inc);
      for (var i=0; i < serviceIds.length; i++) {
        //get the service record
        var service = new GlideRecord("cmdb_ci_service");
        service.get(serviceIds[i]);
        gs.print(service.getDisplayValue());
      }
    }
    Sortie :
    IT Services
    Email
    Windows Mobile
    Electronic Messaging
    Outlook Web Access (OWA)
    Blackberry