Flux secondaire - Inclus dans le périmètre (obsolète)

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 2 minutes de lecture

    • L’API de flux secondaire fournit des méthodes d’exécution des flux secondaires publiés Studio de workflow .

    Cette API est obsolète et remplacée par le .FlowAPI : incluse dans le périmètre, globale

    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’y a pas de 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(chaîne scopeName.subflowName, entrées de carte)

    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.

    Tableau 1. Paramètres
    Nom Type Description
    scopeName.subflowName Chaîne Périmètre de l’application pour le flux secondaire et nom interne du flux secondaire à exécuter. Si scopeName n’est pas inclus, le scope 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 comprend des entrées obligatoires, elles doivent être incluses. Pour les entrées de types de champ de référence ou ID de document, utilisez un objet GlideRecord comme valeur.
    Tableau 2. Renvoie
    Type Description
    Objet Objet PlanResponse contenant les propriétés suivantes :
    • contextId : Sys_id de l’enregistrement des détails d’exécution pour le flux secondaire exécuté. Accédez aux détails de l’exécution en naviguant vers l’onglet Exécutions de flux et en Studio de workflow filtrant par sys_id.
    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.
    		 
    //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);
  }

})();