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


---

# CMDBQBScopedScriptableAPI -- Umfang

# CMDBQBScopedScriptableAPI -- Umfang {#ariaid-title1}

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

Stellt Methoden zur Ausführung bereit Configuration Management Database (CMDB)Abfragegenerator-Vorgänge in serverseitigen Skripts.

Diese API ist das bereichsbezogene Äquivalent von [CMDBQueryBuilderAPI -- Global](https://servicenow-prod.fluidtopics.net/prhTrIlCntOB7zBH0Hkxuw#CMDBQueryBuilderAPI "Stellt Methoden zur Ausführung bereit Configuration Management Database (CMDB)Abfragegenerator-Vorgänge in serverseitigen Skripts.").

Diese API erfordert das Plugin „Konfigurationsverwaltung für bereichsbezogene Apps" (com.snc.cmdb.scope) und wird in bereitgestellt `sn_cmdb `Namespace.

Für weitere Informationen zu CMDBAbfragegenerator, siehe [CMDB Query Builder](https://www.servicenow.com/docs/access?context=cmdb-query-builder-landing-page&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US).

## CMDBQBScopedScriptableAPI -- createReport(Zeichenfolge savedQueryId, Zeichenfolge savedQueryName) {#ariaid-title2}

Erstellt einen Bericht, der die Ergebnisse von anzeigt Configuration Management Database (CMDB)Abfrage-Generator-Abfrage und gibt die URL des Berichts zurück.
{#CMDBQB-createReport_S_S__id_nfx_fns_pbc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| savedQueryId | Zeichenfolge | SYS_ID der Abfrage, die für den Bericht verwendet werden soll. Dieser Parameter ist nicht erforderlich, wenn ein Abfragename angegeben wird. Tabelle: Gespeicherte Abfragen \[qb_saved_query\] |
| SavedQueryName | Zeichenfolge | Name der Abfrage, die für den Bericht verwendet werden soll. Dieser Parameter ist nicht erforderlich, wenn eine Abfrage-sys_ID angegeben wird. Tabelle: Gespeichert in Name Feld der Tabelle „gespeicherte Abfragen" \[qb_saved_query\]. |
[Tabelle : 1. Parameter]

{#CMDBQB-createReport_S_S__id_nfx_fns_pbc} {#CMDBQB-createReport_S_S__id_d3g_gns_pbc__entry__2}

| Typ | Beschreibung |
|-|-|
| Objekt | Details zum erstellten Bericht und zu Fehlern. { "error": "String", "message": "String", "status": "String" } |
| \<Object\>.Fehler | Fehlercode. Wird zurückgegeben, wenn die Berichterstellung fehlschlägt oder ungültige Eingabeparameter angegeben werden. Mögliche Fehler: * `USER_NOT_AUTHORIZED_EXCEPTION` * `UNGÜLTIGER_PARAM` * `QUERY_SYS_ID_INVALID` {#CMDBQB-createReport_S_S__ul_bgg_kls_pbc} Datentyp: Zeichenfolge |
| \<Object\>.Nachricht | Nachricht mit Details zum Erfolg oder Fehler der Berichterstellung. Mögliche Nachrichten: * `<report-url>` * `Anwender ist nicht berechtigt, einen CMDBQueryBuilder-Abfragebericht zu erstellen` * `Ungültige Parameter. Geben Sie entweder eine gültige sysId oder einen gültigen Namen einer gespeicherten Abfrage an` * `Ungültige AbfrageID. Geben Sie eine gültige gespeicherte Abfrage-ID an` {#CMDBQB-createReport_S_S__ul_cgg_kls_pbc} Datentyp: Zeichenfolge |
| \<Object\>.Status | Statuscode. Wird zurückgegeben, wenn die Aktualisierung erfolgreich ist. Wert: `Erfolg ` Datentyp: Zeichenfolge |
[Tabelle : 2. Rückgaben]

{#CMDBQB-createReport_S_S__id_d3g_gns_pbc}  
Dieses Beispiel zeigt, wie ein Bericht erstellt wird, indem ein gespeicherter Abfragename übergeben wird.

    gs.info(JSON.stringify(sn_cmdb.CMDBQBScopedScriptableAPI.createReport('','CMDBQueryTest1')));

Ausgabe:

    {
       "message":"\/sys_report_template.do?sysparm_report_source_id=6d299cf81bbd4210bccf42a3b24bcb7a&sysparm_type=list&sysparm_title=CMDBQueryTest1&sysparm_source_type=source&sysparm_from_list=true&sysparm_chart_size=large&sysparm_manual_labor=true",
       "status":"success"
    }

Dieses Beispiel zeigt einen Fehler an, wenn sowohl die Abfrage-sys_ID als auch der Name im Methodenaufruf fehlen.

    gs.info(JSON.stringify(sn_cmdb.CMDBQBScopedScriptableAPI.createReport('', '')));

Ausgabe:

    {
       "error":"INVALID_PARAM",
       "message":"Invalid Parameters. Please provide either a valid sysId or a valid name of a saved query"
    }

## CMDBQBScopedScriptableAPI -- deleteQuery(Zeichenfolge savedQueryId, Zeichenfolge savedQueryName) {#ariaid-title3}

Löscht einen Configuration Management Database (CMDB)Abfrage des Abfragegenerators.
{#CMDBQB-deleteQuery_S_S__id_hxw_tn4_pbc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| savedQueryId | Zeichenfolge | SYS_ID der zu löschenden Abfrage. Dieser Parameter ist nicht erforderlich, wenn ein Abfragename angegeben wird. Tabelle: Gespeicherte Abfragen \[qb_saved_query\] |
| SavedQueryName | Zeichenfolge | Name der zu löschenden Abfrage. Dieser Parameter ist nicht erforderlich, wenn eine Abfrage-sys_ID angegeben wird. Tabelle: Gespeichert in <var class="keyword varname">Name </var>Feld der Tabelle „gespeicherte Abfragen" \[qb_saved_query\]. |
[Tabelle : 3. Parameter]

{#CMDBQB-deleteQuery_S_S__id_hxw_tn4_pbc} {#CMDBQB-deleteQuery_S_S__id_aww_5n4_pbc__entry__2}

| Typ | Beschreibung |
|-|-|
| Objekt | Details zur gelöschten Abfrage und zu allen Fehlern. { "error": "String", "message": "String", "status": "String" } |
| \<Object\>.Fehler | Fehlercode. Wird zurückgegeben, wenn der Löschvorgang fehlschlägt oder ungültige Eingabeparameter angegeben werden. Mögliche Fehler: * `USER_NOT_AUTHORIZED_EXCEPTION` * `UNGÜLTIGER_PARAM` * `QUERY_DELETE_FAILED` {#CMDBQB-deleteQuery_S_S__ul_ynr_pl4_pbc} Datentyp: Zeichenfolge |
| \<Object\>.Nachricht | Nachricht mit Details zum Erfolg oder Fehler des Löschvorgangs. Mögliche Nachrichten: * `Die gespeicherte Abfrage wurde erfolgreich gelöscht` * `Anwender ist nicht berechtigt, eine CMDBQueryBuilder-Abfrage zu löschen` * `Ungültige Parameter. Geben Sie entweder eine gültige sysId oder einen gültigen Namen einer gespeicherten Abfrage an` * `Fehler beim Löschen der angegebenen gespeicherten Abfrage` {#CMDBQB-deleteQuery_S_S__ul_znr_pl4_pbc} Datentyp: Zeichenfolge |
| \<Object\>.Status | Statuscode. Wird zurückgegeben, wenn die Aktualisierung erfolgreich ist. Wert: `Erfolg ` Datentyp: Zeichenfolge |
[Tabelle : 4. Rückgaben]

{#CMDBQB-deleteQuery_S_S__id_aww_5n4_pbc}  
Dieses Beispiel zeigt, wie eine gespeicherte Abfrage durch Übergabe des Abfragenamens gelöscht wird.

    gs.info(JSON.stringify(sn_cmdb.CMDBQBScopedScriptableAPI.deleteQuery('', 'CMDBQueryTest1')));

Ausgabe:

    {
       "message":"Successfully deleted the saved query",
       "status":"success"
    }

Dieses Beispiel zeigt einen Fehler an, wenn sowohl die Abfrage-sys_ID als auch der Name im Methodenaufruf fehlen.

    gs.info(JSON.stringify(sn_cmdb.CMDBQBScopedScriptableAPI.deleteQuery('', '')));

Ausgabe:

    {
       "error":"INVALID_PARAM",
       "message":"Invalid Parameters. Please provide either a valid sysId or a valid name of a saved query"
    }

## CMDBQBScopedScriptableAPI -- getSavedQueryExecutionDetails (Zeichenfolge savedQueryName, boolesche executeQuery, Zahlenzeitüberschreitung) {#ariaid-title4}

Gibt die Ausführungsdetails für zurück Configuration Management Database (CMDB)Abfrage des Abfragegenerators.
Optional können Sie die Abfrage ausführen, um aktuelle Ausführungsdetails zurückzugeben.

Wenn während der Ausführung der Abfrage eine Zeitüberschreitung oder ein Speicherproblem auftritt, können Sie die Größe des Abfragebatches optimieren, um diese Probleme zu lindern. Weitere Informationen finden Sie unter [Batchgröße für gespeicherte Abfragen des Abfragegenerators](https://www.servicenow.com/docs/access?context=batch-size-query&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US).
{#CMDBQB-getSavedQueryExeDts_S_B_N__id_ezv_4vz_pbc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| SavedQueryName | Zeichenfolge | Name der Abfrage, für die Ausführungsdetails abgerufen werden sollen. Tabelle: <var class="keyword varname">Name </var>Feld in der Tabelle „gespeicherte Abfragen" \[qb_saved_query\]. |
| ExecuteQuery | Boolean | Optional. Kennzeichnung, die angibt, ob die angegebene Abfrage ausgeführt werden soll. Gültige Werte: * Wahr: Führen Sie die angegebene Abfrage aus, und geben Sie ihre Ausführungsdetails zurück. * Falsch: Die angegebene Abfrage nicht ausführen. Gibt die neuesten Ausführungsdetails für die Abfrage zurück. {#CMDBQB-getSavedQueryExeDts_S_B_N__ul_enk_jtn_kjb} Standard: Falsch |
| Zeitüberschreitung | Nummer | Optional. Ganzzahliger Wert, der den standardmäßigen Zeitüberschreitungsgrenzwert für die Abfrageausführung von fünf Minuten überschreibt. Einheit: Sekunden Standard: Fünf Minuten |
[Tabelle : 5. Parameter]

{#CMDBQB-getSavedQueryExeDts_S_B_N__id_ezv_4vz_pbc} {#CMDBQB-getSavedQueryExeDts_S_B_N__id_wyc_pvz_pbc__entry__2}

| Typ | Beschreibung |
|-|-|
| Objekt | Details zur Abfrageausführung und zu Fehlern. { "error": "String", "message": "String", "query_id": "String", "status": "String", "table_name": "String" } |
| \<Object\>.Fehler | Fehlercode. Wird zurückgegeben, wenn die Ausführung der Abfrage fehlschlägt oder die angegebene Abfrage nicht gefunden wird. Mögliche Fehler: * `QUERY_EXECUTION_NOT_FOUND` * `QUERY_NOT_FOUND` * `QUERY_EXECUTION_FAILED` * `USER_NOT_AUTHORIZED_EXCEPTION` {#CMDBQB-getSavedQueryExeDts_S_B_N__ul_ylr_lyn_kjb} Datentyp: Zeichenfolge |
| \<Object\>.Nachricht | Nachricht mit Details zum Fehlercode. Wird zurückgegeben, wenn die Ausführung der Abfrage fehlschlägt oder die angegebene Abfrage nicht gefunden wird. Mögliche Nachrichten: * `Details zur Abfrageausführung nicht gefunden. Führen Sie die Abfrage aus.` * `Angegebene gespeicherte Abfrage nicht gefunden. Stellen Sie sicher, dass Sie den Namen einer gespeicherten Abfrage übergeben.` * `Abfrageausführung fehlgeschlagen. Verwenden Sie eine gültige Abfrage.` * `Anwender ist nicht zum Ausführen einer CMDBQueryBuilder-Abfrage berechtigt.` {#CMDBQB-getSavedQueryExeDts_S_B_N__ul_kwz_zsz_pbc} Datentyp: Zeichenfolge |
| \<Object\>.Query_ID | SYS_ID der Abfrageausführung. Datentyp: Zeichenfolge Tabelle: Abfragestatus \[qb_query_Status\] |
| \<Object\>.Status | Status der Abfrageausführung. * ABGESCHLOSSEN: Ausführung ist abgeschlossen. * FEHLGESCHLAGEN: Fehler beim Ausführen der Abfrage. * TIME_OUT: Zeitüberschreitung bei der Ausführung der Abfrage. * MAX_LIMIT: Maximale Anzahl von Rückgabeergebnissen erreicht. {#CMDBQB-getSavedQueryExeDts_S_B_N__ul_p2f_5yn_kjb} Datentyp: Zeichenfolge |
| \<Object\>.Table_Name | Name der Tabelle, die die Details der Abfrageausführung enthält. Datentyp: Zeichenfolge |
[Tabelle : 6. Rückgaben]

{#CMDBQB-getSavedQueryExeDts_S_B_N__id_wyc_pvz_pbc}  
Dieses Beispiel zeigt, wie eine gespeicherte Abfrage ausgeführt und der Zeitüberschreitungswert für die Abfrageausführung auf 10 Minuten festgelegt wird.

    gs.info(JSON.stringify(sn_cmdb.CMDBQBScopedScriptableAPI.getSavedQueryExecutionDetails('Test', true, 600)));

Ausgabe:

    {
       "query_id":"024fd53a7773330033b5270bba106141",
       "table_name":"u_cmdb_qb_result_598918aacb4dbf3f1a8dcf03fce6a5d57151a4e2",
       "status":COMPLETE
    }

## CMDBQBScopedScriptableAPI -- saveQuery(Zeichenfolge savedQueryName, Zeichenfolge queryJson) {#ariaid-title5}

Speichert Configuration Management Database (CMDB)Abfrage-Generator-Abfrage und gibt die sys_ID der gespeicherten Abfrage zurück.
{#CMDBQB-saveQuery_S_S__id_nfl_dym_pbc__entry__3}{#CMDBQB-saveQuery_S_S__save-query-name}{#CMDBQB-saveQuery_S_S__save-query-json}

| Name | Typ | Beschreibung |
|-|-|-|
| SavedQueryName | Zeichenfolge | Name, unter dem die Abfrage gespeichert werden soll. Tabelle: Gespeichert in Name Feld der Tabelle „gespeicherte Abfragen" \[qb_saved_query\]. |
| QueryJson | Zeichenfolge | JSON, das die Abfrage definiert. Tabelle: Gespeichert in Abfrage Feld der Tabelle „gespeicherte Abfragen" \[qb_saved_query\]. |
[Tabelle : 7. Parameter]

{#CMDBQB-saveQuery_S_S__id_nfl_dym_pbc} {#CMDBQB-saveQuery_S_S__id_acg_5zm_pbc__entry__2}

| Typ | Beschreibung |
|-|-|
| Objekt | Objekt mit Details zur gespeicherten Abfrage und zu allen Fehlern. { "error": "String", "message": "String", "status": "String" } |
| \<Object\>.Fehler | Fehlercode. Wird zurückgegeben, wenn der Speichervorgang fehlschlägt oder ungültige Eingabeparameter angegeben werden. Mögliche Fehler: * `USER_NOT_AUTHORIZED_EXCEPTION` * `QUERY_NAME_INVALID` * `ABFRAGE_UNGÜLTIG` * `QUERY_EXISTS_ALREADY` * `QUERY_SAVE_FAILED` {#CMDBQB-saveQuery_S_S__ul_pp2_ttm_pbc} Datentyp: Zeichenfolge |
| \<Object\>.Nachricht | Nachricht mit Details zum Erfolg oder Fehler des Speichervorgangs. Mögliche Nachrichten: * `Die Abfrage wurde erfolgreich mit der sysId-<sy_id> gespeichert` * `Anwender ist nicht berechtigt, eine CMDBQueryBuilder-Abfrage zu speichern` * `Abfragename ist leer. Geben Sie einen Namen an` * `AbfrageJson ist ungültig. Geben Sie eine gültige queryJson an` * `Abfragename wird bereits verwendet. Verwenden Sie einen anderen Namen` * `Unerwartete Ausnahme beim Speichern der Abfrage` {#CMDBQB-saveQuery_S_S__ul_qj1_qvm_pbc} Datentyp: Zeichenfolge |
| \<Object\>.Status | Statuscode. Wird zurückgegeben, wenn der Speichervorgang erfolgreich ist. Wert: `Erfolg ` Datentyp: Zeichenfolge |
[Tabelle : 8. Rückgaben]

{#CMDBQB-saveQuery_S_S__id_acg_5zm_pbc}  
Dieses Beispiel zeigt, wie der Tabelle „gespeicherte Abfragen" \[qb_saved_query\] eine Abfrage hinzugefügt wird.

    var queryJson = "{\"type\":\"cmdb\",\"nodes\":[{\"label\":\"Server\",\"unique_id\":\"d93f96981b310210bccf42a3b24bcb41\",\"nodeType\":\"class\",\"image\":\"images/app.ngbsm/server.svg\",\"properties\":\"\",\"allowed_connections\":[],\"filters\":{\"platform\":\"cmdb_ci_server\",\"custom\":\"\"},\"ci_type\":\"cmdb_ci_server\",\"ci_type_label\":\"Server\",\"sys_id\":\"d93f96981b310210bccf42a3b24bcb41\",\"x\":72,\"y\":337,\"returnValues\":[],\"filters_attrib\":\"\",\"applied_filters\":\"\",\"isStartNode\":true,\"nodeId\":\"d93f96981b310210bccf42a3b24bcb41_4_23_2024_5_50_54\",\"name\":\"Server 1\",\"type\":\"class\",\"refFilterApplied\":false,\"focused\":false,\"id\":\"d93f96981b310210bccf42a3b24bcb41_4_23_2024_5_50_54\",\"className\":\"cmdb_ci_server\"},{\"label\":\"Database\",\"unique_id\":\"b640269c1b310210bccf42a3b24bcb36\",\"nodeType\":\"class\",\"image\":\"images/app.ngbsm/database.svg\",\"properties\":\"\",\"allowed_connections\":[],\"filters\":{\"platform\":\"cmdb_ci_database\",\"custom\":\"\"},\"ci_type\":\"cmdb_ci_database\",\"ci_type_label\":\"Database\",\"sys_id\":\"b640269c1b310210bccf42a3b24bcb36\",\"x\":510,\"y\":340,\"returnValues\":[],\"filters_attrib\":\"\",\"applied_filters\":\"\",\"isStartNode\":false,\"nodeId\":\"b640269c1b310210bccf42a3b24bcb36_4_23_2024_5_50_57\",\"name\":\"Database 1\",\"type\":\"class\",\"refFilterApplied\":false,\"focused\":false,\"id\":\"b640269c1b310210bccf42a3b24bcb36_4_23_2024_5_50_57\",\"className\":\"cmdb_ci_database\"}],\"edges\":[{\"id\":\"Server 1_Database 1\",\"from\":\"d93f96981b310210bccf42a3b24bcb41_4_23_2024_5_50_54\",\"to\":\"b640269c1b310210bccf42a3b24bcb36_4_23_2024_5_50_57\",\"isDotted\":false,\"type\":\"relation\",\"isReverse\":false,\"direction\":\"outbound\",\"hiddenLevel\":0,\"relations\":[\"607ad1b2c0a8010e01941856b365af90\",\"1a9cb166f1571100a92eb60da2bce5c5\"]}],\"usedNames\":{\"cmdb_ci_server\":1,\"cmdb_ci_database\":1}}";
    gs.info(JSON.stringify(sn_cmdb.CMDBQBScopedScriptableAPI.saveQuery('CMDBQueryTest1', queryJson)));

Ausgabe:

    {
       "message":"Successfully saved the query with sysId d93f96981b310210bccf42a3b24bcb41",
       "status":"success"
    }

Dieses Beispiel zeigt einen Fehler, wenn eine ungültige JSON-Abfrage angegeben wird.

    var queryJson = "Test";
    gs.info(JSON.stringify(sn_cmdb.CMDBQBScopedScriptableAPI.saveQuery('Test', queryJson)));

Ausgabe:

    {
       "error":"QUERY_INVALID",
       "message":"QueryJson is invalid. Please provide a valid queryJson"
    }

## CMDBQBScopedScriptableAPI -- updateQuery(Zeichenfolge savedQueryId, Zeichenfolge savedQueryName, Zeichenfolge queryJson) {#ariaid-title6}

Aktualisiert die JSON für einen Configuration Management Database (CMDB)Abfrage des Abfragegenerators.
{#CMDBQB-updateQuery_S_S_S__id_ecz_vh4_pbc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| savedQueryId | Zeichenfolge | SYS_ID der zu aktualisierenden Abfrage. Dieser Parameter ist nicht erforderlich, wenn ein Abfragename angegeben wird. Tabelle: Gespeicherte Abfragen \[qb_saved_query\] |
| SavedQueryName | Zeichenfolge | Name der zu aktualisierenden Abfrage. Dieser Parameter ist nicht erforderlich, wenn eine Abfrage-sys_ID angegeben wird. Tabelle: Gespeichert in <var class="keyword varname">Name </var>Feld in der Tabelle „gespeicherte Abfragen" \[qb_saved_query\]. |
| QueryJson | Zeichenfolge | JSON, mit dem die Abfrage aktualisiert werden soll. Tabelle: Gespeichert in <var class="keyword varname">Abfrage </var>Feld in der Tabelle „gespeicherte Abfragen" \[qb_saved_query\]. |
[Tabelle : 9. Parameter]

{#CMDBQB-updateQuery_S_S_S__id_ecz_vh4_pbc} {#CMDBQB-updateQuery_S_S_S__id_d3q_134_pbc__entry__2}

| Typ | Beschreibung |
|-|-|
| Objekt | Details zur aktualisierten Abfrage und zu allen Fehlern. { "error": "String", "message": "String", "status": "String" } |
| \<Object\>.Fehler | Fehlercode. Wird zurückgegeben, wenn das Update fehlschlägt oder ungültige Eingabeparameter angegeben werden. Mögliche Fehler: * `USER_NOT_AUTHORIZED_EXCEPTION` * `UNGÜLTIGER_PARAM` * `ABFRAGE_UNGÜLTIG` * `QUERY_UPDATE_FAILED` * `UNAUTHORIZED_REPORT_SOURCE_USER` {#CMDBQB-updateQuery_S_S_S__ul_xbd_nd4_pbc} Datentyp: Zeichenfolge |
| \<Object\>.Nachricht | Nachricht mit Details zum Erfolg oder Fehler des Updates. Mögliche Nachrichten: * `Die gespeicherte Abfrage wurde erfolgreich aktualisiert` * `Anwender ist nicht berechtigt, eine CMDBQueryBuilder-Abfrage zu aktualisieren` * `Ungültige Parameter. Geben Sie entweder eine gültige sysId oder einen gültigen Namen einer gespeicherten Abfrage an` * `AbfrageJson ist ungültig. Geben Sie eine gültige queryJson an` * `Fehler beim Aktualisieren der angegebenen gespeicherten Abfrage` * `Anwender ist nicht berechtigt, die Berichtsquelle einer gespeicherten Abfrage zu aktualisieren` {#CMDBQB-updateQuery_S_S_S__ul_ybd_nd4_pbc} Datentyp: Zeichenfolge |
| \<Object\>.Status | Statuscode. Wird zurückgegeben, wenn die Aktualisierung erfolgreich ist. Wert: `Erfolg ` Datentyp: Zeichenfolge |
[Tabelle : 10. Rückgaben]

{#CMDBQB-updateQuery_S_S_S__id_d3q_134_pbc}  
Dieses Beispiel zeigt, wie eine gespeicherte Abfrage durch Übergabe des Abfragenamens aktualisiert wird.

    var queryJson = "{\"type\":\"cmdb\",\"nodes\":[{\"label\":\"Server\",\"unique_id\":\"d93f96981b310210bccf42a3b24bcb41\",\"nodeType\":\"class\",\"image\":\"images/app.ngbsm/server.svg\",\"properties\":\"\",\"allowed_connections\":[],\"filters\":{\"platform\":\"cmdb_ci_server\",\"custom\":\"\"},\"ci_type\":\"cmdb_ci_server\",\"ci_type_label\":\"Server\",\"sys_id\":\"d93f96981b310210bccf42a3b24bcb41\",\"x\":72,\"y\":336,\"returnValues\":[],\"filters_attrib\":\"\",\"applied_filters\":\"\",\"isStartNode\":true,\"nodeId\":\"d93f96981b310210bccf42a3b24bcb41_4_23_2024_5_50_54\",\"name\":\"Server 1\",\"type\":\"class\",\"refFilterApplied\":false,\"focused\":false,\"id\":\"d93f96981b310210bccf42a3b24bcb41_4_23_2024_5_50_54\",\"className\":\"cmdb_ci_server\"},{\"label\":\"Web Server\",\"unique_id\":\"984f5a981b310210bccf42a3b24bcb03\",\"nodeType\":\"class\",\"image\":\"images/app.ngbsm/web_server.svg\",\"properties\":\"\",\"allowed_connections\":[],\"filters\":{\"platform\":\"cmdb_ci_web_server\",\"custom\":\"\"},\"ci_type\":\"cmdb_ci_web_server\",\"ci_type_label\":\"Web Server\",\"sys_id\":\"984f5a981b310210bccf42a3b24bcb03\",\"x\":446,\"y\":330,\"returnValues\":[],\"filters_attrib\":\"\",\"applied_filters\":\"\",\"isStartNode\":false,\"nodeId\":\"984f5a981b310210bccf42a3b24bcb03_4_23_2024_6_32_19\",\"name\":\"Web Server 1\",\"type\":\"class\",\"refFilterApplied\":false,\"focused\":false,\"id\":\"984f5a981b310210bccf42a3b24bcb03_4_23_2024_6_32_19\",\"className\":\"cmdb_ci_web_server\"}],\"edges\":[{\"id\":\"Server 1_Web Server 1\",\"from\":\"d93f96981b310210bccf42a3b24bcb41_4_23_2024_5_50_54\",\"to\":\"984f5a981b310210bccf42a3b24bcb03_4_23_2024_6_32_19\",\"isDotted\":false,\"type\":\"relation\",\"isReverse\":false,\"direction\":\"outbound\",\"hiddenLevel\":0,\"relations\":[\"607ad1b2c0a8010e01941856b365af90\"]}],\"usedNames\":{\"cmdb_ci_server\":1,\"cmdb_ci_database\":1,\"cmdb_ci_web_server\":1}}";
    gs.info(JSON.stringify(sn_cmdb.CMDBQBScopedScriptableAPI.updateQuery('', 'CMDBQueryTest1', queryJson)));

Ausgabe:

    {
       "message":"Successfully updated the saved query",
       "status":"success"
    }

Dieses Beispiel zeigt einen Fehler an, wenn sowohl die Abfrage-sys_ID als auch der Name im Methodenaufruf fehlen.

    var queryJson = "{\"type\":\"cmdb\",\"nodes\":[{\"label\":\"Server\",\"unique_id\":\"d93f96981b310210bccf42a3b24bcb41\",\"nodeType\":\"class\",\"image\":\"images/app.ngbsm/server.svg\",\"properties\":\"\",\"allowed_connections\":[],\"filters\":{\"platform\":\"cmdb_ci_server\",\"custom\":\"\"},\"ci_type\":\"cmdb_ci_server\",\"ci_type_label\":\"Server\",\"sys_id\":\"d93f96981b310210bccf42a3b24bcb41\",\"x\":72,\"y\":336,\"returnValues\":[],\"filters_attrib\":\"\",\"applied_filters\":\"\",\"isStartNode\":true,\"nodeId\":\"d93f96981b310210bccf42a3b24bcb41_4_23_2024_5_50_54\",\"name\":\"Server 1\",\"type\":\"class\",\"refFilterApplied\":false,\"focused\":false,\"id\":\"d93f96981b310210bccf42a3b24bcb41_4_23_2024_5_50_54\",\"className\":\"cmdb_ci_server\"},{\"label\":\"Web Server\",\"unique_id\":\"984f5a981b310210bccf42a3b24bcb03\",\"nodeType\":\"class\",\"image\":\"images/app.ngbsm/web_server.svg\",\"properties\":\"\",\"allowed_connections\":[],\"filters\":{\"platform\":\"cmdb_ci_web_server\",\"custom\":\"\"},\"ci_type\":\"cmdb_ci_web_server\",\"ci_type_label\":\"Web Server\",\"sys_id\":\"984f5a981b310210bccf42a3b24bcb03\",\"x\":446,\"y\":330,\"returnValues\":[],\"filters_attrib\":\"\",\"applied_filters\":\"\",\"isStartNode\":false,\"nodeId\":\"984f5a981b310210bccf42a3b24bcb03_4_23_2024_6_32_19\",\"name\":\"Web Server 1\",\"type\":\"class\",\"refFilterApplied\":false,\"focused\":false,\"id\":\"984f5a981b310210bccf42a3b24bcb03_4_23_2024_6_32_19\",\"className\":\"cmdb_ci_web_server\"}],\"edges\":[{\"id\":\"Server 1_Web Server 1\",\"from\":\"d93f96981b310210bccf42a3b24bcb41_4_23_2024_5_50_54\",\"to\":\"984f5a981b310210bccf42a3b24bcb03_4_23_2024_6_32_19\",\"isDotted\":false,\"type\":\"relation\",\"isReverse\":false,\"direction\":\"outbound\",\"hiddenLevel\":0,\"relations\":[\"607ad1b2c0a8010e01941856b365af90\"]}],\"usedNames\":{\"cmdb_ci_server\":1,\"cmdb_ci_database\":1,\"cmdb_ci_web_server\":1}}";
    gs.info(JSON.stringify(sn_cmdb.CMDBQBScopedScriptableAPI.updateQuery('', '', queryJson)));

Ausgabe:

    {
       "error":"INVALID_PARAM",
       "message":"Invalid Parameters. Please provide either a valid sysId or a valid name of a saved query"
    }


