Subflow – Umfang (Veraltet)

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 1 Minute Lesedauer
  • Die Subflow Die API stellt Methoden zur Ausführung veröffentlichter Methoden bereit Workflow-Studio Subflows.

    Diese API ist veraltet und wird durch ersetzt FlowAPI: Bereichsbezogen, Global.

    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-Studio Schnittstelle. Weil Subflow Die API interagiert nur mit vorgefertigten Subflows. Für die Klasse ist kein Konstruktor vorhanden.

    Hinweis:
    Um die Instanzleistung zu optimieren, sollten Sie vermeiden, diese Methoden aus einem asynchronen Business-Regel-Skript aufzurufen. Erstellen Sie stattdessen einen Datensatz für eine geplante Aufgabe in Workflow-Studio UI.

    Subflow – startAsync(Zeichenfolge scope Name.subflowName, Zuordnungseingaben)

    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.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    scopeName.subflowName Zeichenfolge Der Anwendungsbereich für den Subflow und der interne Name des auszuführenden Subflows. Wenn scopeName nicht enthalten ist, wird der Bereich des aktuell angemeldeten Benutzers verwendet. Rufen Sie den internen Namen des Subflows mit der Spalte Interner Name auf der Workflow-Studio-Zielseite ab.
    inputs Zuordnung Name-Wert-Paare, die Subflow-Eingaben definieren. Wenn ein Subflow obligatorische Eingaben enthält, müssen diese enthalten sein. Verwenden Sie für Eingaben der Feldtypen „Referenz“ oder „Dokument-ID“ ein GlideRecord-Objekt als Wert.
    Tabelle : 2. Ergebnisse
    Typ Beschreibung
    Objekt PlanResponse-Objekt, das die folgenden Eigenschaften enthält:
    • ContextID: SYS_ID des Ausführungsdetails-Datensatzes für den ausgeführten Subflow. Rufen Sie die Ausführungsdetails auf, indem Sie zur Registerkarte „Flow-Ausführungen“ in Workflow-Studio navigieren und nach sys_id filtern.
    Eine Ausnahme tritt auf, wenn der Subflow:
    • Nicht im angegebenen Anwendungsbereich vorhanden ist oder der Name des Subflows oder Bereichs falsch geschrieben wurde.
    • Nicht veröffentlicht wird.
    • Ein Eingabeobjekt erhält, das nicht mit den Subflow-Eingaben übereinstimmt.
    • Überschreitet die von festgelegte Rekursionsgrenze com.glide.hub.flow_engine.indirect_recursion_limitSystemeigenschaft. Der Standardwert ist drei.
    //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);
      }
    
    })();