Flux secondaire - Dans le champ d’application (déconseillé)

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 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 : dans le champ d’application, global.

    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 les flux secondaires prédéfinis, il n’existe 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. Créez plutôt un enregistrement de tâche planifiée dans l’interface Studio de workflow utilisateur.

    Flux secondaire : startAsync(String 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 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 de 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, elles doivent être incluses. Pour les entrées de champs de type 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é.
    • Reçoit un objet d’entrée qui ne correspond pas aux entrées de flux secondaire.
    • 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);
  }

})();