---
sourceDocument: Xanadu-API-Referenz
sourceDocumentLink: https://www.servicenow.com/docs/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


---

# RESTAPIResponseStream -- Bereichsbezogen, Global

# RESTAPIResponseStream -- Bereichsbezogen, Global {#ariaid-title1}

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

Die RESTAPIResponseStream- API stellt Methoden bereit, mit denen Sie direkt in den geskripteten REST-API-Antwortstream schreiben können.

Verwenden Sie die RESTAPIResponseStream- Methoden, um Webservice-APIs in der Funktion „Geskriptete [REST-API](https://www.servicenow.com/docs/pBEhxF058O25UNzlFTgtzA "Mit der geskripteten REST-API-Funktion können Anwendungsentwickler benutzerdefinierte Webservice-APIs erstellen.") " zu erstellen.

Diese API wird im Namespace `sn_ws ausgeführt`.  
Hinweis:  
Sie können Objekte dieses Typs nicht instanziieren. Objekte dieses Typs werden automatisch erstellt und sind nur in Skripts für geskriptete REST-API-Ressourcen verfügbar.

## RESTAPIResponseStream -- writeStream(Object stream) {#ariaid-title2}

Schreibt einen Eingabe-Stream in den Antwort-Stream.
Sie müssen den Content-Typ und den Statuscode vor dem Aufrufen der Methode writeStream() festlegen, oder die Antwort schlägt fehl. Sie können diese Werte nach dem Aufrufen der Methode writeStream() nicht ändern.  
Hinweis:  
Es liegt in der Verantwortung des Skriptautors, den Stream von einem Service eines Drittanbieters zu beziehen.
{#r_SSRSW-writeStream_O__table_c2x_wnb_sr__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| stream | Objekt | Ein Anhang oder ein Antwort-Stream von einem Drittanbieterservice. |
[Tabelle : 1. Parameter]

{#r_SSRSW-writeStream_O__table_c2x_wnb_sr} {#r_SSRSW-writeStream_O__table_d2x_wnb_sr__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 2. Ergebnisse]

{#r_SSRSW-writeStream_O__table_d2x_wnb_sr}  
Das folgende Beispiel gilt für bereichsbezogene Anwendungen:

    (function process(/*RESTAPIRequest*/ request, /*RESTAPIResponse*/ response) {

        response.setContentType('application/json');
        response.setStatus(200);

        var gsa = new GlideSysAttachment();
        var attachmentStream = new gsa.getContentStream(<sys_id of attachment>); 
        var writer = response.getStreamWriter();
        writer.writeStream(attachmentStream);

    })(request, response);

Das folgende Beispiel gilt für globale Anwendungen:

    (function process(/*RESTAPIRequest*/ request, /*RESTAPIResponse*/ response) {

        response.setContentType('application/json');
        response.setStatus(200);

        var attachmentStream = new GlideSysAttachmentInputStream(<sys_id of attachment>);
        var writer = response.getStreamWriter();
        writer.writeStream(attachmentStream);

    })(request, response);

## RESTAPIResponseStream -- writeString(String data) {#ariaid-title3}

Schreibt Zeichenfolgendaten in den Antwort-Stream.
Sie müssen den Content-Typ und den Statuscode vor dem Aufrufen der Methode writeString() festlegen, oder die Antwort schlägt fehl. Sie können diese Werte nach dem Aufrufen der Methode writeString() nicht ändern.
{#r_SSRSW-writeString_S__table_gck_rcr_qr__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| data | Zeichenfolge | Die Zeichenfolge, die den Antwortdaten hinzugefügt werden soll. |
[Tabelle : 3. Parameter]

{#r_SSRSW-writeString_S__table_gck_rcr_qr} {#r_SSRSW-writeString_S__table_hck_rcr_qr__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 4. Ergebnisse]

{#r_SSRSW-writeString_S__table_hck_rcr_qr}  

    response.setContentType('application/json');
    response.setStatus(200);
    var writer = response.getStreamWriter();
    var body ={
      name:user1,
      id: 1234,
      roles: [
        {
          name: admin
        },
        {
          name: itil
        }
      ]
    }
    writer.writeString("{'name':'user','id':'1234'}");
    writer.writeString(JSON.stringify(body));