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


---

# CMDBGroupAPI -- Umfang

# CMDBGroupAPI -- Umfang {#ariaid-title1}

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

Die CMDBGroupAPI Stellt Methoden zum Ausführen von Aktionen für bereit Configuration Management Database (CMDB)Gruppen.  
Diese API ist eine bereichsbezogene statische Klasse. Zur Verwendung dieser Klasse müssen Sie einschließen `sn_cmdbGroup `Namespace-Bezeichner vor dem CMDBGroupAPI-Objekt. Zum Beispiel:

    var response = sn_cmdbgroup.CMDBGroupAPI.getManualCIList(groupSysId, false);

Um auf diese API zuzugreifen, müssen Sie über die itil- oder Asset-Rolle verfügen.

## CMDBGroupAPI -- getAllCI (Zeichenfolge groupId, boolescher AnforderungCompleteSet, boolescher AnforderungAllQueryNodesCis) {#ariaid-title2}

Gibt alle Konfigurationselemente (CIs) für die angegebene Gruppe zurück. Die Ergebnisse umfassen alle manuellen CIs und die Liste der CIs aus der gespeicherten Abfrage des Abfragegenerators.
{#r_CMDBG-getAllCI_S_B__table_nyt_5lz_kx__entry__3}{#r_CMDBG-getAllCI_S_B__entry-groupId-CMDB}{#r_CMDBG-getAllCI_S_B__entry-requireCompleteSet-CMDB}{#r_CMDBG-getAllCI_S_B__entry-requireAllQueryNodesCis-CMDB}

| Name | Typ | Beschreibung |
|-|-|-|
| group_id | Zeichenfolge | SYS_ID der CMDB-Gruppe (Configuration Management Database). |
| AnforderungsCompleteSet | Boolean | Optional, muss aber übergeben werden, wenn requireAllQueryNodesCisIst bestanden. Kennzeichnung, die angibt, ob eine leere Zeichenfolge zurückgegeben wird, wenn CIs durch Zugriffssteuerungslistenbeschränkungen (ACL) herausgefiltert werden. Gültige Werte: * Wahr: Leere Zeichenfolge zurückgeben. * Falsch: Wert nicht zurückgeben. {#r_CMDBG-getAllCI_S_B__ul_u1j_dsd_vlb} Standard: Falsch |
| AnforderungAllQueryNodesCis | Boolean | Optional. Kennzeichnung, die angibt, ob CIs aus allen CMDB-Klassen der Abfrage zurückgegeben werden sollen. Gültige Werte: * Wahr: CIs aus allen Spalten zurückgeben. * Falsch: Gibt nur CIs vom Startknoten der Abfrage des Abfragegenerators zurück. {#r_CMDBG-getAllCI_S_B__ul_k2j_jsd_vlb} Standard: Falsch |
[Tabelle : 1. Parameter]

{#r_CMDBG-getAllCI_S_B__table_nyt_5lz_kx} {#r_CMDBG-getAllCI_S_B__table_rm2_322_vlb__entry__2}

| Typ | Beschreibung |
|-|-|
| Fehler | Liste der Fehler für einen fehlgeschlagenen Vorgang. Datentyp: Array "errors": [ { "message": "String", "error": "String" } ] |
| Fehler.Fehler | Fehlername. Mögliche Werte: * GROUP_SYS_ID_IS_NOT_FOUND * GROUP_SYS_ID_IS_EMPTY * FAIL_TO_INSERT_GROUP_CI_PAIR * FAIL_TO_INSERT_GROUP_QUERY_ID_PAIR * CI_CAN_NOT_FOUND * SAVED_QUERY_ID_NOT_FOUND * ERROR_DURING_QUERY_BUILDER_PROCESS_QUERY * TIMEOUT_DURING_QUERY_BUILDER_PROCESS_QUERY * NOT_COMPLETE_DURING_QUERY_BUILDER_PROCESS_QUERY * MAX_LIMIT_DURING_QUERY_BUILDER_PROCESS_QUERY * GROUP_API_TIMEOUT * EXCEPTION_FROM_EXECUTE_QUERY * SOME_CI_NOT_VISIBLE_DUE_TO_SECURITY_CONSTRAINT {#r_CMDBG-getAllCI_S_B__ul_ky1_tyd_vlb} Datentyp: Zeichenfolge |
| Fehler.Nachricht | Kurze Beschreibung der Fehlermeldung. Datentyp: Zeichenfolge |
| IdListe | Liste der CMDB-CI-sys_IDs. Datentyp: Array |
| PartialCIListDueToACLFlag | Kennzeichnung, die angibt, ob die Liste der zurückgegebenen CIs aufgrund von ACL-Einschränkungen unvollständig ist. Hinweis: Dies wird nicht als Fehlerbedingung betrachtet, und es werden keine entsprechenden Fehlerinformationen zurückgegeben. Datentyp: Boolescher Wert Gültige Werte: * Wahr: idListIst unvollständig. * Falsch: idListIst abgeschlossen. {#r_CMDBG-getAllCI_S_B__ul_q2f_lzd_vlb} |
| Ergebnis | Kennzeichnung, die angibt, ob die Methode erfolgreich abgeschlossen wurde. Mögliche Werte: * Wahr: Erfolg * Falsch: Fehler {#r_CMDBG-getAllCI_S_B__ul_khr_vb2_vlb} |
[Tabelle : 2. Rückgaben]

{#r_CMDBG-getAllCI_S_B__table_rm2_322_vlb}  

    // Script example: 
    var getAllCIFunc = function(groupSysId) {
      var parser = new JSONParser();
      var response = sn_cmdbgroup.CMDBGroupAPI.getAllCI(groupSysId, false);
      var parsed = parser.parse(response);
      if (parsed.result) {
        gs.info("succeed to retrieve ci list: " + parsed.idList);
      } else {
        gs.info("fail to retrieve list, errors: " + JSON.stringify(parsed.errors));
      }
    }
    var groupExists = "d0d2d25113152200eef2dd828144b0e4";
    var groupContainsInvalidSavedQuery = "e685a2c3d7012200de92a5f75e610387";
    getAllCIFunc(groupExists);
    getAllCIFunc(groupContainsInvalidSavedQuery);

Ausgabe:

    // Successful response
    {
      'result':true, 
      'partialCIListDueToACLFlag': false,
      'idList':[
        '3a5dd3dbc0a8ce0100655f1ec66ed42c',
        '6b43105c37301000deeabfc8bcbe5db2'
      ] 
    }

    // Error response
    { 
      'result':false, 
      'errors':[ 
        {
          'message':'Group does not exist',
          'error':'GROUP_SYS_ID_IS_NOT_FOUND'
        } 
      ], 
      'partialCIListDueToACLFlag':false,
      'idList':[] 
    }

## CMDBGroupAPI -- getAllCIFromQueryBuilder(Zeichenfolge groupId, boolescher AnforderungsCompleteSet, boolescher AnforderungsAllQueryNodesCis) {#ariaid-title3}

Gibt alle Konfigurationselemente (CIs) zurück, die von den Abfrage-IDs aller gespeicherten Abfragegeneratoren für die angegebene Gruppe zurückgegeben werden.
{#r_CMDBG-getAllCIFromQBuild_S_B__table_kcy_mjz_kx__entry__3}{#r_CMDBG-getAllCIFromQBuild_S_B__entry-groupId-CMDB}{#r_CMDBG-getAllCIFromQBuild_S_B__entry-requireCompleteSet-CMDB}{#r_CMDBG-getAllCIFromQBuild_S_B__entry-requireAllQueryNodesCis-CMDB}

| Name | Typ | Beschreibung |
|-|-|-|
| group_id | Zeichenfolge | SYS_ID der CMDB-Gruppe (Configuration Management Database). |
| AnforderungsCompleteSet | Boolean | Optional, muss aber übergeben werden, wenn requireAllQueryNodesCisIst bestanden. Kennzeichnung, die angibt, ob eine leere Zeichenfolge zurückgegeben wird, wenn CIs durch Zugriffssteuerungslistenbeschränkungen (ACL) herausgefiltert werden. Gültige Werte: * Wahr: Leere Zeichenfolge zurückgeben. * Falsch: Wert nicht zurückgeben. {#r_CMDBG-getAllCIFromQBuild_S_B__ul_u1j_dsd_vlb} Standard: Falsch |
| AnforderungAllQueryNodesCis | Boolean | Optional. Kennzeichnung, die angibt, ob CIs aus allen CMDB-Klassen der Abfrage zurückgegeben werden sollen. Gültige Werte: * Wahr: CIs aus allen Spalten zurückgeben. * Falsch: Gibt nur CIs vom Startknoten der Abfrage des Abfragegenerators zurück. {#r_CMDBG-getAllCIFromQBuild_S_B__ul_k2j_jsd_vlb} Standard: Falsch |
[Tabelle : 3. Parameter]

{#r_CMDBG-getAllCIFromQBuild_S_B__table_kcy_mjz_kx} {#r_CMDBG-getAllCIFromQBuild_S_B__table_lfb_k22_vlb__entry__2}

| Typ | Beschreibung |
|-|-|
| Fehler | Liste der Fehler für einen fehlgeschlagenen Vorgang. Datentyp: Array "errors": [ { "message": "String", "error": "String" } ] |
| Fehler.Fehler | Fehlername. Mögliche Werte: * GROUP_SYS_ID_IS_NOT_FOUND * GROUP_SYS_ID_IS_EMPTY * FAIL_TO_INSERT_GROUP_CI_PAIR * FAIL_TO_INSERT_GROUP_QUERY_ID_PAIR * CI_CAN_NOT_FOUND * SAVED_QUERY_ID_NOT_FOUND * ERROR_DURING_QUERY_BUILDER_PROCESS_QUERY * TIMEOUT_DURING_QUERY_BUILDER_PROCESS_QUERY * NOT_COMPLETE_DURING_QUERY_BUILDER_PROCESS_QUERY * MAX_LIMIT_DURING_QUERY_BUILDER_PROCESS_QUERY * GROUP_API_TIMEOUT * EXCEPTION_FROM_EXECUTE_QUERY * SOME_CI_NOT_VISIBLE_DUE_TO_SECURITY_CONSTRAINT {#r_CMDBG-getAllCIFromQBuild_S_B__ul_ky1_tyd_vlb} Datentyp: Zeichenfolge |
| Fehler.Nachricht | Kurze Beschreibung der Fehlermeldung. Datentyp: Zeichenfolge |
| IdListe | Liste der CMDB-CI-sys_IDs. Datentyp: Array |
| PartialCIListDueToACLFlag | Kennzeichnung, die angibt, ob die Liste der zurückgegebenen CIs aufgrund von ACL-Einschränkungen unvollständig ist. Hinweis: Dies wird nicht als Fehlerbedingung betrachtet, und es werden keine entsprechenden Fehlerinformationen zurückgegeben. Datentyp: Boolescher Wert Gültige Werte: * Wahr: idListIst unvollständig. * Falsch: idListIst abgeschlossen. {#r_CMDBG-getAllCIFromQBuild_S_B__ul_q2f_lzd_vlb} |
| Ergebnis | Kennzeichnung, die angibt, ob die Methode erfolgreich abgeschlossen wurde. Mögliche Werte: * Wahr: Erfolg * Falsch: Fehler {#r_CMDBG-getAllCIFromQBuild_S_B__ul_khr_vb2_vlb} |
[Tabelle : 4. Rückgaben]

{#r_CMDBG-getAllCIFromQBuild_S_B__table_lfb_k22_vlb}  

    // Script example:
    var getAllCIFromQueryBuilderFunc = function(groupSysId) {
      var parser = new JSONParser();
      var response = sn_cmdbgroup.CMDBGroupAPI.getAllCIFromQueryBuilder(groupSysId, false);
      var parsed = parser.parse(response);
      if (parsed.result) {
        gs.info("succeed to retrieve ci list: " + parsed.idList);
      } else {
        gs.info("fail to retrieve list, errors: " + JSON.stringify(parsed.errors));
      }
    }
    var groupExists = "d0d2d25113152200eef2dd828144b0e4";
    var groupContainsInvalidSavedQuery = "e685a2c3d7012200de92a5f75e610387";
    getAllCIFromQueryBuilderFunc(groupExists);
    getAllCIFromQueryBuilderFunc(groupContainsInvalidSavedQuery);

Ausgabe:

    // Successful response
    {
      'result':true, 
      'partialCIListDueToACLFlag': false,
      'idList':[
        '3a5dd3dbc0a8ce0100655f1ec66ed42c',
        '6b43105c37301000deeabfc8bcbe5db2'
      ] 
    }

    // Error response
    { 
      'result':false, 
      'errors':[ 
        {'message':'Group does not exist',
        'error':'GROUP_SYS_ID_IS_NOT_FOUND'} 
      ], 
      'partialCIListDueToACLFlag':false,
      'idList':[] 
    }

## CMDBGroupAPI -- getManualCIList(Zeichenfolge groupId, boolescher Wert für „required CompleteSet") {#ariaid-title4}

Gibt die manuelle CI-Liste der CMDB-Gruppe zurück.
{#r_CMDBG-getManualCIList_S_B__table_efx_szx_kx__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| group_id | Zeichenfolge | Die sysId der CMDB-Gruppe. |
| AnforderungsCompleteSet | Boolean | Bei „wahr" wird eine Fehlerzeichenfolge zurückgegeben, wenn CIs durch ACL-Einschränkungen herausgefiltert werden. |
[Tabelle : 5. Parameter]

{#r_CMDBG-getManualCIList_S_B__table_efx_szx_kx} {#r_CMDBG-getManualCIList_S_B__table_ffx_szx_kx__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Eine JSON-formatierte Zeichenfolge im Format { 'result':false, 'errors':[ {'message':'Group does not exist', 'error':'GROUP_SYS_ID_IS_NOT_FOUND'}, { } // another error if it exists ], 'partialCIListDueToACLFlag':false, 'idList':['sys_id_1', 'sys_id2'] } Wobei * Ergebnis: Eine boolesche Kennzeichnung. Bei „wahr" war die Methode erfolgreich. * Fehler: Eine Liste von Fehlern mit einer Meldung und einem Fehlercode. * PartialCIListDueToACLFlag: Eine boolesche Kennzeichnung. Bei „wahr" ist die idList aufgrund einer ACL-Einschränkung unvollständig. Bei „falsch" ist die idList abgeschlossen. * IdList: Ein Array von cmdb_ci sys_IDs {#r_CMDBG-getManualCIList_S_B__ul_hb5_4sp_mx} Wenn nicht erfolgreich, wird einer der Fehler „GROUP_SYS_ID_IS_NOT_FOUND", „GROUP_SYS_ID_IS_EMPTY", „FAIL_TO_INSERT_GROUP_CI_PAIR", „FAIL_TO_INSERT_GROUP_QUERY_ID_PAIR", „CI_CAN_NOT_FOUND" zurückgegeben. SAVED_QUERY_ID_NOT_FOUND, ERROR_DURING_QUERY_BUILDER_PROCESS_QUERY, TIMEOUT_DURING_QUERY_BUILDER_PROCESS_QUERY, NOT_COMPLETE_DURING_QUERY_BUILDER_PROCESS_QUERY, MAX_LIMIT_DURING_QUERY_BUILDER_PROCESS_QUERY, GROUP_API_TIMEOUT, EXCEPTION_FROM_EXECUTE_QUERY, SOME_CI_NOT_VISIBLE_DUE_TO_SECURITY_CONSTRAINT |
[Tabelle : 6. Rückgaben]

{#r_CMDBG-getManualCIList_S_B__table_ffx_szx_kx}  

    // Script example for requireCompleteSet being false:
        var getManualCIList = function(groupSysId) {
        var parser = new JSONParser();
        var response = sn_cmdbgroup.CMDBGroupAPI.getManualCIList(groupSysId, false);
        var parsed = parser.parse(response);
        if (parsed.result) {
            gs.info("succeed to retrieve ci list: " + parsed.idList);
        } else {
            gs.info("fail to retrieve list, errors: " + JSON.stringify(parsed.errors));
        }
    }
    // create a group in cmdb_group, and add CIs to this group in Edit Manual CI form
    var groupExists = "d0d2d25113152200eef2dd828144b0e4";
    // use a non-exist group
    var groupDoesNotExists = "d0d2d25113152200eef2dd828144b0e4111";
    getManualCIList(groupExists);
    getManualCIList(groupDoesNotExists);
     
Ausgabe: (Zeilenumbrüche zur Formatierung hinzugefügt.)

    succeed to retrieve ci 
    list: 6b43105c37301000deeabfc8bcbe5db2,2dfd7c8437201000deeabfc8bcbe5d56
    fail to retrieve list, errors: 
    [{"message":"Group does not exist","error":"GROUP_SYS_ID_IS_NOT_FOUND"}]

    // Script example for requireCompleteSet being true
        var getManualCIList = function(groupSysId) {
        var parser = new JSONParser();
        var response = sn_cmdbgroup.CMDBGroupAPI.getManualCIList(groupSysId, true);
        var parsed = parser.parse(response);
        if (parsed.result) {
            gs.info("succeed to retrieve ci list: " + parsed.idList);
        } else {
            gs.info("fail to retrieve list, errors: " + JSON.stringify(parsed.errors));
        }
    }
    // create a group in cmdb_group, and add CIs to this group in Edit Manual CI form
    var groupExists = "d0d2d25113152200eef2dd828144b0e4";
    getManualCIList(groupExists);

Ausgabe: (Zeilenumbrüche zur Formatierung hinzugefügt.)

    fail to retrieve list, errors: 
    [{"message":"Some CI(s) not visible due to security constraint",
    "error":"SOME_CI_NOT_VISIBLE_DUE_TO_SECURITY_CONSTRAINT"}]

## CMDBGroupAPI -- getSavedQueryIdList(Zeichenfolge groupId, boolescher Wert für „required CompleteSet") {#ariaid-title5}

Gibt die Abfrage-IDs des Abfragegenerators für die angegebene CMDB-Gruppe zurück.
{#r_CMDBG-getSavedQueryIdList_S_B__table_ewk_lfy_kx__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| group_id | Zeichenfolge | Die sysId der CMDB-Gruppe. |
| AnforderungsCompleteSet | Boolean | Bei „wahr" wird eine leere Zeichenfolge zurückgegeben, wenn CIs durch ACL-Einschränkungen herausgefiltert werden. |
[Tabelle : 7. Parameter]

{#r_CMDBG-getSavedQueryIdList_S_B__table_ewk_lfy_kx} {#r_CMDBG-getSavedQueryIdList_S_B__table_fwk_lfy_kx__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Eine JSON-formatierte Zeichenfolge im Format { 'result':false, 'errors':[ {'message':'Group does not exist', 'error':'GROUP_SYS_ID_IS_NOT_FOUND'}, { } // another error if it exists ], 'partialCIListDueToACLFlag':false, 'idList':['sys_id_1', 'sys_id2'] } Wobei * Ergebnis: Eine boolesche Kennzeichnung. Bei „wahr" war die Methode erfolgreich. * Fehler: Eine Liste von Fehlern mit einer Meldung und einem Fehlercode. * PartialCIListDueToACLFlag: Eine boolesche Kennzeichnung. Bei „wahr" ist die idList aufgrund einer ACL-Einschränkung unvollständig. Bei „falsch" ist die idList abgeschlossen. * IdList: Ein Array von cmdb_ci sys_IDs {#r_CMDBG-getSavedQueryIdList_S_B__ul_hb5_4sp_mx} Wenn nicht erfolgreich, wird einer der Fehler „GROUP_SYS_ID_IS_NOT_FOUND", „GROUP_SYS_ID_IS_EMPTY", „FAIL_TO_INSERT_GROUP_CI_PAIR", „FAIL_TO_INSERT_GROUP_QUERY_ID_PAIR", „CI_CAN_NOT_FOUND" zurückgegeben. SAVED_QUERY_ID_NOT_FOUND, ERROR_DURING_QUERY_BUILDER_PROCESS_QUERY, TIMEOUT_DURING_QUERY_BUILDER_PROCESS_QUERY, NOT_COMPLETE_DURING_QUERY_BUILDER_PROCESS_QUERY, MAX_LIMIT_DURING_QUERY_BUILDER_PROCESS_QUERY, GROUP_API_TIMEOUT, EXCEPTION_FROM_EXECUTE_QUERY, SOME_CI_NOT_VISIBLE_DUE_TO_SECURITY_CONSTRAINT |
[Tabelle : 8. Rückgaben]

{#r_CMDBG-getSavedQueryIdList_S_B__table_fwk_lfy_kx}  

    // Script example:
    var getSavedQueryIdList = function(groupSysId) {
        var parser = new JSONParser();
        var response = sn_cmdbgroup.CMDBGroupAPI.getSavedQueryIdList(groupSysId, false);
        var parsed = parser.parse(response);
        if (parsed.result) {
            gs.info("succeed to retrieve saved query id list: " + parsed.idList);
        } else {
            gs.info("fail to retrieve list, errors: " + JSON.stringify(parsed.errors));
        }
    }
    var groupExists = "d0d2d25113152200eef2dd828144b0e4";
    var groupDoesNotExists = "d0d2d25113152200eef2dd828144b0e4111";
    getSavedQueryIdList(groupExists);
    getSavedQueryIdList(groupDoesNotExists);

Ausgabe: (Zeilenumbrüche zur Formatierung hinzugefügt.)

    succeed to retrieve saved query id list: 5d498532d7c12200de92a5f75e6103ce
    fail to retrieve list, errors:
     [{"message":"Group does not exist","error":"GROUP_SYS_ID_IS_NOT_FOUND"}]

## CMDBGroupAPI -- setManualCIList(Zeichenfolge groupId, Zeichenfolge ciSysIds) {#ariaid-title6}

Legt die manuelle CI-Liste für die angegebene Gruppe fest. Die vorhandene manuelle CI-Liste wird überschrieben. CI-SYS-IDs, die in der Tabelle „cmdb_ci" nicht gefunden wurden, werden ignoriert.
{#r_CMDBG-setManualCIList_S_S__table_zt3_cnz_kx__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| group_id | Zeichenfolge | Die sysId der CMDB-Gruppe. |
| ciSysIds | Zeichenfolge | Kommagetrennte Liste von CI-sysIds. |
[Tabelle : 9. Parameter]

{#r_CMDBG-setManualCIList_S_S__table_zt3_cnz_kx} {#r_CMDBG-setManualCIList_S_S__table_a53_cnz_kx__entry__2}{#r_CMDBG-setManualCIList_S_S__CMDBGroupAPI_JSON_output}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Eine JSON-formatierte Zeichenfolge im Format { 'result':false, 'errors':[ {'message':'Group does not exist', 'error':'GROUP_SYS_ID_IS_NOT_FOUND'}, { } // another error if it exists ], 'partialCIListDueToACLFlag':false, 'idList':['sys_id_1', 'sys_id2'] } Wobei * Ergebnis: Eine boolesche Kennzeichnung. Bei „wahr" war die Methode erfolgreich. * Fehler: Eine Liste von Fehlern mit einer Meldung und einem Fehlercode. * PartialCIListDueToACLFlag: Eine boolesche Kennzeichnung. Bei „wahr" ist die idList aufgrund einer ACL-Einschränkung unvollständig. Bei „falsch" ist die idList abgeschlossen. * IdList: Ein Array von cmdb_ci sys_IDs {#r_CMDBG-setManualCIList_S_S__ul_hb5_4sp_mx} Wenn nicht erfolgreich, wird einer der Fehler „GROUP_SYS_ID_IS_NOT_FOUND", „GROUP_SYS_ID_IS_EMPTY", „FAIL_TO_INSERT_GROUP_CI_PAIR", „FAIL_TO_INSERT_GROUP_QUERY_ID_PAIR", „CI_CAN_NOT_FOUND" zurückgegeben. SAVED_QUERY_ID_NOT_FOUND, ERROR_DURING_QUERY_BUILDER_PROCESS_QUERY, TIMEOUT_DURING_QUERY_BUILDER_PROCESS_QUERY, NOT_COMPLETE_DURING_QUERY_BUILDER_PROCESS_QUERY, MAX_LIMIT_DURING_QUERY_BUILDER_PROCESS_QUERY, GROUP_API_TIMEOUT, EXCEPTION_FROM_EXECUTE_QUERY, SOME_CI_NOT_VISIBLE_DUE_TO_SECURITY_CONSTRAINT |
[Tabelle : 10. Rückgaben]

{#r_CMDBG-setManualCIList_S_S__table_a53_cnz_kx}  

    // Script example:
    var setManualCIListFunc = function(groupSysId, manualCIList) {
        var parser = new JSONParser();
        var response = sn_cmdbgroup.CMDBGroupAPI.setManualCIList(groupSysId, manualCIList);
        var parsed = parser.parse(response);
        if (parsed.result) {
            gs.info("succeed to set manual ci list");
        } else {
            gs.info("fail to set manual ci list, errors: " + JSON.stringify(parsed.errors));
        }
    }
    var group = "d0d2d25113152200eef2dd828144b0e4";
    var groupDoesNotExist = "1234";
    var manualCIList = "b4fd7c8437201000deeabfc8bcbe5dc1, affd3c8437201000deeabfc8bcbe5dc3";
    setManualCIListFunc(group, manualCIList);
    setManualCIListFunc(groupDoesNotExist, manualCIList);

Ausgabe: (Zeilenumbrüche zur Formatierung hinzugefügt.)

    succeed to set manual ci list
    fail to set manual ci list, errors: [{"message":"Group does not exist","error":
    "GROUP_SYS_ID_IS_NOT_FOUND"}]

## CMDBGroupAPI -- setSavedQueryIdList(Zeichenfolge groupId, Zeichenfolge queryIds) {#ariaid-title7}

Legt die gespeicherte Abfrage-ID-Liste für die angegebene Gruppe fest. Die vorhandene Abfrage-ID-Liste wird überschrieben. Abfrage-SYS-IDs, die in der Tabelle „qb_saved_query" nicht gefunden wurden, werden ignoriert.
{#r_CMDBG-setSavedQueryIdList_S_S__table_h3d_1qz_kx__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| group_id | Zeichenfolge | Die sysId der CMDB-Gruppe. |
| QueryIds | Zeichenfolge | Kommagetrennte Liste der gespeicherten Abfrage-sysIds. |
[Tabelle : 11. Parameter]

{#r_CMDBG-setSavedQueryIdList_S_S__table_h3d_1qz_kx} {#r_CMDBG-setSavedQueryIdList_S_S__table_i3d_1qz_kx__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Eine JSON-formatierte Zeichenfolge im Format { 'result':false, 'errors':[ {'message':'Group does not exist', 'error':'GROUP_SYS_ID_IS_NOT_FOUND'}, { } // another error if it exists ], 'partialCIListDueToACLFlag':false, 'idList':['sys_id_1', 'sys_id2'] } Wobei * Ergebnis: Eine boolesche Kennzeichnung. Bei „wahr" war die Methode erfolgreich. * Fehler: Eine Liste von Fehlern mit einer Meldung und einem Fehlercode. * PartialCIListDueToACLFlag: Eine boolesche Kennzeichnung. Bei „wahr" ist die idList aufgrund einer ACL-Einschränkung unvollständig. Bei „falsch" ist die idList abgeschlossen. * IdList: Ein Array von cmdb_ci sys_IDs {#r_CMDBG-setSavedQueryIdList_S_S__ul_hb5_4sp_mx} Wenn nicht erfolgreich, wird einer der Fehler „GROUP_SYS_ID_IS_NOT_FOUND", „GROUP_SYS_ID_IS_EMPTY", „FAIL_TO_INSERT_GROUP_CI_PAIR", „FAIL_TO_INSERT_GROUP_QUERY_ID_PAIR", „CI_CAN_NOT_FOUND" zurückgegeben. SAVED_QUERY_ID_NOT_FOUND, ERROR_DURING_QUERY_BUILDER_PROCESS_QUERY, TIMEOUT_DURING_QUERY_BUILDER_PROCESS_QUERY, NOT_COMPLETE_DURING_QUERY_BUILDER_PROCESS_QUERY, MAX_LIMIT_DURING_QUERY_BUILDER_PROCESS_QUERY, GROUP_API_TIMEOUT, EXCEPTION_FROM_EXECUTE_QUERY, SOME_CI_NOT_VISIBLE_DUE_TO_SECURITY_CONSTRAINT |
[Tabelle : 12. Rückgaben]

{#r_CMDBG-setSavedQueryIdList_S_S__table_i3d_1qz_kx}  

    // Script example:
    var setSavedQueryIdListFunc = function(groupSysId, queryIdList) {
        var parser = new JSONParser();
        var response = sn_cmdbgroup.CMDBGroupAPI.setSavedQueryIdList(groupSysId, queryIdList);
        var parsed = parser.parse(response);
        if (parsed.result) {
            gs.info("succeed to set saved query id list");
        } else {
            gs.info("fail to set saved query id list, errors: " + JSON.stringify(parsed.errors));
        }
    }
    var group = "d0d2d25113152200eef2dd828144b0e4";
    var savedQueryBuilderIdList = "394585fed7812200de92a5f75e6103e8";
    var savedQueryBuilderIdNotExistList = "b4fd7c8437201000deeabfc8bcbe5dc1,
       affd3c8437201000deeabfc8bcbe5dc3";
     
    setSavedQueryIdListFunc(group, savedQueryBuilderIdList);
    setSavedQueryIdListFunc(group, savedQueryBuilderIdNotExistList);

Ausgabe: (Zeilenumbrüche zur Formatierung hinzugefügt.)

    succeed to set saved query id list
    fail to set saved query id list, errors: [{"message":
    "Saved query id(b4fd7c8437201000deeabfc8bcbe5dc1) is not found for 
    group(d0d2d25113152200eef2dd828144b0e4)","error":
    "SAVED_QUERY_ID_NOT_FOUND"},{"message":
    "Saved query id(affd3c8437201000deeabfc8bcbe5dc3) is not found for 
    group(d0d2d25113152200eef2dd828144b0e4)","error":"SAVED_QUERY_ID_NOT_FOUND"}]


