CIUtils : global

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 1 minute de lecture

    • L’include de script CIUtils est une classe utilitaire qui fournit des méthodes d’utilisation des éléments de configuration (CI).

    Par défaut, lors de la traversée des relations de 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’éléments est de 1 000. 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 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 L’sys_id d’un élément de configuration (cmdb_ci) à vérifier.
    Tableau 2. Renvoie
    Type Description
    Tableau Tableau de valeurs sys_id pour cmdb_ci enregistrements en aval (ou affectés par) l’élément spécifié.

    Cet exemple affiche les noms des services affectés par les éléments de 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