Subflow – bereichsbezogen (veraltet)

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 1 Minute Lesedauer
  • Die Subflow- API bietet Methoden zum Ausführen veröffentlichter Workflow-Studio -Subflows.

    Diese API ist veraltet und wurde durch FlowAPI: Bereichsbezogen, globalersetzt.

    Die Subflow- API kann nur in Serverskripts verwendet werden.

    Verwenden Sie den Namespace sn_fd, um auf die Subflow- API zuzugreifen.

    Bevor Sie mit einem Subflow über die Subflow- API interagieren, müssen Sie den Subflow zuerst in der Schnittstelle Workflow-Studio erstellen und veröffentlichen. Da die Subflow -API nur mit vorgefertigten Subflows interagiert, gibt es keinen Konstruktor für die Klasse.

    Hinweis:
    Um die Leistung der Instanz zu optimieren, sollten Sie diese Methoden nicht aus einem asynchronen Business Rule-Skript aufrufen. Erstellen Sie stattdessen einen Datensatz für eine geplante Aufgabe in der Anwenderoberfläche Workflow-Studio.

    Subflow – startAsync(String scopeName.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ührungsdetaildatensatzes 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 das durch die Systemeigenschaft com.glide.hub.flow_engine.indirect_recursion_limit festgelegte Rekursionslimit. 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);
      }
    
    })();