CIUtils : global

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 1 minute de lecture
  • Le script include CIUtils est une classe utilitaire permettant d’utiliser 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(String CI_sys_id)

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

    Tableau 1. Paramètres
    Nom Type Description
    CI_sys_id Chaîne 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).

    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 aux entreprises sont affectés par la tâche spécifiée.

    Tableau 3. Paramètres
    Nom Type Description
    tâche GlideRecord Une tâche GlideRecord, par exemple un incident, une change_request ou un problème.
    Tableau 4. Renvoie
    Type Description
    Tableau Tableau des valeurs 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 touchés par l’INC00050 d’incident.

    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