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


---

# ScriptableDataStream: Bereichsbezogen, global

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

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

Die SkriptableDataStream Die API bietet Methoden zur Interaktion mit einem Datenstrom.

Diese Klasse kann nur in einem serverseitigen Skript verwendet werden, nachdem ein ScriptableDataStream-Objekt mit einer der folgenden APIs abgerufen wurde:  
* Die ExecuteDataStreamAction() Methode in FlowAPI Klasse. Siehe [FlowAPI](https://servicenow-prod.fluidtopics.net/8pVh7NSX~YkxpEJpgYrYHg#ScriptableFlowAPI "Die FlowAPI Stellt Methoden zum Ausführen von Aktionen, Flows oder Subflows in serverseitigen Skripts mit blockierenden oder nicht blockierenden Methoden bereit.").
* Die GetDataStream() Methode in ScriptableFlowRunnerResult Klasse. Siehe [ScriptableFlowRunnerResult](https://servicenow-prod.fluidtopics.net/39D~NEQcQ3oHtlq5aVMVfg#ScriptableFlowRunnerResultScopedAPI "Erfasst das Ergebnis der Verwendung ScriptableFlowRunner Dient zum Ausführen eines Flows, Subflows oder einer Aktion. Enthält Daten wie die Kontext-ID, die Domäne und alle Ausgaben aus der Flow-Ausführung.").
{#ScriptableDataStreamAPI__ul_wnh_sfv_ylb}

Rufen Sie nach dem Abrufen eines ScriptableDataStream-Objekts die Methoden in dieser bestimmten Reihenfolge auf:  
1. Verwenden Sie [HasNext()](https://servicenow-prod.fluidtopics.net/MS5ltafpqwLfvkBMGxVwmg#ScriptableDS-hasNext "Gibt „wahr“ zurück, wenn der Datenstrom weitere Elemente enthält.")Methode, um zu bestimmen, ob der Datenstrom weitere Elemente enthält.
2. Verwenden Sie [Next()](https://servicenow-prod.fluidtopics.net/MS5ltafpqwLfvkBMGxVwmg#ScriptableDS-next "Gibt das nächste Element in einem Datenstrom zurück.")Methode für den Zugriff auf das nächste Element im Stream.
3. Verwenden Sie [GetItemIndex()](https://servicenow-prod.fluidtopics.net/MS5ltafpqwLfvkBMGxVwmg#ScriptableDS-getItemIndex "Gibt den aktuellen Index eines Elements in einem Datenstrom zurück."), [GetItemInPageIndex()](https://servicenow-prod.fluidtopics.net/MS5ltafpqwLfvkBMGxVwmg#ScriptableDS-getItemInPageIndex "Gibt den aktuellen Index eines Elements auf der aktuellen Seite in einem Datenstrom zurück."), Und [GetPageIndex()](https://servicenow-prod.fluidtopics.net/MS5ltafpqwLfvkBMGxVwmg#ScriptableDS-getPageIndex "Gibt den aktuellen Index einer Seite in einem Datenstrom zurück.")Methoden zum Abrufen von Informationen aus dem Stream.
4. Verwenden Sie [Schließen()](https://servicenow-prod.fluidtopics.net/MS5ltafpqwLfvkBMGxVwmg#ScriptableDS-close "Schließt die Verbindung zu einem Datenstrom. Rufen Sie diese Methode immer auf, nachdem Sie die gewünschten Vorgänge für einen Datenstrom ausgeführt haben.")Methode zum Schließen des Streams.
{#ScriptableDataStreamAPI__ol_k1k_yp1_3jb}

Diese Klasse wird ausgeführt in `sn_fd `Namespace.  
Hinweis:  
Datenstromlogik immer in umbrechen `Versuchen/fangen `Blockieren, um Fehler zu erfassen. Fügen Sie immer ein ein `Endlich `Anweisung, die mit endet Schließen() Methode aus SkriptableDataStream Klasse zum Schließen des Datenstroms und zur Vermeidung von Leistungsproblemen.

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

Schließt die Verbindung zu einem Datenstrom. Rufen Sie diese Methode immer auf, nachdem Sie die gewünschten Vorgänge für einen Datenstrom ausgeführt haben.
Sie können diese Methode nur für ein ScriptableDataStream-Objekt aufrufen, das von zurückgegeben wird ExecuteDataStreamAction() Methode in der FlowAPI-Klasse. Siehe [FlowAPI](https://servicenow-prod.fluidtopics.net/8pVh7NSX~YkxpEJpgYrYHg#ScriptableFlowAPI "Die FlowAPI Stellt Methoden zum Ausführen von Aktionen, Flows oder Subflows in serverseitigen Skripts mit blockierenden oder nicht blockierenden Methoden bereit.").
{#ScriptableDS-close__table_idv_glc_cjb__entry__3}

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

{#ScriptableDS-close__table_idv_glc_cjb} {#ScriptableDS-close__table_jdv_glc_cjb__entry__2}

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

{#ScriptableDS-close__table_jdv_glc_cjb}  

    (function() {
    	
    	try {
    ​
    		// Execute Data Stream Action. 
    		var stream = sn_fd.FlowAPI.executeDataStreamAction('x_snc_my_scope.data_stream_name');
    ​
    		// Process each item in the data stream
    		while (stream.hasNext()) {
    ​
    			// Get a single item from the data stream.
    			var user = stream.next();
    		
    			// Only log the first item in each page
    			if (stream.getItemInPageIndex() == 0) {
    				gs.info('first user on page is ' + user.name);
    			}
    		}		
    	} catch (ex) {
    		var message = ex.getMessage();
    		gs.error(message);
    	} finally {
    		stream.close();
    	}
    	
    })();

## ScriptableDataStream -- getItemIndex() {#ariaid-title3}

Gibt den aktuellen Index eines Elements in einem Datenstrom zurück.
Sie können diese Methode nur für ein ScriptableDataStream-Objekt aufrufen, das von zurückgegeben wird ExecuteDataStreamAction() Methode in der FlowAPI-Klasse. Siehe [FlowAPI](https://servicenow-prod.fluidtopics.net/8pVh7NSX~YkxpEJpgYrYHg#ScriptableFlowAPI "Die FlowAPI Stellt Methoden zum Ausführen von Aktionen, Flows oder Subflows in serverseitigen Skripts mit blockierenden oder nicht blockierenden Methoden bereit.").
{#ScriptableDS-getItemIndex__table_ic4_flc_cjb__entry__3}

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

{#ScriptableDS-getItemIndex__table_ic4_flc_cjb} {#ScriptableDS-getItemIndex__table_jc4_flc_cjb__entry__2}

| Typ | Beschreibung |
|-|-|
| Nummer | Aktueller Index eines Elements in einem Datenstrom mit Zero-basierter Indizierung. |
[Tabelle : 4. Rückgaben]

{#ScriptableDS-getItemIndex__table_jc4_flc_cjb}  

    (function() {
    	
    	try {

    		// Execute Data Stream Action. 
    		var stream = sn_fd.FlowAPI.executeDataStreamAction('x_my_scope.data_stream_name');

    		// Process each item in the data stream
    		while (stream.hasNext()) {

    			// Get a single item from the data stream.
    			var User = stream.next();

    			// Use the item. Example:
    			// var now_GR = new GlideRecord(<table_name>);
    			// now_GR.<field_name> = User.<field_name>;
    			// now_GR.insert();
    		
    			// By default, this code snippet will terminate after 10 items.
    			// Remove or modify this limit after your code has been tested.
    			if (stream.getItemIndex() >= 9) {
    				break;
    			}
    		}		
    	} catch (ex) {
    		var message = ex.getMessage();
    		gs.error(message);
    	} finally {
    		stream.close();
    	}
    	
    })();

## ScriptableDataStream -- getItemInPageIndex() {#ariaid-title4}

Gibt den aktuellen Index eines Elements auf der aktuellen Seite in einem Datenstrom zurück.
Sie können diese Methode nur für ein ScriptableDataStream-Objekt aufrufen, das von zurückgegeben wird ExecuteDataStreamAction() Methode in der FlowAPI-Klasse. Siehe [FlowAPI](https://servicenow-prod.fluidtopics.net/8pVh7NSX~YkxpEJpgYrYHg#ScriptableFlowAPI "Die FlowAPI Stellt Methoden zum Ausführen von Aktionen, Flows oder Subflows in serverseitigen Skripts mit blockierenden oder nicht blockierenden Methoden bereit.").
{#ScriptableDS-getItemInPageIndex__table_mg4_zkc_cjb__entry__3}

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

{#ScriptableDS-getItemInPageIndex__table_mg4_zkc_cjb} {#ScriptableDS-getItemInPageIndex__table_ng4_zkc_cjb__entry__2}

| Typ | Beschreibung |
|-|-|
| Nummer | Aktueller Index eines Elements auf der aktuellen Seite im Datenstrom mit Zero-basierter Indizierung. |
[Tabelle : 6. Rückgaben]

{#ScriptableDS-getItemInPageIndex__table_ng4_zkc_cjb}  

    (function() {
    	
    	try {
    ​
    		// Execute Data Stream Action. 
    		var stream = sn_fd.FlowAPI.executeDataStreamAction('x_snc_my_scope.data_stream_name');
    ​
    		// Process each item in the data stream
    		while (stream.hasNext()) {
    ​
    			// Get a single item from the data stream.
    			var user = stream.next();
    		
    			// Only log the first item in each page
    			if (stream.getItemInPageIndex() == 0) {
    				gs.info('first user on page is ' + user.name);
    			}
    		}		
    	} catch (ex) {
    		var message = ex.getMessage();
    		gs.error(message);
    	} finally {
    		stream.close();
    	}
    	
    })();

## ScriptableDataStream -- getPageIndex() {#ariaid-title5}

Gibt den aktuellen Index einer Seite in einem Datenstrom zurück.
Sie können diese Methode nur für ein ScriptableDataStream-Objekt aufrufen, das von zurückgegeben wird ExecuteDataStreamAction() Methode in der FlowAPI-Klasse. Siehe [FlowAPI](https://servicenow-prod.fluidtopics.net/8pVh7NSX~YkxpEJpgYrYHg#ScriptableFlowAPI "Die FlowAPI Stellt Methoden zum Ausführen von Aktionen, Flows oder Subflows in serverseitigen Skripts mit blockierenden oder nicht blockierenden Methoden bereit.").
{#ScriptableDS-getPageIndex__table_l3t_g43_bjb__entry__3}

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

{#ScriptableDS-getPageIndex__table_l3t_g43_bjb} {#ScriptableDS-getPageIndex__table_m3t_g43_bjb__entry__2}

| Typ | Beschreibung |
|-|-|
| Nummer | Aktueller Index einer Seite in einem Datenstrom mit Zero-basierter Indizierung. |
[Tabelle : 8. Rückgaben]

{#ScriptableDS-getPageIndex__table_m3t_g43_bjb}  

    (function() {
    	
    	try {

    		// Execute Data Stream Action. 
    		var stream = sn_fd.FlowAPI.executeDataStreamAction('x_my_scope.data_stream_name');

    		// Process each item in the data stream
    		while (stream.hasNext()) {

    			// Get a single item from the data stream.
    			var item = stream.next();

    			// Use the item. 
    			var now_GR = new GlideRecord('incident');
    			now_GR.setValue('number',item.id);
    			now_GR.setValue('short_description',item.name);
    			now_GR.insert();
    		
    			// By default, this code snippet will terminate after 5 pages.
    			// Remove or modify this limit after testing your code.
    			if (stream.getPageIndex() >= 4) {
    				break;
    			}
    		}		
    	} catch (ex) {
    		var message = ex.getMessage();
    		gs.error(message);
    	} finally {
    		stream.close();
    	}
    	
    })();

## ScriptableDataStream -- hasNext() {#ariaid-title6}

Gibt „wahr" zurück, wenn der Datenstrom weitere Elemente enthält.
Sie können diese Methode nur für ein ScriptableDataStream-Objekt aufrufen, das von zurückgegeben wird ExecuteDataStreamAction() Methode in der FlowAPI-Klasse. Siehe [FlowAPI](https://servicenow-prod.fluidtopics.net/8pVh7NSX~YkxpEJpgYrYHg#ScriptableFlowAPI "Die FlowAPI Stellt Methoden zum Ausführen von Aktionen, Flows oder Subflows in serverseitigen Skripts mit blockierenden oder nicht blockierenden Methoden bereit.").  
Hinweis:  
Standardmäßig wartet die Instanz 600 Sekunden, um eine einzelne Seite mit Daten von abzurufen MID-Server. Wenn beim Ausführen von eine Zeitüberschreitung auftritt DatenstromAktion über MID-Server, Ändern Sie diesen Standard, indem Sie erhöhen datastream_alternative_env_fetch_page_timeout_secondsSystemeigenschaft.
{#ScriptableDS-hasNext__table_fcx_d43_bjb__entry__3}

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

{#ScriptableDS-hasNext__table_fcx_d43_bjb} {#ScriptableDS-hasNext__table_gcx_d43_bjb__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die bestimmt, ob der Datenstrom weitere Elemente enthält. Werte: * Wahr: Im Datenstrom sind weitere Elemente zum Iterieren vorhanden. * Falsch: Der Datenstrom enthält keine weiteren Elemente. {#ScriptableDS-hasNext__ul_xy5_z4d_cjb} |
[Tabelle : 10. Rückgaben]

{#ScriptableDS-hasNext__table_gcx_d43_bjb}  
Dieses Beispiel erstellt einen Incident-Datensatz für jedes im Datenstrom zurückgegebene Element.

    (function() {
    	
    	try {

    		// Execute Data Stream Action. 
    		var stream = sn_fd.FlowAPI.executeDataStreamAction('x_my_scope.data_stream_name');

    		// Process each item in the data stream
    		while (stream.hasNext()) {

    			// Get a single item from the data stream.
    			var item = stream.next();

    			// Use the item. 
    			var now_GR = new GlideRecord('incident');
    			now_GR.setValue('number',item.id);
    			now_GR.setValue('short_description',item.name);
    			now_GR.insert();
    		
    			// By default, this code snippet will terminate after 10 items.
    			// Remove or modify this limit after testing your code.
    			if (stream.getItemIndex() >= 9) {
    				break;
    			}
    		}		
    	} catch (ex) {
    		var message = ex.getMessage();
    		gs.error(message);
    	} finally {
    		stream.close();
    	}
    	
    })();

## ScriptableDataStream -- next() {#ariaid-title7}

Gibt das nächste Element in einem Datenstrom zurück.
Sie können diese Methode nur für ein ScriptableDataStream-Objekt aufrufen, das von zurückgegeben wird ExecuteDataStreamAction() Methode in der FlowAPI-Klasse. Siehe [FlowAPI](https://servicenow-prod.fluidtopics.net/8pVh7NSX~YkxpEJpgYrYHg#ScriptableFlowAPI "Die FlowAPI Stellt Methoden zum Ausführen von Aktionen, Flows oder Subflows in serverseitigen Skripts mit blockierenden oder nicht blockierenden Methoden bereit.").  
Hinweis:  
Standardmäßig wartet die Instanz 600 Sekunden, um eine einzelne Seite mit Daten von abzurufen MID-Server. Wenn beim Ausführen von eine Zeitüberschreitung auftritt DatenstromAktion über MID-Server, Ändern Sie diesen Standard, indem Sie erhöhen datastream_alternative_env_fetch_page_timeout_secondsSystemeigenschaft.
{#ScriptableDS-next__table_lrc_f43_bjb__entry__3}

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

{#ScriptableDS-next__table_lrc_f43_bjb} {#ScriptableDS-next__table_mrc_f43_bjb__entry__2}

| Typ | Beschreibung |
|-|-|
| Objekt | Das nächste Element im Datenstrom. Dieses Objekt enthält die Ausgaben, die durch die Datenstromaktion definiert sind. Um die Ausgaben der Datenstromaktion anzuzeigen, navigieren Sie in der Flow Designer-Oberfläche zum Abschnitt „Ausgaben" der Datenstromaktion. |
[Tabelle : 12. Rückgaben]

{#ScriptableDS-next__table_mrc_f43_bjb}  
Dieses Beispiel erstellt einen Incident-Datensatz für jedes im Datenstrom zurückgegebene Element.

    (function() {
    	
    	try {

    		// Execute Data Stream Action. 
    		var stream = sn_fd.FlowAPI.executeDataStreamAction('x_my_scope.data_stream_name');

    		// Process each item in the data stream
    		while (stream.hasNext()) {

    			// Get a single item from the data stream.
    			var item = stream.next();

    			// Use the item. 
    			var now_GR = new GlideRecord('incident');
    			now_GR.setValue('number',item.id);
    			now_GR.setValue('short_description',item.name);
    			now_GR.insert();
    		
    			// By default, this code snippet will terminate after 10 items.
    			// Remove or modify this limit after testing your code.
    			if (stream.getItemIndex() >= 9) {
    				break;
    			}
    		}		
    	} catch (ex) {
    		var message = ex.getMessage();
    		gs.error(message);
    	} finally {
    		stream.close();
    	}
    	
    })();


