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


---

# XMLStreamingAPI -- Umfang

# XMLStreamingAPI -- Umfang {#ariaid-title1}

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

Erstellt eine große XML-Streaming-Nutzlast zur Verwendung in einer REST- oder SOAP-Anforderung, um Massendaten an eine Drittanbieter-API zu senden. Sie können die Nutzlast auch als XML-Zeichenfolge für eine nicht-Streaming-Option erstellen.
Verwenden Sie diese Methoden in einem Workflow-StudioSkriptschritt mit `sn_ih `Namespace-Bezeichner. Sie können diese API beispielsweise verwenden, um eine XML-Nutzlast in zu erstellen Workflow-StudioSkriptschritt und übergeben Sie den zurückgegebenen Wert an den REST-Schritt, um die Anforderung an einen Drittparteiservice zu senden. Weitere Informationen finden Sie unter Workflow-Studio [Skriptschritt](https://www.servicenow.com/docs/access?context=javascript-step-action-designer&version=yokohama&pubname=yokohama-build-workflows&ft:locale=en-US).  
Hinweis:  
Sie können diese API nur innerhalb von verwenden Workflow-StudioUmgebung.

Für diese Klasse ist kein Konstruktor vorhanden. Stattdessen müssen Sie anrufen Build() Methode in [XMLStreamingBuilder](https://servicenow-prod.fluidtopics.net/VHteMVbFyyJLuUIe9cP~sQ#XMLStreamingBuilderScopedAPI "Erstellt ein Builder-Objekt, um eine große XML-Nutzlast zu erstellen, die in einer REST- oder SOAP-Anforderung verwendet werden kann, um Massendaten an eine Drittanbieter-API zu senden. Sie können die Nutzlast auch als XML-Zeichenfolge für eine nicht-Streaming-Option erstellen.")Klasse, um ein XMLStreamingAPI-Objekt zurückzugeben.

## API-Aufrufreihenfolge {#XMLStreamingAPIScopedAPI__section_wk4_5bm_jlb}

Generieren Sie XML-Nutzlasten, indem Sie zuerst ein Generatorobjekt mit instanziieren XMLStreamingBuilder Und ruft dann die Methoden in auf XMLStreamingAPI Klasse:  

1. XMLStreamingBuilder : Erstellt ein Generatorobjekt
:   Verwenden Sie diese Methode in der folgenden Reihenfolge, um ein Generatorobjekt zu erstellen:  
    1. XMLStreamingBuilder() : Instanziiert das XMLStreamingBuilder-Objekt.
    2. MitAnhang() : Optional. Erstellt ein XML-Dokument als Anhang und speichert es in der Tabelle „Streaming-Anhänge" \[Streaming_attachment\]. Wenn Sie diese Methode nicht aufrufen, erstellt die API die Nutzlast als XML-Zeichenfolge.
    3. AblaufAt() : Optional. Legt einen Zeitpunkt fest, zu dem der Anhang abläuft. „Falsch" ist der Standard. Muss auch anrufen MitAnhang() Methode.
    4. Build() : Gibt ein XMLStreamingAPI-Objekt zurück.
    {#XMLStreamingAPIScopedAPI__ol_gvr_k2k_jlb}

2. XMLStreamingAPI : Erstellt die XML-Nutzlast
:   Verwenden Sie diese Methoden in der folgenden Reihenfolge, um die XML-Nutzlast zu erstellen:  
    1. StartDocument() : Erstellt das übergeordnete Element der obersten Ebene im XML-Dokument.
    2. Methoden zum Generieren untergeordneter Elemente im XML-Dokument, z. B. WriteTextElement() , StartElement() , Und WriteArray() .
    3. Methoden zum Generieren von Attributen für ein Element, z. B. WriteAttribute() , WriteNamespace() , Und WriteDtd() .
    4. Endelement() : Schließt ein XML-Element.
    5. EndDokument : Schließt das übergeordnete Element der obersten Ebene.
    6. GetXMLZeichenfolge() Oder GetAttachmentId() : Gibt die von Ihnen erstellte XML-Zeichenfolge oder Anhang-ID zurück.
    7. Schließen() : Schließt das XMLStreamingAPI-Objekt.
    {#XMLStreamingAPIScopedAPI__ol_hvr_k2k_jlb}

## Größenbeschränkungen {#XMLStreamingAPIScopedAPI__section_qkj_sd5_hlb}

Über diese API generierte Nutzlasten dürfen diese Größenbeschränkungen nicht überschreiten:  
* Anhänge: 200 MB
* Zeichenfolgen: 5 MB
{#XMLStreamingAPIScopedAPI__ul_syy_lsw_3lb}  
Das folgende Beispiel zeigt, wie ein XML-Dokument erstellt und in der Tabelle „Streaming-Anhänge" \[Streaming_attachment\] mit einem definierten Ablaufdatum gespeichert wird.  


    try {
      var ttl = new GlideDateTime("2011-01-01 12:00:00");
      var builder = new sn_ih.XMLStreamingBuilder()
        .withAttachment() // Creates the XML document in streaming mode within an attachment.
        .expiresAt(ttl) // Sets an expiration date for the attachment.
        .build(); // Creates the XMLStreamingAPI object.

      builder.startDocument("Employee") // Begins generating the XML document.
        .writeTextElement("firstName","John") // Writes a "firstName" element and value.
        .writeTextElement("lastName","Smith")
        .writeTextElement("age","25")
        .startElement("address") // Adds an "address" parent element.
          .writeTextElement("streetAddress", "21 2nd Street") // Writes a child element and value.
          .writeTextElement("city", "Santa Clara")
          .writeTextElement("state", "CA")
          .writeTextElement("postalCode", "11111")
        .endElement() // Adds a closing tag for the "address" element.
        .startElement("phoneNumber")
          .writeTextElement("type","home")
          .writeTextElement("number","212 555-1234")
          .writeTextElement("type","fax")
          .writeTextElement("number","646 555-4567")
        .endElement()
      .endDocument() // Stops generating the XML document.
          
      gs.log(builder.getAttachmentId()); // Returns the sys_id of the attachment.
    } catch (err) {
      gs.log(err);
    } finally {
      builder.close();
    }

Alternativ zeigt dieses Beispiel, wie die API im Skriptschritt verwendet und die Nutzlast als XML-Zeichenfolge erstellt wird. Sie können diese Option verwenden, um Nutzlasten unter zu erstellen 5 MB .  

    (function execute(inputs, outputs) {

      var builder = new sn_ih.XMLStreamingBuilder().build();
      
      builder.startDocument("Employee")
        .enablePrettyPrint()
        .writeTextElement("firstName","John")
        .writeTextElement("lastName","Smith")
        .writeTextElement("age","25")
        .startElement("address")
          .writeTextElement("streetAddress", "21 2nd Street")
          .writeTextElement("city", "Santa Clara")
          .writeTextElement("state", "CA")
          .writeTextElement("postalCode", "11111")
        .endElement()
        .startElement("phoneNumber")
          .writeTextElement("type","home")
          .writeTextElement("number","212 555-1234")
          .writeTextElement("type","fax")
          .writeTextElement("number","646 555-4567")
        .endElement()
      .endDocument()

      outputs.payload = builder.getXMLString();
      
    })(inputs, outputs);

Ausgabe:  

    <?xml version="1.0" encoding="UTF-8"?>
    <firstName>John</firstName>
    <lastName>Smith</lastName>
    <age>25</age>
    <address>
      <streetAddress>21 2nd Street</streetAddress>
      <city>Santa Clara</city>
      <state>CA</state>
      <postalCode>11111</postalCode>
    </address>
    <phoneNumber>
      <type>home</type>
      <number>212 555-1234</number>
      <type>fax</type>
      <number>646 555-4567</number>
    </phoneNumber>

## XMLStreamingAPI -- close() {#ariaid-title2}

Schließt das XMLStreamingAPI-Objekt. Sie müssen diese Methode aufrufen, um den Stream nach der Erstellung Ihres XML-Dokuments zu schließen.
{#XSA-close__table_pnn_31t_jlb__entry__3}

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

{#XSA-close__table_pnn_31t_jlb} {#XSA-close__table_qnn_31t_jlb__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 2. Rückgaben]

{#XSA-close__table_qnn_31t_jlb}

### Beispiel

Das folgende Beispiel zeigt, wie ein XML-Dokument erstellt und in der Tabelle „Streaming-Anhänge" \[Streaming_attachment\] mit einem definierten Ablaufdatum gespeichert wird.


    try {
      var ttl = new GlideDateTime("2011-01-01 12:00:00");
      var builder = new sn_ih.XMLStreamingBuilder()
        .withAttachment() // Creates the XML document in streaming mode within an attachment.
        .expiresAt(ttl) // Sets an expiration date for the attachment.
        .build(); // Creates the XMLStreamingAPI object.

      builder.startDocument("Employee") // Begins generating the XML document.
        .writeTextElement("firstName","John") // Writes a "firstName" element and value.
        .writeTextElement("lastName","Smith")
        .writeTextElement("age","25")
        .startElement("address") // Adds an "address" parent element.
          .writeTextElement("streetAddress", "21 2nd Street") // Writes a child element and value.
          .writeTextElement("city", "Santa Clara")
          .writeTextElement("state", "CA")
          .writeTextElement("postalCode", "11111")
        .endElement() // Adds a closing tag for the "address" element.
        .startElement("phoneNumber")
          .writeTextElement("type","home")
          .writeTextElement("number","212 555-1234")
          .writeTextElement("type","fax")
          .writeTextElement("number","646 555-4567")
        .endElement()
      .endDocument() // Stops generating the XML document.
          
      gs.log(builder.getAttachmentId()); // Returns the sys_id of the attachment.
    } catch (err) {
      gs.log(err);
    } finally {
      builder.close();
    }

## XMLStreamingAPI -- disablePrettyPrint() {#ariaid-title3}

Beendet die XML-Formatierung für den hübschen Druck.
Bevor Sie diese Methode aufrufen, müssen Sie zuerst anrufen EnablePrettyPrint() Zum Hinzufügen einer XML-Formatierung zu einem Abschnitt.
{#XSA-disablePrettyPrint__table_exb_gct_jlb__entry__3}

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

{#XSA-disablePrettyPrint__table_exb_gct_jlb} {#XSA-disablePrettyPrint__table_fxb_gct_jlb__entry__2}

| Typ | Beschreibung |
|-|-|
| XMLStreamingAPI | Streaming-XML-Objekt zum Erstellen der Nutzlast. |
[Tabelle : 4. Rückgaben]

{#XSA-disablePrettyPrint__table_fxb_gct_jlb}  
Das folgende Beispiel zeigt, wie Sie dem eine hübsche Druckformatierung hinzufügen `Adresse `Element.

    try {
      var ttl = new GlideDateTime("2011-01-01 12:00:00");
      var builder = new sn_ih.XMLStreamingBuilder()
        .withAttachment()
        .expiresAt(ttl)
        .build();

      builder.startDocument("Employee")
        .writeTextElement("firstName","John")
        .writeTextElement("lastName","Smith")
        .writeTextElement("age","25")
        .enablePrettyPrint()
        .startElement("address")
          .writeTextElement("streetAddress", "21 2nd Street")
          .writeTextElement("city", "Santa Clara")
          .writeTextElement("state", "CA")
          .writeTextElement("postalCode", "11111")
        .endElement()
        .disablePrettyPrint()
        .startElement("phoneNumber")
          .writeTextElement("type","home")
          .writeTextElement("number","212 555-1234")
          .writeTextElement("type","fax")
          .writeTextElement("number","646 555-4567")
        .endElement()
      .endDocument()
          
      gs.log(builder.getAttachmentId());
    } catch (err) {
      gs.log(err);
    } finally {
      builder.close();
    }

## XMLStreamingAPI -- enablePrettyPrint() {#ariaid-title4}

Fügt einem XML-Element oder einer Elementstruktur eine hübsche Druckformatierung hinzu.
Verwenden Sie DeaktivierenPrettyPrint() Methode zum Beenden der Formatierung.
{#XSA-enablePrettyPrint__table_b2k_2ct_jlb__entry__3}

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

{#XSA-enablePrettyPrint__table_b2k_2ct_jlb} {#XSA-enablePrettyPrint__table_c2k_2ct_jlb__entry__2}

| Typ | Beschreibung |
|-|-|
| XMLStreamingAPI | Streaming-XML-Objekt zum Erstellen der Nutzlast. |
[Tabelle : 6. Rückgaben]

{#XSA-enablePrettyPrint__table_c2k_2ct_jlb}  
Das folgende Beispiel zeigt, wie Sie dem eine hübsche Druckformatierung hinzufügen `Adresse `Element.

    try {
      var ttl = new GlideDateTime("2011-01-01 12:00:00");
      var builder = new sn_ih.XMLStreamingBuilder()
        .withAttachment()
        .expiresAt(ttl)
        .build();

      builder.startDocument("Employee")
        .writeTextElement("firstName","John")
        .writeTextElement("lastName","Smith")
        .writeTextElement("age","25")
        .enablePrettyPrint()
        .startElement("address")
          .writeTextElement("streetAddress", "21 2nd Street")
          .writeTextElement("city", "Santa Clara")
          .writeTextElement("state", "CA")
          .writeTextElement("postalCode", "11111")
        .endElement()
        .disablePrettyPrint()
        .startElement("phoneNumber")
          .writeTextElement("type","home")
          .writeTextElement("number","212 555-1234")
          .writeTextElement("type","fax")
          .writeTextElement("number","646 555-4567")
        .endElement()
      .endDocument()
          
      gs.log(builder.getAttachmentId());
    } catch (err) {
      gs.log(err);
    } finally {
      builder.close();
    }

## XMLStreamingAPI -- endDocument() {#ariaid-title5}

Beendet die Struktur Ihres XML-Dokuments.
Nach dem Aufruf von StartDocument() Methode und Organisation Ihres XML-Streaming-Dokuments, rufen Sie auf EndDocument() Methode am Ende der Struktur Ihres Dokuments. Sie müssen diese beiden Methoden gemeinsam verwenden, um die Struktur Ihres XML-Streaming-Dokuments erfolgreich zu erstellen.
{#XSA-endDocument__table_nvn_bnz_clb__entry__3}

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

{#XSA-endDocument__table_nvn_bnz_clb} {#XSA-endDocument__table_ovn_bnz_clb__entry__2}

| Typ | Beschreibung |
|-|-|
| XMLStreamingAPI | Streaming-XML-Objekt zum Erstellen der Nutzlast. |
[Tabelle : 8. Rückgaben]

{#XSA-endDocument__table_ovn_bnz_clb}  
Das folgende Beispiel zeigt, wie ein XML-Dokument erstellt wird, das Elemente zu einem Anwender enthält.

    try {
        var ttl = new GlideDateTime('2011-01-01 12:00:00');
        var builder = new sn_ih.XMLStreamingBuilder().withAttachment().expiresAt(ttl);
        var streamingDocument = builder.build();

        streamingDocument.startDocument('Employee')
            .writeTextElement('firstName', 'John')
            .writeTextElement('lastName', 'Smith')
            .writeTextElement('age', '25')
            .endDocument();
        gs.log(streamingDocument.getAttachmentId());
    } catch (err) {
        gs.log(err);
    } finally {
        streamingDocument.close();
    }

## XMLStreamingAPI -- endElement() {#ariaid-title6}

Fügt einem XML-Element ein schließendes Tag hinzu.
Verwenden Sie die folgenden Methoden in dieser Reihenfolge, um ein gültiges XML-Element zu erstellen:

1. Verwenden Sie StartElement() Methode zum Hinzufügen eines Start-Tags.
2. Verwenden Sie Endelement() Methode zum Hinzufügen des schließenden Tags.
{#XSA-endElement__ol_uwy_qb3_bmb}
{#XSA-endElement__table_cct_vkh_dlb__entry__3}

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

{#XSA-endElement__table_cct_vkh_dlb} {#XSA-endElement__table_dct_vkh_dlb__entry__2}

| Typ | Beschreibung |
|-|-|
| XMLStreamingAPI | Streaming-XML-Objekt zum Erstellen der Nutzlast. |
[Tabelle : 10. Rückgaben]

{#XSA-endElement__table_dct_vkh_dlb}  
Das folgende Beispiel zeigt, wie ein übergeordnetes Element mit dem Namen erstellt wird `Adresse `Und schreiben Sie dann vier untergeordnete Elemente.

    try {
      var ttl = new GlideDateTime("2011-01-01 12:00:00");
      var builder = new sn_ih.XMLStreamingBuilder()
        .withAttachment()
        .expiresAt(ttl)
        .build();

      builder.startDocument("Employee")
          .startElement("address")
          .writeTextElement("streetAddress", "21 2nd Street")
          .writeTextElement("city", "Santa Clara")
          .writeTextElement("state", "CA")
          .writeTextElement("postalCode", "11111")
        .endElement()
      .endDocument()
          
      gs.log(builder.getAttachmentId());
    } catch (err) {
      gs.log(err);
    } finally {
      builder.close();
    }

## XMLStreamingAPI -- getXMLString() {#ariaid-title7}

Gibt das XML-Dokument als Zeichenfolge zurück.
Um das XML-Dokument als Zeichenfolge zurückzugeben, rufen Sie nicht auf GetAttachementId() Methode in XMLStreamingBuilder Klasse. Weitere Informationen finden Sie unter [XMLStreamingBuilder: Bereichsbezogen](https://servicenow-prod.fluidtopics.net/VHteMVbFyyJLuUIe9cP~sQ#XMLStreamingBuilderScopedAPI "Erstellt ein Builder-Objekt, um eine große XML-Nutzlast zu erstellen, die in einer REST- oder SOAP-Anforderung verwendet werden kann, um Massendaten an eine Drittanbieter-API zu senden. Sie können die Nutzlast auch als XML-Zeichenfolge für eine nicht-Streaming-Option erstellen.").
{#XSA-getXMLString__table_rbj_kct_jlb__entry__3}

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

{#XSA-getXMLString__table_rbj_kct_jlb} {#XSA-getXMLString__table_sbj_kct_jlb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | XML-Dokument, das mit erstellt wurde XMLStreamingAPI Methoden als Zeichenfolge. |
[Tabelle : 12. Rückgaben]

{#XSA-getXMLString__table_sbj_kct_jlb}  
Das folgende Beispiel zeigt, wie ein XML-Dokument erstellt und dann als Zeichenfolge zurückgegeben wird.  

    (function execute(inputs, outputs) {

      var builder = new sn_ih.XMLStreamingBuilder().build();
      
      builder.startDocument("Employee")
        .enablePrettyPrint()
        .writeTextElement("firstName","John")
        .writeTextElement("lastName","Smith")
        .writeTextElement("age","25")
        .startElement("address")
          .writeTextElement("streetAddress", "21 2nd Street")
          .writeTextElement("city", "Santa Clara")
          .writeTextElement("state", "CA")
          .writeTextElement("postalCode", "11111")
        .endElement()
        .startElement("phoneNumber")
          .writeTextElement("type","home")
          .writeTextElement("number","212 555-1234")
          .writeTextElement("type","fax")
          .writeTextElement("number","646 555-4567")
        .endElement()
      .endDocument()

      outputs.payload = builder.getXMLString();
      
    })(inputs, outputs);

Ausgabe:  

    <?xml version="1.0" encoding="UTF-8"?>
    <firstName>John</firstName>
    <lastName>Smith</lastName>
    <age>25</age>
    <address>
      <streetAddress>21 2nd Street</streetAddress>
      <city>Santa Clara</city>
      <state>CA</state>
      <postalCode>11111</postalCode>
    </address>
    <phoneNumber>
      <type>home</type>
      <number>212 555-1234</number>
      <type>fax</type>
      <number>646 555-4567</number>
    </phoneNumber>

## XMLStreamingAPI -- startDocument(Zeichenfolge RootElement, Object namespaceDefinitionMap) {#ariaid-title8}

Beginnt mit der Erstellung eines XML-Dokuments.
Nach dem Aufruf von Build() Methode, rufen Sie auf StartDocument() Methode zum Starten der Organisation Ihres XML-Dokuments. Sie müssen auch anrufen EndDokument Methode am Ende der Struktur Ihres Dokuments.
{#XSA-startDocument_S_O__table_yyj_tqg_dlb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| RootElement | Zeichenfolge | Optional. Stammelement oder übergeordnetes Element der obersten Ebene für Ihr XML-Dokument. |
| NamespaceDefinitionMap | Objekt | Optional. Zuordnung von Schlüsseln und Werten für die Namespaces und die zugehörigen Werte in einer nachfolgenden Liste von Elementen. Zum Beispiel: { 'namespaceOne':'namespaceValue', 'namespaceTwo':'namespaceValue' } |
[Tabelle : 13. Parameter]

{#XSA-startDocument_S_O__table_yyj_tqg_dlb} {#XSA-startDocument_S_O__table_zyj_tqg_dlb__entry__2}

| Typ | Beschreibung |
|-|-|
| XMLStreamingAPI | Streaming-XML-Objekt zum Erstellen der Nutzlast. |
[Tabelle : 14. Rückgaben]

{#XSA-startDocument_S_O__table_zyj_tqg_dlb}  
Das folgende Beispiel zeigt, wie ein XML-Dokument erstellt wird, das Elemente mit Informationen zu einem Mitarbeiter enthält.

    try {
        var ttl = new GlideDateTime('2011-01-01 12:00:00');
        var builder = new sn_ih.XMLStreamingBuilder().withAttachment().expiresAt(ttl);
        var streamingDocument = builder.build();

        streamingDocument.startDocument('Employee')
            .writeTextElement('firstName', 'John')
            .writeTextElement('lastName', 'Smith')
            .writeTextElement('age', '25')
            .endDocument();
        gs.log(streamingDocument.getAttachmentId());
    } catch (err) {
        gs.log(err);
    } finally {
        streamingDocument.close();
    }

## XMLStreamingAPI -- startElement (Zeichenfolgenname, ObjektnamespaceMap, ObjektattributeMap, Zeichenfolgenpräfix) {#ariaid-title9}

Fügt ein Start-Tag für ein XML-Element hinzu.
Verwenden Sie die folgenden Methoden in dieser Reihenfolge, um ein gültiges XML-Element zu erstellen:

1. Verwenden Sie StartElement() Methode zum Hinzufügen eines Start-Tags.
2. Verwenden Sie Endelement() Methode zum Hinzufügen des schließenden Tags.
{#XSA-startElement_S_O_O_S__ol_uwy_qb3_bmb}
{#XSA-startElement_S_O_O_S__table_d1l_cjh_dlb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| name | Zeichenfolge | Name des XML-Elements. |
| NamespaceMap | Objekt | Optional. Zuordnung von Schlüsseln und Werten für die Namespaces und die zugehörigen Werte in einer nachfolgenden Liste von Elementen. Zum Beispiel: { 'namespaceOne':'namespaceValue', 'namespaceTwo':'namespaceValue' } |
| AttributeMap | Objekt | Optional. Zuordnung von Schlüsseln und Werten für die Attribute und die zugehörigen Werte in einer nachfolgenden Liste von Elementen. |
| Präfix | Zeichenfolge | Optional. Präfix für das XML-Element. |
[Tabelle : 15. Parameter]

{#XSA-startElement_S_O_O_S__table_d1l_cjh_dlb} {#XSA-startElement_S_O_O_S__table_e1l_cjh_dlb__entry__2}

| Typ | Beschreibung |
|-|-|
| XMLStreamingAPI | Streaming-XML-Objekt zum Erstellen der Nutzlast. |
[Tabelle : 16. Rückgaben]

{#XSA-startElement_S_O_O_S__table_e1l_cjh_dlb}  
Das folgende Beispiel zeigt, wie ein übergeordnetes Element mit dem Namen erstellt wird Adresse Und schreiben Sie dann vier untergeordnete Elemente.

    try {
      var ttl = new GlideDateTime("2011-01-01 12:00:00");
      var builder = new sn_ih.XMLStreamingBuilder()
        .withAttachment()
        .expiresAt(ttl)
        .build();

      builder.startDocument("Employee")
          .startElement("address")
          .writeTextElement("streetAddress", "21 2nd Street")
          .writeTextElement("city", "Santa Clara")
          .writeTextElement("state", "CA")
          .writeTextElement("postalCode", "11111")
        .endElement()
      .endDocument()
          
      gs.log(builder.getAttachmentId());
    } catch (err) {
      gs.log(err);
    } finally {
      builder.close();
    }

## XMLStreamingAPI -- writeArray(String elementName, Array-Daten, String wrappingElement) {#ariaid-title10}

Fügt Ihrem XML-Streaming-Dokument eine Liste geschachtelter Elemente mit vordefiniertem Text hinzu.
Nach dem Aufruf von StartDocument() Methode, können Sie aufrufen WriteArray() Methode zum Hinzufügen eines Blocks geschachtelter Elemente zu Ihrem XML-Streaming-Dokument.
{#XSA-writeArray_S_O_O__table_fgt_jbt_jlb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Elementname | Zeichenfolge | Name des XML-Elements, das jeder Zeichenfolge zugeordnet ist, die in aufgeführt ist dataArray. |
| Daten | Array | Liste der Werte, die jedem darin geschachtelten Element zugewiesen werden sollen wrappingElement. |
| WrappingElement | Zeichenfolge | Übergeordnetes Element, das jedes enthält elementName. |
[Tabelle : 17. Parameter]

{#XSA-writeArray_S_O_O__table_fgt_jbt_jlb} {#XSA-writeArray_S_O_O__table_ggt_jbt_jlb__entry__2}

| Typ | Beschreibung |
|-|-|
| XMLStreamingAPI | Streaming-XML-Objekt zum Erstellen der Nutzlast. |
[Tabelle : 18. Rückgaben]

{#XSA-writeArray_S_O_O__table_ggt_jbt_jlb}  
Das folgende Beispiel zeigt, wie ein übergeordnetes Element mit dem Namen erstellt wird `Bürostandorte `, Und verschachteln Sie dann ein Array von fünf `Stadt `Elemente.

    try {
      var ttl = new GlideDateTime("2011-01-01 12:00:00");
      var builder = new sn_ih.XMLStreamingBuilder()
        .withAttachment()
        .expiresAt(ttl)
        .build();

      builder.startDocument("Employee")
          .writeArray('city', ['Santa Clara','San Diego','Chicago','Sydney','London'], 'officeLocations')
      .endDocument()
          
      gs.log(builder.getAttachmentId());
    } catch (err) {
      gs.log(err);
    } finally {
      builder.close();
    }

## XMLStreamingAPI -- writeAttribute (Zeichenfolgenname, Zeichenfolgenwert) {#ariaid-title11}

Fügt einem Element in Ihrem XML-Dokument ein Attribut hinzu.
Nach dem Aufruf von StartDocument() , StartElement() , Oder WriteTextElement() Methode, können Sie aufrufen WriteAttribute() Methode zum Hinzufügen eines Attributs zum zugeordneten XML-Element.
{#XSA-writeAttribute_S_S__table_gwq_2bt_jlb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| name | Zeichenfolge | Name des Attributs des XML-Elements. |
| Wert | Zeichenfolge | Wert für das Attribut des XML-Elements. |
[Tabelle : 19. Parameter]

{#XSA-writeAttribute_S_S__table_gwq_2bt_jlb} {#XSA-writeAttribute_S_S__table_hwq_2bt_jlb__entry__2}

| Typ | Beschreibung |
|-|-|
| XMLStreamingAPI | Streaming-XML-Objekt zum Erstellen der Nutzlast. |
[Tabelle : 20. Rückgaben]

{#XSA-writeAttribute_S_S__table_hwq_2bt_jlb}  
In diesem Beispiel wird ein Attribut mit dem Namen hinzugefügt ID-Nummer An Mitarbeiter Element.

    try {
        var ttl = new GlideDateTime('2011-01-01 12:00:00');
        var builder = new sn_ih.XMLStreamingBuilder().withAttachment().expiresAt(ttl);
        var streamingDocument = builder.build();

        streamingDocument.startDocument('Employee')
        .writeAttribute('idNumber','12345')
            .writeTextElement('firstName', 'John')
            .writeTextElement('lastName', 'Smith')
            .writeTextElement('age', '25')
        .endDocument();
        gs.log(streamingDocument.getAttachmentId());
    } catch (err) {
        gs.log(err);
    } finally {
        streamingDocument.close();
    }

## XMLStreamingAPI -- writeAttributes(Object attributeMap) {#ariaid-title12}

Fügt einem Element in Ihrem XML-Dokument Attribute hinzu.
Nach dem Aufruf von StartDocument() , StartElement() , Oder WriteTextElement() Methode, können Sie aufrufen WriteAttributes() Methode zum Hinzufügen von Attributen zum zugeordneten XML-Element.
{#XSA-writeAttributes_O__table_nzt_gbt_jlb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| AttributeMap | Objekt | Zuordnung von Schlüsseln und Werten mit Attributnamen und -Werten, die dem XML-Element zugeordnet werden sollen. Zum Beispiel: { 'attributeOne':'attributeValue', 'attributeTwo':'attributeValue' } |
[Tabelle : 21. Parameter]

{#XSA-writeAttributes_O__table_nzt_gbt_jlb} {#XSA-writeAttributes_O__table_ozt_gbt_jlb__entry__2}

| Typ | Beschreibung |
|-|-|
| XMLStreamingAPI | Streaming-XML-Objekt zum Erstellen der Nutzlast. |
[Tabelle : 22. Rückgaben]

{#XSA-writeAttributes_O__table_ozt_gbt_jlb}  
In diesem Beispiel werden Attribute mit dem Namen hinzugefügt ID-Nummer , Bürostandort , Und Abteilung An Mitarbeiter Element.

    try {
        var ttl = new GlideDateTime('2011-01-01 12:00:00');
        var builder = new sn_ih.XMLStreamingBuilder().withAttachment().expiresAt(ttl);
        var streamingDocument = builder.build();

        streamingDocument.startDocument('Employee')
        .writeAttributes({'idNumber':'12345', 'officeLocation':'San Diego', 'department':'Sales'})
            .writeTextElement('firstName', 'John')
            .writeTextElement('lastName', 'Smith')
            .writeTextElement('age', '25')
        .endDocument();
        gs.log(streamingDocument.getAttachmentId());
    } catch (err) {
        gs.log(err);
    } finally {
        streamingDocument.close();
    }

## XMLStreamingAPI -- writeCData (Zeichenfolgendaten) {#ariaid-title13}

Fügt Ihrem XML-Dokument CDATA hinzu.
Nach dem Aufruf von WriteCDataElement() Methode, können Sie aufrufen WriteCData() Methode zum Hinzufügen von CDATA innerhalb des Elements.
{#XSA-writeCData_S__table_ncx_qbt_jlb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Daten | Zeichenfolge | Wert, der nach dem CDATA-Stichwort in Ihr CDATA-Element aufgenommen werden soll. |
[Tabelle : 23. Parameter]

{#XSA-writeCData_S__table_ncx_qbt_jlb} {#XSA-writeCData_S__table_ocx_qbt_jlb__entry__2}

| Typ | Beschreibung |
|-|-|
| XMLStreamingAPI | Streaming-XML-Objekt zum Erstellen der Nutzlast. |
[Tabelle : 24. Rückgaben]

{#XSA-writeCData_S__table_ocx_qbt_jlb}  
Dieses Beispiel fügt dem CDATA-Element CDATA hinzu `Zeit gearbeitet `.

    try {
        var ttl = new GlideDateTime('2011-01-01 12:00:00');
        var builder = new sn_ih.XMLStreamingBuilder().withAttachment().expiresAt(ttl);
        var streamingDocument = builder.build();

        streamingDocument.startDocument('Employee')
            .writeTextElement('firstName', 'John')
            .writeTextElement('lastName', 'Smith')
            .writeTextElement('age', '25')
            .writeCDataElement('timeWorked')
            .writeCData('< 2 years')
        .endDocument();
        gs.log(streamingDocument.getAttachmentId());
    } catch (err) {
        gs.log(err);
    } finally {
        streamingDocument.close();
    }

## XMLStreamingAPI -- writeCDataElement (Zeichenfolgenname, Zeichenfolgendaten, Objektpräfix) {#ariaid-title14}

Fügt Ihrem XML-Dokument ein CDATA-Element hinzu.
Nach dem Aufruf von StartDocument() Methode, können Sie aufrufen WriteCDataElement() Methode zum Hinzufügen eines CDATA-Elements zu Ihrem XML-Dokument.
{#XSA-writeCDataElement_S_S_O__table_z31_tbt_jlb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| name | Zeichenfolge | Name des CDATA-Elements. |
| Daten | Zeichenfolge | Optional. Typ der Daten, als die das CDATA-Element analysiert werden soll. |
| Präfix | Objekt | Optional. Zuordnung der untergeordneten Elemente und Werte, die das CDATA-Element enthält. Zum Beispiel: { 'prefixOne':'prefixValue', 'prefixTwo':'prefixValue' } Sie müssen das Präfix eines XML-Elements mit einem Namespace zuordnen [WriteNamespace()](https://servicenow-prod.fluidtopics.net/nmEzfHo0hcTpfrP1Ug07UQ#XMLStreamingAPIScopedAPI "Erstellt eine große XML-Streaming-Nutzlast zur Verwendung in einer REST- oder SOAP-Anforderung, um Massendaten an eine Drittanbieter-API zu senden. Sie können die Nutzlast auch als XML-Zeichenfolge für eine nicht-Streaming-Option erstellen."). |
[Tabelle : 25. Parameter]

{#XSA-writeCDataElement_S_S_O__table_z31_tbt_jlb} {#XSA-writeCDataElement_S_S_O__table_aj1_tbt_jlb__entry__2}

| Typ | Beschreibung |
|-|-|
| XMLStreamingAPI | Streaming-XML-Objekt zum Erstellen der Nutzlast. |
[Tabelle : 26. Rückgaben]

{#XSA-writeCDataElement_S_S_O__table_aj1_tbt_jlb}  
In diesem Beispiel wird eine Dokumenttypdefinition mit dem Namen verwendet `Adresse ` Zum Definieren einer internen Dokumenttypdefinition für das XML-Dokument.

    try {
      var ttl = new GlideDateTime("2011-01-01 12:00:00");
      var builder = new sn_ih.XMLStreamingBuilder()
        .withAttachment()
        .expiresAt(ttl)
        .build();

      builder.startDocument("Employee")
      .writeDtd('address')
      .writeCDataElement('home', '#PCDATA', {'streetAddress', 'city', 'state', 'postalCode'})
          .writeTextElement("streetAddress", "21 2nd Street")
          .writeTextElement("city", "Santa Clara")
          .writeTextElement("state", "CA")
          .writeTextElement("postalCode", "11111")
      .endDocument()
          
      gs.log(builder.getAttachmentId());
    } catch (err) {
      gs.log(err);
    } finally {
      builder.close();
    }

## XMLStreamingAPI -- writeCharacters (Zeichenfolgentext) {#ariaid-title15}

Fügt Ihrem XML-Dokument Text hinzu.
Verwenden Sie WriteCharacters() Methode zum Einfügen von Zeichenfolgendaten in einen Abschnitt in Ihrem XML-Dokument.
{#XSA-writeCharacters_S__table_gwv_nbt_jlb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| HTML | Zeichenfolge | Text, der einem Abschnitt Ihres XML-Dokuments hinzugefügt werden soll. |
[Tabelle : 27. Parameter]

{#XSA-writeCharacters_S__table_gwv_nbt_jlb} {#XSA-writeCharacters_S__table_hwv_nbt_jlb__entry__2}

| Typ | Beschreibung |
|-|-|
| XMLStreamingAPI | Streaming-XML-Objekt zum Erstellen der Nutzlast. |
[Tabelle : 28. Rückgaben]

{#XSA-writeCharacters_S__table_hwv_nbt_jlb}  
Das folgende Beispiel zeigt, wie Sie Textwerte zu Elementen in Ihrem XML-Dokument hinzufügen.

    try {
        var ttl = new GlideDateTime('2011-01-01 12:00:00');
        var builder = new sn_ih.XMLStreamingBuilder().withAttachment().expiresAt(ttl);
        var streamingDocument = builder.build();

        streamingDocument.startDocument('Employee')
            .startElement('firstName')
            .writeCharacters('John')
            .EndElement()
            .startElement('lastName')
            .writeCharacters('Smith')
            .endElement()
        .endDocument();
        gs.log(streamingDocument.getAttachmentId());
    } catch (err) {
        gs.log(err);
    } finally {
        streamingDocument.close();
    }

## XMLStreamingAPI -- writeComment(Zeichenfolgenkommentar) {#ariaid-title16}

Fügt Ihrem XML-Dokument einen Kommentar hinzu.
Nach dem Aufruf von StartDocument() Methode, können Sie aufrufen SchreibenComment() Methode zum Hinzufügen eines Kommentars zu Ihrem XML-Dokument.
{#XSA-writeComment_S__table_i2x_vbt_jlb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Anmerkung | Zeichenfolge | Einzubeziehender Kommentartext. |
[Tabelle : 29. Parameter]

{#XSA-writeComment_S__table_i2x_vbt_jlb} {#XSA-writeComment_S__table_j2x_vbt_jlb__entry__2}

| Typ | Beschreibung |
|-|-|
| XMLStreamingAPI | Streaming-XML-Objekt zum Erstellen der Nutzlast. |
[Tabelle : 30. Rückgaben]

{#XSA-writeComment_S__table_j2x_vbt_jlb}  
Das folgende Beispiel zeigt, wie einem XML-Dokument ein Kommentar hinzugefügt wird.

    try {
        var ttl = new GlideDateTime('2011-01-01 12:00:00');
        var builder = new sn_ih.XMLStreamingBuilder().withAttachment().expiresAt(ttl);
        var streamingDocument = builder.build();

        streamingDocument.startDocument('Employee')
            .writeComment('Element for information related to active employees.')
            .writeTextElement('firstName', 'John')
            .writeTextElement('lastName', 'Smith')
            .writeTextElement('age', '25')
        .endDocument();
        gs.log(streamingDocument.getAttachmentId());
    } catch (err) {
        gs.log(err);
    } finally {
        streamingDocument.close();
    }

## XMLStreamingAPI -- writeDtd(Zeichenfolge dtd) {#ariaid-title17}

Fügt Ihrem XML-Dokument eine Dokumenttypdefinition hinzu.
Nach dem Aufruf von StartDocument() Methode, können Sie aufrufen WriteDtd() Methode zum Hinzufügen einer gültigen XML-Dokumenttypdefinition zu Ihrem XML-Dokument.
{#XSA-writeDtd_S__table_iyt_xbt_jlb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| dtd | Zeichenfolge | Name einer gültigen XML-Dokumenttypdefinition. |
[Tabelle : 31. Parameter]

{#XSA-writeDtd_S__table_iyt_xbt_jlb} {#XSA-writeDtd_S__table_jyt_xbt_jlb__entry__2}

| Typ | Beschreibung |
|-|-|
| XMLStreamingAPI | Streaming-XML-Objekt zum Erstellen der Nutzlast. |
[Tabelle : 32. Rückgaben]

{#XSA-writeDtd_S__table_jyt_xbt_jlb}  
In diesem Beispiel wird eine Dokumenttypdefinition mit dem Namen verwendet Adresse Zum Definieren einer internen Dokumenttypdefinition für das XML-Dokument.

    try {
      var ttl = new GlideDateTime("2011-01-01 12:00:00");
      var builder = new sn_ih.XMLStreamingBuilder()
        .withAttachment()
        .expiresAt(ttl)
        .build();

      builder.startDocument("Employee")
      .writeDtd('address')
      .writeCDataElement('home', '#PCDATA', {'streetAddress', 'city', 'state', 'postalCode'})
          .writeTextElement("streetAddress", "21 2nd Street")
          .writeTextElement("city", "Santa Clara")
          .writeTextElement("state", "CA")
          .writeTextElement("postalCode", "11111")
      .endDocument()
          
      gs.log(builder.getAttachmentId());
    } catch (err) {
      gs.log(err);
    } finally {
      builder.close();
    }

## XMLStreamingAPI -- writeNamespace (Zeichenfolgenpräfix, ZeichenfolgennamespaceURI) {#ariaid-title18}

Fügt einem Element in Ihrem XML-Dokument einen Namespace hinzu.
Nach dem Aufruf von StartDocument() , StartElement() , Oder WriteTextElement() Methode, können Sie aufrufen WriteNamespace() Methode zum Hinzufügen eines Namespace zum zugeordneten XML-Element.
{#XSA-writeNamespace_S_S__table_edp_qzs_jlb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Präfix | Zeichenfolge | Präfix für den XML-Namespace. |
| NamespaceURI | Zeichenfolge | Optional. URI für den Namespace. |
[Tabelle : 33. Parameter]

{#XSA-writeNamespace_S_S__table_edp_qzs_jlb} {#XSA-writeNamespace_S_S__table_fdp_qzs_jlb__entry__2}

| Typ | Beschreibung |
|-|-|
| XMLStreamingAPI | Streaming-XML-Objekt zum Erstellen der Nutzlast. |
[Tabelle : 34. Rückgaben]

{#XSA-writeNamespace_S_S__table_fdp_qzs_jlb}  
Das folgende Beispiel zeigt, wie ein Namespace und eine URI zu hinzugefügt werden `Unternehmen `Stammelement und weisen Sie dann das Präfix dem geschachtelten zu `Unternehmensname `Element.

    try {
        var ttl = new GlideDateTime('2011-01-01 12:00:00');
        var builder = new sn_ih.XMLStreamingBuilder().withAttachment().expiresAt(ttl);
        var streamingDocument = builder.build();

        streamingDocument.startDocument('company')
        .writeNamespace('x','https://www.servicenow.com')
            .writeTextElement('companyName', 'ServiceNow')
            .writeNamespace('x')
        .endDocument();
        gs.log(streamingDocument.getAttachmentId());
    } catch (err) {
        gs.log(err);
    } finally {
        streamingDocument.close();
    }

## XMLStreamingAPI -- writeNamespaces(Object namespaceMap) {#ariaid-title19}

Fügt dem Stamm Namespaces hinzu Element in Ihr XML-Dokument.
Nach dem Aufruf von StartDocument() Oder StartElement() Methode, können Sie aufrufen WriteNamespaces() Methode zum Deklardieren von Namespaces für das zugeordnete XML-Element.
{#XSA-writeNamespaces_O__table_z4l_21t_jlb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| NamespaceMap | Objekt | Zuordnung von Schlüsseln und Werten mit Namespace-Präfixen und URIs, die dem Stammelement von zugeordnet werden sollen XML Dokument. Zum Beispiel: { 'namespaceOne':'namespaceValue', 'namespaceTwo':'namespaceValue' } |
[Tabelle : 35. Parameter]

{#XSA-writeNamespaces_O__table_z4l_21t_jlb} {#XSA-writeNamespaces_O__table_apl_21t_jlb__entry__2}

| Typ | Beschreibung |
|-|-|
| XMLStreamingAPI | Streaming-XML-Objekt zum Erstellen der Nutzlast. |
[Tabelle : 36. Rückgaben]

{#XSA-writeNamespaces_O__table_apl_21t_jlb}  
Dieses Beispiel fügt zwei Namespaces und URIs zu hinzu Unternehmen Stammelement und weist den geschachtelten Elementen dann die entsprechenden Präfixe zu.

    try {
        var ttl = new GlideDateTime('2011-01-01 12:00:00');
        var builder = new sn_ih.XMLStreamingBuilder().withAttachment().expiresAt(ttl);
        var streamingDocument = builder.build();

        streamingDocument.startDocument('company')
        .writeNamespaces({'x':'https://www.servicenow.com', 'y':'https://www.developer.servicenow.com'})
            .writeTextElement('companyName', 'ServiceNow')
            .writeNamespace('x')
            .writeTextElement('devFramework', 'UI Framework')
            .writeNamespace('y')
        .endDocument();
        gs.log(streamingDocument.getAttachmentId());
    } catch (err) {
        gs.log(err);
    } finally {
        streamingDocument.close();
    }

## XMLStreamingAPI -- writeTextElement (Zeichenfolgenname, Zeichenfolgentext, Objektpräfix) {#ariaid-title20}

Fügt Ihrem XML-Dokument ein einzelnes XML-Element hinzu.
Nach dem Aufruf von StartDocument() Methode, können Sie aufrufen WriteTextElement() Methode zum Hinzufügen eines einzelnen XML-Elements zur Struktur Ihres XML-Dokuments.
{#XSA-writeTextElement_S_S_O__table_ryd_zkh_dlb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| name | Zeichenfolge | Name des XML-Elements. |
| HTML | Zeichenfolge | Wert für das XML-Element. |
| Präfix | Objekt | Optional. Zuordnung von Präfixen und Werten, die dem XML-Element zugeordnet sind. Zum Beispiel: { 'prefixOne':'prefixValue', 'prefixTwo':'prefixValue' } Sie müssen das Präfix eines XML-Elements mit einem Namespace zuordnen [WriteNamespace()](https://servicenow-prod.fluidtopics.net/nmEzfHo0hcTpfrP1Ug07UQ#XMLStreamingAPIScopedAPI "Erstellt eine große XML-Streaming-Nutzlast zur Verwendung in einer REST- oder SOAP-Anforderung, um Massendaten an eine Drittanbieter-API zu senden. Sie können die Nutzlast auch als XML-Zeichenfolge für eine nicht-Streaming-Option erstellen."). |
[Tabelle : 37. Parameter]

{#XSA-writeTextElement_S_S_O__table_ryd_zkh_dlb} {#XSA-writeTextElement_S_S_O__table_syd_zkh_dlb__entry__2}

| Typ | Beschreibung |
|-|-|
| XMLStreamingAPI | Streaming-XML-Objekt zum Erstellen der Nutzlast. |
[Tabelle : 38. Rückgaben]

{#XSA-writeTextElement_S_S_O__table_syd_zkh_dlb}  
Das folgende Beispiel zeigt, wie ein XML-Dokument erstellt wird, das drei Elemente mit Informationen zu einem Mitarbeiter enthält.

    try {
        var ttl = new GlideDateTime('2011-01-01 12:00:00');
        var builder = new sn_ih.XMLStreamingBuilder().withAttachment().expiresAt(ttl);
        var streamingDocument = builder.build();

        streamingDocument.startDocument('Employee')
            .writeTextElement('firstName', 'John')
            .writeTextElement('lastName', 'Smith')
            .writeTextElement('age', '25')
        .endDocument();
        gs.log(streamingDocument.getAttachmentId());
    } catch (err) {
        gs.log(err);
    } finally {
        streamingDocument.close();
    }


