---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Flux secondaire : inclus dans le champ d'application (déconseillé)

# Flux secondaire : inclus dans le champ d'application (déconseillé) {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes de lecture

L'API de flux secondaire fournit des méthodes pour exécuter les flux secondaires publiés Studio de workflow .

Cette API est obsolète et remplacée par le [FlowAPI : inclus, global](https://servicenow-prod.fluidtopics.net/jMtOvbWhA2_AciBNG_kHww#ScriptableFlowAPI "FlowAPI fournit des méthodes pour exécuter des actions, des flux ou des flux secondaires dans des scripts côté serveur à l’aide de méthodes bloquantes ou non.")fichier .

L'API de flux secondaire ne peut être utilisée que dans les scripts serveur.

Utilisez l'espace de noms `sn_fd` pour accéder à l'API de flux secondaire .

Avant d'interagir avec un flux secondaire à l'aide de l'API de flux secondaire , vous devez d'abord créer et publier le flux secondaire dans l'interface Studio de workflow . Étant donné que l'API de flux secondaire n'interagit qu'avec des flux secondaires prédéfinis, il n'existe aucun constructeur pour la classe.  
Remarque :  
Pour optimiser les performances de l'instance, évitez d'appeler ces méthodes à partir d'un script de règle métier asynchrone. Au lieu de cela, créez un enregistrement de tâche planifiée dans l'interface Studio de workflow utilisateur.

## Flux secondaire : startAsync(String scopeName.subflowName, entrées de carte) {#ariaid-title2}

Exécute un flux secondaire publié de manière asynchrone.
Les appels asynchrones ne sont pas bloquants, ce qui permet au client d'exécuter d'autres codes dans le script sans avoir à attendre la fin du flux secondaire.
{#SubflowScoped-startAsync_S_O__table_slq_v1v_ncb__entry__3}

| Nom | Type | Description |
|-|-|-|
| scopeName.subflowName | Chaîne | Le périmètre de l'application pour le flux secondaire et le nom interne du flux secondaire à exécuter. Si scopeName n'est pas inclus, le champ d'application de l'utilisateur actuellement connecté est utilisé. Récupérez le nom interne du flux secondaire à l'aide de la colonne Nom interne sur la Studio de workflow page de destination. |
| entrées | Carte | Paires nom-valeur qui définissent les entrées de flux secondaire. Si un flux secondaire inclut des entrées obligatoires, celles-ci doivent être incluses. Pour les entrées de types de champs Référence ou ID de document, utilisez un objet GlideRecord comme valeur. |
[Tableau 1. Paramètres]

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

| Type | Description |
|-|-|
| Objet | Objet PlanResponse contenant les propriétés suivantes : * contextId : Sys_id de l'enregistrement des détails de l'exécution pour le flux secondaire exécuté. Accédez aux détails de l'exécution en accédant à l'onglet Exécutions de flux et Studio de workflow en filtrant par sys_id. {#SubflowScoped-startAsync_S_O__ul_bd2_k2v_ncb} Une exception se produit lorsque le flux secondaire : * N'existe pas dans le périmètre de l'application spécifié, ou le nom du flux secondaire ou du périmètre a été mal orthographié. * N'est pas publié. * Un objet d'entrée qui ne correspond pas aux entrées de flux secondaire est transmis. * Dépasse la limite de récursivité définie par la com.glide.hub.flow_engine.indirect_recursion_limit propriété système. La valeur par défaut est trois. {#SubflowScoped-startAsync_S_O__ul_ub3_n3t_pcb} |
[Tableau 2. Renvoie]

{#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);
      }

    })();