ScriptableFlowRunnerResult : inclus dans le champ d’application

Capture le résultat de l’utilisation de ScriptableFlowRunner pour exécuter un flux, un flux secondaire ou une action. Inclut des données telles que l’ID de contexte, le domaine et toutes les sorties de l’exécution du flux.

Utilisez ces méthodes dans vos scripts côté serveur avec l’identificateur d’espace de noms sn_fd.

Ordre d’appel d’API

Créez et exécutez des flux, des flux secondaires et des actions à l’aide de ces API dans l’ordre suivant :

1. FlowAPI : crée un objet de générateur

Utilisez getRunner() pour instancier l’objet générateur ScriptableFlowRunner.

2. ScriptableFlowRunner : spécifier Studio de workflow le contenu à exécuter

Utilisez ces méthodes dans l’ordre suivant pour créer le modèle de générateur :

1. Utilisez l’une des méthodes action(),datastream(), flow() ou subflow() pour spécifier le type d’objet Studio de workflow à construire.
2. Utilisez une ou plusieurs méthodes telles que addInput(),inDomain() ou quick() pour spécifier les paramètres d’exécution.
3. Utilisez la méthode run() pour exécuter l’action, le flux ou le flux secondaire avec les paramètres fournis et renvoyer un objet ScriptableFlowRunnerResult.

3. ScriptableFlowRunnerResult : récupérer les Studio de workflow détails de l’exécution

Utilisez une ou plusieurs méthodes telles que getContextId(),getOutputs() et getDomainId() pour afficher les détails de l’exécution.

Exemple

Cet exemple montre comment créer un objet générateur ScriptableFlowRunner et l’utiliser pour exécuter une action d’approbation sur un enregistrement spécifique. Un objet ScriptableFlowRunnerResult capture les arguments d’exécution et les sorties d’action.

(function() {
  try {

    var inputs = {}; 

    inputs['sys_id'] = '57af7aec73d423002728660c4cf6a71c';  // Pass the record's sys_id in as input.  

    var result = sn_fd.FlowAPI.getRunner()  // Create a ScriptableFlowRunner builder object.
      .action('global.markapproved')        // Run the global scope action named markapproved.
      .inForeground()
      .inDomain('TOP/ACME')                 // Run the action from the TOP/ACME domain.                               
      .withInputs(inputs)
      .run();                               // Run the action and return a FlowRunnerResult object.

    var contextId = result.getContextId();  // Retrieve the context ID from the result
    var dateRun = result.getDate();
    var domainUsed = result.getDomainId();  // Retrieve the Domain ID from the result.
    var flowName = result.getFlowObjectName();
    var flowObjectType = result.getFlowObjectType();

    var outputs = result.getOutputs();            // Retrieve any outputs from the action execution.
    var newApprovalStatus = outputs['approval'];  // Echo back the approval status for verification.
		
  } catch (ex) {
    var message = ex.getMessage();
    gs.error(message);
  }
	
})();
   

ScriptableFlowRunnerResult : debug()

Renvoie des informations sur le flux, le flux secondaire ou l’action exécuté, y compris l’ID de contexte, l’ID de domaine et les sorties d’exécution.

Tableau 1. Paramètres

Nom	Type	Description
Aucun

Tableau 2. Renvoie

Type

Description

Chaîne

Détails d’exécution sur l’exécution de l’action, du flux ou du Studio de workflow flux secondaire. Nom de l’objet de flux : nom du flux, du flux secondaire ou de l’action. Type d’objet de flux : flux, flux secondaire, action ou action de flux de données. ID de domaine : ID du domaine dans lequel le flux, le flux secondaire ou l’action s’est exécuté. result time : durée d’exécution. ID de contexte : Sys_id de l’enregistrement des détails de l’exécution Studio de workflow pour l’action, le flux ou le flux secondaire. Nombre de sorties : nombre de sorties d’action ou de flux secondaire.

Cet exemple montre comment récupérer des informations sur le flux, le flux secondaire ou l’action exécuté à partir de l’objet ScriptableFlowRunnerResult.

(function() {
  try {

    var result = sn_fd.FlowAPI.getRunner()
      .flow('global.test_flow')
      .inForeground()
      .timeout(12000)
      .run();

    gs.info(result.debug());

  } catch (ex) {
    var message = ex.getMessage();
    gs.error(message);
  }

})();

Sortie :

*** Script: FlowRunnerResult
Flow Object Name: global.test_flow
Flow Object Type: flow
Domain: null
Result Time: 2020-06-08 18:28:41
ContextId: null
Output count: 0

ScriptableFlowRunnerResult : getContextId()

Renvoie l’ID de contexte du flux, du flux secondaire ou de l’action.

Tableau 3. Paramètres

Nom	Type	Description
Aucun

Tableau 4. Renvoie

Type	Description
Chaîne	sys_id de l’enregistrement des détails de l’exécution Studio de workflow pour l’action, le flux ou le flux secondaire.

Cet exemple montre comment récupérer un ID de contexte à partir d’un objet ScriptableFlowRunnerResult.

var contextId = result.getContextId();

Sortie :

4ecead85c4da1110598d0c7d6bf73554

ScriptableFlowRunnerResult : getDate()

Renvoie la date et l’heure auxquelles une action, un flux ou un Studio de workflow flux secondaire s’est exécuté en tant qu’objet GlideDateTime.

Tableau 5. Paramètres

Nom	Type	Description
Aucun

Tableau 6. Renvoie

Type	Description
GlideDateTime	Date et heure d’exécution du flux, du flux secondaire ou de l’action.

Cet exemple montre comment récupérer la date et l’heure d’exécution d’un flux à partir d’un objet ScriptableFlowRunnerResult.

(function() {
  try {

    var result = sn_fd.FlowAPI.getRunner()
      .flow('global.test_flow')
      .inForeground()
      .timeout(12000)
      .run();

    gs.info(result.getDate());

  } catch (ex) {
    var message = ex.getMessage();
    gs.error(message);
  }

})();

Sortie :

2020-05-22 18:45:42

ScriptableFlowRunnerResult : getDataStream()

Renvoie le flux de données à partir d’une action de flux de données.

Si la méthode datastream() a été utilisée dans la classe du générateur ScriptableFlowRunner , cela renvoie le flux de données en tant qu’objet ScriptableDataStream. Utilisez la classe ScriptableDataStream pour itérer sur les éléments du flux. Consultez ScriptableDataStream.

Pour plus d’informations sur les actions de flux de données, consultez Actions de flux de données et pagination.

Tableau 7. Paramètres

Nom	Type	Description
Aucun

Tableau 8. Renvoie

Type	Description
ScriptableDataStream	Un objet ScriptableDataStream que vous pouvez utiliser pour itérer entre les éléments d’un flux de données. Utilisez les méthodes de la classe ScriptableDataStream pour interagir avec cet objet. Consultez ScriptableDataStream.

Cet exemple montre comment récupérer un flux de données à partir d’un objet ScriptableFlowRunnerResult.

var datastream = result.getDataStream();

ScriptableFlowRunnerResult : getDomainId()

Renvoie la sys_id du domaine dans lequel l’action, le flux ou le flux secondaire s’est Studio de workflow exécuté.

Tableau 9. Paramètres

Nom	Type	Description
Aucun

Tableau 10. Renvoie

Type	Description
Chaîne	sys_id du domaine dans lequel l’action, le flux ou le flux secondaire s’est Studio de workflow exécuté.

Cet exemple montre comment récupérer un ID de domaine à partir d’un objet ScriptableFlowRunnerResult.

(function() {
  try {

    var result = sn_fd.FlowAPI.getRunner()
      .flow('global.test_flow')
      .inForeground()
      .inDomain('TOP/ACME')
      .timeout(12000)
      .run();

    gs.info(result.getDomainId());

  } catch (ex) {
    var message = ex.getMessage();
    gs.error(message);
  }

})();

Sortie :

4ecead85a4da1110598d0c7d6bf75554

ScriptableFlowRunnerResult : getFlowObjectType()

Renvoie le type d’exécution d’objet Studio de workflow .

Tableau 11. Paramètres

Nom	Type	Description
Aucun

Tableau 12. Renvoie

Type	Description
Type d’objet de flux	Type d’exécution d’objet Studio de workflow , qui est action, flux ou flux secondaire.

Cet exemple montre comment récupérer le type d’objet de flux à partir de l’API ScriptableFlowRunnerResult .

(function() {
  try {

    var result = sn_fd.FlowAPI.getRunner()
      .flow('global.test_flow')
      .inForeground()
      .timeout(12000)
      .run();

    gs.info(result.getFlowObjectType());

  } catch (ex) {
    var message = ex.getMessage();
    gs.error(message);
  }

})();

Sortie :

flow

ScriptableFlowRunnerResult : getFlowObjectName()

Renvoie le champ d’application et le nom interne de l’exécution, du Studio de workflow flux ou du flux secondaire.

Tableau 13. Paramètres

Nom	Type	Description
Aucun

Tableau 14. Renvoie

Type	Description
Chaîne	Champ d’application et nom interne de l’exécution de l’action, du flux ou du Studio de workflow flux secondaire. Par exemple, global.emailflow.

Cet exemple montre comment récupérer le nom du flux, du flux secondaire ou de l’action à partir d’un objet ScriptableFlowRunnerResult.

(function() {
  try {

    var result = sn_fd.FlowAPI.getRunner()
      .flow('global.test_flow')
      .inForeground()
      .timeout(12000)
      .run();

    gs.info(result.getFlowObjectName());

  } catch (ex) {
    var message = ex.getMessage();
    gs.error(message);
  }

})();

Sortie :

global.test_flow

ScriptableFlowRunnerResult : getOutputs()

Renvoie les sorties d’une action, d’un flux ou d’un flux secondaire terminé Studio de workflow .

Tableau 15. Paramètres

Nom	Type	Description
Aucun

Tableau 16. Renvoie

Type	Description
Objet	Objet contenant la sortie d’une action, d’un flux ou d’un flux secondaire terminé Studio de workflow .

Cet exemple montre comment récupérer les sorties d’une exécution, d’un flux ou d’un Studio de workflow flux secondaire avec l’API ScriptableFlowRunner .

(function() {
  try {

    var result = sn_fd.FlowAPI.getRunner()
      .action('global.test_action')
      .inForeground()
      .timeout(12000)
      .run();

    gs.info(result.getOutputs());

  } catch (ex) {
    var message = ex.getMessage();
    gs.error(message);
  }

})();

Sortie :

Flow Designer: Warning. This is an important log message.