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


---

# ScriptableFlowRunner -- Umfang

# ScriptableFlowRunner -- Umfang {#ariaid-title1}

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

Erstellt ein Generatorobjekt, das zum Definieren von Parametern für die Flow-, Subflow- und Aktionsausführung verwendet wird. Sie können einen Flow angeben, der in einer bestimmten Domäne ausgeführt werden soll. Starten Sie die Flow-, Subflow- oder Aktionsausführung direkt über den Generator, und zeigen Sie die Ergebnisse in einem ScriptableFlowRunnerResult-Objekt an.
Verwenden Sie diese Methoden in Ihren serverseitigen Skripts mit `sn_fd `Namespace-Bezeichner.

## API-Aufrufreihenfolge {#ScriptableFlowRunnerScopedAPI__section_fnq_jjs_slb}

Erstellen und führen Sie Flows, Subflows und Aktionen mit diesen APIs in der folgenden Reihenfolge aus:  

1. FlowAPI : Erstellt ein Generatorobjekt
:   Verwenden GetRunner() Zum Instanziieren des ScriptableFlowRunner-Generatorobjekts.

2. ScriptableFlowRunner : Geben Sie An Workflow-StudioAuszuführender Inhalt
:   Verwenden Sie diese Methoden in der folgenden Reihenfolge, um das Generatormuster zu erstellen:  
    1. Verwenden Sie eine der Methoden Aktion() , Datenstrom() , Flow() , Oder subflow() Um anzugeben, welchen Typ von Workflow-StudioZu erstellendes Objekt.
    2. Verwenden Sie eine oder mehrere Methoden wie AddInput() , Domäne () , Oder Schnell() Zum Angeben von Ausführungsparametern.
    3. Verwenden Sie Ausführen () Methode zum Ausführen der Aktion, des Flows oder des Subflows mit den angegebenen Parametern und Rückgeben eines ScriptableFlowRunnerResult-Objekts.
    {#ScriptableFlowRunnerScopedAPI__ol_hcw_m4s_slb}

3. ScriptableFlowRunnerResult : Abrufen Workflow-StudioAusführungsdetails
:   Verwenden Sie eine oder mehrere Methoden wie GetContextId() , GetAusgaben() , Und GetDomainId() Zum Anzeigen von Ausführungsdetails.

## Beispiel {#ScriptableFlowRunnerScopedAPI__section_nfr_rjw_slb}

Dieses Beispiel zeigt, wie ein ScriptableFlowRunner-Builder-Objekt erstellt wird, und verwendet es, um eine Genehmigungsaktion für einen bestimmten Datensatz auszuführen. Ein ScriptableFlowRunnerResult-Objekt erfasst die Ausführungsargumente und Aktionsausgaben.  


    (function() {
      try {

        var inputs = {}; 

        inputs['sys_id'] = '57af7aec73d423002728660c4cf6a71c';  // Pass the record's sys_id in as input.  

        var result = sn_fd.FlowAPI.getRunner()  // Create a ScriptableFlowRunner builder object.
          .action('global.markapproved')        // Run the global scope action named markapproved.
          .inForeground()
          .inDomain('TOP/ACME')                 // Run the action from the TOP/ACME domain.                               
          .withInputs(inputs)
          .run();                               // Run the action and return a FlowRunnerResult object.

        var contextId = result.getContextId();  // Retrieve the context ID from the result
        var dateRun = result.getDate();
        var domainUsed = result.getDomainId();  // Retrieve the Domain ID from the result.
        var flowName = result.getFlowObjectName();
        var flowObjectType = result.getFlowObjectType();

        var outputs = result.getOutputs();            // Retrieve any outputs from the action execution.
        var newApprovalStatus = outputs['approval'];  // Echo back the approval status for verification.
    		
      } catch (ex) {
        var message = ex.getMessage();
        gs.error(message);
      }
    	
    })();
       
## ScriptableFlowRunner -- action(string scopedActionName) {#ariaid-title2}

Gibt den Umfang und den Namen der auszuführenden Aktion an.
Siehe auch:

* [ScriptableFlowRunner -- Flow(Zeichenfolge scope edFlowName)](https://servicenow-prod.fluidtopics.net/N9zYXyk2FirKvqdvyusIug#FlowRunner-flow_S "Gibt den Umfang und den Namen des auszuführenden Flows an.")
* [ScriptableFlowRunner -- Subflow(Zeichenfolge scope edSubflowName)](https://servicenow-prod.fluidtopics.net/N9zYXyk2FirKvqdvyusIug#FlowRunner-subflow_S "Gibt den Umfang und den Namen des auszuführenden Subflows an.")
{#FlowRunner-action_S__ul_v5f_vt4_gcc}
{#FlowRunner-action_S__table_dkl_vlp_rlb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| ScopedActionName | Zeichenfolge | Umfang und Name der auszuführenden Aktion. Beispiel: `Global.actionName `. |
[Tabelle : 1. Parameter]

{#FlowRunner-action_S__table_dkl_vlp_rlb} {#FlowRunner-action_S__table_ekl_vlp_rlb__entry__2}

| Typ | Beschreibung |
|-|-|
| [ScriptableFlowRunner](https://servicenow-prod.fluidtopics.net/N9zYXyk2FirKvqdvyusIug#ScriptableFlowRunnerScopedAPI "Erstellt ein Generatorobjekt, das zum Definieren von Parametern für die Flow-, Subflow- und Aktionsausführung verwendet wird. Sie können einen Flow angeben, der in einer bestimmten Domäne ausgeführt werden soll. Starten Sie die Flow-, Subflow- oder Aktionsausführung direkt über den Generator, und zeigen Sie die Ergebnisse in einem ScriptableFlowRunnerResult-Objekt an.") | Generatorobjekt, das zum Ausführen von verwendet wird Workflow-StudioAktion, Flow oder Subflow. |
[Tabelle : 2. Rückgaben]

{#FlowRunner-action_S__table_ekl_vlp_rlb}  
Dieses Beispiel zeigt, wie ein ScriptableFlowRunner-Builder-Objekt erstellt wird, und verwendet es, um eine Genehmigungsaktion für einen bestimmten Datensatz auszuführen. Ein ScriptableFlowRunnerResult-Objekt erfasst die Ausführungsargumente und Aktionsausgaben.


    (function() {
      try {

        var inputs = {}; 

        inputs['sys_id'] = '57af7aec73d423002728660c4cf6a71c';  // Pass the record's sys_id in as input.  

        var result = sn_fd.FlowAPI.getRunner()  // Create a ScriptableFlowRunner builder object.
          .action('global.markapproved')        // Run the global scope action named markapproved.
          .inForeground()
          .inDomain('TOP/ACME')                 // Run the action from the TOP/ACME domain.                               
          .withInputs(inputs)
          .run();                               // Run the action and return a FlowRunnerResult object.

        var contextId = result.getContextId();  // Retrieve the context ID from the result
        var dateRun = result.getDate();
        var domainUsed = result.getDomainId();  // Retrieve the Domain ID from the result.
        var flowName = result.getFlowObjectName();
        var flowObjectType = result.getFlowObjectType();

        var outputs = result.getOutputs();            // Retrieve any outputs from the action execution.
        var newApprovalStatus = outputs['approval'];  // Echo back the approval status for verification.
    		
      } catch (ex) {
        var message = ex.getMessage();
        gs.error(message);
      }
    	
    })();
       
## ScriptableFlowRunner -- addInput (Zeichenfolgenname, Objektwert) {#ariaid-title3}

Fügt eine einzelne Eingabe hinzu. Wenn der als Argument übergebene Name bereits als separate Eingabe vorhanden ist, ersetzt der neue Wert den bereits vorhandenen Wert.
Diese Methode fügt eine einzelne Eingabe hinzu. Verwenden Sie zum Erstellen eines Objekts und Hinzufügen mehrerer Eingaben Mit Eingaben() Methode.
{#FlowRunner-addInput_S_O__table_ucp_smp_rlb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| name | Zeichenfolge | Der Name der Eingabe für den Flow, den Subflow oder die Aktion. |
| Wert | Objekt | Der Wert der Eingabe für den Flow, den Subflow oder die Aktion. |
[Tabelle : 3. Parameter]

{#FlowRunner-addInput_S_O__table_ucp_smp_rlb} {#FlowRunner-addInput_S_O__table_vcp_smp_rlb__entry__2}

| Typ | Beschreibung |
|-|-|
| [ScriptableFlowRunner](https://servicenow-prod.fluidtopics.net/N9zYXyk2FirKvqdvyusIug#ScriptableFlowRunnerScopedAPI "Erstellt ein Generatorobjekt, das zum Definieren von Parametern für die Flow-, Subflow- und Aktionsausführung verwendet wird. Sie können einen Flow angeben, der in einer bestimmten Domäne ausgeführt werden soll. Starten Sie die Flow-, Subflow- oder Aktionsausführung direkt über den Generator, und zeigen Sie die Ergebnisse in einem ScriptableFlowRunnerResult-Objekt an.") | Generatorobjekt, das zum Ausführen von verwendet wird Workflow-StudioAktion, Flow oder Subflow. |
[Tabelle : 4. Rückgaben]

{#FlowRunner-addInput_S_O__table_vcp_smp_rlb}  
In diesem Beispiel wird eine Aktion ausgeführt, die eine einzelne Eingabe verwendet, die aufgerufen wird `Tabellenname `.

    (function() {
      try {

        var result = sn_fd.FlowAPI.getRunner()
          .action('global.test_action')
          .addInput('table_name', 'incident')
          .inForeground()
          .run();

        gs.info(result.debug());

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

    })();

Ausgabe:

    Flow Designer: TableName
    *** Script: FlowRunnerResult
    Flow Object Name: global.test_action
    Flow Object Type: action
    Domain: null
    Result Time: 2020-06-09 00:10:57
    ContextId: null
    Output count: 1

## ScriptableFlowRunner -- asUser() {#ariaid-title4}

Führt den Flow als Anwender aus, der ihn ausgelöst hat, nicht als System, für schnelle Hintergrundausführungen.
Wenn ein Flow mit ausgelöst wird Schnell() Zusammen mit AsAnwender() Methode: Anwender, der den Flow ausgelöst hat, wird abgerufen und für die Flow-Ausführung verwendet.  
{#FlowRunner-asUser__table_c33_pts_qtb__entry__3}

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

{#FlowRunner-asUser__table_c33_pts_qtb}  
{#FlowRunner-asUser__table_l4l_tts_qtb__entry__2}

| Typ | Beschreibung |
|-|-|
| [ScriptableFlowRunner -- Umfang](https://servicenow-prod.fluidtopics.net/N9zYXyk2FirKvqdvyusIug#ScriptableFlowRunnerScopedAPI "Erstellt ein Generatorobjekt, das zum Definieren von Parametern für die Flow-, Subflow- und Aktionsausführung verwendet wird. Sie können einen Flow angeben, der in einer bestimmten Domäne ausgeführt werden soll. Starten Sie die Flow-, Subflow- oder Aktionsausführung direkt über den Generator, und zeigen Sie die Ergebnisse in einem ScriptableFlowRunnerResult-Objekt an.") | Generatorobjekt, das zum Ausführen von verwendet wird Workflow-StudioAktion, Flow oder Subflow. |
[Tabelle : 6. Rückgaben]

{#FlowRunner-asUser__table_l4l_tts_qtb}  
Dieses Beispiel zeigt, wie ein ScriptableFlowRunner-Builder-Objekt erstellt und verwendet es, um eine Genehmigungsaktion für einen bestimmten Datensatz mit auszuführen AsAnwender() Und Schnell() Methoden. Ein ScriptableFlowRunnerResult-Objekt erfasst die Ausführungsargumente und Aktionsausgaben.

    (function() {
        try {

            var outputs = sn_fd.FlowAPI.getRunner() // Create a ScriptableFlowRunner builder object.
            .flow('global.stry53225960_flow_asuser_test')
            .inForeground()
            .quick() //Run the flow from a server-side script.
            .asUser() //Run flow with the roles specified in the flow.
            .run(); // Run the action and return a FlowRunnerResult object.

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

    })();

### Fehler {#FlowRunner-asUser__section_jml_4tk_5tb}

Diese Fehler können bei der Verwendung von auftreten AsAnwender() Methode:

* Skript gibt einen Fehler zurück, wenn AsAnwender() Nicht zusammen mit verwendet Schnell() .
* Skript gibt einen Fehler zurück, wenn AsAnwender() Wird in einem Flow aufgerufen, für den Rollen definiert sind.
* Skript gibt einen Fehler zurück, wenn WithRoles() Und AsAnwender() Methoden werden gleichzeitig aufgerufen.
{#FlowRunner-asUser__ul_nhw_stk_5tb}

## ScriptableFlowRunner -- datastream(Zeichenfolge scopedDatastreamName) {#ariaid-title5}

Gibt den Umfang und den Namen der auszuführenden Datenstromaktion an.
Weitere Informationen zu Datenstromaktionen finden Sie unter [Datenstromaktionen und Paginierung](https://www.servicenow.com/docs/access?context=data-stream-actions&version=yokohama&pubname=yokohama-integrate-applications&ft:locale=en-US).
{#FlowRunner-datastream_S__table_xlx_wlp_rlb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Scope edDatastreamName | Zeichenfolge | Umfang und Name der auszuführenden Datenstromaktion. Beispiel: `Global.dataStreamActionName `. |
[Tabelle : 7. Parameter]

{#FlowRunner-datastream_S__table_xlx_wlp_rlb} {#FlowRunner-datastream_S__table_ylx_wlp_rlb__entry__2}

| Typ | Beschreibung |
|-|-|
| [ScriptableFlowRunner](https://servicenow-prod.fluidtopics.net/N9zYXyk2FirKvqdvyusIug#ScriptableFlowRunnerScopedAPI "Erstellt ein Generatorobjekt, das zum Definieren von Parametern für die Flow-, Subflow- und Aktionsausführung verwendet wird. Sie können einen Flow angeben, der in einer bestimmten Domäne ausgeführt werden soll. Starten Sie die Flow-, Subflow- oder Aktionsausführung direkt über den Generator, und zeigen Sie die Ergebnisse in einem ScriptableFlowRunnerResult-Objekt an.") | Generatorobjekt, das zum Ausführen von verwendet wird Workflow-StudioAktion, Flow oder Subflow. |
[Tabelle : 8. Rückgaben]

{#FlowRunner-datastream_S__table_ylx_wlp_rlb}  
Dieses Beispiel zeigt, wie eine Datenstromaktion ausgeführt wird.

    (function() {
      try {

        var result = sn_fd.FlowAPI.getRunner()
          .datastream('global.test_dsa')
          .inForeground()
          .run();

        gs.info(result.debug());

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

    })();

Ausgabe:

    *** Script: FlowRunnerResult
    Flow Object Name: global.test_dsa
    Flow Object Type: datastream
    Domain: null
    Result Time: 2020-06-08 16:41:13
    ContextId: null
    Output count: 0

## ScriptableFlowRunner -- Flow(Zeichenfolge scope edFlowName) {#ariaid-title6}

Gibt den Umfang und den Namen des auszuführenden Flows an.
Siehe auch:

* [ScriptableFlowRunner -- action(string scopedActionName)](https://servicenow-prod.fluidtopics.net/N9zYXyk2FirKvqdvyusIug#FlowRunner-action_S "Gibt den Umfang und den Namen der auszuführenden Aktion an.")
* [ScriptableFlowRunner -- Subflow(Zeichenfolge scope edSubflowName)](https://servicenow-prod.fluidtopics.net/N9zYXyk2FirKvqdvyusIug#FlowRunner-subflow_S "Gibt den Umfang und den Namen des auszuführenden Subflows an.")
{#FlowRunner-flow_S__ul_v5f_vt4_gcc}
{#FlowRunner-flow_S__table_zpn_4lp_rlb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Scope-FlowName | Zeichenfolge | Umfang und Name des auszuführenden Flows. Beispiel: `Global.flowName `. |
[Tabelle : 9. Parameter]

{#FlowRunner-flow_S__table_zpn_4lp_rlb} {#FlowRunner-flow_S__table_aqn_4lp_rlb__entry__2}

| Typ | Beschreibung |
|-|-|
| [ScriptableFlowRunner](https://servicenow-prod.fluidtopics.net/N9zYXyk2FirKvqdvyusIug#ScriptableFlowRunnerScopedAPI "Erstellt ein Generatorobjekt, das zum Definieren von Parametern für die Flow-, Subflow- und Aktionsausführung verwendet wird. Sie können einen Flow angeben, der in einer bestimmten Domäne ausgeführt werden soll. Starten Sie die Flow-, Subflow- oder Aktionsausführung direkt über den Generator, und zeigen Sie die Ergebnisse in einem ScriptableFlowRunnerResult-Objekt an.") | Generatorobjekt, das zum Ausführen von verwendet wird Workflow-StudioAktion, Flow oder Subflow. |
[Tabelle : 10. Rückgaben]

{#FlowRunner-flow_S__table_aqn_4lp_rlb}  
Dieses Beispiel zeigt, wie ein Flow ausgeführt wird, der eine Nachricht protokolliert.

    (function() {
      try {

        var result = sn_fd.FlowAPI.getRunner()
          .flow('global.test_flow')
          .inForeground()
          .run();

        gs.info(result.debug());

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

    })();

Ausgabe:

    *** Script: FlowRunnerResult
    Flow Object Name: global.test_flow
    Flow Object Type: flow
    Domain: null
    Result Time: 2020-06-08 16:41:13
    ContextId: null
    Output count: 0

## ScriptableFlowRunner -- inBackground() {#ariaid-title7}

Führt den Flow, den Subflow oder die Aktion asynchron aus. Sobald die Ausführung des Flow-Objekts beginnt, wird die Skriptausführung sofort fortgesetzt.
{#FlowRunner-inBackground__table_pzg_1mp_rlb__entry__3}

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

{#FlowRunner-inBackground__table_pzg_1mp_rlb} {#FlowRunner-inBackground__table_qzg_1mp_rlb__entry__2}

| Typ | Beschreibung |
|-|-|
| [ScriptableFlowRunner](https://servicenow-prod.fluidtopics.net/N9zYXyk2FirKvqdvyusIug#ScriptableFlowRunnerScopedAPI "Erstellt ein Generatorobjekt, das zum Definieren von Parametern für die Flow-, Subflow- und Aktionsausführung verwendet wird. Sie können einen Flow angeben, der in einer bestimmten Domäne ausgeführt werden soll. Starten Sie die Flow-, Subflow- oder Aktionsausführung direkt über den Generator, und zeigen Sie die Ergebnisse in einem ScriptableFlowRunnerResult-Objekt an.") | Generatorobjekt, das zum Ausführen von verwendet wird Workflow-StudioAktion, Flow oder Subflow. |
[Tabelle : 12. Rückgaben]

{#FlowRunner-inBackground__table_qzg_1mp_rlb}  
Hinweis:  
Ab XanaduRelease, wenn eine Aktion, ein Flow oder ein Subflow im Hintergrund mit der Quick()-Methode ausgeführt wird, wird eine Ausführungs-ID als ContextId-Wert zurückgegeben. Die Ausführungs-ID ist kein tatsächlicher Kontextdatensatz, da keine Datensätze in die Tabelle „Flow-Kontext" \[sys_Flow_context\] eingefügt werden. Stattdessen wird die Ausführungs-ID verwendet, um den asynchronen Aufruf nachzuverfolgen.  
Dieses Beispiel zeigt, wie ein Flow im Hintergrund asynchron ausgeführt wird.

    (function() {
        try {
      
          var result = sn_fd.FlowAPI.getRunner()
            .flow('global.change__unauthorized__review')
            .inBackground()
            .run();
      
          gs.info(result.debug());
      
        } catch (ex) {
          var message = ex.getMessage();
          gs.error(message);
        }
      
      })();

Ausgabe:


    [0:00:01.015] Script completed in scope global: script
    ----------------------------------------------------------------------------------------------------------
    Script execution history and recovery available here
    Operation       Table                               Row Count
    insert          sys_flow_context_inputs_chunk       1
    insert          sys_flow_context                    1
    ----------------------------------------------------------------------------------------------------------
    Complex type redefined: FlowDesigner:FDCollection
    Queued flow.fire event in NowMQ for sys_flow_context.sys_id: e0cd6e30b8b602104a8752ad4a9167c8,
    sysevent.sys_id: 34cd6e30dbb60210497c1a48139619c9, with priority 5
    *** Script: FlowRunnerResult
    Flow Object Name: global.change__unauthorized__review
    Flow Object Type: flow
    Domain: null
    Result Time: 2024-06-12 17:54:58
    ContextId: e0cd6e30b8b602104a8752ad4a9167c8
    Output count: 0

## ScriptableFlowRunner -- inDomain (Zeichenfolge domainId) {#ariaid-title8}

Führt den Flow, den Subflow oder die Aktion in der angegebenen Domäne aus. Überprüft, ob die Domäne vorhanden und verfügbar ist.
{#FlowRunner-inDomain_S__table_pcy_hmp_rlb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| domainId | Zeichenfolge | Die sys_ID oder der Name für die Ausführungsdomäne für den Flow. |
[Tabelle : 13. Parameter]

{#FlowRunner-inDomain_S__table_pcy_hmp_rlb} {#FlowRunner-inDomain_S__table_qcy_hmp_rlb__entry__2}

| Typ | Beschreibung |
|-|-|
| [ScriptableFlowRunner](https://servicenow-prod.fluidtopics.net/N9zYXyk2FirKvqdvyusIug#ScriptableFlowRunnerScopedAPI "Erstellt ein Generatorobjekt, das zum Definieren von Parametern für die Flow-, Subflow- und Aktionsausführung verwendet wird. Sie können einen Flow angeben, der in einer bestimmten Domäne ausgeführt werden soll. Starten Sie die Flow-, Subflow- oder Aktionsausführung direkt über den Generator, und zeigen Sie die Ergebnisse in einem ScriptableFlowRunnerResult-Objekt an.") | Generatorobjekt, das zum Ausführen von verwendet wird Workflow-StudioAktion, Flow oder Subflow. |
[Tabelle : 14. Rückgaben]

{#FlowRunner-inDomain_S__table_qcy_hmp_rlb}  
Dieses Beispiel zeigt, wie ein ScriptableFlowRunner-Builder-Objekt erstellt wird, und verwendet es, um eine Genehmigungsaktion für einen bestimmten Datensatz auszuführen. Ein ScriptableFlowRunnerResult-Objekt erfasst die Ausführungsargumente und Aktionsausgaben.


    (function() {
      try {

        var inputs = {}; 

        inputs['sys_id'] = '57af7aec73d423002728660c4cf6a71c';  // Pass the record's sys_id in as input.  

        var result = sn_fd.FlowAPI.getRunner()  // Create a ScriptableFlowRunner builder object.
          .action('global.markapproved')        // Run the global scope action named markapproved.
          .inForeground()
          .inDomain('TOP/ACME')                 // Run the action from the TOP/ACME domain.                               
          .withInputs(inputs)
          .run();                               // Run the action and return a FlowRunnerResult object.

        var contextId = result.getContextId();  // Retrieve the context ID from the result
        var dateRun = result.getDate();
        var domainUsed = result.getDomainId();  // Retrieve the Domain ID from the result.
        var flowName = result.getFlowObjectName();
        var flowObjectType = result.getFlowObjectType();

        var outputs = result.getOutputs();            // Retrieve any outputs from the action execution.
        var newApprovalStatus = outputs['approval'];  // Echo back the approval status for verification.
    		
      } catch (ex) {
        var message = ex.getMessage();
        gs.error(message);
      }
    	
    })();
       
## ScriptableFlowRunner -- inForeground() {#ariaid-title9}

Führt den Flow, den Subflow oder die Aktion synchron aus. Die Skriptausführung wird angehalten, während das Flow-Objekt ausgeführt wird.
Hinweis:  
Diese Methode unterstützt nicht das Anhalten der Aktion, um auf Bedingungen zu warten. Schritte, die für Wartebedingungen anhalten, z. B. „Genehmigung anfordern" oder „Warten auf Bedingung", werden nicht unterstützt.
{#FlowRunner-inForeground__table_irw_ylp_rlb__entry__3}

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

{#FlowRunner-inForeground__table_irw_ylp_rlb} {#FlowRunner-inForeground__table_jrw_ylp_rlb__entry__2}

| Typ | Beschreibung |
|-|-|
| [ScriptableFlowRunner](https://servicenow-prod.fluidtopics.net/N9zYXyk2FirKvqdvyusIug#ScriptableFlowRunnerScopedAPI "Erstellt ein Generatorobjekt, das zum Definieren von Parametern für die Flow-, Subflow- und Aktionsausführung verwendet wird. Sie können einen Flow angeben, der in einer bestimmten Domäne ausgeführt werden soll. Starten Sie die Flow-, Subflow- oder Aktionsausführung direkt über den Generator, und zeigen Sie die Ergebnisse in einem ScriptableFlowRunnerResult-Objekt an.") | Generatorobjekt, das zum Ausführen von verwendet wird Workflow-StudioAktion, Flow oder Subflow. |
[Tabelle : 16. Rückgaben]

{#FlowRunner-inForeground__table_jrw_ylp_rlb}  
Dieses Beispiel zeigt, wie ein ScriptableFlowRunner-Builder-Objekt erstellt wird, und verwendet es, um eine Genehmigungsaktion für einen bestimmten Datensatz auszuführen. Ein ScriptableFlowRunnerResult-Objekt erfasst die Ausführungsargumente und Aktionsausgaben.


    (function() {
      try {

        var inputs = {}; 

        inputs['sys_id'] = '57af7aec73d423002728660c4cf6a71c';  // Pass the record's sys_id in as input.  

        var result = sn_fd.FlowAPI.getRunner()  // Create a ScriptableFlowRunner builder object.
          .action('global.markapproved')        // Run the global scope action named markapproved.
          .inForeground()
          .inDomain('TOP/ACME')                 // Run the action from the TOP/ACME domain.                               
          .withInputs(inputs)
          .run();                               // Run the action and return a FlowRunnerResult object.

        var contextId = result.getContextId();  // Retrieve the context ID from the result
        var dateRun = result.getDate();
        var domainUsed = result.getDomainId();  // Retrieve the Domain ID from the result.
        var flowName = result.getFlowObjectName();
        var flowObjectType = result.getFlowObjectType();

        var outputs = result.getOutputs();            // Retrieve any outputs from the action execution.
        var newApprovalStatus = outputs['approval'];  // Echo back the approval status for verification.
    		
      } catch (ex) {
        var message = ex.getMessage();
        gs.error(message);
      }
    	
    })();
       
## ScriptableFlowRunner -- Quick() {#ariaid-title10}

Führt einen Flow, Subflow, eine Aktion oder eine Datenstromaktion aus einem serverseitigen Skript synchron oder asynchron aus, ohne Ausführungsdetails oder andere zugehörige Datensätze zu erstellen. Verbessert die Leistung, indem der Overhead bei der Datensatzaufbewahrung beseitigt wird.
Verwenden Sie diese API, um die Geschwindigkeit der Verarbeitung mit hohem Volumen, z. B. mehrere Ausführungen pro Sekunde, in einer Produktionsumgebung zu erhöhen.

Berichterstellung und Datensätze generiert
:   Diese Methode erstellt keine Ausführungsdetails und Kontextdatensätze, unabhängig von Workflow-StudioEinstellungen.

Unterstützung für Wartebedingung
:   Diese Methode unterstützt nicht das Anhalten einer Aktion oder eines Flows, um auf Bedingungen zu warten. Aktionen, Flow-Logik und Schritte, die für Wartebedingungen anhalten, z. B. „Genehmigung anfordern", „auf Bedingung warten" oder „Warten auf eine Dauer", werden nicht unterstützt.

MID-Server-Unterstützung
:   Diese Methode unterstützt nicht das Anhalten einer Aktion oder eines Flows zur Ausführung von einem MID-Server. Diese Einschränkung umfasst Vorverarbeitungsskripts für Datenstromaktionen, die eine Aktion anhalten, um sie von einem MID-Server aus auszuführen.

Unterstützung von Datenstromaktionen
:   Diese Methode unterstützt nicht das Anhalten einer Datenstromaktion, um ein Vorverarbeitungsskript von einem MID-Server auszuführen.

Flow-Prioritätsunterstützung
:   Diese Methode unterstützt Flow-Prioritätseinstellungen. Der Flow wird mit der angegebenen Flow-Priorität ausgeführt.
{#FlowRunner-quick__table_lmh_cmp_rlb__entry__3}

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

{#FlowRunner-quick__table_lmh_cmp_rlb} {#FlowRunner-quick__table_mmh_cmp_rlb__entry__2}

| Typ | Beschreibung |
|-|-|
| [ScriptableFlowRunner](https://servicenow-prod.fluidtopics.net/N9zYXyk2FirKvqdvyusIug#ScriptableFlowRunnerScopedAPI "Erstellt ein Generatorobjekt, das zum Definieren von Parametern für die Flow-, Subflow- und Aktionsausführung verwendet wird. Sie können einen Flow angeben, der in einer bestimmten Domäne ausgeführt werden soll. Starten Sie die Flow-, Subflow- oder Aktionsausführung direkt über den Generator, und zeigen Sie die Ergebnisse in einem ScriptableFlowRunnerResult-Objekt an.") | Generatorobjekt, das zum Ausführen von verwendet wird Workflow-StudioAktion, Flow oder Subflow. |
[Tabelle : 18. Rückgaben]

{#FlowRunner-quick__table_mmh_cmp_rlb}  
Hinweis:  
Ab XanaduRelease, wenn eine Aktion, ein Flow oder ein Subflow im Hintergrund mit der Quick()-Methode ausgeführt wird, wird eine Ausführungs-ID als ContextId-Wert zurückgegeben. Die Ausführungs-ID ist kein tatsächlicher Kontextdatensatz, da keine Datensätze in die Tabelle „Flow-Kontext" \[sys_Flow_context\] eingefügt werden. Stattdessen wird die Ausführungs-ID verwendet, um den asynchronen Aufruf nachzuverfolgen.  
Dieses Beispiel zeigt, wie ein Flow ausgeführt wird, ohne zugehörige Datensätze zu erstellen.

    (function() {
      try {

        var result = sn_fd.FlowAPI.getRunner()
          .flow('global.change__unauthorized__review')
          .inBackground()
          .quick()
          .run();

        gs.info(result.debug());

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

    })();

Ausgabe:


    Complex type redefined: FlowDesigner:FDCollection
    Queued flow.run.quick event in NowMQ for sys_flow_context.sys_id: d81781ec57801110403e8f90ac94f90e,
    sysevent.sys_id: 48abe270dbf20210497c1a4813961908, with priority 5
    *** Script: FlowRunnerResult
    Flow Object Name: global.change__unauthorized__review
    Flow Object Type: flow
    Domain: null
    Result Time: 2024-06-12 17:45:37
    ContextId: 08abe2706cf202107b7d3b283f7ee108
    Output count: 0

## ScriptableFlowRunner -- Run() {#ariaid-title11}

Führt den Flow, den Subflow oder die Aktion mit den angegebenen Parametern aus.
{#FlowRunner-run__table_tjy_wmp_rlb__entry__3}

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

{#FlowRunner-run__table_tjy_wmp_rlb} {#FlowRunner-run__table_ujy_wmp_rlb__entry__2}

| Typ | Beschreibung |
|-|-|
| SkriptableFlowRunnerResultScoped | Objekt, das die Ausführungsdetails von enthält Workflow-StudioAktion, Flow oder Subflow. |
[Tabelle : 20. Rückgaben]

{#FlowRunner-run__table_ujy_wmp_rlb}  
Dieses Beispiel zeigt, wie ein ScriptableFlowRunner-Builder-Objekt erstellt wird, und verwendet es, um eine Genehmigungsaktion für einen bestimmten Datensatz auszuführen. Ein ScriptableFlowRunnerResult-Objekt erfasst die Ausführungsargumente und Aktionsausgaben.


    (function() {
      try {

        var inputs = {}; 

        inputs['sys_id'] = '57af7aec73d423002728660c4cf6a71c';  // Pass the record's sys_id in as input.  

        var result = sn_fd.FlowAPI.getRunner()  // Create a ScriptableFlowRunner builder object.
          .action('global.markapproved')        // Run the global scope action named markapproved.
          .inForeground()
          .inDomain('TOP/ACME')                 // Run the action from the TOP/ACME domain.                               
          .withInputs(inputs)
          .run();                               // Run the action and return a FlowRunnerResult object.

        var contextId = result.getContextId();  // Retrieve the context ID from the result
        var dateRun = result.getDate();
        var domainUsed = result.getDomainId();  // Retrieve the Domain ID from the result.
        var flowName = result.getFlowObjectName();
        var flowObjectType = result.getFlowObjectType();

        var outputs = result.getOutputs();            // Retrieve any outputs from the action execution.
        var newApprovalStatus = outputs['approval'];  // Echo back the approval status for verification.
    		
      } catch (ex) {
        var message = ex.getMessage();
        gs.error(message);
      }
    	
    })();
       
## ScriptableFlowRunner -- Subflow(Zeichenfolge scope edSubflowName) {#ariaid-title12}

Gibt den Umfang und den Namen des auszuführenden Subflows an.
Siehe auch:

* [ScriptableFlowRunner -- action(string scopedActionName)](https://servicenow-prod.fluidtopics.net/N9zYXyk2FirKvqdvyusIug#FlowRunner-action_S "Gibt den Umfang und den Namen der auszuführenden Aktion an.")
* [ScriptableFlowRunner -- Flow(Zeichenfolge scope edFlowName)](https://servicenow-prod.fluidtopics.net/N9zYXyk2FirKvqdvyusIug#FlowRunner-flow_S "Gibt den Umfang und den Namen des auszuführenden Flows an.")
{#FlowRunner-subflow_S__ul_v5f_vt4_gcc}
{#FlowRunner-subflow_S__table_sxg_5lp_rlb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Scope edSubflowName | Zeichenfolge | Umfang und Name des auszuführenden Subflows. Beispiel: `Global.subflowName `. |
[Tabelle : 21. Parameter]

{#FlowRunner-subflow_S__table_sxg_5lp_rlb} {#FlowRunner-subflow_S__table_txg_5lp_rlb__entry__2}

| Typ | Beschreibung |
|-|-|
| [ScriptableFlowRunner](https://servicenow-prod.fluidtopics.net/N9zYXyk2FirKvqdvyusIug#ScriptableFlowRunnerScopedAPI "Erstellt ein Generatorobjekt, das zum Definieren von Parametern für die Flow-, Subflow- und Aktionsausführung verwendet wird. Sie können einen Flow angeben, der in einer bestimmten Domäne ausgeführt werden soll. Starten Sie die Flow-, Subflow- oder Aktionsausführung direkt über den Generator, und zeigen Sie die Ergebnisse in einem ScriptableFlowRunnerResult-Objekt an.") | Generatorobjekt, das zum Ausführen von verwendet wird Workflow-StudioAktion, Flow oder Subflow. |
[Tabelle : 22. Rückgaben]

{#FlowRunner-subflow_S__table_txg_5lp_rlb}  
Dieses Beispiel zeigt, wie ein Subflow ausgeführt wird, der eine Nachricht protokolliert.

    (function() {
      try {

        var result = sn_fd.FlowAPI.getRunner()
          .subflow('global.output_test')
          .inForeground()
          .run();
       
        gs.info(result.debug());

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

    })();

Ausgabe:

    record-watcher asynchronous tracking complete - time: 1 ms. Executed responders: 1 
    record-watcher asynchronous tracking complete - time: 1 ms. Executed responders: 1 
    *** Script: FlowRunnerResult
    Flow Object Name: global.output_test
    Flow Object Type: subflow
    Domain: null
    Result Time: 2024-08-02 22:52:08
    ContextId: b2dxx659bebf01101d72200x503x19pr
    Output count: 2

## ScriptableFlowRunner -- Timeout (Zeitüberschreitung bei Anzahl) {#ariaid-title13}

Legt eine Zeitüberschreitung für eine Flow-, Subflow- oder Aktionsausführung fest.
{#FlowRunner-timeout_N__table_m4g_lmp_rlb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Zeitüberschreitung | Nummer | Zeitüberschreitung in Millisekunden. |
[Tabelle : 23. Parameter]

{#FlowRunner-timeout_N__table_m4g_lmp_rlb} {#FlowRunner-timeout_N__table_n4g_lmp_rlb__entry__2}

| Typ | Beschreibung |
|-|-|
| [ScriptableFlowRunner](https://servicenow-prod.fluidtopics.net/N9zYXyk2FirKvqdvyusIug#ScriptableFlowRunnerScopedAPI "Erstellt ein Generatorobjekt, das zum Definieren von Parametern für die Flow-, Subflow- und Aktionsausführung verwendet wird. Sie können einen Flow angeben, der in einer bestimmten Domäne ausgeführt werden soll. Starten Sie die Flow-, Subflow- oder Aktionsausführung direkt über den Generator, und zeigen Sie die Ergebnisse in einem ScriptableFlowRunnerResult-Objekt an.") | Generatorobjekt, das zum Ausführen von verwendet wird Workflow-StudioAktion, Flow oder Subflow. |
[Tabelle : 24. Rückgaben]

{#FlowRunner-timeout_N__table_n4g_lmp_rlb}  
Dieses Beispiel zeigt, wie ein Flow ausgeführt wird, und legt eine Zeitüberschreitung für zwei Minuten fest.

    (function() {
      try {

        var result = sn_fd.FlowAPI.getRunner()
          .flow('global.test_flow')
          .inForeground()
          .timeout(120000)
          .run();

        gs.info(result.debug());

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

    })(); 

Ausgabe:

    Flow Designer: Cloning a new session to run as as user id: [user_name] from original user session: [user_name]
    Flow Designer: Reverting cloned session to original user session: [user_name]
    *** Script: FlowRunnerResult
    Flow Object Name: global.test_flow
    Flow Object Type: flow
    Domain: null
    Result Time: 2020-06-08 18:22:35
    ContextId: null
    Output count: 0

## ScriptableFlowRunner -- validateInputs (boolescher validateInputs) {#ariaid-title14}

Lösen Sie einen Fehler aus, und verhindern Sie, dass die ScriptableFlowRunner-Klasse ausgeführt wird, wenn eine Methodeneingabe einen unerwarteten Wert hat. Diese Methode ist für jeden ScriptableFlowRunner-Aufruf standardmäßig auf „wahr" festgelegt.
{#FlowRunner-validateInputs_B__table_vmh_2yp_rwb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| ValidierenEingaben | Boolean | Kennzeichnung, die angibt, ob Eingaben der ScriptableFlowRunner-Methode validiert werden sollen. Es gibt zwei gültige Werte. * Wahr: Löst einen Fehler aus, wenn Eingaben unerwartete Werte aufweisen, und beendet die Ausführung des Skripts. * Falsch: Zulassen, dass das Skript mit unerwarteten Werten ausgeführt wird. {#FlowRunner-validateInputs_B__ul_mdn_wzp_rwb} Standard: Wahr |
[Tabelle : 25. Parameter]

{#FlowRunner-validateInputs_B__table_vmh_2yp_rwb} {#FlowRunner-validateInputs_B__table_wmh_2yp_rwb__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 26. Rückgaben]

{#FlowRunner-validateInputs_B__table_wmh_2yp_rwb}  
Dieses Beispiel zeigt, wie ein Flow ausgeführt wird, ohne die Eingabewerte der Methode zu validieren.

    (function() {
      try {

        var result = sn_fd.FlowAPI.getRunner()
          .flow('global.test_flow')
          .inForeground()
          .validateInputs(false)
          .run();

        gs.info(result.debug());

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

    })();

Ausgabe:

    *** Script: FlowRunnerResult
    Flow Object Name: global.test_flow
    Flow Object Type: flow
    Domain: null
    Result Time: 2020-06-08 16:41:13
    ContextId: null
    Output count: 0

## ScriptableFlowRunner -- withConnectionAliasOverride(String AliasName, String overrideName) {#ariaid-title15}

Überschreibt Verbindungen und AnmeldeinformationenAlias, der dem Flow, der Aktion oder dem Subflow zugeordnet ist. Sie können den standardmäßigen übergeordneten Alias mit einem seiner untergeordneten Aliasse überschreiben.
Um mehr über das Überschreiben von zu erfahren Verbindungen und AnmeldeinformationenAlias, siehe [Unterstützt mehrere Verbindungen](https://www.servicenow.com/docs/access?context=support-multiple-connections&version=yokohama&pubname=yokohama-integrate-applications&ft:locale=en-US).
{#FR-wConnectionAliasOverride_S_S__table_av4_gv5_rlb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| ParentAliasSysID | Zeichenfolge | Die sys_ID des übergeordneten Alias, der Alias, den Sie überschreiben möchten. |
| ÜberschriebenAliasSysID | Zeichenfolge | Die sys_ID des untergeordneten Alias, der Alias, den Sie beim Ausführen des Flows, Subflows oder der Aktion verwenden möchten. |
[Tabelle : 27. Parameter]

{#FR-wConnectionAliasOverride_S_S__table_av4_gv5_rlb} {#FR-wConnectionAliasOverride_S_S__table_bv4_gv5_rlb__entry__2}

| Typ | Beschreibung |
|-|-|
| [ScriptableFlowRunner](https://servicenow-prod.fluidtopics.net/N9zYXyk2FirKvqdvyusIug#ScriptableFlowRunnerScopedAPI "Erstellt ein Generatorobjekt, das zum Definieren von Parametern für die Flow-, Subflow- und Aktionsausführung verwendet wird. Sie können einen Flow angeben, der in einer bestimmten Domäne ausgeführt werden soll. Starten Sie die Flow-, Subflow- oder Aktionsausführung direkt über den Generator, und zeigen Sie die Ergebnisse in einem ScriptableFlowRunnerResult-Objekt an.") | Generatorobjekt, das zum Ausführen von verwendet wird Workflow-StudioAktion, Flow oder Subflow. |
[Tabelle : 28. Rückgaben]

{#FR-wConnectionAliasOverride_S_S__table_bv4_gv5_rlb}  
Dieses Beispiel zeigt, wie ein Flow mit einem anderen Alias als dem Standard ausgeführt wird, der dem Flow zugeordnet ist.

    (function() {
      try {

        var result = sn_fd.FlowAPI.getRunner()
          .flow('global.test_flow')
          .withConnectionAliasOverride('sn_original_alias.spoke', 'x_new_alias.spoke')
          .inForeground()
          .run();

        gs.info(result.debug());

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

    })();

## ScriptableFlowRunner -- withInputs (Zuordnungseingaben) {#ariaid-title16}

Fügt eine Sammlung von Eingaben hinzu. Wenn bereits ein Name in einem der Name-Wert-Paare vorhanden ist, ersetzt der neue Wert den bereits vorhandenen Wert.
{#FlowRunner-withInputs_O__table_zw2_vnp_rlb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| inputs | Objekt | Zuordnungsobjekt, das die Name-Wert-Paare enthält, die Eingaben für den Flow, den Subflow oder die Aktion definieren. |
[Tabelle : 29. Parameter]

{#FlowRunner-withInputs_O__table_zw2_vnp_rlb} {#FlowRunner-withInputs_O__table_ax2_vnp_rlb__entry__2}

| Typ | Beschreibung |
|-|-|
| [ScriptableFlowRunner](https://servicenow-prod.fluidtopics.net/N9zYXyk2FirKvqdvyusIug#ScriptableFlowRunnerScopedAPI "Erstellt ein Generatorobjekt, das zum Definieren von Parametern für die Flow-, Subflow- und Aktionsausführung verwendet wird. Sie können einen Flow angeben, der in einer bestimmten Domäne ausgeführt werden soll. Starten Sie die Flow-, Subflow- oder Aktionsausführung direkt über den Generator, und zeigen Sie die Ergebnisse in einem ScriptableFlowRunnerResult-Objekt an.") | Generatorobjekt, das zum Ausführen von verwendet wird Workflow-StudioAktion, Flow oder Subflow. |
[Tabelle : 30. Rückgaben]

{#FlowRunner-withInputs_O__table_ax2_vnp_rlb}  
Erstellt ein Eingabeobjekt und übergibt den Wert an Mit Eingaben() Methode.


    (function() {
      try {

        var inputs = {}; 

        inputs['sys_id'] = '57af7aec73d423002728660c4cf6a71c';  // Pass the record's sys_id in as input.  

        var result = sn_fd.FlowAPI.getRunner()  // Create a ScriptableFlowRunner builder object.
          .action('global.markapproved')        // Run the global scope action named markapproved.
          .inForeground()
          .inDomain('TOP/ACME')                 // Run the action from the TOP/ACME domain.                               
          .withInputs(inputs)
          .run();                               // Run the action and return a FlowRunnerResult object.

        var contextId = result.getContextId();  // Retrieve the context ID from the result
        var dateRun = result.getDate();
        var domainUsed = result.getDomainId();  // Retrieve the Domain ID from the result.
        var flowName = result.getFlowObjectName();
        var flowObjectType = result.getFlowObjectType();

        var outputs = result.getOutputs();            // Retrieve any outputs from the action execution.
        var newApprovalStatus = outputs['approval'];  // Echo back the approval status for verification.
    		
      } catch (ex) {
        var message = ex.getMessage();
        gs.error(message);
      }
    	
    })();
       
## ScriptableFlowRunner -- withRoles() {#ariaid-title17}

Führt den Flow als Anwender aus, der den Flow ausgelöst hat, oder führt den Flow mit Rollen aus, die in hinzugefügt wurden Workflow-Studio.
Wenn ein Flow mit ausgelöst wird Schnell() Zusammen mit WithRoles() Methode: In den Flow-Eigenschaften definierte Rollen werden abgerufen, während der Flow-Ausführung übergeben, und der Flow wird mit den Rollen ausgeführt.  
{#FlowRunner-withRoles__table_c33_pts_qtb__entry__3}

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

{#FlowRunner-withRoles__table_c33_pts_qtb}  
{#FlowRunner-withRoles__table_l4l_tts_qtb__entry__2}

| Typ | Beschreibung |
|-|-|
| [ScriptableFlowRunner -- Umfang](https://servicenow-prod.fluidtopics.net/N9zYXyk2FirKvqdvyusIug#ScriptableFlowRunnerScopedAPI "Erstellt ein Generatorobjekt, das zum Definieren von Parametern für die Flow-, Subflow- und Aktionsausführung verwendet wird. Sie können einen Flow angeben, der in einer bestimmten Domäne ausgeführt werden soll. Starten Sie die Flow-, Subflow- oder Aktionsausführung direkt über den Generator, und zeigen Sie die Ergebnisse in einem ScriptableFlowRunnerResult-Objekt an.") | Generatorobjekt, das zum Ausführen von verwendet wird Workflow-StudioAktion, Flow oder Subflow. |
[Tabelle : 32. Rückgaben]

{#FlowRunner-withRoles__table_l4l_tts_qtb}  
Dieses Beispiel zeigt, wie ein ScriptableFlowRunner-Builder-Objekt erstellt und verwendet es, um eine Genehmigungsaktion für einen bestimmten Datensatz mit auszuführen WithRoles() Und Schnell() Methoden. Ein ScriptableFlowRunnerResult-Objekt erfasst die Ausführungsargumente und Aktionsausgaben.

    (function() {
        try {

            var outputs = sn_fd.FlowAPI.getRunner() // Create a ScriptableFlowRunner builder object.
            .flow('global.stry53225960_flow')
            .inForeground()
            .quick() //Run the flow from a server-side script.
            .withRoles() //Run the flow as the user who triggered the flow.
            .run(); // Run the action and return a FlowRunnerResult object.

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

        }  

    })();

### Fehler {#FlowRunner-withRoles__section_ckg_zsk_5tb}

Diese Fehler können bei der Verwendung von auftreten WithRoles() Methode:

* WithRoles() Führt keinen Vorgang aus, wenn er nicht zusammen mit verwendet wird Schnell() .
* Skript gibt einen Fehler zurück, wenn WithRoles() Wird in einem Flow aufgerufen, der keine Rollen hat.
* Skript gibt einen Fehler zurück, wenn WithRoles() Und AsAnwender() Methoden werden gleichzeitig aufgerufen.
{#FlowRunner-withRoles__ul_zcv_ctk_5tb}

