---
sourceDocument: Xanadu-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# CIUtils : Global

# CIUtils : Global {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 Minute Lesedauer

Die Skripteinbindung CIUtils ist eine Dienstprogrammklasse, die Methoden für die Arbeit mit Configuration Items (CI) bereitstellt.

Standardmäßig verwendet das System beim Durchlaufen von CI-Beziehungen eine maximale Tiefe von 10. Sie können diesen Wert überschreiben, indem Sie die Eigenschaft „glide.relationship.max_tiefe" ändern.

Die maximale Anzahl von Elementergebnissen ist 1000. Sie können diesen Wert überschreiben, indem Sie die Eigenschaft glide.relationship.threshold ändern.

Die Klasse CIUtils ist für serverseitige Skripts verfügbar.

## CIUtils -- servicesAffectedByCI(String CI_sys_id) {#ariaid-title2}

Bestimmt, welche Business-Services von dem spezifischen Configuration Item (CI) betroffen sind.
{#r_CIUtils-servicesAffectedByCI_S__table_ity_vh1_4t__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| CI_sys_id | Zeichenfolge | Die sys_id eines zu überprüfenden Konfigurationselements (cmdb_ci). |
[Tabelle : 1. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Array | Ein Array von sys_id-Werten für cmdb_ci-Datensätze hinter dem angegebenen Element (oder solche, die davon beeinflusst werden). |
[Tabelle : 2. Ergebnisse]

{#r_CIUtils-servicesAffectedByCI_S__table_jty_vh1_4t}  
In diesem Beispiel werden die Namen der Services angezeigt, die von den CI-Elementen mit dem Namen = lnux100 betroffen sind.

    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());
      }
    }

Ausgabe:

    Client Services
    IT Services
    Bond Trading

## CIUtils -- servicesAffectedByTask(GlideRecord task) {#ariaid-title3}

Bestimmt, welche Business-Services von der angegebenen Aufgabe betroffen sind.
{#r_CIUtils-servicesAffByTask_GR__table_dml_r31_4t__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| task | GlideRecord | Aufgaben-GlideRecord, z. B. „Incident", „change_request" oder „problem". |
[Tabelle : 3. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Array | Liste der sys_id-Werte für CIs, die dem Konfigurationselement nachgelagert sind (oder von diesem betroffen sind), auf das das Feld „cmdb_ci" der Aufgabe verweist. |
[Tabelle : 4. Ergebnisse]

{#r_CIUtils-servicesAffByTask_GR__table_eml_r31_4t}  
In diesem Beispiel werden die Namen der Services angezeigt, die vom Incident INC00050 betroffen sind.

    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());
      }
    }

Ausgabe:

    IT Services
    Email
    Windows Mobile
    Electronic Messaging
    Outlook Web Access (OWA)
    Blackberry