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


---

# CdmEditorApi

# CdmEditorApi {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](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 einschließen, Knoten löschen und Knoten und Knoteneinbindungen abrufen können.  
Sie müssen über eine der folgenden Rollen verfügen, um auf diese API zuzugreifen:

* Geskriptete REST-CDM-Zugriffssteuerungsliste anzeigen (sn_cdm.cdm.Viewer)
* Geskriptete REST-CDM-Editor-ACL (sn_cdm.cdm_Editor)

Um verschlüsselte Felder anzuzeigen, müssen Sie über die Rolle „CDM-Geheimnis" verfügen.

Darüber hinaus wird Konfigurationsdaten-Management(CDM) Plugin muss 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: LÖSCHEN SIE /sn_cdm/Editor/nodes {#ariaid-title2}

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

### URL-Format

Versionierte URL: /api/sn_cdm/{api_Version}/Editor/nodes

Standard-URL: /api/sn_cdm/Editor/nodes  
Hinweis:  
Verfügbare Versionen werden in angegeben [REST-API-Explorer](https://servicenow-prod.fluidtopics.net/QZyr9s_~V0xB9fqGOlvJ4A "In diesem Tutorial verwenden Sie den REST API Explorer, um zu testen ServiceNowREST-APIs."). Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf [Geskriptetes REST-Service-Formular](https://servicenow-prod.fluidtopics.net/0V9QfkPsOI5r~YAD7CJWCA "Mit der geskripteten REST-API-Funktion können Anwendungsentwickler anwenderdefinierte Webservice-APIs erstellen.").

### Unterstützte Anforderungsparameter

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

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. 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. Pfad-Parameter]

{#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". Datentyp: Zeichenfolge Tabelle: CDM-Änderungssatz \[sn_cdm_Changeset\] |
| FullNamePath | Erforderlich. Pfadname des zu löschenden Knotens. Sie können den Namenspfad in einem der folgenden Formate übergeben. Beispiel: Um den folgenden Knoten zu löschen `TestApp/bereitstellbare Elemente/Entwickler1/cdi1 `: * Backslash-Format: TestApp/bereitstellbare Elemente/Entwickler1/cdi1 Hinweis: Wenn Ihr Knotenname einen umgekehrten Schrägstrich ("/") enthält, können Sie dieses Format nicht verwenden. * Back-End-Namenspfad mit Ersatzzeichen: TestApp bereitstellbareEntwickler1 cdi1 * Array: \['TestApp','bereitstellbare Elemente','Development1','cdi1'\] {#editor-DELETE-nodes__ul_xrv_rc1_cyb} Datentyp: Zeichenfolge |
[Tabelle : 2. Abfrageparameter]

{#editor-DELETE-nodes__entry__12}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 3. Anforderungstext-Parameter]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. 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/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#editor-DELETE-nodes__entry__16}{#editor-DELETE-nodes__accept-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
[Tabelle : 4. Anforderungskopfzeilen.]

{#editor-DELETE-nodes__entry__20}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 5. Antwort-Header]

### 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 [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#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 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 6. Statuscodes]

### Antworttext-Parameter

{#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/include {#ariaid-title3}

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

### URL-Format

Versionierte URL: /api/sn_cdm/{api_Version}/Editor/include

Standard-URL: /api/sn_cdm/Editor/include  
Hinweis:  
Verfügbare Versionen werden in angegeben [REST-API-Explorer](https://servicenow-prod.fluidtopics.net/QZyr9s_~V0xB9fqGOlvJ4A "In diesem Tutorial verwenden Sie den REST API Explorer, um zu testen ServiceNowREST-APIs."). Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf [Geskriptetes REST-Service-Formular](https://servicenow-prod.fluidtopics.net/0V9QfkPsOI5r~YAD7CJWCA "Mit der geskripteten REST-API-Funktion können Anwendungsentwickler anwenderdefinierte Webservice-APIs erstellen.").

### Unterstützte Anforderungsparameter

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

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. 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. Pfad-Parameter]

{#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". Datentyp: Zeichenfolge Tabelle: CDM-Änderungssatz \[sn_cdm_Changeset\] |
| returnFields | Liste der Felder, die als Teil der Antwort zurückgegeben werden sollen. Übergeben Sie die Namen der Datensatzspalte, z. B. sys_ID, sys_updated_by oder Status. 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. Beispiel: Um die Einbindungen für zurückzugeben `SammlungA `Knoten in TestApp/Sammlungen Verzeichnis: * Backslash-Format: TestApp/Sammlungen/SammlungA Hinweis: Wenn Ihr Knotenname einen umgekehrten Schrägstrich ("/") enthält, können Sie dieses Format nicht verwenden. * Back-End-Namenspfad mit Ersatzzeichen: TestApp-SammlungA * Array: \['TestApp','Collections','collectionA'\] Datentyp: Zeichenfolge |
[Tabelle : 9. Anforderungstext-Parameter]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. 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/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#editor-GET-includes__entry__18}{#editor-GET-includes__accept-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
[Tabelle : 10. Anforderungskopfzeilen.]

{#editor-GET-includes__entry__22}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 11. Antwort-Header]

### 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 [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#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 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 12. Statuscodes]

### Antworttext-Parameter

{#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 |
|-|-|
| änderungssatz_ID | Eindeutiger Bezeichner des zugeordneten Changesets, z. B. „Chset-10". Datentyp: Zeichenfolge Tabelle: CDM-Änderungssatz \[sn_cdm_Changeset\] |
| Konflikt | Kennzeichnung, die angibt, ob bei der Verarbeitung des Knotens ein Konflikt aufgetreten ist. Mögliche Werte: * Wahr: Konflikt erkannt. * Falsch: Es wurde kein Konflikt erkannt. Datentyp: Boolescher Wert |
| Conflict_type | Wenn conflictParameter ist „wahr", der Typ des erkannten Konflikts. Null, wenn kein Konflikt erkannt wird. Mögliche Werte: * Corrupted_node * Deleted_node * Duplicate_node * Unvollständig_gelöscht_übergeordnet * Unvollständig_gelöscht_ref * Unvollständig_umbenannt_ref * INVALID_include * Verwaiste_descendant * Related_conflict * Unlinked_include * Unenamed_include * Updated_node Datentyp: Zeichenfolge |
| Beschreibung | Kurzbeschreibung des Zwecks des Knotens. Datentyp: Zeichenfolge |
| Effektiv_von | Zeitstempel (in eine lange Ganzzahl konvertiert), zu dem der Knoten als Teil des Changesets bestätigt wurde. Wenn der Knoten nicht bestätigt wurde, ist dieser Wert „null". Datentyp: Zahl (Ganzzahl) |
| Effektiv_bis | Zeitstempel (in eine lange Ganzzahl konvertiert) des Knotens, als er entweder gelöscht oder durch einen anderen Knoten ersetzt wurde, andernfalls „null". Datentyp: Zahl (Ganzzahl) |
| Fehler | Wenn während der Verarbeitung ein Fehler aufgetreten ist, die Details zum Fehler. Datentyp: Objekt "error": { "detail": "String", "message": "String" } |
| error.detail | Zusätzliche Informationen zum Fehler. Datentyp: Zeichenfolge |
| Fehler.Nachricht | 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 | Die main_idParameter 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 verwenden CdmQuery() Skripteinbindung zum Abrufen einer JSON-Struktur. Beispiel: `CdmQuery().mainId('123')/query().getTree(); ` Datentyp: Zeichenfolge |
| Main_ID_encoded | RADIX 57-Zeichenfolgendarstellung der Knoten main_idParameter. Datentyp: Zeichenfolge |
| name | Name des Knotens, der unter dem Zielpfad enthalten war. Datentyp: Zeichenfolge |
| Node_Classifier | Klassifiziererhierarchie des Knotens. Verwenden Sie diese Informationen, um einen Knoten in der Ordnerhierarchie zu suchen. Beispielsweise hätte ein bereitstellbares Element eine Hierarchie von /Application/proviyables/env:Development Während eine Sammlung eine Hierarchie von hat /Applications/Collections Datentyp: Zeichenfolge |
| Node_path | Vollständiger Pfadname des Knotens, der im Zielpfad enthalten war, z. B. /Produktion/bereitstellbare Elemente/Entwickler1/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 in diesem Fall ein komplexes Objekt unter einem Array hochgeladen wird `{"cdi1": 1} `, Der Endpunkt erstellt einen neuen virtuellen Knoten mit dem Namen, der seiner Position entspricht. Im obigen Beispiel ist dies 2000. Für Includes ist die Position immer leer. Datentyp: Zeichenfolge |
| Vorherige_Version | Details der vorherigen Version des Knotendatensatzes. Hinweis: Wenn ein neuer Knoten erstellt wurde, wird der Endpunkt zurückgegeben `„Previous_Version" = null `Für diesen Parameter. Datentyp: Objekt "previous_version": { "link": "String", "value": "String" } |
| Restricted_to | Details der Gruppe, die Zugriff auf den dem Knoten zugeordneten 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) 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 anweisen, diese Felder nicht zurückzugeben, indem Sie festlegen returnFieldsParameterfeld abfragen. Datentyp: Zeichenfolge |
| Status | Knotenstatus. Mögliche Werte: * GELÖSCHT * NEW * ERSETZT * AKTUALISIERT * GÜLTIG Datentyp: Zeichenfolge |
| sys_id | SYS_ID des Knotens. Datentyp: Zeichenfolge Tabelle: CDM-Knoten \[sn_cdm_node\] |
| Systemordner | Kennzeichnung, die angibt, ob der zugeordnete Knoten ein Systemordner ist. Mögliche Werte: * Wahr: Knoten ist ein Systemordner. * Falsch: Knoten ist kein Systemordner. Datentyp: Boolescher Wert |
| Typ | 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 Einbindungen im Quellpfad abgerufen werden /TestApp/Collections/Colla .

    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: RUFT /sn_cdm/Editor/nodes ab {#ariaid-title4}

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

### URL-Format

Versionierte URL: /api/sn_cdm/{api_Version}/Editor/nodes

Standard-URL: /api/sn_cdm/Editor/nodes  
Hinweis:  
Verfügbare Versionen werden in angegeben [REST-API-Explorer](https://servicenow-prod.fluidtopics.net/QZyr9s_~V0xB9fqGOlvJ4A "In diesem Tutorial verwenden Sie den REST API Explorer, um zu testen ServiceNowREST-APIs."). Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf [Geskriptetes REST-Service-Formular](https://servicenow-prod.fluidtopics.net/0V9QfkPsOI5r~YAD7CJWCA "Mit der geskripteten REST-API-Funktion können Anwendungsentwickler anwenderdefinierte Webservice-APIs erstellen.").

### Unterstützte Anforderungsparameter

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

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. 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. Pfad-Parameter]

{#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". Datentyp: Zeichenfolge Tabelle: CDM-Änderungssatz \[sn_cdm_Changeset\] |
| Entschlüsseln Sie Passwort | Kennzeichnung, die angibt, ob der Wert für die Blattknoten verschlüsselt werden soll. Gültige Werte: * Wahr: Verschlüsselt * Falsch: Nicht verschlüsselt Datentyp: Boolescher Wert Standard: Falsch |
| 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 für den der in angegebene Knoten angegeben ist nameParameter befindet sich. Sie können den Namenspfad in einem der folgenden Formate übergeben. Beispiel: Um die Knoten für zurückzugeben `SammlungA `Knoten in TestApp/Sammlungen Verzeichnis: * Backslash-Format: TestApp/Sammlungen/SammlungA Hinweis: Wenn Ihr Knotenname einen umgekehrten Schrägstrich ("/") enthält, können Sie dieses Format nicht verwenden. * Back-End-Namenspfad mit Ersatzzeichen: TestApp-SammlungA * Array: \['TestApp','Collections','collectionA'\] Datentyp: Zeichenfolge |
| returnFields | Liste der Felder, die als Teil der Antwort zurückgegeben werden sollen. Übergeben Sie die Namen der Datensatzspalte, z. B. sys_ID, sys_updated_by oder Status. Datentyp: Array Standard: Alle Felder, wie vom Endpunkt bestimmt |
| Typ | 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. Anforderungstext-Parameter]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. 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/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#editor-GET-nodes__entry__24}{#editor-GET-nodes__accept-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
[Tabelle : 16. Anforderungskopfzeilen.]

{#editor-GET-nodes__entry__28}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 17. Antwort-Header]

### 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 [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#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 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 18. Statuscodes]

### Antworttext-Parameter

{#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__d2911e3628}{#editor-GET-nodes__value-node-editor-entry}

| Name | Beschreibung |
|-|-|
| änderungssatz_ID | Details des Changeset-Datensatzes, der dem Knoten zugeordnet ist. Datentyp: Objekt "changeset_id": { "link": "String", "value": "String" } |
| änderungssatz_ID.Link | Aufrufsyntax zum Abfragen dieses Changeset-Datensatzes mit Tabelle REST-API. Datentyp: Zeichenfolge |
| änderungssatz_ID.Wert | Eindeutiger Bezeichner des Changeset-Datensatzes. Datentyp: Zeichenfolge Tabelle: CDM-Änderungssatz \[sn_cdm_Changeset\] |
| Konflikt | Kennzeichnung, die angibt, ob bei der Verarbeitung des Knotens ein Konflikt aufgetreten ist. Mögliche Werte: * Wahr: Konflikt erkannt. * Falsch: Es wurde kein Konflikt erkannt. Datentyp: Boolescher Wert |
| Conflict_type | Wenn conflictParameter ist „wahr", der Typ des erkannten Konflikts. Null, wenn kein Konflikt erkannt wird. Mögliche Werte: * Corrupted_node * Deleted_node * Duplicate_node * Unvollständig_gelöscht_übergeordnet * Unvollständig_gelöscht_ref * Unvollständig_umbenannt_ref * INVALID_include * Verwaiste_descendant * Related_conflict * Unlinked_include * Unenamed_include * Updated_node Datentyp: Zeichenfolge |
| Beschreibung | Kurzbeschreibung des Zwecks des Knotens. Datentyp: Zeichenfolge |
| Effektiv_von | Zeitstempel (in eine lange Ganzzahl konvertiert), zu dem der Knoten als Teil des Changesets bestätigt wurde. Wenn der Knoten nicht bestätigt wurde, ist dieser Wert „null". Datentyp: Zahl (Ganzzahl) |
| Effektiv_bis | Zeitstempel (in eine lange Ganzzahl konvertiert) des Knotens, als er entweder gelöscht oder durch einen anderen Knoten ersetzt wurde, andernfalls „null". Datentyp: Zahl (Ganzzahl) |
| Fehler | Wenn während der Verarbeitung ein Fehler aufgetreten ist, die Details zum Fehler. Datentyp: Objekt "error": { "detail": "String", "message": "String" } |
| error.detail | Zusätzliche Informationen zum Fehler. Datentyp: Zeichenfolge |
| Fehler.Nachricht | 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 | Die main_idParameter 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 verwenden CdmQuery() Skripteinbindung zum Abrufen einer JSON-Struktur. Beispiel: `CdmQuery().mainId('123')/query().getTree(); ` Datentyp: Zeichenfolge |
| Main_ID_encoded | RADIX 57-Zeichenfolgendarstellung der Knoten main_idParameter. Datentyp: Zeichenfolge |
| name | Name des Knotens. Datentyp: Zeichenfolge |
| Node_Classifier | Klassifiziererhierarchie des Knotens. Verwenden Sie diese Informationen, um einen Knoten in der Ordnerhierarchie zu suchen. Beispielsweise hätte ein bereitstellbares Element eine Hierarchie von /Application/proviyables/env:Development Während eine Sammlung eine Hierarchie von hat /Applications/Collections 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 in diesem Fall ein komplexes Objekt unter einem Array hochgeladen wird `{"cdi1": 1} `, Der Endpunkt erstellt einen neuen virtuellen Knoten mit dem Namen, der seiner Position entspricht. Im obigen Beispiel ist dies 2000. Für Includes ist die Position immer leer. Datentyp: Zeichenfolge |
| Vorherige_Version | Details der vorherigen Version des Knotendatensatzes. Hinweis: Wenn ein neuer Knoten erstellt wurde, wird der Endpunkt zurückgegeben `„Previous_Version" = null `Für diesen Parameter. Datentyp: Objekt "previous_version": { "link": "String", "value": "String" } |
| Previous_Version.Link | Aufrufsyntax zum Abfragen dieses Knotendatensatzes mit Tabelle REST-API. Datentyp: Zeichenfolge |
| Previous_Version.value | SYS_ID des Knotendatensatzes. Datentyp: Zeichenfolge Tabelle: CDM-Knoten \[sn_cdm_node\] |
| Grund_für_Konflikt | Detaillierte Erklärung des Konflikts. Datentyp: Zeichenfolge |
| Restricted_to | Details der Gruppe, die Zugriff auf den dem Knoten zugeordneten hat. Datentyp: Objekt "restricted_to": { "link": "String", "value": "String" } |
| Restricted_to.Link | Aufrufsyntax zum Abfragen dieses Gruppendatensatzes mit Tabelle REST-API. Datentyp: Zeichenfolge |
| Restricted_to.value | SYS_ID des Gruppendatensatzes. Datentyp: Zeichenfolge Tabelle: CDM-Gruppe \[sys_user_Group\] |
| Secure_value | Wenn dieser Wert als gesichert gekennzeichnet wurde, wird das verschlüsselte Feld (maskiert zurückgegeben) 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 anweisen, diese Felder nicht zurückzugeben, indem Sie festlegen returnFieldsParameterfeld abfragen. Datentyp: Zeichenfolge |
| Status | Knotenstatus. Mögliche Werte: * GELÖSCHT * NEW * ERSETZT * AKTUALISIERT * GÜLTIG Datentyp: Zeichenfolge |
| Systemordner | Kennzeichnung, die angibt, ob der zugeordnete Knoten ein Systemordner ist. Mögliche Werte: * Wahr: Knoten ist ein Systemordner. * Falsch: Knoten ist kein Systemordner. Datentyp: Boolescher Wert |
| 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. Datentyp: Zeichenfolge Tabelle: CDM-Knoten \[sn_cdm_node\] |
| sys_updated_by | Name des Anwenders, 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 |
| Typ | 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 abgerufen werden /TestApp/Fbereitstellbare Elemente/Entwicklung_1 Übergeordneter Knoten.

    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/include {#ariaid-title5}

Schließt einen vorhandenen Knoten in einen anderen Knoten ein, z. B. einen Komponentenknoten in einem Sammlungsknoten oder einen Sammlungsknoten in einem bereitstellbaren Knoten. Nach dem Einbeziehen eines Knotens hat der neue Knoten seine eigene eindeutige sys_ID und Main_ID.
Der Aufrufer dieses Endpunkts muss über die Rolle „CDM-Editor" verfügen.

### URL-Format

Versionierte URL: /api/sn_cdm/{api_Version}/Editor/include

Standard-URL: /api/sn_cdm/Editor/include  
Hinweis:  
Verfügbare Versionen werden in angegeben [REST-API-Explorer](https://servicenow-prod.fluidtopics.net/QZyr9s_~V0xB9fqGOlvJ4A "In diesem Tutorial verwenden Sie den REST API Explorer, um zu testen ServiceNowREST-APIs."). Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf [Geskriptetes REST-Service-Formular](https://servicenow-prod.fluidtopics.net/0V9QfkPsOI5r~YAD7CJWCA "Mit der geskripteten REST-API-Funktion können Anwendungsentwickler anwenderdefinierte Webservice-APIs erstellen.").

### Unterstützte Anforderungsparameter

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

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. 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. Pfad-Parameter]

{#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. Datentyp: Zeichenfolge Tabelle: CDM-Änderungssatz \[sn_cdm_Changeset\] |
| returnFields | Liste der Felder, die als Teil der Antwort zurückgegeben werden sollen. Übergeben Sie die Namen der Datensatzspalte, z. B. sys_ID, sys_updated_by oder Status. 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. Beispiel: Um den folgenden Knoten einzubeziehen `Bereitstellung/bereitstellbare Elemente/Entwickler1/cdi1 `: * Backslash-Format: Bereitstellung/bereitstellbare Elemente/Entwickler1/cdi1 Hinweis: Wenn Ihr Knotenname einen umgekehrten Schrägstrich ("/") enthält, können Sie dieses Format nicht verwenden. * Back-End-Namenspfad mit Ersatzzeichen: Bereitstellung bereitstellbarer Elemente-- Entwickler1cdi1 * Array: \['Bereitstellung','bereitstellbare Elemente','Entwickler1','cdi1'\] Datentyp: Zeichenfolge |
| TargetFullNamePath | Erforderlich. Pfadname des Knotens, unter dem der Quellknoten aufgenommen werden soll. Sie können den Namenspfad in einem der folgenden Formate übergeben. Beispiel: Um den folgenden Knoten einzubeziehen `Produktion/bereitstellbare Elemente/Entwickler1 `: * Backslash-Format: Produktion/bereitstellbare Elemente/Entwickler1/cdi1 Hinweis: Wenn Ihr Knotenname einen umgekehrten Schrägstrich ("/") enthält, können Sie dieses Format nicht verwenden. * Back-End-Namenspfad mit Ersatzzeichen: In der Produktion bereitstellbareEntwicklung1cdi1 * Array: \['Produktion','bereitstellbare Elemente','Entwickler1','cdi1'\] {#editor-POST-includes__ul_wk2_k21_cyb} Datentyp: Zeichenfolge |
[Tabelle : 20. Abfrageparameter]

{#editor-POST-includes__entry__16}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 21. Anforderungstext-Parameter]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. 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/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch 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}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
| Inhaltstyp | Datenformat des Anforderungstexts. Nur unterstützt application/json. |
[Tabelle : 22. Anforderungskopfzeilen.]

{#editor-POST-includes__entry__26}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 23. Antwort-Header]

### 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 [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#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 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 24. Statuscodes]

### Antworttext-Parameter

{#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 |
|-|-|
| änderungssatz_ID | Eindeutiger Bezeichner des zugeordneten Changesets, z. B. „Chset-10". Datentyp: Zeichenfolge Tabelle: CDM-Änderungssatz \[sn_cdm_Changeset\] |
| Konflikt | Kennzeichnung, die angibt, ob bei der Verarbeitung des Knotens ein Konflikt aufgetreten ist. Mögliche Werte: * Wahr: Konflikt erkannt. * Falsch: Es wurde kein Konflikt erkannt. Datentyp: Boolescher Wert |
| Conflict_type | Wenn conflictParameter ist „wahr", der Typ des erkannten Konflikts. Null, wenn kein Konflikt erkannt wird. Mögliche Werte: * Corrupted_node * Deleted_node * Duplicate_node * Unvollständig_gelöscht_übergeordnet * Unvollständig_gelöscht_ref * Unvollständig_umbenannt_ref * INVALID_include * Verwaiste_descendant * Related_conflict * Unlinked_include * Unenamed_include * Updated_node Datentyp: Zeichenfolge |
| Beschreibung | Kurzbeschreibung des Zwecks des Knotens. Datentyp: Zeichenfolge |
| Effektiv_von | Zeitstempel (in eine lange Ganzzahl konvertiert), zu dem der Knoten als Teil des Changesets bestätigt wurde. Wenn der Knoten nicht bestätigt wurde, ist dieser Wert „null". Datentyp: Zahl (Ganzzahl) |
| Effektiv_bis | Zeitstempel (in eine lange Ganzzahl konvertiert) des Knotens, als er entweder gelöscht oder durch einen anderen Knoten ersetzt wurde, andernfalls „null". Datentyp: Zahl (Ganzzahl) |
| Fehler | Wenn während der Verarbeitung ein Fehler aufgetreten ist, die Details zum Fehler. Datentyp: Objekt "error": { "detail": "String", "message": "String" } |
| error.detail | Zusätzliche Informationen zum Fehler. Datentyp: Zeichenfolge |
| Fehler.Nachricht | 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 | Die main_idParameter 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 verwenden CdmQuery() Skripteinbindung zum Abrufen einer JSON-Struktur. Beispiel: `CdmQuery().mainId('123')/query().getTree(); ` Datentyp: Zeichenfolge |
| Main_ID_encoded | RADIX 57-Zeichenfolgendarstellung der Knoten main_idParameter. Datentyp: Zeichenfolge |
| name | Name des Knotens, der unter dem Zielpfad enthalten war. Datentyp: Zeichenfolge |
| Node_Classifier | Klassifiziererhierarchie des Knotens. Verwenden Sie diese Informationen, um einen Knoten in der Ordnerhierarchie zu suchen. Beispielsweise hätte ein bereitstellbares Element eine Hierarchie von /Application/proviyables/env:Development Während eine Sammlung eine Hierarchie von hat /Applications/Collections Datentyp: Zeichenfolge |
| Node_path | Vollständiger Pfadname des Knotens, der im Zielpfad enthalten war, z. B. /Produktion/bereitstellbare Elemente/Entwickler1/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 in diesem Fall ein komplexes Objekt unter einem Array hochgeladen wird `{"cdi1": 1} `, Der Endpunkt erstellt einen neuen virtuellen Knoten mit dem Namen, der seiner Position entspricht. Im obigen Beispiel ist dies 2000. Für Includes ist die Position immer leer. Datentyp: Zeichenfolge |
| Vorherige_Version | Details der vorherigen Version des Knotendatensatzes. Hinweis: Wenn ein neuer Knoten erstellt wurde, wird der Endpunkt zurückgegeben `„Previous_Version" = null `Für diesen Parameter. Datentyp: Objekt "previous_version": { "link": "String", "value": "String" } |
| Restricted_to | Details der Gruppe, die Zugriff auf den dem Knoten zugeordneten 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) 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 anweisen, diese Felder nicht zurückzugeben, indem Sie festlegen returnFieldsParameterfeld abfragen. Datentyp: Zeichenfolge |
| Status | Knotenstatus. Mögliche Werte: * GELÖSCHT * NEW * ERSETZT * AKTUALISIERT * GÜLTIG Datentyp: Zeichenfolge |
| sys_id | SYS_ID des Knotens. Datentyp: Zeichenfolge Tabelle: CDM-Knoten \[sn_cdm_node\] |
| Systemordner | Kennzeichnung, die angibt, ob der zugeordnete Knoten ein Systemordner ist. Mögliche Werte: * Wahr: Knoten ist ein Systemordner. * Falsch: Knoten ist kein Systemordner. Datentyp: Boolescher Wert |
| Typ | 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 einbezogen wird /TestApp/Collections/Colla Unter /TestApp/bereitstellbare Elemente/Entwicklung_1 .

    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, Konfigurationsdatenelement (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 über die Rolle „CDM-Editor" oder „CDM-Geheimnis" verfügen.

### URL-Format

Versionierte URL: /api/sn_cdm/{api_Version}/Editor/nodes

Standard-URL: /api/sn_cdm/Editor/nodes  
Hinweis:  
Verfügbare Versionen werden in angegeben [REST-API-Explorer](https://servicenow-prod.fluidtopics.net/QZyr9s_~V0xB9fqGOlvJ4A "In diesem Tutorial verwenden Sie den REST API Explorer, um zu testen ServiceNowREST-APIs."). Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf [Geskriptetes REST-Service-Formular](https://servicenow-prod.fluidtopics.net/0V9QfkPsOI5r~YAD7CJWCA "Mit der geskripteten REST-API-Funktion können Anwendungsentwickler anwenderdefinierte Webservice-APIs erstellen.").

### Unterstützte Anforderungsparameter

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

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. 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. Pfad-Parameter]

{#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 |
|-|-|
| Übergeordnete Elemente automatisch erstellen | Kennzeichnung, die angibt, ob die nicht vorhandenen übergeordneten Elemente im Namenspfad automatisch als Komponenten erstellt werden sollen. Ausnahmen davon 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: Erstellen Sie die nicht vorhandenen übergeordneten Elemente automatisch. * Falsch: Nicht vorhandene übergeordnete Elemente nicht automatisch erstellen. Datentyp: Boolescher Wert Standard: Falsch |
| changesetNumber | Erforderlich. Eindeutiger Bezeichner des zugeordneten Changesets, z. B. „Chset-10". Datentyp: Zeichenfolge Tabelle: CDM-Änderungssatz \[sn_cdm_Changeset\] |
| FullNamePath | Erforderlich. Pfadname des Knotens. Sie können den Namenspfad in einem der folgenden Formate übergeben. Beispiel: Um den Namenspfad für den Knoten zu definieren `TestApp/bereitstellbare Elemente/Entwickler1/cdi1 `: * Backslash-Format: TestApp/bereitstellbare Elemente/Entwickler1/cdi1 Hinweis: Wenn Ihr Knotenname einen umgekehrten Schrägstrich ("/") enthält, können Sie dieses Format nicht verwenden. * Back-End-Namenspfad mit Ersatzzeichen: TestApp bereitstellbareEntwickler1 cdi1 * Array: \['TestApp','bereitstellbare Elemente','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 Namen der Datensatzspalte, z. B. sys_ID, sys_updated_by oder Status. Datentyp: Array Standard: Alle Felder, wie vom Endpunkt bestimmt |
| Sicher | Kennzeichnung, die angibt, ob der Wert für die Blattknoten verschlüsselt werden soll. Gültige Werte: * Wahr: Verschlüsselt * Falsch: Nicht verschlüsselt Datentyp: Boolescher Wert Standard: Falsch |
| Typ | 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. Anforderungstext-Parameter]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. 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/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch 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}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
| Inhaltstyp | Datenformat des Anforderungstexts. Nur unterstützt application/json. |
[Tabelle : 28. Anforderungskopfzeilen.]

{#editor-POST-nodes__entry__32}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 29. Antwort-Header]

### 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 [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#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 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 30. Statuscodes]

### Antworttext-Parameter

{#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 |
|-|-|
| änderungssatz_ID | Details des Changeset-Datensatzes, der dem Knoten zugeordnet ist. Datentyp: Objekt "changeset_id": { "link": "String", "value": "String" } |
| änderungssatz_ID.Link | Aufrufsyntax zum Abfragen dieses Changeset-Datensatzes mit Tabelle REST-API. Datentyp: Zeichenfolge |
| änderungssatz_ID.Wert | Eindeutiger Bezeichner des Changeset-Datensatzes. Datentyp: Zeichenfolge Tabelle: CDM-Änderungssatz \[sn_cdm_Changeset\] |
| Konflikt | Kennzeichnung, die angibt, ob bei der Verarbeitung des Knotens ein Konflikt aufgetreten ist. Mögliche Werte: * Wahr: Konflikt erkannt. * Falsch: Es wurde kein Konflikt erkannt. Datentyp: Boolescher Wert |
| Conflict_type | Wenn conflictParameter ist „wahr", der Typ des erkannten Konflikts. Null, wenn kein Konflikt erkannt wird. Mögliche Werte: * Corrupted_node * Deleted_node * Duplicate_node * Unvollständig_gelöscht_übergeordnet * Unvollständig_gelöscht_ref * Unvollständig_umbenannt_ref * INVALID_include * Verwaiste_descendant * Related_conflict * Unlinked_include * Unenamed_include * Updated_node Datentyp: Zeichenfolge |
| Beschreibung | Kurzbeschreibung des Zwecks des Knotens. Datentyp: Zeichenfolge |
| Effektiv_von | Zeitstempel (in eine lange Ganzzahl konvertiert), zu dem der Knoten als Teil des Changesets bestätigt wurde. Wenn der Knoten nicht bestätigt wurde, ist dieser Wert „null". Datentyp: Zahl (Ganzzahl) |
| Effektiv_bis | Zeitstempel (in eine lange Ganzzahl konvertiert) des Knotens, als er entweder gelöscht oder durch einen anderen Knoten ersetzt wurde, andernfalls „null". Datentyp: Zahl (Ganzzahl) |
| Fehler | Wenn während der Verarbeitung ein Fehler aufgetreten ist, die Details zum Fehler. Datentyp: Objekt "error": { "detail": "String", "message": "String" } |
| error.detail | Zusätzliche Informationen zum Fehler. Datentyp: Zeichenfolge |
| Fehler.Nachricht | 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 | Die main_idParameter 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 verwenden CdmQuery() Skripteinbindung zum Abrufen einer JSON-Struktur. Beispiel: `CdmQuery().mainId('123')/query().getTree(); ` Datentyp: Zeichenfolge |
| Main_ID_encoded | RADIX 57-Zeichenfolgendarstellung der Knoten main_idParameter. Datentyp: Zeichenfolge |
| name | Name des Knotens. Datentyp: Zeichenfolge |
| Node_Classifier | Klassifiziererhierarchie des Knotens. Verwenden Sie diese Informationen, um einen Knoten in der Ordnerhierarchie zu suchen. Beispielsweise hätte ein bereitstellbares Element eine Hierarchie von /Application/proviyables/env:Development Während eine Sammlung eine Hierarchie von hat /Applications/Collections 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 in diesem Fall ein komplexes Objekt unter einem Array hochgeladen wird `{"cdi1": 1} `, Der Endpunkt erstellt einen neuen virtuellen Knoten mit dem Namen, der seiner Position entspricht. Im obigen Beispiel ist dies 2000. Für Includes ist die Position immer leer. Datentyp: Zeichenfolge |
| Vorherige_Version | Details der vorherigen Version des Knotendatensatzes. Hinweis: Wenn ein neuer Knoten erstellt wurde, wird der Endpunkt zurückgegeben `„Previous_Version" = null `Für diesen Parameter. Datentyp: Objekt "previous_version": { "link": "String", "value": "String" } |
| Previous_Version.Link | Aufrufsyntax zum Abfragen dieses Knotendatensatzes mit Tabelle REST-API. Datentyp: Zeichenfolge |
| Previous_Version.value | SYS_ID des Knotendatensatzes. Datentyp: Zeichenfolge Tabelle: CDM-Knoten \[sn_cdm_node\] |
| Grund_für_Konflikt | Detaillierte Erklärung des Konflikts. Datentyp: Zeichenfolge |
| Restricted_to | Details der Gruppe, die Zugriff auf den dem Knoten zugeordneten hat. Datentyp: Objekt "restricted_to": { "link": "String", "value": "String" } |
| Restricted_to.Link | Aufrufsyntax zum Abfragen dieses Gruppendatensatzes mit Tabelle REST-API. Datentyp: Zeichenfolge |
| Restricted_to.value | SYS_ID des Gruppendatensatzes. Datentyp: Zeichenfolge Tabelle: CDM-Gruppe \[sys_user_Group\] |
| Secure_value | Wenn dieser Wert als gesichert gekennzeichnet wurde, wird das verschlüsselte Feld (maskiert zurückgegeben) 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 anweisen, diese Felder nicht zurückzugeben, indem Sie festlegen returnFieldsParameterfeld abfragen. Datentyp: Zeichenfolge |
| Status | Knotenstatus. Mögliche Werte: * GELÖSCHT * NEW * ERSETZT * AKTUALISIERT * GÜLTIG Datentyp: Zeichenfolge |
| Systemordner | Kennzeichnung, die angibt, ob der zugeordnete Knoten ein Systemordner ist. Mögliche Werte: * Wahr: Knoten ist ein Systemordner. * Falsch: Knoten ist kein Systemordner. Datentyp: Boolescher Wert |
| 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. Datentyp: Zeichenfolge Tabelle: CDM-Knoten \[sn_cdm_node\] |
| sys_updated_by | Name des Anwenders, 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 |
| Typ | 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 ein Knoten mit diesem Endpunkt erstellt wird.

    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 Wert eines angegebenen Knotens.
Der Aufrufer dieses Endpunkts muss entweder über die Rolle „CDM-Editor" oder „CDM-Geheimnis" verfügen.

### URL-Format

Versionierte URL: /api/sn_cdm/{api_Version}/Editor/nodes

Standard-URL: /api/sn_cdm/Editor/nodes  
Hinweis:  
Verfügbare Versionen werden in angegeben [REST-API-Explorer](https://servicenow-prod.fluidtopics.net/QZyr9s_~V0xB9fqGOlvJ4A "In diesem Tutorial verwenden Sie den REST API Explorer, um zu testen ServiceNowREST-APIs."). Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf [Geskriptetes REST-Service-Formular](https://servicenow-prod.fluidtopics.net/0V9QfkPsOI5r~YAD7CJWCA "Mit der geskripteten REST-API-Funktion können Anwendungsentwickler anwenderdefinierte Webservice-APIs erstellen.").

### Unterstützte Anforderungsparameter

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

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. 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. Pfad-Parameter]

{#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". Datentyp: Zeichenfolge Tabelle: CDM-Änderungssatz \[sn_cdm_Changeset\] |
| FullNamePath | Erforderlich. Pfadname des Knotens. Sie können den Namenspfad in einem der folgenden Formate übergeben. Beispiel: Um den Namenspfad für den Knoten zu definieren `TestApp/bereitstellbare Elemente/Entwickler1/cdi1 `: * Backslash-Format: TestApp/bereitstellbare Elemente/Entwickler1/cdi1 Hinweis: Wenn Ihr Knotenname einen umgekehrten Schrägstrich ("/") enthält, können Sie dieses Format nicht verwenden. * Back-End-Namenspfad mit Ersatzzeichen: TestApp bereitstellbareEntwickler1 cdi1 * Array: \['TestApp','bereitstellbare Elemente','Development1','cdi1'\] {#editor-PUT-nodes__cdm_apps-namePath-ul} Datentyp: Zeichenfolge |
| NEWNAME | 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 Blattknoten verschlüsselt werden soll. Gültige Werte: * Wahr: Verschlüsselt * Falsch: Nicht verschlüsselt Datentyp: Boolescher Wert Standard: Falsch |
| returnFields | Liste der Felder, die als Teil der Antwort zurückgegeben werden sollen. Übergeben Sie die Namen der Datensatzspalte, z. B. sys_ID, sys_updated_by oder Status. Datentyp: Array Standard: Alle Felder, wie vom Endpunkt bestimmt |
[Tabelle : 32. Abfrageparameter]

{#editor-PUT-nodes__entry__20}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 33. Anforderungstext-Parameter]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. 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/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch 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}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
| Inhaltstyp | Datenformat des Anforderungstexts. Nur unterstützt application/json. |
[Tabelle : 34. Anforderungskopfzeilen.]

{#editor-PUT-nodes__entry__30}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 35. Antwort-Header]

### 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 [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#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 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 36. Statuscodes]

### Antworttext-Parameter

{#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 |
|-|-|
| änderungssatz_ID | Details des Changeset-Datensatzes, der dem Knoten zugeordnet ist. Datentyp: Objekt "changeset_id": { "link": "String", "value": "String" } |
| änderungssatz_ID.Link | Aufrufsyntax zum Abfragen dieses Changeset-Datensatzes mit Tabelle REST-API. Datentyp: Zeichenfolge |
| änderungssatz_ID.Wert | Eindeutiger Bezeichner des Changeset-Datensatzes. Datentyp: Zeichenfolge Tabelle: CDM-Änderungssatz \[sn_cdm_Changeset\] |
| Konflikt | Kennzeichnung, die angibt, ob bei der Verarbeitung des Knotens ein Konflikt aufgetreten ist. Mögliche Werte: * Wahr: Konflikt erkannt. * Falsch: Es wurde kein Konflikt erkannt. Datentyp: Boolescher Wert |
| Conflict_type | Wenn conflictParameter ist „wahr", der Typ des erkannten Konflikts. Null, wenn kein Konflikt erkannt wird. Mögliche Werte: * Corrupted_node * Deleted_node * Duplicate_node * Unvollständig_gelöscht_übergeordnet * Unvollständig_gelöscht_ref * Unvollständig_umbenannt_ref * INVALID_include * Verwaiste_descendant * Related_conflict * Unlinked_include * Unenamed_include * Updated_node Datentyp: Zeichenfolge |
| Beschreibung | Kurzbeschreibung des Zwecks des Knotens. Datentyp: Zeichenfolge |
| Effektiv_von | Zeitstempel (in eine lange Ganzzahl konvertiert), zu dem der Knoten als Teil des Changesets bestätigt wurde. Wenn der Knoten nicht bestätigt wurde, ist dieser Wert „null". Datentyp: Zahl (Ganzzahl) |
| Effektiv_bis | Zeitstempel (in eine lange Ganzzahl konvertiert) des Knotens, als er entweder gelöscht oder durch einen anderen Knoten ersetzt wurde, andernfalls „null". Datentyp: Zahl (Ganzzahl) |
| Fehler | Wenn während der Verarbeitung ein Fehler aufgetreten ist, die Details zum Fehler. Datentyp: Objekt "error": { "detail": "String", "message": "String" } |
| error.detail | Zusätzliche Informationen zum Fehler. Datentyp: Zeichenfolge |
| Fehler.Nachricht | 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 | Die main_idParameter 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 verwenden CdmQuery() Skripteinbindung zum Abrufen einer JSON-Struktur. Beispiel: `CdmQuery().mainId('123')/query().getTree(); ` Datentyp: Zeichenfolge |
| Main_ID_encoded | RADIX 57-Zeichenfolgendarstellung der Knoten main_idParameter. Datentyp: Zeichenfolge |
| name | Name des Knotens. Datentyp: Zeichenfolge |
| Node_Classifier | Klassifiziererhierarchie des Knotens. Verwenden Sie diese Informationen, um einen Knoten in der Ordnerhierarchie zu suchen. Beispielsweise hätte ein bereitstellbares Element eine Hierarchie von /Application/proviyables/env:Development Während eine Sammlung eine Hierarchie von hat /Applications/Collections 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 in diesem Fall ein komplexes Objekt unter einem Array hochgeladen wird `{"cdi1": 1} `, Der Endpunkt erstellt einen neuen virtuellen Knoten mit dem Namen, der seiner Position entspricht. Im obigen Beispiel ist dies 2000. Für Includes ist die Position immer leer. Datentyp: Zeichenfolge |
| Vorherige_Version | Details der vorherigen Version des Knotendatensatzes. Hinweis: Wenn ein neuer Knoten erstellt wurde, wird der Endpunkt zurückgegeben `„Previous_Version" = null `Für diesen Parameter. Datentyp: Objekt "previous_version": { "link": "String", "value": "String" } |
| Previous_Version.Link | Aufrufsyntax zum Abfragen dieses Knotendatensatzes mit Tabelle REST-API. Datentyp: Zeichenfolge |
| Previous_Version.value | SYS_ID des Knotendatensatzes. Datentyp: Zeichenfolge Tabelle: CDM-Knoten \[sn_cdm_node\] |
| Grund_für_Konflikt | Detaillierte Erklärung des Konflikts. Datentyp: Zeichenfolge |
| Restricted_to | Details der Gruppe, die Zugriff auf den dem Knoten zugeordneten hat. Datentyp: Objekt "restricted_to": { "link": "String", "value": "String" } |
| Restricted_to.Link | Aufrufsyntax zum Abfragen dieses Gruppendatensatzes mit Tabelle REST-API. Datentyp: Zeichenfolge |
| Restricted_to.value | SYS_ID des Gruppendatensatzes. Datentyp: Zeichenfolge Tabelle: CDM-Gruppe \[sys_user_Group\] |
| Secure_value | Wenn dieser Wert als gesichert gekennzeichnet wurde, wird das verschlüsselte Feld (maskiert zurückgegeben) 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 anweisen, diese Felder nicht zurückzugeben, indem Sie festlegen returnFieldsParameterfeld abfragen. Datentyp: Zeichenfolge |
| Status | Knotenstatus. Mögliche Werte: * GELÖSCHT * NEW * ERSETZT * AKTUALISIERT * GÜLTIG Datentyp: Zeichenfolge |
| Systemordner | Kennzeichnung, die angibt, ob der zugeordnete Knoten ein Systemordner ist. Mögliche Werte: * Wahr: Knoten ist ein Systemordner. * Falsch: Knoten ist kein Systemordner. Datentyp: Boolescher Wert |
| 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. Datentyp: Zeichenfolge Tabelle: CDM-Knoten \[sn_cdm_node\] |
| sys_updated_by | Name des Anwenders, 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 |
| Typ | 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 
      } 
    }


