Subflow – Scoped (veraltet)

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 1 Minute Lesedauer
  • Die Subflow- API stellt Methoden zum Ausführen veröffentlichter Flow Designer -Subflows bereit.

    Diese API ist veraltet und wird durch FlowAPI – Scoped, 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 Flow Designer erstellen und veröffentlichen. Da die Subflow -API nur mit vorab erstellten Subflows interagiert, gibt es keinen Konstruktor für die Klasse.

    Hinweis:
    Um die Instanzleistung 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 Benutzeroberfläche von Flow Designer.

    Scoped Subflow – startAsync(String scopeName.subflowName, Map inputs)

    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 Flow Designer-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ührungsdetail-Datensatzes für den ausgeführten Subflow. Rufen Sie die Ausführungsdetails auf, indem Sie zur Registerkarte „Flow-Ausführungen“ in Flow Designer 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 von der 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);
      }
    
    })();