Flux secondaire : inclus dans le périmètre (déconseillé)

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 2 minutes de lecture
  • L’API de flux secondaire fournit des méthodes pour exécuter les flux secondaires publiésConcepteur de flux.

    Cette API est déconseillée et remplacée par le FlowAPI - Inclus dans le périmètre, 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 Concepteur de flux . É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 Concepteur de flux utilisateur.

    Flux secondaire inclus dans le périmètre : startAsync(String scopeName.subflowName, Mapper les entrées)

    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 page de Concepteur de flux 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 naviguant vers l’onglet Exécutions de flux et en Concepteur de flux 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 de 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);
      }
    
    })();