---
sourceDocument: Xanadu-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# XMLNode: Bereichsbezogen, global

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

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

Die XMLNode- API bietet Methoden zum Abfragen von Werten aus XML-Knoten. XMLNodes 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 die Methode createElement() von [XMLDocument2](https://servicenow-prod.fluidtopics.net/zRHIQ_h6PSevL3SMcT~hpg#c_XMLDocument2ScopedAPI "Die XMLDocument2- API ist ein JavaScript-Objekt-Wrapper zum Analysieren und Extrahieren von XML-Daten aus einer XML-Zeichenfolge."), die einem vorhandenen Dokument einen Knoten hinzufügt.

## Scoped XMLNode -- getAttribute(String attribute) {#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 | Wert des Attributs. |
[Tabelle : 2. Ergebnisse]

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

## Scoped XMLNode -- 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 Attributwert ist. |
[Tabelle : 4. Ergebnisse]

{#r_SXMLN_getAttributes__table_ck3_rjy_3x}

## Scoped XMLNode -- 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 | Knoten-Iterator-Objekt. |
[Tabelle : 6. Ergebnisse]

{#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());

## Scoped XMLNode -- 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 |
|-|-|
| XMLNode | Erster untergeordneter Knoten des Knotens. |
[Tabelle : 8. Ergebnisse]

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

## Scoped XMLNode -- 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 |
|-|-|
| XMLNode | Letztes untergeordnetes Element des Knotens. |
[Tabelle : 10. Ergebnisse]

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

## Scoped XMLNode -- getNodeName() {#ariaid-title7}

Ruft den Namen des Knotens ab. Der Name eines Knotens wird vom Knotentyp bestimmt. Der Name eines Dokumentelementknotens lautet #document. Der Name eines Textknotens lautet #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 | Name des Knotens. |
[Tabelle : 12. Ergebnisse]

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

## Scoped XMLNode -- getNodeValue() {#ariaid-title8}

Ruft den Wert des Knotens ab. Der Wert eines Knotens wird vom Knotentyp bestimmt. Element- und Dokumentelementknoten 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 | Wert des Knotens. |
[Tabelle : 14. Ergebnisse]

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

## Scoped XMLNode -- 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 | Textinhalt des aktuellen Knotens. |
[Tabelle : 16. Ergebnisse]

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

## Scoped XMLNode -- hasAttribute(String attribute) {#ariaid-title10}

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

| Name | Typ | Beschreibung |
|-|-|-|
| Attribut | Zeichenfolge | 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 | „True", wenn der Knoten das Attribut hat. |
[Tabelle : 18. Ergebnisse]

{#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 XMLNode -- isCDATANode() {#ariaid-title11}

Gibt an, ob der CDATA-Knoten als separater Knoten beibehalten wird.
Verwenden Sie die Methode [Bereichsbezogenes XML-Dokument2 -- setEnableCDATAReporting(Boolean enable)](https://servicenow-prod.fluidtopics.net/zRHIQ_h6PSevL3SMcT~hpg#SXMLD_setEnableCDATAReporting_B "Legt fest, ob Knoten nach der Analyse als CDATA oder normaler Text behandelt werden. Die CDATA-Berichterstellung ist standardmäßig deaktiviert."), um sicherzustellen, dass CDATA-Knoten erhalten bleiben 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 es sich bei einem abgefragten Knoten um CDATA oder Nur-Text handelt. Gültige Werte: * wahr: Der abgefragte Knoten ist CDATA. * „falsch": Der abgefragte Knoten ist Nur-Text. {#SXMLN_isCDATANode__ul_fj4_svh_lzb} |
[Tabelle : 20. Ergebnisse]

{#SXMLN_isCDATANode__table_ck3_rjy_3x}  
Das folgende Beispiel zeigt, wie eine XML-Zeichenfolge bei aktivierter CDATA-Berichterstellung mit [Bereichsbezogenes XML-Dokument2 -- setEnableCDATAReporting(Boolean enable)](https://servicenow-prod.fluidtopics.net/zRHIQ_h6PSevL3SMcT~hpg#SXMLD_setEnableCDATAReporting_B "Legt fest, ob Knoten nach der Analyse als CDATA oder normaler Text behandelt werden. Die CDATA-Berichterstellung ist standardmäßig deaktiviert.")analysiert wird. Der Code verwendet isCDATANode(), um anzuzeigen, 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

## Scoped XMLNode -- 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 | Zeichenfolgewert des aktuellen Knotens. |
[Tabelle : 22. Ergebnisse]

{#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: Der Ausgabe wurden Zeilenumbrüche hinzugefügt.

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