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

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# CIUtils -- Global

# CIUtils -- Global {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 Minute Lesedauer

Die CIUtils Die Skripteinbindung ist eine Dienstprogrammklasse, die Methoden für die Arbeit mit Konfigurationselementen (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 ändern Glide.Beziehung.max_Tiefe Eigenschaft.

Die maximale Anzahl von zurückgegebenen Elementen beträgt 1000. Sie können diesen Wert überschreiben, indem Sie ändern Glide.Beziehung.Schwellenwert Eigenschaft.

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

## CIUtils -- servicesAffectedByCI(Zeichenfolge CI_sys_ID) {#ariaid-title2}

Bestimmt, welche Business-Services vom spezifischen Konfigurationselement (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, die dem angegebenen Element nachgelagert (oder von ihm betroffen) sind. |
[Tabelle : 2. Rückgaben]

{#r_CIUtils-servicesAffectedByCI_S__table_jty_vh1_4t}  
In diesem Beispiel werden die Namen der Services angezeigt, die von den CI-Elementen betroffen sind, mit dem Namen = 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());
      }
    }

Ausgabe:

    Client Services
    IT Services
    Bond Trading

## CIUtils -- servicesAffectedByTask (GlideRecord-Aufgabe) {#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 |
|-|-|-|
| Aufgabe | 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 nachgelagerte CIs des Konfigurationselements (oder davon betroffen), auf das das Feld „cmdb_ci" der Aufgabe verweist. |
[Tabelle : 4. Rückgaben]

{#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


