---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# CIUtils - Global

# CIUtils - Global {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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) {#ariaid-title2}

Détermine quels services d'entreprise sont affectés par l'élément de configuration (CI) spécifique.
{#r_CIUtils-servicesAffectedByCI_S__table_ity_vh1_4t__entry__3}

| Nom | Type | Description |
|-|-|-|
| CI_sys_id | Chaîne | La sys_id d'un élément de configuration (cmdb_ci) à vérifier. |
[Tableau 1. Paramètres]

{#r_CIUtils-servicesAffectedByCI_S__table_ity_vh1_4t} {#r_CIUtils-servicesAffectedByCI_S__table_jty_vh1_4t__entry__2}

| 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). |
[Tableau 2. Renvoie]

{#r_CIUtils-servicesAffectedByCI_S__table_jty_vh1_4t}  
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) {#ariaid-title3}

Détermine quels services d'entreprise sont affectés par la tâche spécifiée.
{#r_CIUtils-servicesAffByTask_GR__table_dml_r31_4t__entry__3}

| Nom | Type | Description |
|-|-|-|
| tâche | GlideRecord | GlideRecord de la tâche, par exemple incident, change_request ou problème. |
[Tableau 3. Paramètres]

{#r_CIUtils-servicesAffByTask_GR__table_dml_r31_4t} {#r_CIUtils-servicesAffByTask_GR__table_eml_r31_4t__entry__2}

| 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. |
[Tableau 4. Renvoie]

{#r_CIUtils-servicesAffByTask_GR__table_eml_r31_4t}  
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