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


---

# CDMEditorAPI

# CDMEditorAPI {#ariaid-title1}

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

Die CdmEditorApi stellt Endpunkte bereit, mit denen Sie Knoten erstellen, Knoten aktualisieren, vorhandene Knoten unter anderen Knoten einfügen, Knoten löschen und Knoten und Knoteneinbindungen abrufen können.  
Sie müssen eine der folgenden Rollen aufweisen, um auf diese API zugreifen zu können:

* Scripted REST CDM View ACL (sn_cdm.cdm.viewer)
* Scripted REST CDM Editor ACL (sn_cdm.cdm_editor)

Um verschlüsselte Felder anzuzeigen, benötigen Sie die Rolle „CDM-Geheimnis".

Außerdem muss das Plugin Konfigurationsdaten-Management (CDM) aktiviert sein, damit diese API in einer -Instanz verfügbar ist.  
Hinweis:  
Die CdmEditorApi- API kann nicht zum Ändern von Dateien verwendet werden. Derzeit ist nur das Löschen von Dateien zulässig.

## CdmEditorApi -- /sn_cdm/editor/nodes LÖSCHEN {#ariaid-title2}

Löscht einen angegebenen Knoten.
Der Aufrufer dieses Endpunkts muss über die Rolle „CDM-Editor" verfügen.

### URL-Format

URL mit Versionsnummer: /api/sn_cdm/{api_version}/editor/nodes

Standard-URL: /api/sn_cdm/editor/nodes

### Unterstützte Anforderungsparameter

{#editor-DELETE-nodes__entry__2}{#editor-DELETE-nodes__version-RESTAPI}

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel <kbd class="ph userinput">v1</kbd> oder <kbd class="ph userinput">v2</kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
[Tabelle : 1. Pfadparameter]

{#editor-DELETE-nodes__entry__6}{#editor-DELETE-nodes__changesetNumber-changeset-entry}{#editor-DELETE-nodes__fullNamePath-node-editor-entry}

| Name | Beschreibung |
|-|-|
| changesetNumber | Erforderlich. Eindeutiger Bezeichner des zugeordneten Changesets, z. B. „Chset-10". Befindet sich in der Tabelle „CDMChangeset" \[sn_cdm_changeset\]. Datentyp: Zeichenfolge |
| vollständigerNamenspfad | Erforderlich. Pfadname des zu löschenden Knotens. Sie können den Namenspfad in einem der folgenden Formate übergeben. Um beispielsweise den folgenden Knoten `testApp/deployables/Development1/cdi1`zu löschen: * Backslash-Format: testApp/deployables/Development1/cdi1 Hinweis: Wenn Ihr Knotenname einen umgekehrten Schrägstrich („/") enthält, können Sie dieses Format nicht verwenden. * Back-End-Namenspfad mit Ersetzungszeichen: testApp¬deployables¬Development1cdi1 * Array: \['testApp','deployables','Development1','cdi1'\] {#editor-DELETE-nodes__ul_xrv_rc1_cyb} Datentyp: Zeichenfolge |
[Tabelle : 2. Abfrageparameter]

{#editor-DELETE-nodes__entry__12}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 3. Anforderungstextparameter]

### Kopfzeilen

Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter [Unterstützte REST API-Header](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.").
{#editor-DELETE-nodes__entry__16}{#editor-DELETE-nodes__accept-JSON-only-entry-RESTAPI}

| Kopfzeile | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützt nur application/json. |
[Tabelle : 4. Anforderungskopfzeilen]

{#editor-DELETE-nodes__entry__20}

| Kopfzeile | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 5. Antwortkopfzeilen]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter [HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API.
{#editor-DELETE-nodes__entry__24}{#editor-DELETE-nodes__entry-200-status-code}{#editor-DELETE-nodes__entry-400-status-code}{#editor-DELETE-nodes__entry-500-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler. |
[Tabelle : 6. Statuscodes]

### Parameter des Antwort-Haupttexts

{#editor-DELETE-nodes__entry__32}

| Name | Beschreibung |
|-|-|
| Keine |   |
[ ]

### cURL-Anforderung

Das folgende Codebeispiel zeigt, wie der Knoten „cdi88" gelöscht wird.

    curl "http://instance.servicenow.com/api/sn_cdm/editor/nodes?changesetNumber=Chset783&fullNamePath=%2FtestApp%2Fdeployables%2FDevelopment-1%2Fcdi88" \
    --request DELETE \
    --header "Accept:application/json" \
    --user 'username':'password'

Ergebnis zurückgeben:

    None - just the associated HTTP status code

## CdmEditorApi: GET /sn_cdm/editor/includes {#ariaid-title3}

Gibt die Liste der Knoten zurück, die in einem angegebenen Knotenpfad enthalten waren.
Der Anrufer dieses Endpunkts muss über die Rolle „CDM-Betrachter" verfügen.

### URL-Format

URL mit Versionsnummer: /api/sn_cdm/{api_version}/editor/includes

Standard-URL: /api/sn_cdm/editor/includes

### Unterstützte Anforderungsparameter

{#editor-GET-includes__entry__2}{#editor-GET-includes__version-RESTAPI}

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel <kbd class="ph userinput">v1</kbd> oder <kbd class="ph userinput">v2</kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
[Tabelle : 7. Pfadparameter]

{#editor-GET-includes__entry__6}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 8. Abfrageparameter]

{#editor-GET-includes__entry__10}{#editor-GET-includes__cdm_apps-returnFields-entry}

| Name | Beschreibung |
|-|-|
| changesetNumber | Eindeutiger Bezeichner des zugeordneten Changesets, z. B. „Chset-10". Befindet sich in der Tabelle „CDMChangeset" \[sn_cdm_changeset\]. Datentyp: Zeichenfolge |
| returnFields | Liste der Felder, die als Teil der Antwort zurückgegeben werden sollen. Übergeben Sie die Datensatzspaltennamen wie sys_id, sys_updated_by oder state. Datentyp: Array Standard: Alle Felder wie vom Endpunkt bestimmt |
| sourceFullNamePath | Erforderlich. Pfadname des Quellknotens, für den die enthaltenen Knoten zurückgegeben werden sollen. Sie können den Namenspfad in einem der folgenden Formate übergeben. Um beispielsweise die Einbindungen für den Knoten „ `collectionA` " im Verzeichnis „testApp/collections" zurückzugeben, gehen Sie wie folgt vor: * Format mit umgekehrtem Schrägstrich: testApp/collections/collectionA Hinweis: Wenn Ihr Knotenname einen umgekehrten Schrägstrich („/") enthält, können Sie dieses Format nicht verwenden. * Back-End-Namenspfad mit Ersetzungszeichen: testApp Sammlungsammlungen SammlungA * Array: \['testApp','collections','collectionA'\] Datentyp: Zeichenfolge |
[Tabelle : 9. Anforderungstextparameter]

### Header

Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter [Unterstützte REST API-Header](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.").
{#editor-GET-includes__entry__18}{#editor-GET-includes__accept-JSON-only-entry-RESTAPI}

| Kopfzeile | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützt nur application/json. |
[Tabelle : 10. Anforderungskopfzeilen]

{#editor-GET-includes__entry__22}

| Kopfzeile | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 11. Antwortkopfzeilen]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter [HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API.
{#editor-GET-includes__entry__26}{#editor-GET-includes__entry-200-status-code}{#editor-GET-includes__entry-400-status-code}{#editor-GET-includes__entry-500-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler. |
[Tabelle : 12. Statuscodes]

### Parameter des Antwort-Haupttexts

{#editor-GET-includes__id_jpm_rxl_c5b__entry__2}{#editor-GET-includes__conflict-node-editor-entry}{#editor-GET-includes__conflict_type-node-editor-entry}{#editor-GET-includes__description-node-editor-entry}{#editor-GET-includes__effective_from-node-editor-entry}{#editor-GET-includes__effective_to-node-editor-entry}{#editor-GET-includes__level-node-editor-entry}{#editor-GET-includes__linked_to-node-editor-entry}{#editor-GET-includes__main_id-node-editor-entry}{#editor-GET-includes__main_id_encoded-node-editor-entry}{#editor-GET-includes__node_classifier-node-editor-entry}{#editor-GET-includes__previous_version-node-editor-entry}{#editor-GET-includes__restricted_to-node-editor-entry}{#editor-GET-includes__system_folder-node-editor-entry}

| Name | Beschreibung |
|-|-|
| changeset_id | Eindeutiger Bezeichner des zugeordneten Changesets, z. B. „Chset-10". Befindet sich in der Tabelle „CDMChangeset" \[sn_cdm_changeset\]. Datentyp: Zeichenfolge |
| Konflikt | Kennzeichnung, die angibt, ob bei der Verarbeitung des Knotens ein Konflikt aufgetreten ist. Mögliche Werte: * true: Konflikt erkannt. * „falsch": Es wurde kein Konflikt erkannt. Datentyp: Boolesch |
| Konflikttyp | Wenn der Parameter conflict auf „true" festgelegt ist, wird der Typ des erkannten Konflikts erkannt. NULL, wenn kein Konflikt erkannt wird. Mögliche Werte: * beschädigter_Knoten * delete_node * duplicated_node * unvollständig_gelöscht_übergeordnet * unvollständig_gelöscht_ref * unvollständig_umbenannt_ref * ungültig_include * verwaiste_descendant * related_conflict * unlinked_include * unrennamed_include * update_node Datentyp: Zeichenfolge |
| Beschreibung | Kurze Beschreibung des Zwecks des Knotens. Datentyp: Zeichenfolge |
| effektiv_von | Zeitstempel (in eine lange Ganzzahl konvertiert), wenn der Knoten als Teil des Changesets committet wurde. Wenn der Knoten nicht festgelegt wurde, ist dieser Wert „null". Datentyp: Ganzzahl |
| effektiv_bis | Zeitstempel (in eine lange Ganzzahl konvertiert) des Knotens, wann er gelöscht oder durch einen anderen Knoten ersetzt wurde, ansonsten „null". Datentyp: Ganzzahl |
| Fehler | Wenn während der Verarbeitung ein Fehler aufgetreten ist, die Details zum Fehler. Datentyp: Objekt "error": { "detail": "String", "message": "String" } |
| Fehler.detail | Zusätzliche Informationen zum Fehler. Datentyp: Zeichenfolge |
| Fehlernachricht | Fehlermeldung, die beim Versuch, die Anforderung zu verarbeiten, generiert wurde. Datentyp: Zeichenfolge |
| level | Ebene des Knotens, beginnend mit dem Stammknoten, der immer 0 ist. Beispiel: Der Knoten /AppA/components/compA hat zwei Ebenen. Datentyp: Zeichenfolge |
| linked_to | Der Parameter main_id des referenzierten Knotens, mit dem dieser Knoten verknüpft ist. Wenn dieser Knoten nicht mit einem Referenzknoten verknüpft ist, ist der Wert „null". Datentyp: Zeichenfolge |
| main_id | Primärer Bezeichner für den Knoten. Sie können diesen Wert in der Skripteinbindung CdmQuery() verwenden, um eine JSON-Struktur abzurufen. Beispiel: `CdmQuery().mainId('123')/query().getTree();` Datentyp: Zeichenfolge |
| main_id_encoded | RADIX 57-Zeichenfolgendarstellung des Parameters main_id des Knotens. Datentyp: Zeichenfolge |
| name | Name des Knotens, der im Zielpfad enthalten war. Datentyp: Zeichenfolge |
| node_classifier | Klassifiziererhierarchie des Knotens. Verwenden Sie diese Informationen, um einen Knoten innerhalb der Ordnerhierarchie zu finden. Ein bereitstellbares Element hat beispielsweise die Hierarchie /application/deployables/env:Development Während eine Sammlung eine Hierarchie von /applications/collectionshätte Datentyp: Zeichenfolge |
| node_path | Vollständiger Pfadname des Knotens, der im Zielpfad enthalten war, z. B. /Production/deployables/Development1/cdi1. Datentyp: Zeichenfolge |
| position | Knotenposition. Beispiel: Wenn Sie das folgende Array hochladen: arrayNode1: [ "literal1", {"cdi1": 1}, "literal3" ] Die Positionswerte werden wie folgt festgelegt: * arrayNode1.literal1 = 1000 * arrayNode1.2000 = 2000 * arrayNode1.literal3 = 3000 {#editor-GET-includes__ul_ybk_wg2_25b}Wenn ein komplexes Objekt unter einem Array hochgeladen wird, in diesem Fall `{"cdi1": 1}`, erstellt der Endpunkt einen neuen virtuellen Knoten, dessen Name seiner Position entspricht. Im obigen Beispiel ist dies 2000. Bei Einbindungen ist die Position immer leer. Datentyp: Zeichenfolge |
| previous_version | Details der vorherigen Version des Knotendatensatzes. Hinweis: Wenn ein neuer Knoten erstellt wurde, gibt der Endpunkt für diesen Parameter `„ previous_version" = null` zurück. Datentyp: Objekt "previous_version": { "link": "String", "value": "String" } |
| Beschränken_auf | Details der Gruppe, die Zugriff auf den zugeordneten Knoten hat. Datentyp: Objekt "restricted_to": { "link": "String", "value": "String" } |
| Secure_value | Wenn dieser Wert als gesichert gekennzeichnet wurde, wird das verschlüsselte Feld (maskiert zurückgegeben) Ein Anwender muss über die Rolle sn_cdm.cdm_secrets verfügen, um diese Informationen zu entschlüsseln. Sie können den Endpunkt so festlegen, dass diese Felder nicht zurückgegeben werden, indem Sie das Abfrageparameterfeld returnFields festlegen. Datentyp: Zeichenfolge |
| status | Knotenstatus Mögliche Werte: * GELÖSCHT * NEW * ERSETZT * AKTUALISIERT * GÜLTIG Datentyp: Zeichenfolge |
| sys_id | Sys_id des Knotens. Befindet sich in der Tabelle „CDM-Knoten" \[sn_cdm_node\]. Datentyp: Zeichenfolge |
| system_folder | Kennzeichnung, die angibt, ob der zugeordnete Knoten ein Systemordner ist. Mögliche Werte: * wahr: Knoten ist ein Systemordner. * false: Knoten ist kein Systemordner. Datentyp: Boolesch |
| type | Knotentyp. Mögliche Werte: * sn_cdm_node_cdi * sn_cdm_node_collection * sn_cdm_node_component * sn_cdm_node_folder * sn_cdm_node_variable Datentyp: Zeichenfolge |
| Wert | Knotenwert Datentyp: Zeichenfolge |
[ ]

{#editor-GET-includes__id_jpm_rxl_c5b}  

### cURL-Anforderung

Dieses Codebeispiel zeigt, wie die Includes im Quellpfad /testApp/collections/collA abgerufen werden.

    curl "http://instance.servicenow.com/api/sn_cdm/editor/includes?changesetNumber=Chset5&sourceFullNamePath=%2FtestApp%2Fcollections%2FcollA" \
    --request GET \
    --header "Accept:application/json" \
    --user 'username':'password'

Ergebnis zurückgeben:

    { 
      "result": [ 
        { 
          "sys_id": "a1c517a953b70110a1d3ddeeff7b129b", 
          "type": "sn_cdm_node_deployable", 
          "main_id": "6", 
          "main_id_encoded": ",", 
          "node_path": "!$!+!,", 
          "level": 2, 
          "status": "valid", 
          "node_classifier": "/application/deployables/env:Development", 
          "position": null, 
          "restricted_to": null, 
          "changeset_id": "e9c517a953b70110a1d3ddeeff7b1299", 
          "previous_version": null, 
          "effective_from": "1654002206866", 
          "effective_to": null, 
          "name": "Development_1", 
          "description": null, 
          "value": null, 
          "secure_value": null, 
          "system_folder": "0", 
          "linked_to": null, 
          "conflict": "0", 
          "conflict_type": null 
        } 
      ] 
    }

## CdmEditorApi -- GET /sn_cdm/editor/nodes {#ariaid-title4}

Gibt die Details eines angegebenen Knotens oder einer Liste von untergeordneten Knoten Konfigurationsdaten-Management (CDM) für einen angegebenen übergeordneten Knoten zurück.
Der Anrufer dieses Endpunkts muss über die Rolle „CDM-Betrachter" verfügen.

### URL-Format

URL mit Versionsnummer: /api/sn_cdm/{api_version}/editor/nodes

Standard-URL: /api/sn_cdm/editor/nodes

### Unterstützte Anforderungsparameter

{#editor-GET-nodes__entry__2}{#editor-GET-nodes__version-RESTAPI}

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel <kbd class="ph userinput">v1</kbd> oder <kbd class="ph userinput">v2</kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
[Tabelle : 13. Pfadparameter]

{#editor-GET-nodes__entry__6}{#editor-GET-nodes__cdm_apps-returnFields-entry}{#editor-GET-nodes__type-node-editor-entry}

| Name | Beschreibung |
|-|-|
| changesetNumber | Eindeutiger Bezeichner des zugeordneten Changesets, z. B. „Chset-10". Befindet sich in der Tabelle „CDMChangeset" \[sn_cdm_changeset\]. Datentyp: Zeichenfolge |
| decryptPassword | Kennzeichnung, die angibt, ob der Wert für die Endknoten verschlüsselt werden soll. Gültige Werte: * true: Verschlüsselt * false: Nicht verschlüsselt Datentyp: Boolesch Standardwert: false |
| name | Knotenname Wenn Sie diesen Parameter übergeben, werden nur die Ergebnisse für den angegebenen Knoten zurückgegeben. Datentyp: Zeichenfolge Standard: Alle Knoten innerhalb des übergeordneten Knotens |
| parentFullNamePath | Erforderlich. Pfadname des übergeordneten Knotens, für den die untergeordneten Knoten zurückgegeben werden sollen oder an dem sich der im Parameter name angegebene Knoten befindet. Sie können den Namenspfad in einem der folgenden Formate übergeben. Um beispielsweise die Knoten für den Knoten „ `collectionA` " im Verzeichnis „testApp/collections" zurückzugeben, gehen Sie wie folgt vor: * Format mit umgekehrtem Schrägstrich: testApp/collections/collectionA Hinweis: Wenn Ihr Knotenname einen umgekehrten Schrägstrich („/") enthält, können Sie dieses Format nicht verwenden. * Back-End-Namenspfad mit Ersetzungszeichen: testApp Sammlungsammlungen SammlungA * Array: \['testApp','collections','collectionA'\] Datentyp: Zeichenfolge |
| returnFields | Liste der Felder, die als Teil der Antwort zurückgegeben werden sollen. Übergeben Sie die Datensatzspaltennamen wie sys_id, sys_updated_by oder state. Datentyp: Array Standard: Alle Felder wie vom Endpunkt bestimmt |
| type | Knotentyp. Mögliche Werte: * sn_cdm_node_cdi ODER cdi * sn_cdm_node_collection ODER Sammlung * sn_cdm_node_component ODER Komponente * sn_cdm_node_folder ODER Ordner * sn_cdm_node_variable ODER-Variable Datentyp: Zeichenfolge Standard: Alle |
[Tabelle : 14. Abfrageparameter]

{#editor-GET-nodes__entry__20}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 15. Anforderungstextparameter]

### Kopfzeilen

Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter [Unterstützte REST API-Header](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.").
{#editor-GET-nodes__entry__24}{#editor-GET-nodes__accept-JSON-only-entry-RESTAPI}

| Kopfzeile | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützt nur application/json. |
[Tabelle : 16. Anforderungskopfzeilen]

{#editor-GET-nodes__entry__28}

| Kopfzeile | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 17. Antwortkopfzeilen]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter [HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API.
{#editor-GET-nodes__entry__32}{#editor-GET-nodes__entry-200-status-code}{#editor-GET-nodes__entry-400-status-code}{#editor-GET-nodes__entry-500-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler. |
[Tabelle : 18. Statuscodes]

### Parameter des Antwort-Haupttexts

{#editor-GET-nodes__id_nwg_5jl_c5b__entry__2}{#editor-GET-nodes__changeset-node-editor-entry}{#editor-GET-nodes__changeset_link-node-editor-entry}{#editor-GET-nodes__changeset_value-node-editor-entry}{#editor-GET-nodes__conflict-node-editor-entry}{#editor-GET-nodes__conflict_type-node-editor-entry}{#editor-GET-nodes__description-node-editor-entry}{#editor-GET-nodes__effective_from-node-editor-entry}{#editor-GET-nodes__effective_to-node-editor-entry}{#editor-GET-nodes__level-node-editor-entry}{#editor-GET-nodes__linked_to-node-editor-entry}{#editor-GET-nodes__main_id-node-editor-entry}{#editor-GET-nodes__main_id_encoded-node-editor-entry}{#editor-GET-nodes__name-node-editor-entry}{#editor-GET-nodes__node_classifier-node-editor-entry}{#editor-GET-nodes__name_path-node-editor-entry}{#editor-GET-nodes__position-node-editor-entry}{#editor-GET-nodes__previous_version-node-editor-entry}{#editor-GET-nodes__previous_version_link-node-editor-entry}{#editor-GET-nodes__previous_version_value-node-editor-entry}{#editor-GET-nodes__restricted_to-node-editor-entry}{#editor-GET-nodes__restricted_to_link-node-editor-entry}{#editor-GET-nodes__restricted_to_value-node-editor-entry}{#editor-GET-nodes__secure_value-node-editor-entry}{#editor-GET-nodes__status-node-editor-entry}{#editor-GET-nodes__system_folder-node-editor-entry}{#editor-GET-nodes__sys_class_name-node-editor-entry}{#editor-GET-nodes__sys_created_by-node-editor-entry}{#editor-GET-nodes__sys_created_on-node-editor-entry}{#editor-GET-nodes__sys_id-node-editor-entry}{#editor-GET-nodes__sys_updated_by-node-editor-entry}{#editor-GET-nodes__sys_updated_on-node-editor-entry}{#editor-GET-nodes__d2925e3563}{#editor-GET-nodes__value-node-editor-entry}

| Name | Beschreibung |
|-|-|
| changeset_id | Details des Changeset-Datensatzes, der dem Knoten zugeordnet ist. Datentyp: Objekt "changeset_id": { "link": "String", "value": "String" } |
| changeset_id.link | Rufen Sie die Syntax zum Abfragen dieses Changeset-Datensatzes mit der Tabellen -REST-API auf. Datentyp: Zeichenfolge |
| changeset_id.value | Eindeutiger Bezeichner des Changeset-Datensatzes. Befindet sich in der Tabelle „CDM-Änderungssatz" \[sn_cdm_changeset\]. Datentyp: Zeichenfolge |
| Konflikt | Kennzeichnung, die angibt, ob bei der Verarbeitung des Knotens ein Konflikt aufgetreten ist. Mögliche Werte: * true: Konflikt erkannt. * „falsch": Es wurde kein Konflikt erkannt. Datentyp: Boolesch |
| Konflikttyp | Wenn der Parameter conflict auf „true" festgelegt ist, wird der Typ des erkannten Konflikts erkannt. NULL, wenn kein Konflikt erkannt wird. Mögliche Werte: * beschädigter_Knoten * delete_node * duplicated_node * unvollständig_gelöscht_übergeordnet * unvollständig_gelöscht_ref * unvollständig_umbenannt_ref * ungültig_include * verwaiste_descendant * related_conflict * unlinked_include * unrennamed_include * update_node Datentyp: Zeichenfolge |
| Beschreibung | Kurze Beschreibung des Zwecks des Knotens. Datentyp: Zeichenfolge |
| effektiv_von | Zeitstempel (in eine lange Ganzzahl konvertiert), wenn der Knoten als Teil des Changesets committet wurde. Wenn der Knoten nicht festgelegt wurde, ist dieser Wert „null". Datentyp: Ganzzahl |
| effektiv_bis | Zeitstempel (in eine lange Ganzzahl konvertiert) des Knotens, wann er gelöscht oder durch einen anderen Knoten ersetzt wurde, ansonsten „null". Datentyp: Ganzzahl |
| Fehler | Wenn während der Verarbeitung ein Fehler aufgetreten ist, die Details zum Fehler. Datentyp: Objekt "error": { "detail": "String", "message": "String" } |
| Fehler.detail | Zusätzliche Informationen zum Fehler. Datentyp: Zeichenfolge |
| Fehlernachricht | Fehlermeldung, die beim Versuch, die Anforderung zu verarbeiten, generiert wurde. Datentyp: Zeichenfolge |
| level | Ebene des Knotens, beginnend mit dem Stammknoten, der immer 0 ist. Beispiel: Der Knoten /AppA/components/compA hat zwei Ebenen. Datentyp: Zeichenfolge |
| linked_to | Der Parameter main_id des referenzierten Knotens, mit dem dieser Knoten verknüpft ist. Wenn dieser Knoten nicht mit einem Referenzknoten verknüpft ist, ist der Wert „null". Datentyp: Zeichenfolge |
| main_id | Primärer Bezeichner für den Knoten. Sie können diesen Wert in der Skripteinbindung CdmQuery() verwenden, um eine JSON-Struktur abzurufen. Beispiel: `CdmQuery().mainId('123')/query().getTree();` Datentyp: Zeichenfolge |
| main_id_encoded | RADIX 57-Zeichenfolgendarstellung des Parameters main_id des Knotens. Datentyp: Zeichenfolge |
| name | Name des Knotens. Datentyp: Zeichenfolge |
| node_classifier | Klassifiziererhierarchie des Knotens. Verwenden Sie diese Informationen, um einen Knoten innerhalb der Ordnerhierarchie zu finden. Ein bereitstellbares Element hat beispielsweise die Hierarchie /application/deployables/env:Development Während eine Sammlung eine Hierarchie von /applications/collectionshätte Datentyp: Zeichenfolge |
| node_path | Vollständiger Knotenpfadname. Datentyp: Zeichenfolge |
| position | Knotenposition. Beispiel: Wenn Sie das folgende Array hochladen: arrayNode1: [ "literal1", {"cdi1": 1}, "literal3" ] Die Positionswerte werden wie folgt festgelegt: * arrayNode1.literal1 = 1000 * arrayNode1.2000 = 2000 * arrayNode1.literal3 = 3000 {#editor-GET-nodes__ul_ybk_wg2_25b}Wenn ein komplexes Objekt unter einem Array hochgeladen wird, in diesem Fall `{"cdi1": 1}`, erstellt der Endpunkt einen neuen virtuellen Knoten, dessen Name seiner Position entspricht. Im obigen Beispiel ist dies 2000. Bei Einbindungen ist die Position immer leer. Datentyp: Zeichenfolge |
| previous_version | Details der vorherigen Version des Knotendatensatzes. Hinweis: Wenn ein neuer Knoten erstellt wurde, gibt der Endpunkt für diesen Parameter `„ previous_version" = null` zurück. Datentyp: Objekt "previous_version": { "link": "String", "value": "String" } |
| previous_version.link | Rufen Sie die Syntax zum Abfragen dieses Knotendatensatzes mit der Tabellen -REST-API auf. Datentyp: Zeichenfolge |
| previous_version.value | Sys_id des Knotendatensatzes. Befindet sich in der Tabelle „CDM-Knoten" \[sn_cdm_node\]. Datentyp: Zeichenfolge |
| Reason_for_conflict | Ausführliche Erklärung des Konflikts. Datentyp: Zeichenfolge |
| Beschränken_auf | Details der Gruppe, die Zugriff auf den zugeordneten Knoten hat. Datentyp: Objekt "restricted_to": { "link": "String", "value": "String" } |
| strict_to.link | Rufen Sie die Syntax zum Abfragen dieses Gruppendatensatzes mit der Tabellen -REST-API auf. Datentyp: Zeichenfolge |
| „restricted_to.value" | Sys_id des Gruppendatensatzes. Befindet sich in der Tabelle „CDM-Gruppe" \[sys_user_group\]. Datentyp: Zeichenfolge |
| Secure_value | Wenn dieser Wert als gesichert gekennzeichnet wurde, wird das verschlüsselte Feld (maskiert zurückgegeben) Ein Anwender muss über die Rolle sn_cdm.cdm_secrets verfügen, um diese Informationen zu entschlüsseln. Sie können den Endpunkt so festlegen, dass diese Felder nicht zurückgegeben werden, indem Sie das Abfrageparameterfeld returnFields festlegen. Datentyp: Zeichenfolge |
| status | Knotenstatus Mögliche Werte: * GELÖSCHT * NEW * ERSETZT * AKTUALISIERT * GÜLTIG Datentyp: Zeichenfolge |
| system_folder | Kennzeichnung, die angibt, ob der zugeordnete Knoten ein Systemordner ist. Mögliche Werte: * wahr: Knoten ist ein Systemordner. * false: Knoten ist kein Systemordner. Datentyp: Boolesch |
| sys_class_name | Tabelle, in der sich der Knoten befindet. Datentyp: Zeichenfolge |
| sys_created_by | Name des Anwenders, der den Knoten erstellt hat. Datentyp: Zeichenfolge |
| sys_created_on | Datum und Uhrzeit der Erstellung des Knotens. Datentyp: Zeichenfolge Format: jjjj-mm-tt hh:mm:ss |
| sys_id | Sys_id des Knotens. Befindet sich in der Tabelle „CDM-Knoten" \[sn_cdm_node\]. Datentyp: Zeichenfolge |
| sys_updated_by | Name des Benutzers, der den Knoten aktualisiert hat. Datentyp: Zeichenfolge |
| sys_updated_on | Datum und Uhrzeit der letzten Aktualisierung des Knotens. Datentyp: Zeichenfolge Format: jjjj-mm-tt hh:mm:ss |
| type | Knotentyp. Mögliche Werte: * sn_cdm_node_cdi * sn_cdm_node_collection * sn_cdm_node_component * sn_cdm_node_folder * sn_cdm_node_variable Datentyp: Zeichenfolge Standard: Alle |
| Wert | Knotenwert Datentyp: Zeichenfolge |
[ ]

{#editor-GET-nodes__id_nwg_5jl_c5b}  

### cURL-Anforderung

Dieses Codebeispiel zeigt, wie die untergeordneten Knoten vom Typ „sn_cdm_node_cdi" unter dem übergeordneten Knoten „/testApp/Fdeployables/Development_1" abgerufen werden.

    curl "http://instance.servicenow.com/api/sn_cdm/editor/nodes?decryptPassword=true&name=cdi45&changesetNumber=Chset3&parentFullNamePath=%2FtestApp%2Fdeployables%2FDevelopment_1&type=sn_cdm_node_cdi" \
    --request GET \
    --header "Accept:application/json" \
    --user 'username':'password'

Ergebnis zurückgeben:

    { 
      "result": [ 
        { 
          "changeset_id": { 
            "value": "d403648653b70110a1d3ddeeff7b12c5", 
            "link": "http://instance.servicenow.com/api/now/table/sn_cdm_changeset/d403648653b70110a1d3ddeeff7b12c5" 
          }, 
          "node_path": "!$!+!,![:", 
          "description": null, 
          "sys_updated_on": "2022-06-30 09:24:07", 
          "type": "sn_cdm_node_cdi", 
          "sys_class_name": "sn_cdm_node", 
          "sys_id": "c93c7c1753981110a1d3ddeeff7b12c7", 
          "sys_updated_by": "admin", 
          "previous_version": null, 
          "sys_created_on": "2022-06-30 08:53:13", 
          "value": "cdcdc", 
          "effective_from": null, 
          "linked_to": null, 
          "sys_created_by": "admin", 
          "restricted_to": null, 
          "level": "3", 
          "conflict_type": null, 
          "main_id": "2869", 
          "effective_to": null, 
          "secure_value": null, 
          "node_classifier": "/application/deployables/env:Development", 
          "main_id_encoded": "[:", 
          "name": "cdi45", 
          "position": null, 
          "reason_for_conflict": null, 
          "system_folder": false, 
          "status": "new", 
          "conflict": false 
        } 
      ] 
    }

## CdmEditorApi -- POST /sn_cdm/editor/includes {#ariaid-title5}

Schließt einen vorhandenen Knoten in einen anderen Knoten ein, z. B. einen Komponentenknoten in einen Sammlungsknoten oder einen Sammlungsknoten in einen bereitstellbaren Knoten. Nach dem Einfügen eines Knotens verfügt der neue Knoten über eine eigene eindeutige sys_id und main_Id.
Der Aufrufer dieses Endpunkts muss über die Rolle „CDM-Editor" verfügen.

### URL-Format

URL mit Versionsnummer: /api/sn_cdm/{api_version}/editor/includes

Standard-URL: /api/sn_cdm/editor/includes

### Unterstützte Anforderungsparameter

{#editor-POST-includes__entry__2}{#editor-POST-includes__version-RESTAPI}

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel <kbd class="ph userinput">v1</kbd> oder <kbd class="ph userinput">v2</kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
[Tabelle : 19. Pfadparameter]

{#editor-POST-includes__entry__6}{#editor-POST-includes__cdm_apps-returnFields-entry}

| Name | Beschreibung |
|-|-|
| changesetNumber | Erforderlich. Eindeutige Nummer des offenen Changesets, das in den Zielknoten aufgenommen werden soll. Befindet sich in der Tabelle „CDM-Änderungssatz" \[sn_cdm_changeset\]. Datentyp: Zeichenfolge |
| returnFields | Liste der Felder, die als Teil der Antwort zurückgegeben werden sollen. Übergeben Sie die Datensatzspaltennamen wie sys_id, sys_updated_by oder state. Datentyp: Array Standard: Alle Felder wie vom Endpunkt bestimmt |
| sourceFullNamePath | Erforderlich. Pfadname des Knotens, der in den Zielknoten aufgenommen werden soll. Sie können den Namenspfad in einem der folgenden Formate übergeben. Um beispielsweise den folgenden Knoten `Staging/deployables/Development1/cdi1 einzubeziehen`: * Format mit umgekehrtem Schrägstrich: Staging/deployables/Development1/cdi1 Hinweis: Wenn Ihr Knotenname einen umgekehrten Schrägstrich („/") enthält, können Sie dieses Format nicht verwenden. * Back-End-Namenspfad mit Ersetzungszeichen: Staging¬deployables¬Development1¬cdi1 * Array: \['Staging','deployables','Development1','cdi1'\] Datentyp: Zeichenfolge |
| targetFullNamePath | Erforderlich. Pfadname des Knotens, unter dem der Quellknoten enthalten sein soll. Sie können den Namenspfad in einem der folgenden Formate übergeben. Um beispielsweise den folgenden Knoten einzubeziehen: `Production/deployables/Development1`: * Format mit umgekehrtem Schrägstrich: Production/deployables/Development1/cdi1 Hinweis: Wenn Ihr Knotenname einen umgekehrten Schrägstrich („/") enthält, können Sie dieses Format nicht verwenden. * Back-End-Namenspfad mit Ersetzungszeichen: Produktion, bereitstellbare Elemente, Entwicklung1, cdi1 * Array: \['Production','deployables','Development1','cdi1'\] {#editor-POST-includes__ul_wk2_k21_cyb} Datentyp: Zeichenfolge |
[Tabelle : 20. Abfrageparameter]

{#editor-POST-includes__entry__16}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 21. Anforderungstextparameter]

### Kopfzeilen

Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter [Unterstützte REST API-Header](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.").
{#editor-POST-includes__entry__20}{#editor-POST-includes__accept-JSON-only-entry-RESTAPI}{#editor-POST-includes__content_type-JSON-only-entry-RESTAPI}

| Kopfzeile | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützt nur application/json. |
| Content-Type | Datenformat des Anforderungstexts. Unterstützt nur application/json. |
[Tabelle : 22. Anforderungskopfzeilen]

{#editor-POST-includes__entry__26}

| Kopfzeile | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 23. Antwortkopfzeilen]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter [HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API.
{#editor-POST-includes__entry__30}{#editor-POST-includes__entry-200-status-code}{#editor-POST-includes__entry-400-status-code}{#editor-POST-includes__entry-500-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler. |
[Tabelle : 24. Statuscodes]

### Parameter des Antwort-Haupttexts

{#editor-POST-includes__id_cvv_pxl_c5b__entry__2}{#editor-POST-includes__conflict-node-editor-entry}{#editor-POST-includes__conflict_type-node-editor-entry}{#editor-POST-includes__description-node-editor-entry}{#editor-POST-includes__effective_from-node-editor-entry}{#editor-POST-includes__effective_to-node-editor-entry}{#editor-POST-includes__level-node-editor-entry}{#editor-POST-includes__linked_to-node-editor-entry}{#editor-POST-includes__main_id-node-editor-entry}{#editor-POST-includes__main_id_encoded-node-editor-entry}{#editor-POST-includes__node_classifier-node-editor-entry}{#editor-POST-includes__previous_version-node-editor-entry}{#editor-POST-includes__restricted_to-node-editor-entry}{#editor-POST-includes__system_folder-node-editor-entry}

| Name | Beschreibung |
|-|-|
| changeset_id | Eindeutiger Bezeichner des zugeordneten Changesets, z. B. „Chset-10". Befindet sich in der Tabelle „CDMChangeset" \[sn_cdm_changeset\]. Datentyp: Zeichenfolge |
| Konflikt | Kennzeichnung, die angibt, ob bei der Verarbeitung des Knotens ein Konflikt aufgetreten ist. Mögliche Werte: * true: Konflikt erkannt. * „falsch": Es wurde kein Konflikt erkannt. Datentyp: Boolesch |
| Konflikttyp | Wenn der Parameter conflict auf „true" festgelegt ist, wird der Typ des erkannten Konflikts erkannt. NULL, wenn kein Konflikt erkannt wird. Mögliche Werte: * beschädigter_Knoten * delete_node * duplicated_node * unvollständig_gelöscht_übergeordnet * unvollständig_gelöscht_ref * unvollständig_umbenannt_ref * ungültig_include * verwaiste_descendant * related_conflict * unlinked_include * unrennamed_include * update_node Datentyp: Zeichenfolge |
| Beschreibung | Kurze Beschreibung des Zwecks des Knotens. Datentyp: Zeichenfolge |
| effektiv_von | Zeitstempel (in eine lange Ganzzahl konvertiert), wenn der Knoten als Teil des Changesets committet wurde. Wenn der Knoten nicht festgelegt wurde, ist dieser Wert „null". Datentyp: Ganzzahl |
| effektiv_bis | Zeitstempel (in eine lange Ganzzahl konvertiert) des Knotens, wann er gelöscht oder durch einen anderen Knoten ersetzt wurde, ansonsten „null". Datentyp: Ganzzahl |
| Fehler | Wenn während der Verarbeitung ein Fehler aufgetreten ist, die Details zum Fehler. Datentyp: Objekt "error": { "detail": "String", "message": "String" } |
| Fehler.detail | Zusätzliche Informationen zum Fehler. Datentyp: Zeichenfolge |
| Fehlernachricht | Fehlermeldung, die beim Versuch, die Anforderung zu verarbeiten, generiert wurde. Datentyp: Zeichenfolge |
| level | Ebene des Knotens, beginnend mit dem Stammknoten, der immer 0 ist. Beispiel: Der Knoten /AppA/components/compA hat zwei Ebenen. Datentyp: Zeichenfolge |
| linked_to | Der Parameter main_id des referenzierten Knotens, mit dem dieser Knoten verknüpft ist. Wenn dieser Knoten nicht mit einem Referenzknoten verknüpft ist, ist der Wert „null". Datentyp: Zeichenfolge |
| main_id | Primärer Bezeichner für den Knoten. Sie können diesen Wert in der Skripteinbindung CdmQuery() verwenden, um eine JSON-Struktur abzurufen. Beispiel: `CdmQuery().mainId('123')/query().getTree();` Datentyp: Zeichenfolge |
| main_id_encoded | RADIX 57-Zeichenfolgendarstellung des Parameters main_id des Knotens. Datentyp: Zeichenfolge |
| name | Name des Knotens, der im Zielpfad enthalten war. Datentyp: Zeichenfolge |
| node_classifier | Klassifiziererhierarchie des Knotens. Verwenden Sie diese Informationen, um einen Knoten innerhalb der Ordnerhierarchie zu finden. Ein bereitstellbares Element hat beispielsweise die Hierarchie /application/deployables/env:Development Während eine Sammlung eine Hierarchie von /applications/collectionshätte Datentyp: Zeichenfolge |
| node_path | Vollständiger Pfadname des Knotens, der im Zielpfad enthalten war, z. B. /Production/deployables/Development1/cdi1. Datentyp: Zeichenfolge |
| position | Knotenposition. Beispiel: Wenn Sie das folgende Array hochladen: arrayNode1: [ "literal1", {"cdi1": 1}, "literal3" ] Die Positionswerte werden wie folgt festgelegt: * arrayNode1.literal1 = 1000 * arrayNode1.2000 = 2000 * arrayNode1.literal3 = 3000 {#editor-POST-includes__ul_ybk_wg2_25b}Wenn ein komplexes Objekt unter einem Array hochgeladen wird, in diesem Fall `{"cdi1": 1}`, erstellt der Endpunkt einen neuen virtuellen Knoten, dessen Name seiner Position entspricht. Im obigen Beispiel ist dies 2000. Bei Einbindungen ist die Position immer leer. Datentyp: Zeichenfolge |
| previous_version | Details der vorherigen Version des Knotendatensatzes. Hinweis: Wenn ein neuer Knoten erstellt wurde, gibt der Endpunkt für diesen Parameter `„ previous_version" = null` zurück. Datentyp: Objekt "previous_version": { "link": "String", "value": "String" } |
| Beschränken_auf | Details der Gruppe, die Zugriff auf den zugeordneten Knoten hat. Datentyp: Objekt "restricted_to": { "link": "String", "value": "String" } |
| Secure_value | Wenn dieser Wert als gesichert gekennzeichnet wurde, wird das verschlüsselte Feld (maskiert zurückgegeben) Ein Anwender muss über die Rolle sn_cdm.cdm_secrets verfügen, um diese Informationen zu entschlüsseln. Sie können den Endpunkt so festlegen, dass diese Felder nicht zurückgegeben werden, indem Sie das Abfrageparameterfeld returnFields festlegen. Datentyp: Zeichenfolge |
| status | Knotenstatus Mögliche Werte: * GELÖSCHT * NEW * ERSETZT * AKTUALISIERT * GÜLTIG Datentyp: Zeichenfolge |
| sys_id | Sys_id des Knotens. Befindet sich in der Tabelle „CDM-Knoten" \[sn_cdm_node\]. Datentyp: Zeichenfolge |
| system_folder | Kennzeichnung, die angibt, ob der zugeordnete Knoten ein Systemordner ist. Mögliche Werte: * wahr: Knoten ist ein Systemordner. * false: Knoten ist kein Systemordner. Datentyp: Boolesch |
| type | Knotentyp. Mögliche Werte: * sn_cdm_node_cdi * sn_cdm_node_collection * sn_cdm_node_component * sn_cdm_node_folder * sn_cdm_node_variable Datentyp: Zeichenfolge |
| Wert | Knotenwert Datentyp: Zeichenfolge |
[ ]

{#editor-POST-includes__id_cvv_pxl_c5b}  

### cURL-Anforderung

Das folgende Codebeispiel zeigt, wie der Knoten /testApp/collections/collA unter /testApp/deployables/Development_1 eingefügt wird.

    curl "http://instance.servicenow.com/api/sn_cdm/editor/includes?changesetNumber=Chset5&targetFullNamePath=%2FtestApp%2Fdeployables%2FDevelopment_1&sourceFullNamePath=%2FtestApp%2Fcollecti
    ons%2FcollA" \
    --request POST \
    --header "Accept:application/json" \
    --user 'username':'password'

Ergebnis zurückgeben:

    { 
      "result": { 
        "changeset_id": { 
          "value": "d403648653b70110a1d3ddeeff7b12c5", 
          "link": "http://192.168.0.233:8080/api/now/table/sn_cdm_changeset/d403648653b70110a1d3ddeeff7b12c5" 
        }, 
        "node_path": "!$!+!,![?", 
        "description": null, 
        "sys_updated_on": "2022-06-30 09:19:47", 
        "type": "sn_cdm_node_linked", 
        "sys_class_name": "sn_cdm_node", 
        "sys_id": "1642015b53981110a1d3ddeeff7b1232", 
        "sys_updated_by": "admin", 
        "previous_version": null, 
        "sys_created_on": "2022-06-30 09:19:47", 
        "value": null, 
        "effective_from": null, 
        "linked_to": "2870", 
        "sys_created_by": "admin", 
        "restricted_to": null, 
        "level": "3", 
        "conflict_type": null, 
        "main_id": "2872", 
        "effective_to": null, 
        "secure_value": null, 
        "node_classifier": "/application/deployables/env:Development", 
        "main_id_encoded": "[?", 
        "name": "collA", 
        "position": null, 
        "reason_for_conflict": null, 
        "system_folder": false, 
        "status": "new", 
        "conflict": false 
      } 
    }

## CdmEditorApi -- POST /sn_cdm/editor/nodes {#ariaid-title6}

Erstellt einen bestimmten Knotentyp, z. B. Komponente, Sammlung, Ordner, Configuration Data Item (CDI) oder Variable.
Sie können auch angeben, ob übergeordnete Knoten, die derzeit nicht definiert sind, automatisch generiert werden sollen.

Der Aufrufer dieses Endpunkts muss entweder die Rolle „CDM-Editor" oder „CDM-Geheimnis" aufweisen.

### URL-Format

URL mit Versionsnummer: /api/sn_cdm/{api_version}/editor/nodes

Standard-URL: /api/sn_cdm/editor/nodes

### Unterstützte Anforderungsparameter

{#editor-POST-nodes__entry__2}{#editor-POST-nodes__version-RESTAPI}

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel <kbd class="ph userinput">v1</kbd> oder <kbd class="ph userinput">v2</kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
[Tabelle : 25. Pfadparameter]

{#editor-POST-nodes__entry__6}{#editor-POST-nodes__changesetNumber-changeset-entry}{#editor-POST-nodes__fullNamePath-node-editor-entry}{#editor-POST-nodes__cdm_apps-returnFields-entry}{#editor-POST-nodes__secure-node-editor-entry}

| Name | Beschreibung |
|-|-|
| autoCreateParents | Kennzeichnung, die angibt, ob die nicht vorhandenen übergeordneten Elemente im Namenspfad automatisch als Komponenten erstellt werden sollen. Ausnahmen sind die App, das bereitstellbare Element und die Sammlung. Wenn Sie diese Kennzeichnung nicht festlegen und die übergeordneten Elemente noch nicht vorhanden sind, schlägt der Endpunkt fehl. Gültige Werte: * wahr: Nicht vorhandene übergeordnete Elemente werden automatisch erstellt. * „falsch": Die nicht vorhandenen übergeordneten Elemente werden nicht automatisch erstellt. Datentyp: Boolesch Standardwert: false |
| changesetNumber | Erforderlich. Eindeutiger Bezeichner des zugeordneten Changesets, z. B. „Chset-10". Befindet sich in der Tabelle „CDMChangeset" \[sn_cdm_changeset\]. Datentyp: Zeichenfolge |
| vollständigerNamenspfad | Erforderlich. Pfadname des Knotens. Sie können den Namenspfad in einem der folgenden Formate übergeben. Um beispielsweise den Namenspfad für den Knoten `testApp/deployables/Development1/cdi1`zu definieren, gehen Sie wie folgt vor: * Backslash-Format: testApp/deployables/Development1/cdi1 Hinweis: Wenn Ihr Knotenname einen umgekehrten Schrägstrich („/") enthält, können Sie dieses Format nicht verwenden. * Back-End-Namenspfad mit Ersetzungszeichen: testApp¬deployables¬Development1cdi1 * Array: \['testApp','deployables','Development1','cdi1'\] {#editor-POST-nodes__cdm_apps-namePath-ul} Datentyp: Zeichenfolge |
| returnFields | Liste der Felder, die als Teil der Antwort zurückgegeben werden sollen. Übergeben Sie die Datensatzspaltennamen wie sys_id, sys_updated_by oder state. Datentyp: Array Standard: Alle Felder wie vom Endpunkt bestimmt |
| sicher | Kennzeichnung, die angibt, ob der Wert für die Endknoten verschlüsselt werden soll. Gültige Werte: * true: Verschlüsselt * false: Nicht verschlüsselt Datentyp: Boolesch Standardwert: false |
| type | Erforderlich. Typ des neuen Knotens. Gültige Werte: * sn_cdm_node_collection ODER Sammlung * sn_cdm_node_component ODER Komponente * sn_cdm_node_folder ODER Ordner * sn_cdm_node_cdi ODER cdi * sn_cdm_node_variable oder Variable Datentyp: Zeichenfolge |
| Wert | Wert des neuen Knotens. Datentyp: Zeichenfolge Standard: Entspricht „null" |
[Tabelle : 26. Abfrageparameter]

{#editor-POST-nodes__entry__22}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 27. Anforderungstextparameter]

### Kopfzeilen

Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter [Unterstützte REST API-Header](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.").
{#editor-POST-nodes__entry__26}{#editor-POST-nodes__accept-JSON-only-entry-RESTAPI}{#editor-POST-nodes__content_type-JSON-only-entry-RESTAPI}

| Kopfzeile | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützt nur application/json. |
| Content-Type | Datenformat des Anforderungstexts. Unterstützt nur application/json. |
[Tabelle : 28. Anforderungskopfzeilen]

{#editor-POST-nodes__entry__32}

| Kopfzeile | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 29. Antwortkopfzeilen]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter [HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API.
{#editor-POST-nodes__entry__36}{#editor-POST-nodes__entry-200-status-code}{#editor-POST-nodes__entry-400-status-code}{#editor-POST-nodes__entry-500-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler. |
[Tabelle : 30. Statuscodes]

### Parameter des Antwort-Haupttexts

{#editor-POST-nodes__id_nwg_5jl_c5b__entry__2}{#editor-POST-nodes__changeset-node-editor-entry}{#editor-POST-nodes__changeset_link-node-editor-entry}{#editor-POST-nodes__changeset_value-node-editor-entry}{#editor-POST-nodes__conflict-node-editor-entry}{#editor-POST-nodes__conflict_type-node-editor-entry}{#editor-POST-nodes__description-node-editor-entry}{#editor-POST-nodes__effective_from-node-editor-entry}{#editor-POST-nodes__effective_to-node-editor-entry}{#editor-POST-nodes__level-node-editor-entry}{#editor-POST-nodes__linked_to-node-editor-entry}{#editor-POST-nodes__main_id-node-editor-entry}{#editor-POST-nodes__main_id_encoded-node-editor-entry}{#editor-POST-nodes__name-node-editor-entry}{#editor-POST-nodes__node_classifier-node-editor-entry}{#editor-POST-nodes__name_path-node-editor-entry}{#editor-POST-nodes__position-node-editor-entry}{#editor-POST-nodes__previous_version-node-editor-entry}{#editor-POST-nodes__previous_version_link-node-editor-entry}{#editor-POST-nodes__previous_version_value-node-editor-entry}{#editor-POST-nodes__restricted_to-node-editor-entry}{#editor-POST-nodes__restricted_to_link-node-editor-entry}{#editor-POST-nodes__restricted_to_value-node-editor-entry}{#editor-POST-nodes__secure_value-node-editor-entry}{#editor-POST-nodes__status-node-editor-entry}{#editor-POST-nodes__system_folder-node-editor-entry}{#editor-POST-nodes__sys_class_name-node-editor-entry}{#editor-POST-nodes__sys_created_by-node-editor-entry}{#editor-POST-nodes__sys_created_on-node-editor-entry}{#editor-POST-nodes__sys_id-node-editor-entry}{#editor-POST-nodes__sys_updated_by-node-editor-entry}{#editor-POST-nodes__sys_updated_on-node-editor-entry}{#editor-POST-nodes__type-node-editor-entry}{#editor-POST-nodes__value-node-editor-entry}

| Name | Beschreibung |
|-|-|
| changeset_id | Details des Changeset-Datensatzes, der dem Knoten zugeordnet ist. Datentyp: Objekt "changeset_id": { "link": "String", "value": "String" } |
| changeset_id.link | Rufen Sie die Syntax zum Abfragen dieses Changeset-Datensatzes mit der Tabellen -REST-API auf. Datentyp: Zeichenfolge |
| changeset_id.value | Eindeutiger Bezeichner des Changeset-Datensatzes. Befindet sich in der Tabelle „CDM-Änderungssatz" \[sn_cdm_changeset\]. Datentyp: Zeichenfolge |
| Konflikt | Kennzeichnung, die angibt, ob bei der Verarbeitung des Knotens ein Konflikt aufgetreten ist. Mögliche Werte: * true: Konflikt erkannt. * „falsch": Es wurde kein Konflikt erkannt. Datentyp: Boolesch |
| Konflikttyp | Wenn der Parameter conflict auf „true" festgelegt ist, wird der Typ des erkannten Konflikts erkannt. NULL, wenn kein Konflikt erkannt wird. Mögliche Werte: * beschädigter_Knoten * delete_node * duplicated_node * unvollständig_gelöscht_übergeordnet * unvollständig_gelöscht_ref * unvollständig_umbenannt_ref * ungültig_include * verwaiste_descendant * related_conflict * unlinked_include * unrennamed_include * update_node Datentyp: Zeichenfolge |
| Beschreibung | Kurze Beschreibung des Zwecks des Knotens. Datentyp: Zeichenfolge |
| effektiv_von | Zeitstempel (in eine lange Ganzzahl konvertiert), wenn der Knoten als Teil des Changesets committet wurde. Wenn der Knoten nicht festgelegt wurde, ist dieser Wert „null". Datentyp: Ganzzahl |
| effektiv_bis | Zeitstempel (in eine lange Ganzzahl konvertiert) des Knotens, wann er gelöscht oder durch einen anderen Knoten ersetzt wurde, ansonsten „null". Datentyp: Ganzzahl |
| Fehler | Wenn während der Verarbeitung ein Fehler aufgetreten ist, die Details zum Fehler. Datentyp: Objekt "error": { "detail": "String", "message": "String" } |
| Fehler.detail | Zusätzliche Informationen zum Fehler. Datentyp: Zeichenfolge |
| Fehlernachricht | Fehlermeldung, die beim Versuch, die Anforderung zu verarbeiten, generiert wurde. Datentyp: Zeichenfolge |
| level | Ebene des Knotens, beginnend mit dem Stammknoten, der immer 0 ist. Beispiel: Der Knoten /AppA/components/compA hat zwei Ebenen. Datentyp: Zeichenfolge |
| linked_to | Der Parameter main_id des referenzierten Knotens, mit dem dieser Knoten verknüpft ist. Wenn dieser Knoten nicht mit einem Referenzknoten verknüpft ist, ist der Wert „null". Datentyp: Zeichenfolge |
| main_id | Primärer Bezeichner für den Knoten. Sie können diesen Wert in der Skripteinbindung CdmQuery() verwenden, um eine JSON-Struktur abzurufen. Beispiel: `CdmQuery().mainId('123')/query().getTree();` Datentyp: Zeichenfolge |
| main_id_encoded | RADIX 57-Zeichenfolgendarstellung des Parameters main_id des Knotens. Datentyp: Zeichenfolge |
| name | Name des Knotens. Datentyp: Zeichenfolge |
| node_classifier | Klassifiziererhierarchie des Knotens. Verwenden Sie diese Informationen, um einen Knoten innerhalb der Ordnerhierarchie zu finden. Ein bereitstellbares Element hat beispielsweise die Hierarchie /application/deployables/env:Development Während eine Sammlung eine Hierarchie von /applications/collectionshätte Datentyp: Zeichenfolge |
| node_path | Vollständiger Knotenpfadname. Datentyp: Zeichenfolge |
| position | Knotenposition. Beispiel: Wenn Sie das folgende Array hochladen: arrayNode1: [ "literal1", {"cdi1": 1}, "literal3" ] Die Positionswerte werden wie folgt festgelegt: * arrayNode1.literal1 = 1000 * arrayNode1.2000 = 2000 * arrayNode1.literal3 = 3000 {#editor-POST-nodes__ul_ybk_wg2_25b}Wenn ein komplexes Objekt unter einem Array hochgeladen wird, in diesem Fall `{"cdi1": 1}`, erstellt der Endpunkt einen neuen virtuellen Knoten, dessen Name seiner Position entspricht. Im obigen Beispiel ist dies 2000. Bei Einbindungen ist die Position immer leer. Datentyp: Zeichenfolge |
| previous_version | Details der vorherigen Version des Knotendatensatzes. Hinweis: Wenn ein neuer Knoten erstellt wurde, gibt der Endpunkt für diesen Parameter `„ previous_version" = null` zurück. Datentyp: Objekt "previous_version": { "link": "String", "value": "String" } |
| previous_version.link | Rufen Sie die Syntax zum Abfragen dieses Knotendatensatzes mit der Tabellen -REST-API auf. Datentyp: Zeichenfolge |
| previous_version.value | Sys_id des Knotendatensatzes. Befindet sich in der Tabelle „CDM-Knoten" \[sn_cdm_node\]. Datentyp: Zeichenfolge |
| Reason_for_conflict | Ausführliche Erklärung des Konflikts. Datentyp: Zeichenfolge |
| Beschränken_auf | Details der Gruppe, die Zugriff auf den zugeordneten Knoten hat. Datentyp: Objekt "restricted_to": { "link": "String", "value": "String" } |
| strict_to.link | Rufen Sie die Syntax zum Abfragen dieses Gruppendatensatzes mit der Tabellen -REST-API auf. Datentyp: Zeichenfolge |
| „restricted_to.value" | Sys_id des Gruppendatensatzes. Befindet sich in der Tabelle „CDM-Gruppe" \[sys_user_group\]. Datentyp: Zeichenfolge |
| Secure_value | Wenn dieser Wert als gesichert gekennzeichnet wurde, wird das verschlüsselte Feld (maskiert zurückgegeben) Ein Anwender muss über die Rolle sn_cdm.cdm_secrets verfügen, um diese Informationen zu entschlüsseln. Sie können den Endpunkt so festlegen, dass diese Felder nicht zurückgegeben werden, indem Sie das Abfrageparameterfeld returnFields festlegen. Datentyp: Zeichenfolge |
| status | Knotenstatus Mögliche Werte: * GELÖSCHT * NEW * ERSETZT * AKTUALISIERT * GÜLTIG Datentyp: Zeichenfolge |
| system_folder | Kennzeichnung, die angibt, ob der zugeordnete Knoten ein Systemordner ist. Mögliche Werte: * wahr: Knoten ist ein Systemordner. * false: Knoten ist kein Systemordner. Datentyp: Boolesch |
| sys_class_name | Tabelle, in der sich der Knoten befindet. Datentyp: Zeichenfolge |
| sys_created_by | Name des Anwenders, der den Knoten erstellt hat. Datentyp: Zeichenfolge |
| sys_created_on | Datum und Uhrzeit der Erstellung des Knotens. Datentyp: Zeichenfolge Format: jjjj-mm-tt hh:mm:ss |
| sys_id | Sys_id des Knotens. Befindet sich in der Tabelle „CDM-Knoten" \[sn_cdm_node\]. Datentyp: Zeichenfolge |
| sys_updated_by | Name des Benutzers, der den Knoten aktualisiert hat. Datentyp: Zeichenfolge |
| sys_updated_on | Datum und Uhrzeit der letzten Aktualisierung des Knotens. Datentyp: Zeichenfolge Format: jjjj-mm-tt hh:mm:ss |
| type | Knotentyp. Mögliche Werte: * sn_cdm_node_cdi * sn_cdm_node_collection * sn_cdm_node_component * sn_cdm_node_folder * sn_cdm_node_variable Datentyp: Zeichenfolge Standard: Alle |
| Wert | Knotenwert Datentyp: Zeichenfolge |
[ ]

{#editor-POST-nodes__id_nwg_5jl_c5b}  

### cURL-Anforderung

Das folgende Codebeispiel zeigt, wie Sie mit diesem Endpunkt einen -Knoten erstellen.

    curl "http://instance.servicenow.com/api/sn_cdm/editor/nodes?fullNamePath=%2FtestApp%2Fdeployables%2FDevelopment1%2Fcdi1&secure=true&value=someVal&type=cdi&changesetNumber=Chset-760" \
    --request POST \
    --header "Accept:application/json" \
    --user 'username':'password'

Ergebnis zurückgeben:

    { 
      "result": { 
        "changeset_id": { 
          "value": "d403648653b70110a1d3ddeeff7b12c5", 
          "link": "http://instance.servicenow.com/api/now/table/sn_cdm_changeset/d403648653b70110a1d3ddeeff7b12c5" 
        }, 
        "node_path": "!$!+!,![:", 
        "description": null, 
        "sys_updated_on": "2022-06-30 08:53:13", 
        "type": "sn_cdm_node_cdi", 
        "sys_class_name": "sn_cdm_node", 
        "sys_id": "c93c7c1753981110a1d3ddeeff7b12c7", 
        "sys_updated_by": "admin", 
        "previous_version": null, 
        "sys_created_on": "2022-06-30 08:53:13", 
        "value": null, 
        "effective_from": null, 
        "linked_to": null, 
        "sys_created_by": "admin", 
        "restricted_to": null, 
        "level": "3", 
        "conflict_type": null, 
        "main_id": "2869", 
        "effective_to": null, 
        "secure_value": "﷞﷟﷒113a0c6e53001110a1d3ddeeff7b121d﷬﷔1﷬﷭bAUA1wj-fxofbSrMyF-BAg==6qiho5f_9DhnuHT2Km5SLf0Ck4XNX_w=﷮﷯", 
        "node_classifier": "/application/deployables/env:Development", 
        "main_id_encoded": "[:", 
        "name": "cdi45", 
        "position": null, 
        "reason_for_conflict": null, 
        "system_folder": false, 
        "status": "new", 
        "conflict": false 
      } 
    }

## CdmEditorApi: PUT /sn_cdm/editor/nodes {#ariaid-title7}

Aktualisiert den Namen und/oder den Wert eines angegebenen Knotens.
Der Aufrufer dieses Endpunkts muss entweder die Rolle „CDM-Editor" oder „CDM-Geheimnis" aufweisen.

### URL-Format

URL mit Versionsnummer: /api/sn_cdm/{api_version}/editor/nodes

Standard-URL: /api/sn_cdm/editor/nodes

### Unterstützte Anforderungsparameter

{#editor-PUT-nodes__entry__2}{#editor-PUT-nodes__version-RESTAPI}

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel <kbd class="ph userinput">v1</kbd> oder <kbd class="ph userinput">v2</kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
[Tabelle : 31. Pfadparameter]

{#editor-PUT-nodes__entry__6}{#editor-PUT-nodes__changesetNumber-changeset-entry}{#editor-PUT-nodes__fullNamePath-node-editor-entry}{#editor-PUT-nodes__secure-node-editor-entry}{#editor-PUT-nodes__cdm_apps-returnFields-entry}

| Name | Beschreibung |
|-|-|
| changesetNumber | Erforderlich. Eindeutiger Bezeichner des zugeordneten Changesets, z. B. „Chset-10". Befindet sich in der Tabelle „CDMChangeset" \[sn_cdm_changeset\]. Datentyp: Zeichenfolge |
| vollständigerNamenspfad | Erforderlich. Pfadname des Knotens. Sie können den Namenspfad in einem der folgenden Formate übergeben. Um beispielsweise den Namenspfad für den Knoten `testApp/deployables/Development1/cdi1`zu definieren, gehen Sie wie folgt vor: * Backslash-Format: testApp/deployables/Development1/cdi1 Hinweis: Wenn Ihr Knotenname einen umgekehrten Schrägstrich („/") enthält, können Sie dieses Format nicht verwenden. * Back-End-Namenspfad mit Ersetzungszeichen: testApp¬deployables¬Development1cdi1 * Array: \['testApp','deployables','Development1','cdi1'\] {#editor-PUT-nodes__cdm_apps-namePath-ul} Datentyp: Zeichenfolge |
| neuerName | Neuer Name für den zugeordneten Knoten. Datentyp: Zeichenfolge |
| newValue | Neuer Wert für den zugeordneten Knoten. Datentyp: Zeichenfolge |
| sicher | Kennzeichnung, die angibt, ob der Wert für die Endknoten verschlüsselt werden soll. Gültige Werte: * true: Verschlüsselt * false: Nicht verschlüsselt Datentyp: Boolesch Standardwert: false |
| returnFields | Liste der Felder, die als Teil der Antwort zurückgegeben werden sollen. Übergeben Sie die Datensatzspaltennamen wie sys_id, sys_updated_by oder state. Datentyp: Array Standard: Alle Felder wie vom Endpunkt bestimmt |
[Tabelle : 32. Abfrageparameter]

{#editor-PUT-nodes__entry__20}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 33. Anforderungstextparameter]

### Kopfzeilen

Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter [Unterstützte REST API-Header](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.").
{#editor-PUT-nodes__entry__24}{#editor-PUT-nodes__accept-JSON-only-entry-RESTAPI}{#editor-PUT-nodes__content_type-JSON-only-entry-RESTAPI}

| Kopfzeile | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützt nur application/json. |
| Content-Type | Datenformat des Anforderungstexts. Unterstützt nur application/json. |
[Tabelle : 34. Anforderungskopfzeilen]

{#editor-PUT-nodes__entry__30}

| Kopfzeile | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 35. Antwortkopfzeilen]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter [HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API.
{#editor-PUT-nodes__entry__34}{#editor-PUT-nodes__entry-200-status-code}{#editor-PUT-nodes__entry-400-status-code}{#editor-PUT-nodes__entry-500-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler. |
[Tabelle : 36. Statuscodes]

### Parameter des Antwort-Haupttexts

{#editor-PUT-nodes__id_nwg_5jl_c5b__entry__2}{#editor-PUT-nodes__changeset-node-editor-entry}{#editor-PUT-nodes__changeset_link-node-editor-entry}{#editor-PUT-nodes__changeset_value-node-editor-entry}{#editor-PUT-nodes__conflict-node-editor-entry}{#editor-PUT-nodes__conflict_type-node-editor-entry}{#editor-PUT-nodes__description-node-editor-entry}{#editor-PUT-nodes__effective_from-node-editor-entry}{#editor-PUT-nodes__effective_to-node-editor-entry}{#editor-PUT-nodes__level-node-editor-entry}{#editor-PUT-nodes__linked_to-node-editor-entry}{#editor-PUT-nodes__main_id-node-editor-entry}{#editor-PUT-nodes__main_id_encoded-node-editor-entry}{#editor-PUT-nodes__name-node-editor-entry}{#editor-PUT-nodes__node_classifier-node-editor-entry}{#editor-PUT-nodes__name_path-node-editor-entry}{#editor-PUT-nodes__position-node-editor-entry}{#editor-PUT-nodes__previous_version-node-editor-entry}{#editor-PUT-nodes__previous_version_link-node-editor-entry}{#editor-PUT-nodes__previous_version_value-node-editor-entry}{#editor-PUT-nodes__restricted_to-node-editor-entry}{#editor-PUT-nodes__restricted_to_link-node-editor-entry}{#editor-PUT-nodes__restricted_to_value-node-editor-entry}{#editor-PUT-nodes__secure_value-node-editor-entry}{#editor-PUT-nodes__status-node-editor-entry}{#editor-PUT-nodes__system_folder-node-editor-entry}{#editor-PUT-nodes__sys_class_name-node-editor-entry}{#editor-PUT-nodes__sys_created_by-node-editor-entry}{#editor-PUT-nodes__sys_created_on-node-editor-entry}{#editor-PUT-nodes__sys_id-node-editor-entry}{#editor-PUT-nodes__sys_updated_by-node-editor-entry}{#editor-PUT-nodes__sys_updated_on-node-editor-entry}{#editor-PUT-nodes__type-node-editor-entry}{#editor-PUT-nodes__value-node-editor-entry}

| Name | Beschreibung |
|-|-|
| changeset_id | Details des Changeset-Datensatzes, der dem Knoten zugeordnet ist. Datentyp: Objekt "changeset_id": { "link": "String", "value": "String" } |
| changeset_id.link | Rufen Sie die Syntax zum Abfragen dieses Changeset-Datensatzes mit der Tabellen -REST-API auf. Datentyp: Zeichenfolge |
| changeset_id.value | Eindeutiger Bezeichner des Changeset-Datensatzes. Befindet sich in der Tabelle „CDM-Änderungssatz" \[sn_cdm_changeset\]. Datentyp: Zeichenfolge |
| Konflikt | Kennzeichnung, die angibt, ob bei der Verarbeitung des Knotens ein Konflikt aufgetreten ist. Mögliche Werte: * true: Konflikt erkannt. * „falsch": Es wurde kein Konflikt erkannt. Datentyp: Boolesch |
| Konflikttyp | Wenn der Parameter conflict auf „true" festgelegt ist, wird der Typ des erkannten Konflikts erkannt. NULL, wenn kein Konflikt erkannt wird. Mögliche Werte: * beschädigter_Knoten * delete_node * duplicated_node * unvollständig_gelöscht_übergeordnet * unvollständig_gelöscht_ref * unvollständig_umbenannt_ref * ungültig_include * verwaiste_descendant * related_conflict * unlinked_include * unrennamed_include * update_node Datentyp: Zeichenfolge |
| Beschreibung | Kurze Beschreibung des Zwecks des Knotens. Datentyp: Zeichenfolge |
| effektiv_von | Zeitstempel (in eine lange Ganzzahl konvertiert), wenn der Knoten als Teil des Changesets committet wurde. Wenn der Knoten nicht festgelegt wurde, ist dieser Wert „null". Datentyp: Ganzzahl |
| effektiv_bis | Zeitstempel (in eine lange Ganzzahl konvertiert) des Knotens, wann er gelöscht oder durch einen anderen Knoten ersetzt wurde, ansonsten „null". Datentyp: Ganzzahl |
| Fehler | Wenn während der Verarbeitung ein Fehler aufgetreten ist, die Details zum Fehler. Datentyp: Objekt "error": { "detail": "String", "message": "String" } |
| Fehler.detail | Zusätzliche Informationen zum Fehler. Datentyp: Zeichenfolge |
| Fehlernachricht | Fehlermeldung, die beim Versuch, die Anforderung zu verarbeiten, generiert wurde. Datentyp: Zeichenfolge |
| level | Ebene des Knotens, beginnend mit dem Stammknoten, der immer 0 ist. Beispiel: Der Knoten /AppA/components/compA hat zwei Ebenen. Datentyp: Zeichenfolge |
| linked_to | Der Parameter main_id des referenzierten Knotens, mit dem dieser Knoten verknüpft ist. Wenn dieser Knoten nicht mit einem Referenzknoten verknüpft ist, ist der Wert „null". Datentyp: Zeichenfolge |
| main_id | Primärer Bezeichner für den Knoten. Sie können diesen Wert in der Skripteinbindung CdmQuery() verwenden, um eine JSON-Struktur abzurufen. Beispiel: `CdmQuery().mainId('123')/query().getTree();` Datentyp: Zeichenfolge |
| main_id_encoded | RADIX 57-Zeichenfolgendarstellung des Parameters main_id des Knotens. Datentyp: Zeichenfolge |
| name | Name des Knotens. Datentyp: Zeichenfolge |
| node_classifier | Klassifiziererhierarchie des Knotens. Verwenden Sie diese Informationen, um einen Knoten innerhalb der Ordnerhierarchie zu finden. Ein bereitstellbares Element hat beispielsweise die Hierarchie /application/deployables/env:Development Während eine Sammlung eine Hierarchie von /applications/collectionshätte Datentyp: Zeichenfolge |
| node_path | Vollständiger Knotenpfadname. Datentyp: Zeichenfolge |
| position | Knotenposition. Beispiel: Wenn Sie das folgende Array hochladen: arrayNode1: [ "literal1", {"cdi1": 1}, "literal3" ] Die Positionswerte werden wie folgt festgelegt: * arrayNode1.literal1 = 1000 * arrayNode1.2000 = 2000 * arrayNode1.literal3 = 3000 {#editor-PUT-nodes__ul_ybk_wg2_25b}Wenn ein komplexes Objekt unter einem Array hochgeladen wird, in diesem Fall `{"cdi1": 1}`, erstellt der Endpunkt einen neuen virtuellen Knoten, dessen Name seiner Position entspricht. Im obigen Beispiel ist dies 2000. Bei Einbindungen ist die Position immer leer. Datentyp: Zeichenfolge |
| previous_version | Details der vorherigen Version des Knotendatensatzes. Hinweis: Wenn ein neuer Knoten erstellt wurde, gibt der Endpunkt für diesen Parameter `„ previous_version" = null` zurück. Datentyp: Objekt "previous_version": { "link": "String", "value": "String" } |
| previous_version.link | Rufen Sie die Syntax zum Abfragen dieses Knotendatensatzes mit der Tabellen -REST-API auf. Datentyp: Zeichenfolge |
| previous_version.value | Sys_id des Knotendatensatzes. Befindet sich in der Tabelle „CDM-Knoten" \[sn_cdm_node\]. Datentyp: Zeichenfolge |
| Reason_for_conflict | Ausführliche Erklärung des Konflikts. Datentyp: Zeichenfolge |
| Beschränken_auf | Details der Gruppe, die Zugriff auf den zugeordneten Knoten hat. Datentyp: Objekt "restricted_to": { "link": "String", "value": "String" } |
| strict_to.link | Rufen Sie die Syntax zum Abfragen dieses Gruppendatensatzes mit der Tabellen -REST-API auf. Datentyp: Zeichenfolge |
| „restricted_to.value" | Sys_id des Gruppendatensatzes. Befindet sich in der Tabelle „CDM-Gruppe" \[sys_user_group\]. Datentyp: Zeichenfolge |
| Secure_value | Wenn dieser Wert als gesichert gekennzeichnet wurde, wird das verschlüsselte Feld (maskiert zurückgegeben) Ein Anwender muss über die Rolle sn_cdm.cdm_secrets verfügen, um diese Informationen zu entschlüsseln. Sie können den Endpunkt so festlegen, dass diese Felder nicht zurückgegeben werden, indem Sie das Abfrageparameterfeld returnFields festlegen. Datentyp: Zeichenfolge |
| status | Knotenstatus Mögliche Werte: * GELÖSCHT * NEW * ERSETZT * AKTUALISIERT * GÜLTIG Datentyp: Zeichenfolge |
| system_folder | Kennzeichnung, die angibt, ob der zugeordnete Knoten ein Systemordner ist. Mögliche Werte: * wahr: Knoten ist ein Systemordner. * false: Knoten ist kein Systemordner. Datentyp: Boolesch |
| sys_class_name | Tabelle, in der sich der Knoten befindet. Datentyp: Zeichenfolge |
| sys_created_by | Name des Anwenders, der den Knoten erstellt hat. Datentyp: Zeichenfolge |
| sys_created_on | Datum und Uhrzeit der Erstellung des Knotens. Datentyp: Zeichenfolge Format: jjjj-mm-tt hh:mm:ss |
| sys_id | Sys_id des Knotens. Befindet sich in der Tabelle „CDM-Knoten" \[sn_cdm_node\]. Datentyp: Zeichenfolge |
| sys_updated_by | Name des Benutzers, der den Knoten aktualisiert hat. Datentyp: Zeichenfolge |
| sys_updated_on | Datum und Uhrzeit der letzten Aktualisierung des Knotens. Datentyp: Zeichenfolge Format: jjjj-mm-tt hh:mm:ss |
| type | Knotentyp. Mögliche Werte: * sn_cdm_node_cdi * sn_cdm_node_collection * sn_cdm_node_component * sn_cdm_node_folder * sn_cdm_node_variable Datentyp: Zeichenfolge Standard: Alle |
| Wert | Knotenwert Datentyp: Zeichenfolge |
[ ]

{#editor-PUT-nodes__id_nwg_5jl_c5b}  

### cURL-Anforderung

Das folgende Codebeispiel zeigt, wie der Wert eines -Knotens aktualisiert wird.

    curl "http://instance.servicenow.com/api/sn_cdm/editor/nodes?newValue=cdcdc&fullNamePath=%2FtestApp%2Fdeployables%2FDe
    velopment-1%2Fcdi45&changesetNumber=Chset-5" \
    --request PUT \
    --header "Accept:application/json" \
    --user 'username':'password'

Ergebnis zurückgeben:

    { 
      "result": { 
        "changeset_id": { 
          "value": "d403648653b70110a1d3ddeeff7b12c5", 
          "link": "http://instance.servicenow.com/api/now/table/sn_cdm_changeset/d403648653b70110a1d3ddeeff7b12c5" 
        }, 
        "node_path": "!$!+!,![:", 
        "description": null, 
        "sys_updated_on": "2022-06-30 08:53:13", 
        "type": "sn_cdm_node_cdi", 
        "sys_class_name": "sn_cdm_node", 
        "sys_id": "c93c7c1753981110a1d3ddeeff7b12c7", 
        "sys_updated_by": "admin", 
        "previous_version": null, 
        "sys_created_on": "2022-06-30 08:53:13", 
        "value": null, 
        "effective_from": null, 
        "linked_to": null, 
        "sys_created_by": "admin", 
        "restricted_to": null, 
        "level": "3", 
        "conflict_type": null, 
        "main_id": "2869", 
        "effective_to": null, 
        "secure_value": "﷞﷟﷒113a0c6e53001110a1d3ddeeff7b121d﷬﷔1﷬﷭bAUA1wj-fxofbSrMyF-BAg==6qiho5f_9DhnuHT2Km5SLf0Ck4XNX_w=﷮﷯", 
        "node_classifier": "/application/deployables/env:Development", 
        "main_id_encoded": "[:", 
        "name": "cdi45", 
        "position": null, 
        "reason_for_conflict": null, 
        "system_folder": false, 
        "status": "new", 
        "conflict": false 
      } 
    }