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


---

# XMLDocument-Skriptobjekt

# XMLDocument-Skriptobjekt {#ariaid-title1}

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

Ein JavaScript-Objekt-Wrapper zum Analysieren und Extrahieren von XML-Daten aus einem XML-Dokument (Zeichenfolge).

Verwenden Sie diese JavaScript-Klasse, um ein Objekt aus einer XML-Zeichenfolge zu instanziieren, normalerweise ein Rückgabewert aus einem Webservice-Aufruf oder die XML-Nutzlast der ECC-Warteschlange. Mit dem XMLDocument-Objekt in einer JavaScript-Business-Regel können Sie Werte aus den XML-Elementen und -Attributen direkt abfragen.

## Konstruktor

Der Konstruktor eines Skriptobjekts erstellt eine neue Instanz des zu verwendenden Objekts.

    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 XMLDocument(xmlString);

Um die XML-Analyse einer XML-Zeichenfolge durchzuführen, die für den Namensraum qualifiziert ist, geben Sie „wahr" für das zweite Argument für den XMLDocument-Konstruktor an. Im Folgenden finden Sie ein Beispiel für die Analyse und XML-Zeichenfolge, die die Qualifizierung des Namens und Bereichs ihrer Elemente enthält.

    var xmlString = "<bk:book xmlns:bk='urn:loc.gov:books' xmlns:isbn='urn:ISBN:0-395-36341-6'>" +
                      "<bk:title>Cheaper by the Dozen</bk:title>" +
                      "<isbn:number>1568491379</isbn:number>" +
                    "</bk:book>";

    var xmldoc = new XMLDocument(xmlString, true); // XML document is name space aware

## Knoten und Elemente werden gesucht

Jetzt, da wir das XMLDocument-Objekt haben, können wir die folgenden APIs aufrufen, um zu suchen Knoten und Elemente des XML-Dokuments sowie Text direkt daraus extrahieren. Die Abfragesyntax zum Suchen von Knoten und Attributen basiert auf XPath.  
Hinweis:  
Die XML-Analyse mit diesem Objekt ist Namespace nicht bewusst. Dies bedeutet, dass die XPath-Suchzeichenfolge „//myelement" lautet, wenn Sie einen Knotennamen mit Namespace suchen, z. B. „\<names:myelement\> ...".  
Im Folgenden finden Sie Beispiele für das Suchen eines Knotens anhand seines XPath und das Abrufen des Textwerts aus dem resultierenden Knoten.

    var str = xmldoc.getNodeText("//two"); // returns the first occurrence of the node
    // str == "abcd1234"

    str = xmldoc.getNodeText("//three");
    // str == "1234abcd"

    str = xmldoc.getNodeText("/test/one/*");
    // str == "abcd1234"

    str = xmldoc.getNodeInt("//number");
    // str == 1234

Die folgenden Beispiele suchen den Knoten nach XPath und verwenden die API für Knoten und Element zum Abrufen von Attributen und Werten.

    var node = xmldoc.getNode("/test/one/two");
    // node.getNodeName() == "two"
    // node.getNodeType() == "1" // 1 == ELEMENT_NODE
    // node.getLastChild().getNodeType() == "3" // 3 == TEXT_NODE
    // node.getLastChild().getNodeValue() == "abcd1234"

Oder Sie können die folgenden Komfortfunktionen verwenden, um den Knotennamen und -Typ abzurufen

    str = xmldoc.getNodeName("//three");
    // str == "three"

    str = xmldoc.getNodeType("//three");
    // str == "1"

Sie können auch eine Liste von abrufen Knoten, auf die Sie direkt nach Position iterieren oder zugreifen können

    var nodelist = xmldoc.getNodes("//one/*"); // two, three, and two
    // nodelist.getLength() == "3"
    // nodelist.item(0).getNodeName() == "two"
    // nodelist.item(1).getNodeName() == "three"

Das folgende Beispiel ist das Analysieren einer XML-Zeichenfolge, die mit Namensräumen qualifiziert ist.

    var xmlString = "<bk:book xmlns:bk='urn:loc.gov:books' xmlns:isbn='urn:ISBN:0-395-36341-6'>" +
                      "<bk:title>Cheaper by the Dozen</bk:title>" +
                      "<isbn:number>1568491379</isbn:number>" +
                    "</bk:book>";

    var xmldoc = new XMLDocument(xmlString, true);
    var str = xmldoc.getNodeText("//bk:title"); // returns the first occurence of the node
    gs.log(str);

    str = xmldoc.getNodeText("/bk:book/*");
    gs.log(str);

    str = xmldoc.getNodeInt("//isbn:number");
    gs.log(str);

## Attributwerte werden abgerufen

Ein Attribut ist nur eine Erweiterung eines Knotens und hat daher alle dieselben APIs.  
Das folgende Beispiel zeigt, wie ein Knoten abgefragt wird, um sein Attribut nach Position abzurufen

    node = xmldoc.getNode("//two");
    // node.getAttributes().item(0).getNodeValue() == "xxx"

    str = xmldoc.getAttribute("//two", "att");
    // str == "xxx"

XPath hat auch eine Abfragesyntax zum direkten Suchen des Attributknotens, z. B.

    str = xmldoc.getNodeText("//*[@att=\"yyy\"]");
    // str == "1234abcd"

    str = xmldoc.getNode("//@boo").getNodeValue();
    // str == "yah"

## Neue Elemente werden erstellt

Ein XML-Element kann auf jeder Ebene des XML-Dokuments erstellt werden, nachdem es erstellt wurde. Verwenden Sie SetCurrent Funktion zum Positionieren, wo das neue Element als untergeordnetes Element erstellt wird, und verwenden Sie CreateElement Funktion zum Erstellen des Elements.

    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 XMLDocument(xmlString);
    xmldoc.createElement("new", "test"); // creates the new element at the document element level if setCurrent is never called
    xmldoc.createElement("new2"); // calling without a value will create a new element by itself

    var el = xmldoc.createElement("new3");
    xmldoc.setCurrent(el); // this is now the parent of any new elements created subsequently using createElement()
    xmldoc.createElement("newChild", "test");

Das resultierende XML-Dokument sieht so aus

    <test>
      <one>
        <two att="xxx">abcd1234</two>
        <three boo="yah" att="yyy">1234abcd</three>
        <two>another</two>
      </one>
      <number>1234</number>
      <new>test<new>
      <new2/>
      <new3>
          <newChild>test</newChild>
      </new3>
    </test>

* **[XMLHelper](https://servicenow-prod.fluidtopics.net/IClQVHbLG~4U5IH8kQpd_g)**   
  Die XML-Hilfskripteinbindung erleichtert das Analysieren von XML in Skripts.

