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


---

# XMLKnoten: Bereichsbezogen, global

# XMLKnoten: Bereichsbezogen, global {#ariaid-title1}

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

Die XMLKnoten Die API stellt Methoden zum Abfragen von Werten aus XML-Knoten bereit. XMLKnoten werden aus XMLDocument2-Objekten extrahiert, die XML-Zeichenfolgen enthalten.

Es gibt keine Konstruktoren zum Erstellen einer eigenständigen Instanz eines XMLNode-Objekts. Verwenden Sie stattdessen CreateElement() Methode von [XMLDokument2](https://servicenow-prod.fluidtopics.net/ph1s6BPVvLaBXECUj0xCNA#c_XMLDocument2ScopedAPI "Die XMLDokument2 API ist ein JavaScript-Objekt-Wrapper zum Analysieren und Extrahieren von XML-Daten aus einer XML-Zeichenfolge."), Der einem vorhandenen Dokument einen Knoten hinzufügt.

## Bereichsbezogener XMLKnoten -- getAttribute(Zeichenfolgenattribut) {#ariaid-title2}

Ruft den Wert des Attributs ab.
{#r_ScopedXMLNodeGetAttribute_String__table_ir2_12p_1r__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Attribut | Zeichenfolge | Name des Attributs. |
[Tabelle : 1. Parameter]

{#r_ScopedXMLNodeGetAttribute_String__table_ir2_12p_1r} {#r_ScopedXMLNodeGetAttribute_String__table_kr2_12p_1r__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Der Wert des Attributs. |
[Tabelle : 2. Rückgaben]

{#r_ScopedXMLNodeGetAttribute_String__table_kr2_12p_1r}  

    var xmlString = "<test>" +
                    "  <one>" +
                    "    <two att=\"xxx\">abcd1234</two>" +
                    "    <three boo=\"yah\" att=\"yyy\">1234abcd</three>" +
                    "    <two>another</two>" +
                    "  </one>" +
                    "  <number>1234</number>" +
                    "</test>";
    var xmlDoc = new XMLDocument2();
    xmlDoc.parseXML(xmlString);
    var node = xmlDoc.getNode('//two');
    gs.info(node.getAttribute('att'));

Ausgabe:

    xxx

## Bereichsbezogener XMLKnoten -- getAttributes() {#ariaid-title3}

Gibt ein Objekt zurück, das die Attribute des Knotens als Eigenschaften mit Werten enthält.
{#r_SXMLN_getAttributes__table_bk3_rjy_3x__entry__3}

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

{#r_SXMLN_getAttributes__table_bk3_rjy_3x} {#r_SXMLN_getAttributes__table_ck3_rjy_3x__entry__2}

| Typ | Beschreibung |
|-|-|
| Objekt | Enthält Name-Wert-Paare, wobei der Name das Attribut und der Wert der Wert des Attributs ist. |
[Tabelle : 4. Rückgaben]

{#r_SXMLN_getAttributes__table_ck3_rjy_3x}

## Bereichsbezogener XMLKnoten -- getChildNodeIterator() {#ariaid-title4}

Ruft ein XMLNodeIterator-Objekt ab, mit dem die Liste der untergeordneten Knoten durchlaufen werden kann.
{#r_ScopedXMLNodeGetChildNodeIterator__table_ng3_xfc_2r__entry__3}

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

{#r_ScopedXMLNodeGetChildNodeIterator__table_ng3_xfc_2r} {#r_ScopedXMLNodeGetChildNodeIterator__table_brm_x2p_1r__entry__2}

| Typ | Beschreibung |
|-|-|
| XMLNodeIterator | Das Knoteniteratorobjekt. |
[Tabelle : 6. Rückgaben]

{#r_ScopedXMLNodeGetChildNodeIterator__table_brm_x2p_1r}  

    var xmlString = "<test>" +
                    "  <one>" +
                    "    <two att=\"xxx\">abcd1234</two>" +
                    "    <three boo=\"yah\" att=\"yyy\">1234abcd</three>" +
                    "    <two>another</two>" +
                    "  </one>" +
                    "  <number>1234</number>" +
                    "</test>";
    var xmlDoc = new XMLDocument2();
    xmlDoc.parseXML(xmlString);
    var node = xmlDoc.getNode('//one');
    var iter= node.getChildNodeIterator();
    gs.info(iter.hasNext());

## Bereichsbezogener XMLKnoten -- getFirstChild() {#ariaid-title5}

Ruft den ersten untergeordneten Knoten des Knotens ab.
{#r_ScopedXMLNodeGetFirstChild__table_wbb_wfc_2r__entry__3}

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

{#r_ScopedXMLNodeGetFirstChild__table_wbb_wfc_2r} {#r_ScopedXMLNodeGetFirstChild__table_ecg_ccp_1r__entry__2}

| Typ | Beschreibung |
|-|-|
| XMLKnoten | Der erste untergeordnete Knoten des Knotens. |
[Tabelle : 8. Rückgaben]

{#r_ScopedXMLNodeGetFirstChild__table_ecg_ccp_1r}  

    var xmlString = "<test>" +
                    "<one>" +
                    "<two att=\"xxx\">abcd1234</two>" +
                    "<three boo=\"yah\" att=\"yyy\">1234abcd</three>" +
                    "<two>another</two>" +
                    "</one>" +
                    "<number>1234</number>" +
                    "</test>";
    var xmlDoc = new XMLDocument2();
    xmlDoc.parseXML(xmlString);
    var node = xmlDoc.getNode('//one');
    gs.info(node.getFirstChild());

Ausgabe:

    <two att="xxx">abcd1234</two>

## Bereichsbezogener XMLKnoten -- getLastChild() {#ariaid-title6}

Ruft den letzten untergeordneten Knoten des Knotens ab.
{#r_ScopedXMLNodeGetLastChild__table_gw2_vfc_2r__entry__3}

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

{#r_ScopedXMLNodeGetLastChild__table_gw2_vfc_2r} {#r_ScopedXMLNodeGetLastChild__table_kgc_pbp_1r__entry__2}

| Typ | Beschreibung |
|-|-|
| XMLKnoten | Das letzte untergeordnete Element des Knotens. |
[Tabelle : 10. Rückgaben]

{#r_ScopedXMLNodeGetLastChild__table_kgc_pbp_1r}  

    var xmlString = "<test>" +
                    "<one>" +
                    "<two att=\"xxx\">abcd1234</two>" +
                    "<three boo=\"yah\" att=\"yyy\">1234abcd</three>" +
                    "<two>another</two>" +
                    "</one>" +
                    "<number>1234</number>" +
                    "</test>";
    var xmlDoc = new XMLDocument2();
    xmlDoc.parseXML(xmlString);
    var node = xmlDoc.getNode('//one');
     
    gs.info(node.getLastChild());

Ausgabe:

    <two>another</two>

## Bereichsbezogener XMLKnoten -- getNodeName() {#ariaid-title7}

Ruft den Namen des Knotens ab. Der Name eines Knotens wird durch den Knotentyp bestimmt. Der Name eines Dokumentelementknotens ist #document. Der Name eines Textknotens ist #Text. Der Name eines Elementknotens ist der Name des Elements.
{#r_ScopedXMLNodeGetNodeName__table_oxk_vfc_2r__entry__3}

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

{#r_ScopedXMLNodeGetNodeName__table_oxk_vfc_2r} {#r_ScopedXMLNodeGetNodeName__table_ftf_1dp_1r__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Der Name des Knotens. |
[Tabelle : 12. Rückgaben]

{#r_ScopedXMLNodeGetNodeName__table_ftf_1dp_1r}  

    var xmlString = "<test>" +
                    "  <one>" +
                    "    <two att=\"xxx\">abcd1234</two>" +
                    "    <three boo=\"yah\" att=\"yyy\">1234abcd</three>" +
                    "    <two>another</two>" +
                    "  </one>" +
                    "  <number>1234</number>" +
                    "</test>";
    var xmlDoc = new XMLDocument2();
    xmlDoc.parseXML(xmlString);
    var node = xmlDoc.getNode('//two');
    gs.info(node.getNodeName());

Ausgabe:

    two

## Bereichsbezogener XMLKnoten -- getNodeValue() {#ariaid-title8}

Ruft den Wert des Knotens ab. Der Wert eines Knotens wird durch den Knotentyp bestimmt. Element- und Dokument-Element-Knoten geben null zurück.
{#r_ScopedXMLNodeGetNodeValue__table_jbm_tfc_2r__entry__3}

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

{#r_ScopedXMLNodeGetNodeValue__table_jbm_tfc_2r} {#r_ScopedXMLNodeGetNodeValue__table_djn_4cp_1r__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Der Wert des Knotens. |
[Tabelle : 14. Rückgaben]

{#r_ScopedXMLNodeGetNodeValue__table_djn_4cp_1r}  

    var xmlString = "<test>" +
                    "  <one>" +
                    "    <two att=\"xxx\">abcd1234</two>" +
                    "    <three boo=\"yah\" att=\"yyy\">1234abcd</three>" +
                    "    <two>another</two>" +
                    "  </one>" +
                    "  <number>1234</number>" +
                    "</test>";
    var xmlDoc = new XMLDocument2();
    xmlDoc.parseXML(xmlString);
    var node = xmlDoc.getNode('//two');
    gs.info(node.getNodeValue());

Ausgabe:

    null

## Bereichsbezogener XMLKnoten -- getTextContent() {#ariaid-title9}

Ruft den Textinhalt des aktuellen Knotens ab. Der Textinhalt eines Knotens besteht aus allen untergeordneten Textknoten des Knotens
{#r_ScopedXMLNodeGetTextContent__table_g21_tfc_2r__entry__3}

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

{#r_ScopedXMLNodeGetTextContent__table_g21_tfc_2r} {#r_ScopedXMLNodeGetTextContent__table_igr_z1p_1r__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Der Textinhalt des aktuellen Knotens. |
[Tabelle : 16. Rückgaben]

{#r_ScopedXMLNodeGetTextContent__table_igr_z1p_1r}  

    var xmlString = "<test>" +
                    "  <one>" +
                    "    <two att=\"xxx\">abcd1234</two>" +
                    "    <three boo=\"yah\" att=\"yyy\">1234abcd</three>" +
                    "    <two>another</two>" +
                    "  </one>" +
                    "  <number>1234</number>" +
                    "</test>";
    var xmldoc = new XMLDocument2();
    xmldoc.parseXML(xmlString);
    var node = xmldoc.getNode('//one/two');
    gs.info(node.getTextContent());

Ausgabe:

    abcd1234

## Bereichsbezogener XMLKnoten -- HasAttribute(Zeichenfolgenattribut) {#ariaid-title10}

Bestimmt, ob der Knoten das angegebene Attribut hat.
{#r_ScopedXMLNodeHasAttribute_String__table_art_mdp_1r__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Attribut | Zeichenfolge | Der Name des zu überprüfenden Attributs. |
[Tabelle : 17. Parameter]

{#r_ScopedXMLNodeHasAttribute_String__table_art_mdp_1r} {#r_ScopedXMLNodeHasAttribute_String__table_crt_mdp_1r__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | „Wahr", wenn der Knoten das Attribut hat. |
[Tabelle : 18. Rückgaben]

{#r_ScopedXMLNodeHasAttribute_String__table_crt_mdp_1r}  

    var xmlString = "<test>" +
                    "  <one>" +
                    "    <two att=\"xxx\">abcd1234</two>" +
                    "    <three boo=\"yah\" att=\"yyy\">1234abcd</three>" +
                    "    <two>another</two>" +
                    "  </one>" +
                    "  <number>1234</number>" +
                    "</test>";
    var xmlDoc = new XMLDocument2();
    xmlDoc.parseXML(xmlString);
    var node = xmlDoc.getNode('//two');
    gs.info(node.hasAttribute('att'));

Ausgabe:

    true

## Bereichsbezogener XMLKnoten -- isCDATANode() {#ariaid-title11}

Gibt an, ob der CDATA-Knoten als separater Knoten beibehalten wird.
Verwenden Sie [Bereichsbezogenes XMLDocument2 -- setEnableCDATAReporting (boolescher Wert aktivieren)](https://servicenow-prod.fluidtopics.net/ph1s6BPVvLaBXECUj0xCNA#SXMLD_setEnableCDATAReporting_B "Legt fest, ob Knoten nach der Analyse als CDATA oder regulärer Text behandelt werden. CDATA-Berichterstellung ist standardmäßig deaktiviert.")Methode, um sicherzustellen, dass CDATA-Knoten beibehalten und nicht als Text behandelt werden.
{#SXMLN_isCDATANode__table_bk3_rjy_3x__entry__3}

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

{#SXMLN_isCDATANode__table_bk3_rjy_3x} {#SXMLN_isCDATANode__table_ck3_rjy_3x__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob ein abgefragter Knoten CDATA oder nur-Text ist. Gültige Werte: * Wahr: Der abgefragte Knoten ist CDATA. * Falsch: Der abgefragte Knoten ist nur-Text. {#SXMLN_isCDATANode__ul_fj4_svh_lzb} |
[Tabelle : 20. Rückgaben]

{#SXMLN_isCDATANode__table_ck3_rjy_3x}  
Das folgende Beispiel zeigt, wie eine XML-Zeichenfolge analysiert wird, wenn CDATA-Berichterstellung mit aktiviert ist [Bereichsbezogenes XMLDocument2 -- setEnableCDATAReporting (boolescher Wert aktivieren)](https://servicenow-prod.fluidtopics.net/ph1s6BPVvLaBXECUj0xCNA#SXMLD_setEnableCDATAReporting_B "Legt fest, ob Knoten nach der Analyse als CDATA oder regulärer Text behandelt werden. CDATA-Berichterstellung ist standardmäßig deaktiviert."). Der Code verwendet IsCDATANode() Zeigt an, dass der erste in der XML-Zeichenfolge abgefragte Knoten ein CDATA-Knoten ist.

    var xmlString = "<test>" +
      "  <one>" +
      "    <two att=\"xxx\">abcd1234</two>" +
      "    <three boo=\"yah\" att=\"yyy\">1234abcd</three>"+
      "    <four><![CDATA[another]]>element</four>" +
      "  </one>" +
      "  <number>1234</number>" +
      "</test>";
    var xmlDoc = new XMLDocument2();
    xmlDoc.setEnableCDATAReporting(true); // Enables CDATA reporting
    xmlDoc.parseXML(xmlString);
    var content = xmlDoc.getFirstNode('/test/one/four');
    gs.info(content.getFirstChild().isCDATANode());

Ausgabe:

    true

## Bereichsbezogener XMLKnoten -- toString() {#ariaid-title12}

Gibt den Zeichenfolgenwert des aktuellen Knotens zurück.
{#r_ScopedXMLNodeToString__table_jjy_pfc_2r__entry__3}

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

{#r_ScopedXMLNodeToString__table_jjy_pfc_2r} {#r_ScopedXMLNodeToString__table_bqm_nfp_1r__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Der Zeichenfolgenwert des aktuellen Knotens. |
[Tabelle : 22. Rückgaben]

{#r_ScopedXMLNodeToString__table_bqm_nfp_1r}  

    var xmlString = "<test>" +
                    "  <one>" +
                    "    <two att=\"xxx\">abcd1234</two>" +
                    "    <three boo=\"yah\" att=\"yyy\">1234abcd</three>" +
                    "    <two>another</two>" +
                    "  </one>" +
                    "  <number>1234</number>" +
                    "</test>";
    var xmlDoc = new XMLDocument2();
    xmlDoc.parseXML(xmlString);
    var node = xmlDoc.getNode('//one');
    gs.info(node.toString());

Ausgabe: Zeilenumbrüche wurden der Ausgabe hinzugefügt.

    <one>    
    <two att="xxx">abcd1234</two>    
    <three att="yyy" boo="yah">1234abcd</three>    
    <two>another</two>  
    </one>


