CIUtils - Global

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 1 minute de lecture
  • Le script include CIUtils est une classe utilitaire qui fournit des méthodes pour travailler avec des éléments de configuration (CI).

    Par défaut, lors de la traversée 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 de retours d’articles 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(chaîne CI_sys_id)

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

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

    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 GlideRecord de la tâche, 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