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


---

# CMDBUtil -- Global

# CMDBUtil -- Global {#ariaid-title1}

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

Die CMDBUtil Die API stellt Dienstprogrammmethoden zum Erstellen und Verwalten von Tabellenbeziehungen in bereit Configuration Management Database (CMDB)Und verwalten CMDBBaselines.

CMDBUtil ist ein JavaScript-zugängliches ScriptableObject. Die CMDBUtil API verfügt über dynamische und statische Methoden. Sie greifen auf dynamische Methoden zu, indem Sie ein SNC.CMDBUtil-Objekt erstellen. Sie greifen über das globale Objekt „SNC.CMDBUtil" auf statische Methoden zu, um die Methoden aufzurufen.  
In diesem Beispiel wird ein CMDBUtil-Objekt erstellt.

    var cu = new SNC.CMDBUtil();
    cu.baselineProposedChangesGenDIFF(current, action.get('sysparm_changeset'));

In diesem Beispiel wird eine statische Methode aufgerufen.

    var output = SNC.CMDBUtil.getAllChildrenOfAsCommaList('cmdb_ci_computer');

Verwenden Sie diese Methoden zur Verwaltung CMDBTabellenbeziehungen und Baselines.

## CMDBUtil -- baselineProposedChangesApplyChanges(GlideRecord proposedChanges) {#ariaid-title2}

Wendet vorgeschlagene Änderungen in einem Task_ci-Datensatz an, die einen Update-Satz für alle CIs darstellen, die der Aufgabe zugeordnet sind.
Dies ist eine dynamische Methode.
{#r_CMDBU-basePropChApCh_GR__table_tlm_ytc_3v__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| ProposedChanges | GlideRecord | Die Sammlung der vorgeschlagenen Changes in der Change-Anforderung (CHG). |
[Tabelle : 1. Parameter]

{#r_CMDBU-basePropChApCh_GR__table_tlm_ytc_3v} {#r_CMDBU-basePropChApCh_GR__table_ulm_ytc_3v__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 2. Rückgaben]

{#r_CMDBU-basePropChApCh_GR__table_ulm_ytc_3v}  

    //Where current is a GlideRecord and action is the current UI action
    var base = new SNC.CMDBUtil();
    base.baselineProposedChangesApplyChanges(current);

## CMDBUtil -- baselineProposedChangesGenDiff(GlideRecord aktuell, Zeichenfolgenänderungssatz) {#ariaid-title3}

Generiert die XML für die Differenz der vorgeschlagenen Changes und fügt sie dem entsprechenden Task_ci-Datensatz hinzu.
Dies ist eine dynamische Methode.
{#r_CMDBU-basePropChGenDiff_GR_S__table_p2w_2tc_3v__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| aktuell | GlideRecord | Der GlideRecord, der die Sammlung der vorgeschlagenen Changes enthält. |
| Änderungssatz | Zeichenfolge | Die sysid des Task_ci-Datensatzes, der den zu verwendenden Change-Satz darstellt. |
[Tabelle : 3. Parameter]

{#r_CMDBU-basePropChGenDiff_GR_S__table_p2w_2tc_3v} {#r_CMDBU-basePropChGenDiff_GR_S__table_q2w_2tc_3v__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 4. Rückgaben]

{#r_CMDBU-basePropChGenDiff_GR_S__table_q2w_2tc_3v}  

    //Where current is a GlideRecord and action is the current UI action
    var base = new SNC.CMDBUtil();
    base.baselineProposedChangesGenDIFF(current, action.get('sysparm_changeset'));

## CMDBUtil -- Bootstrap(Zeichenfolge dictFile) {#ariaid-title4}

Bootet die Umgebung, indem die Datenbank erstellt, die Systemwörterbuchtabelle erstellt und die Systemwörterbuchtabelle sich selbst beschreibt.
Dies ist eine statische Methode.
{#r_CMDBU-bootstrap_S__table_nc2_gwc_3v__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| DictDatei | Zeichenfolge | Der Dateiname einschließlich Pfad des zu ladenden Wörterbuchs. |
[Tabelle : 5. Parameter]

{#r_CMDBU-bootstrap_S__table_nc2_gwc_3v} {#r_CMDBU-bootstrap_S__table_oc2_gwc_3v__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 6. Rückgaben]

{#r_CMDBU-bootstrap_S__table_oc2_gwc_3v}

## CMDBUtil -- createCIRelationship (Zeichenfolge tableName, übergeordnete Zeichenfolge, untergeordnete Zeichenfolge, Zeichenfolge parentField, Zeichenfolge childField) {#ariaid-title5}

Erstellt eine CI-Beziehung zwischen Feldern.
{#r_CMDBU-createCIRel_S_S_S_S_O__table_a1b_4kc_3v__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| tableName | Zeichenfolge | Optional. Der Name der Beziehungszieltabelle. Standard: CI-Beziehungstabelle \[cmdb_rel_ci\]. |
| übergeordnet | Zeichenfolge | SYS_ID des übergeordneten CI-Datensatzes in der Tabelle „Konfigurationselemente \[cmdb_ci\]". |
| untergeordnetes Element | Zeichenfolge | SYS_ID des untergeordneten CI-Datensatzes in der Tabelle „Konfigurationselemente \[cmdb_ci\]". |
| parentField | Zeichenfolge | Die Bezeichnung der übergeordneten Beziehung, die in der Tabelle „CI-Beziehungstyp" \[cmdb_rel_type\] aufgeführt ist. |
| Child-Feld | Zeichenfolge | Die Bezeichnung der untergeordneten Beziehung, die in der Tabelle „CI-Beziehungstyp" \[cmdb_rel_type\] aufgeführt ist. |
[Tabelle : 7. Parameter]

{#r_CMDBU-createCIRel_S_S_S_S_O__table_a1b_4kc_3v} {#r_CMDBU-createCIRel_S_S_S_S_O__table_b1b_4kc_3v__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | SYS_ID des neuen Datensatzes, der in der CI-Beziehungstabelle \[cmdb_rel_ci\] aufgeführt ist. |
[Tabelle : 8. Rückgaben]

{#r_CMDBU-createCIRel_S_S_S_S_O__table_b1b_4kc_3v}  
Das folgende Beispiel zeigt, wie eine CI-Beziehung zwischen dem übergeordneten CI-Feld „enthält" und dem untergeordneten CI-Feld „include_by" erstellt wird. Die Beziehung wird in der CI-Beziehungstabelle \[cmdb_rel_ci\] aufgeführt.

    var base = new SNC.CMDBUtil();
    base.createCIRelationship('<parent_ci_sys_id>', '<child_ci_sys_id>, 'Contains', 'Contained by');

## CMDBUtil -- getAllChildrenOfAsCommaList(Zeichenfolge baseTable) {#ariaid-title6}

Ruft alle untergeordneten Tabellen der angegebenen Tabelle als kommagetrennte Liste ab.
Dies ist eine statische Methode.
{#r_CMDBU-getAllCOfAsCList_S__table_o2r_nvc_3v__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| baseTable | Zeichenfolge | Der Name der Basistabelle. |
[Tabelle : 9. Parameter]

{#r_CMDBU-getAllCOfAsCList_S__table_o2r_nvc_3v} {#r_CMDBU-getAllCOfAsCList_S__table_p2r_nvc_3v__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Eine kommagetrennte Liste von sys_IDs von Tabellen, die die Basistabelle erweitern. |
[Tabelle : 10. Rückgaben]

{#r_CMDBU-getAllCOfAsCList_S__table_p2r_nvc_3v}  

    //Where cmdv_ci_computer is a table.
    var output = SNC.CMDBUtil.getAllChildrenOfAsCommaList('cmdb_ci_computer');
    gs.print(output);

## CMDBUtil -- getCMDBViews() {#ariaid-title7}

Ruft alle Datensätze in der Tabelle „CMDB-Ansicht" \[cmdb_View\] ab.
Diese Methode ist dynamisch.
{#r_CMDBU-getCMDBViews__table_gww_xwc_3v__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 11. Parameter]

{#r_CMDBU-getCMDBViews__table_gww_xwc_3v} {#r_CMDBU-getCMDBViews__table_hww_xwc_3v__entry__2}

| Typ | Beschreibung |
|-|-|
| Array | Liste der Datensätze in der Tabelle „CMDB-Ansicht" \[cmdb_View\]. |
[Tabelle : 12. Rückgaben]

{#r_CMDBU-getCMDBViews__table_hww_xwc_3v}  
Das folgende Beispiel zeigt, wie die CMDB-Ansichten aufgelistet werden.

    var util = new SNC.CMDBUtil(); 
    var cmdbViews = util.getCMDBViews();
    gs.info(cmdbViews);

    // Note that the output in the example is type: java.util.ArrayList
    // To convert to JS Array, use ArrayUtils (add these lines preceding gs.info):
    // var arrUtil = new global.ArrayUtil();
    // var arrViews = arrUtil.convertArray(cmdbViews);

Ausgabe:

    [View 3, View 1, View 2, Another view]

## CMDBUtil -- getTables0(Zeichenfolge tableName) {#ariaid-title8}

Ruft eine Liste aller übergeordneten Elemente einer Tabelle ab.
Diese Methode ist eine statische Methode.
{#r_CMDBU-getTables_S__table_qhg_bvc_3v__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| tableName | Zeichenfolge | Der Tabellenname. |
[Tabelle : 13. Parameter]

{#r_CMDBU-getTables_S__table_qhg_bvc_3v} {#r_CMDBU-getTables_S__table_rhg_bvc_3v__entry__2}

| Typ | Beschreibung |
|-|-|
| Array | Liste der Tabellen, die der angegebenen Tabelle übergeordnet sind. |
[Tabelle : 14. Rückgaben]

{#r_CMDBU-getTables_S__table_rhg_bvc_3v}  
Das folgende Beispiel zeigt, wie die übergeordneten Tabellen der Servertabelle \[cmdb_ci_Server\] aufgelistet werden.

    var gr = new GlideRecord('incident');

    // Querying the incident table
    gr.addQuery('number','INC0000005'); 
    gr.query();


    if(gr.next()){
      // Find the list of parent tables for Configuration item field of this Incident
      var ciParent = SNC.CMDBUtil.getTables0(gr.cmdb_ci.sys_class_name); 
      gs.print("Parent Tables for the Configuration Item '" + gr.cmdb_ci.name + "' belonging to the CMDB Class '"+ gr.cmdb_ci.sys_class_name+ "' are: \n" + ciParent);
    }

Ausgabe:

    Parent Tables for the Configuration Item 'ApplicationServerPeopleSoft' belonging to the CMDB Class 'cmdb_ci_server' are: 
    [cmdb_ci_server, cmdb_ci_computer, cmdb_ci_hardware, cmdb_ci, cmdb]

## CMDBUtil -- isExcludedFromBR(Zeichenfolge className) {#ariaid-title9}

Bestimmt, ob eine CI-Klasse in der Tabelle „Ausschlusslisten für Geschäftsregeln \[cmdb_business_rule_exclusions\]" definiert ist. Verwenden Sie diese Methode in einer erweiterten Bedingung, um zu verhindern, dass eine Business-Regel für ausgeschlossene CI-Klassen ausgeführt wird.
Beispielsweise verwendet die Business-Regel „Asset beim Einfügen erstellen" diese Methode in der erweiterten Bedingung, um zu verhindern, dass die Regel Assets für CI-Klassen wie cmdb_ci_Qualifier, cmdb_ci_Endpoint, cmdb_ci_storage_volume und cmdb_ci_vcenter_datastore_disk. erstellt Definieren Sie Klassen für den Ausschluss in der Tabelle „Ausschlusslisten für Geschäftsregeln \[cmdb_business_rule_exclusions\]".
{#CMDBU-isExcludedFromBR_S__table_bft_dgv_g2b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| className | Zeichenfolge | Name der Klasse, die auf Ausschluss überprüft werden soll. |
[Tabelle : 15. Parameter]

{#CMDBU-isExcludedFromBR_S__table_bft_dgv_g2b} {#CMDBU-isExcludedFromBR_S__table_cft_dgv_g2b__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | „Wahr", wenn die Klasse in der Tabelle „Ausschlusslisten für Geschäftsregeln \[cmdb_business_rule_exclusions\]" definiert ist; andernfalls „falsch". |
[Tabelle : 16. Rückgaben]

{#CMDBU-isExcludedFromBR_S__table_cft_dgv_g2b}  

    //Returns true if the cmdb_ci_endpoint class is defined 
    //in the Business Rule Exclusion Lists table
    var exclusion = SNC.CMDBUtil.isExcludedFromBR("cmdb_ci_endpoint");

    //Advanced condition that prevents business rules from executing on 
    //classes in the Business Rule Exclusion Lists table
    (!SNC.CMDBUtil.isExcludedFromBR(current.getTableName()))

## CMDBUtil -- processCIChange (GlideRecord-Ereignis, GlideRecord-Ziel) {#ariaid-title10}

Schließt den Anruf an ein RelationshipEventProcessor() , Der alle Änderungen an CI-Beziehungen verarbeitet.
Dies ist eine dynamische Methode.
{#r_CMDBU-processCIChange_GR_GR__table_t5p_xhc_3v__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Ereignis | GlideRecord | Der Ereignisdatensatz. |
| Ziel | GlideRecord | Der Zieldatensatz. |
[Tabelle : 17. Parameter]

{#r_CMDBU-processCIChange_GR_GR__table_t5p_xhc_3v} {#r_CMDBU-processCIChange_GR_GR__table_u5p_xhc_3v__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 18. Rückgaben]

{#r_CMDBU-processCIChange_GR_GR__table_u5p_xhc_3v}

## CMDBUtil -- processRelChange(GlideRecord-Ereignis, GlideRecord-aktuell, ZeichenfolgenrelType, Zeichenfolgentriplett) {#ariaid-title11}

Schließt den Anruf an ein RelationshipEventProcessor() , Der alle Änderungen an CI-Beziehungen mit dem angegebenen Typ und Triplett verarbeitet.
Dies ist eine dynamische Methode.
{#r_CMDBU-procRelChange_GR_GR_S_S__table_iwz_njc_3v__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Ereignis | GlideRecord | Der Ereignisdatensatz |
| aktuell | GlideRecord | Der aktuelle Datensatz, der entweder der Beziehungsdatensatz oder ein Anwenderdatensatz ist, wenn der aktuelle Prozess eine Löschung ist. |
| relType | Zeichenfolge | Der Typ der Beziehung, die sich geändert hat. |
| Triplett | Zeichenfolge | Das untergeordnete Element, das übergeordnete Element und der Klassenname aus der Beziehung, die sich geändert hat. |
[Tabelle : 19. Parameter]

{#r_CMDBU-procRelChange_GR_GR_S_S__table_iwz_njc_3v} {#r_CMDBU-procRelChange_GR_GR_S_S__table_jwz_njc_3v__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 20. Rückgaben]

{#r_CMDBU-procRelChange_GR_GR_S_S__table_jwz_njc_3v}

## CMDBUtil -- removeCIRelationship(Zeichenfolge tableName, Zeichenfolge parentField, Zeichenfolge childField, Zeichenfolge parentDesc, Objekt childDesc) {#ariaid-title12}

Löscht die angegebene CI-Beziehung.
Dies ist eine dynamische Methode.
{#r_CMDBU-removeCIRel_S_S_S_S_O__table_a1b_4kc_3v__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| tableName | Zeichenfolge | Optional. Tabellenname Standard: CI-Beziehungstabelle \[cmdb_rel_ci\] |
| parentField | Zeichenfolge | Übergeordnetes Feld |
| Child-Feld | Zeichenfolge | Untergeordnetes Feld |
| ParentDesc | Zeichenfolge | Übergeordneter Beziehungsdeskriptor |
| ChildDesc | Objekt | Untergeordneter Beziehungsdeskriptor |
[Tabelle : 21. Parameter]

{#r_CMDBU-removeCIRel_S_S_S_S_O__table_a1b_4kc_3v} {#r_CMDBU-removeCIRel_S_S_S_S_O__table_jbs_nsc_3v__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 22. Rückgaben]

{#r_CMDBU-removeCIRel_S_S_S_S_O__table_jbs_nsc_3v}  
Dieses Codebeispiel zeigt, wie jeder Beziehungstyp „abhängig von::verwendet von" für das angegebene übergeordnete Element entfernt wird.

    var cu = new SNC.CMDBUtil();
    var parentSysID = '27d18f6fc0a8000b00ad14d4929d1b45';
    var parentDesc = 'Depends on';
    var childDesc = 'Used by'
     
    // Get records with parent equal parentSysID
    var relation = new GlideRecord('cmdb_rel_ci');
    relation.addQuery('parent', parentSysID);
    relation.query();
    while(relation.next()){
        // Remove every relation of type: 'Depends on::Used by' for the parent
        // If the relation type does not exist, it inserts this relation type into [cmdb_rel_type].
        cu.removeCIRelationship('cmdb_rel_ci', parentSysID, relation.child.getValue('sys_id'), parentDesc, childDesc)
    }

## CMDBUtil -- reParentTable (Zeichenfolgentabelle, Zeichenfolge oldParent, Zeichenfolge newParent) {#ariaid-title13}

Ändert das übergeordnete Element der angegebenen Tabelle in das neue übergeordnete Element.
Diese Methode ist eine statische Methode.
{#r_CMDBU-reParentTable_S_S_S__table_gdq_m5c_3v__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| table | Zeichenfolge | Die Tabelle, die neu übergeordnet werden soll. |
| Altes übergeordnetes Element | Zeichenfolge | Das alte übergeordnete Element. |
| Neues übergeordnetes Element | Zeichenfolge | Das neue übergeordnete Element. |
[Tabelle : 23. Parameter]

{#r_CMDBU-reParentTable_S_S_S__table_gdq_m5c_3v} {#r_CMDBU-reParentTable_S_S_S__table_hdq_m5c_3v__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob der übergeordnete Change erfolgreich ist. Gültige Werte: * Wahr: Übergeordnete Änderung war erfolgreich. * Falsch: Übergeordnete Änderung war nicht erfolgreich. {#r_CMDBU-reParentTable_S_S_S__ul_n3j_mn2_qrb} |
[Tabelle : 24. Rückgaben]

{#r_CMDBU-reParentTable_S_S_S__table_hdq_m5c_3v}  
Um das folgende Beispiel neu zu erstellen, verwenden Sie den bereitgestellten Code, um eine anwenderdefinierte Tabelle zu erstellen. Erstellen Sie als Nächstes einen Datensatz, und überprüfen Sie ihn in der Aufgabentabelle. Die erstellte anwenderdefinierte Tabelle wird aus der Aufgabentabelle erweitert, was bedeutet, dass sie erfolgreich neu übergeordnet wurde. Der Code soll nicht direkt per Kopieren und Einfügen verwendet werden. Zum Anzeigen der Ausgabe wurde die anwenderdefinierte Tabelle vor der Ausführung des Codes erstellt.

    /*
      Before running the code in the background Script Make Sure 'Record For Rollback' is unchecked.

      This API CMDBUtil.reParentTable changes the parent of the table but will not allow the OOB tables to change the parent it works only in the custom table. Hence this script contains the creation of the custom table.
      API CMDBUtil.reParentTable has 3 parameters (Table, Old Parent , New Parent);
      We can make the Parent as Null as well by using this (Table, Old Parent, '');

      The code in this example shows how to create a custom table without any extension.
      Then creating a record and then again creating a record and checking in the task table after it gets extended to the task table.

      If the code returns false means the record is not present in the task table as it is not extended. It returns true only when the record is found in the task table after the table is extended.

    */

    /* Run the following code to create the custom table without an extension
    createCustomTable('u_custom_table','Custom Table'); // Creating a custom Table (don't create if you have one)
    var CreatedRecord = CreateCustomRecord('u_custom_table'); // Creating a record in the custom table
    gs.print(CheckRecord('u_custom_table'));  // Checking of the record in the task table by passing the Class Name (A.K.A your custom Table)

    var getParentTables = new SNC.CMDBUtil.reParentTable('u_custom_table','','task'); // Extending the custom table to task table . This Works only when the table is extendable
    var CreatedRecordAfter = CreateCustomRecord('u_custom_table'); // Creating a record in the custom table
    gs.print(CheckRecord('u_custom_table'));  // Checking of the record in the task table by passing the Class Name (A.K.A your custom Table)
    */

    // If the custom Table is already created, run this. (Do not run these 4 lines when creating the table)
    gs.print(CheckRecord('u_custom_table')); //Checking of the record in the task table by passing the Class Name (A.K.A your custom Table)
    var getParentTables = new SNC.CMDBUtil.reParentTable('u_custom_table','','task'); //Extending the custom table to task table . This Works only when the table is extendable
    var CreatedRecordAfter = CreateCustomRecord('u_custom_table'); //Creating a record in the custom table
    gs.print(CheckRecord('u_custom_table'));  //Checking of the record in the task table by passing the Class Name (A.K.A your custom Table)


    function createCustomTable(Name, Label)
    {
      var customTable = new GlideRecord('sys_db_object');
      customTable.initialize();
      customTable.name=  Name ;
      customTable.label= Label ;
      customTable.is_extendable= true;
      customTable.insert();
    }

    function CreateCustomRecord(customTableName)
    {
      var customTable = new GlideRecord(customTableName);
      customTable.initialize();
      return customTable.insert();
    }

    function CheckRecord(customTableName)
    {
      var task =new GlideRecord('task');
      task.addQuery('sys_class_name', customTableName);
      task.query();

      if(task.next())
      {
        return true;
      }

      return false;
    }

Ausgabe:

    *** Script: true
    *** Script: true


