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


---

# Subflow -- Umfang (Veraltet)

# Subflow -- Umfang (Veraltet) {#ariaid-title1}

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

Die Subflow API stellt Methoden zur Ausführung veröffentlicht bereit Workflow-StudioSubflows.

Diese API ist veraltet und wird durch ersetzt [FlowAPI: Bereichsbezogen, global](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 Subflow API kann nur in Serverskripts verwendet werden.

Verwenden Sie `sn_fd `Namespace für den Zugriff auf Subflow API.

Bevor mit einem Subflow mit interagiert wird Subflow API, müssen Sie zuerst den Subflow in erstellen und veröffentlichen Workflow-StudioSchnittstelle. Weil Subflow API interagiert nur mit vorgefertigten Subflows, es gibt keinen Konstruktor für die Klasse.  
Hinweis:  
Um die Instanzleistung zu optimieren, vermeiden Sie es, diese Methoden aus einem asynchronen Business-Regelskript aufzurufen. Erstellen Sie stattdessen einen Datensatz für eine geplante Aufgabe in Workflow-StudioUI.

## Subflow -- startAsync(Zeichenfolge scope Name.subflowName, Zuordnungseingaben) {#ariaid-title2}

Führt einen veröffentlichten Subflow asynchron aus.
Asynchrone Aufrufe blockieren nicht, sodass der Client anderen Code im Skript ausführen kann, ohne auf den Abschluss des Subflows warten zu müssen.
{#SubflowScoped-startAsync_S_O__table_slq_v1v_ncb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Scope-Name.subflowName | Zeichenfolge | Der Anwendungsbereich für den Subflow und der interne Name des auszuführenden Subflows. Wenn „scope Name" nicht enthalten ist, wird der Umfang des derzeit angemeldeten Anwenders verwendet. Rufen Sie den internen Namen des Subflows mit ab Interner Name Spalte auf Workflow-StudioZielseite. |
| inputs | Karte | Name-Wert-Paare, die Subflow-Eingaben definieren. Wenn ein Subflow obligatorische Eingaben enthält, müssen sie einbezogen werden. Verwenden Sie für Eingaben des Feldtyps „Referenz" oder „Dokument-ID" ein GlideRecord-Objekt als Wert. |
[Tabelle : 1. Parameter]

{#SubflowScoped-startAsync_S_O__table_slq_v1v_ncb} {#SubflowScoped-startAsync_S_O__table_tlq_v1v_ncb__entry__2}

| Typ | Beschreibung |
|-|-|
| Objekt | PlanResponse-Objekt mit den folgenden Eigenschaften: * ContextID: SYS_ID des Ausführungsdetails-Datensatzes für den ausgeführten Subflow. Greifen Sie auf die Ausführungsdetails zu, indem Sie zur Registerkarte „Flow-Ausführungen" in navigieren Workflow-StudioUnd wird nach sys_ID gefiltert {#SubflowScoped-startAsync_S_O__ul_bd2_k2v_ncb} Eine Ausnahme tritt auf, wenn der Subflow: * Ist innerhalb des angegebenen Anwendungsbereichs nicht vorhanden, oder der Subflow- oder Bereichsname wurde falsch geschrieben. * Ist nicht veröffentlicht. * Wird ein Eingabeobjekt übergeben, das nicht mit den Subflow-Eingaben übereinstimmt. * Überschreitet das von festgelegte Rekursionslimit com.glide.hub.flow_engine.indirect_recursion_limitSystemeigenschaft. Der Standardwert ist drei. {#SubflowScoped-startAsync_S_O__ul_ub3_n3t_pcb} |
[Tabelle : 2. Rückgaben]

{#SubflowScoped-startAsync_S_O__table_tlq_v1v_ncb}  

    //Run a subflow that takes two inputs: user, a sys_user record, and laptop_welcome_message, a string.
    (function startSubflowAsync() {

      try {
        var userToProvisionFor = new GlideRecord('sys_user');
        userToProvisionFor.get('62826bf03710200044e0bfc8bcbe5df1');

        var inputs = {};
        inputs['user'] = userToProvisionFor;
        inputs['laptop_welcome_message'] = 'Welcome Onboard!!';

        var result = sn_fd.Subflow.startAsync('sn_devstudio.provisionlaptop', inputs);

        //The Sys ID of a flow execution (contextId)
        var contextId = result.contextId;

      } catch (ex) {
        var message = ex.getMessage();
        gs.error(message);
      }

    })();


