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

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 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, globalfichier .

    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)

    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 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 2. Renvoie
    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.
    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);
      }
    
    })();