GlideFlow : client

L’API GlideFlow fournit des méthodes pour les interactions côté client avec des actions, des flux et des flux secondaires.

Vous pouvez utiliser cette API avec des expériences d’interface utilisateur classiques ServiceNow AI Platform qui acceptent les scripts clients. L’action, le flux ou le flux secondaire doit être défini comme pouvant être appelé par le client et disposer d’une ACL valide à l’aide de la fonction Gérer la sécurité dans Studio de workflow.

Remarque :

Cet APi est incompatible avec l’interface Expérience d'espace de travail utilisateur.

Certaines des méthodes de l’API GlideFlow renvoient des objets de promesse . Une promesse représente le résultat final d’une opération asynchrone. Pour plus d’informations sur les promesses, consultez la documentation Promise - Javascript MDN ou AngularJS.

À l’aide de cette API, vous pouvez :

• Démarrez des actions, des flux ou des flux secondaires via un script.
• Récupérer une exécution existante.
• Obtenez l’état et toutes les sorties disponibles.
• Attendez l’achèvement d’une action, d’un flux ou d’un flux secondaire.

Il n’existe pas de constructeur pour l’API GlideFlow . Accédez aux méthodes GlideFlow à l’aide de l’objet global GlideFlow .

GlideFlow : execution.awaitCompletion()

Renvoie un objet d’achèvement pour l’exécution.

Tableau 1. Paramètres

Nom	Type	Description
Néant

Tableau 2. Renvoie

Type	Description
Objet	Objet qui contient les détails d’achèvement d’une exécution de flux ou d’action.

Dans cet exemple, une action est exécutée à l’aide de startAction(), qui renvoie un objet d’exécution. Le code utilise ensuite awaitCompletion() sur cet objet d’exécution, qui renvoie un objet de complétion. Le code utilise cet objet de complétion pour consigner l’état et les sorties au sein de l’exécution.

(function() {
	var inputs = {};

	inputs['input1'] = 'string input'; // String

	GlideFlow.startAction('global.action_name', inputs)
		.then(function(execution) {
			return execution.awaitCompletion();
		}, errorResolver)
		.then(function(completion) {
			var status = completion.status;
			console.log(status);

			// Available Outputs:
			var outputs = completion.outputs;
			console.log(outputs);
		}, errorResolver());

	function errorResolver(error) {
		// Handle errors in error resolver
		console.error(error);
	}
})();

GlideFlow : execution.getExecutionStatus()

Renvoie une chaîne contenant l’état d’exécution de l’exécution actuelle.

Tableau 3. Paramètres

Nom	Type	Description
Néant

Tableau 4. Renvoie

Type	Description
Chaîne	Chaîne contenant le statut d’exécution.

Dans cet exemple, le code obtient un objet d’exécution à l’aide de la méthode getExecution. La méthode getExecution nécessite un ID, qui est renvoyé par la méthode utilisée pour démarrer l’exécution. Le code utilise ensuite getExecutionStatus() pour déterminer si l’exécution a été terminée avant de continuer.

// Get an existing action, getStatus, and getOutputs if complete
(function() {
   GlideFlow.getExecution('mamIN4Q35vmEFe744EwJV5GHrSz8fmJG')
      .then(function(execution) {
         execution.getExecutionStatus().then(
            function(status) {
               if (status === 'COMPLETE')
                  execution.getOutputs().then(
                     function(outputs) {
                        console.log(outputs);
                     },
                     errorResolver
                  );
            },
            errorResolver
         );
      }, errorResolver);

   function errorResolver(error) {
      // Handle errors in error resolver
      console.error(error);
   }
})();

GlideFlow : execution.getOutputs()

Renvoie un objet de sorties pour l’exécution.

Utilisez cette méthode pour accéder à la sortie générée par l’exécution d’une action, d’un flux ou d’un flux secondaire.

Tableau 5. Paramètres

Nom	Type	Description
Néant

Tableau 6. Renvoie

Type	Description
Objet	Objet contenant des sorties pour une action, un flux ou un flux secondaire.

Dans cet exemple, le code obtient un objet d’exécution à l’aide de la méthode getExecution. Une fois l’exécution terminée, le code utilise getOutputs() pour renvoyer un objet outputs, qu’il journalise ensuite à l’aide de la méthode console.log.

// Get an existing action, getStatus, and getOutputs if complete
(function() {
   GlideFlow.getExecution('mamIN4Q35vmEFe744EwJV5GHrSz8fmJG')
      .then(function(execution) {
         execution.getExecutionStatus().then(
            function(status) {
               if (status === 'COMPLETE')
                  execution.getOutputs().then(
                     function(outputs) {
                        console.log(outputs);
                     },
                     errorResolver
                  );
            },
            errorResolver
         );
      }, errorResolver);

   function errorResolver(error) {
      // Handle errors in error resolver
      console.error(error);
   }
})();

GlideFlow : getExecution(chaîne executionId)

Obtenez une instance d’exécution existante par ID.

Tableau 7. Paramètres

Nom	Type	Description
executionId	Chaîne	L’ID de l’exécution à récupérer.

Tableau 8. Renvoie

Type	Description
Objet	Promesse d’un objet d’exécution.

Dans cet exemple, le code obtient une exécution, puis attend qu’elle soit terminée avant d’enregistrer l’état d’achèvement des exécutions et des sorties à l’aide de console.log.

// Get an existing action and await completion
(function() {
	GlideFlow.getExecution('79cd437e0b202300a150a95e93673ae3')
		.then(function(execution) {
			return execution.awaitCompletion();
		}, errorResolver)
		.then(function(completion) {

			var status = completion.status;
			console.log(status);

			// Available Outputs:
			var outputs = completion.outputs;
			console.log(outputs);
		}, errorResolver());

	function errorResolver(error) {
		// Handle errors in error resolver
		console.error(error);
	}
})();

GlideFlow : startAction(Chaîne scopedName.actionName, entrées de carte)

Démarrez une action.

Tableau 9. Paramètres

Nom	Type	Description
scopedName	Chaîne	Nom inclus dans le périmètre du flux à exécuter.
entrées	Objet	Objet contenant les entrées définies pour l’action.

Tableau 10. Renvoie

Type	Description
Objet	Objet contenant des détails sur l’exécution de l’action.

Dans cet exemple, le code démarre l’action de action_name globale à l’aide d’arguments dans la variable d’objet d’entrée des entrées. Une fois l’opération terminée, l’exemple utilise console.log ou console.error pour rendre compte de la réussite ou de l’échec du flux.

// Start an action and await completion.
(function() {
	var inputs = {};

	inputs['input1'] = 'string input'; // String

	GlideFlow.startAction('global.action_name', inputs)
		.then(function(execution) {
			return execution.awaitCompletion();
		}, errorResolver)
		.then(function(completion) {
			var status = completion.status;
			console.log(status);

			// Available Outputs:
			var outputs = completion.outputs;
			console.log(outputs);
		}, errorResolver());

	function errorResolver(error) {
		// Handle errors in error resolver
		console.error(error);
	}
})();

GlideFlow : startFlow(Chaîne scopedName.flowName, entrées de carte)

Démarrez un flux.

Tableau 11. Paramètres

Nom	Type	Description
scopedName	Chaîne	Nom inclus dans le périmètre du flux à exécuter.
entrées	Objet	Objet contenant des entrées définies pour le flux.

Tableau 12. Renvoie

Type	Description
Objet	Objet contenant des détails sur l’exécution du flux.

Cet exemple de flux est normalement déclenché lorsqu’un enregistrement de la table d’incidents est mis à jour. Étant donné que vous activez le flux à partir du script client, vous devez fournir ces informations. Le code crée une variable d’entrée qui contient l’enregistrement actuel et la table associée à l’enregistrement

// Start a Flow
(function() {
      var inputs = {};
      inputs['current'] = { // GlideRecord 
        table : 'incident', 
        sys_id : '79cd437e0b202300a150a95e93673ae3'  
    };
        inputs['table_name'] = 'incident';
         GlideFlow.startFlow('global.flow_name', inputs)
		.then(
			function(execution) {
				console.log('Started flow_name with execution id :' + execution.getExecutionId());
			},
			function(error) {
				console.log('Unable to start flow: ' + error);
			}
		);
})();

GlideFlow : startSubflow(Chaîne scopedName.subflowName, entrées de carte)

Démarrez un flux secondaire.

Tableau 13. Paramètres

Nom	Type	Description
scopedName	Chaîne	Nom inclus dans le périmètre du flux à exécuter.
entrées	Objet	Objet contenant les entrées utilisées pour le flux secondaire.

Tableau 14. Renvoie

Type	Description
Objet	Objet contenant des détails sur l’exécution du flux secondaire.

Dans cet exemple, le code démarre le flux secondaire de subflow_name global à l’aide des arguments de la variable de tableau d’entrées. Une fois l’opération terminée, l’exemple utilise console.log ou console.error pour rendre compte de la réussite ou de l’échec du flux.

// Start an action and await completion.
(function() {
	var inputs = {};

	inputs['input1'] = 'string input'; // String

	GlideFlow.startSubflow('global.subflow_name', inputs)
		.then(function(execution) {
			return execution.awaitCompletion();
		}, errorResolver)
		.then(function(completion) {
			var status = completion.status;
			console.log(status);

			// Available Outputs:
			var outputs = completion.outputs;
			console.log(outputs);
		}, errorResolver());

	function errorResolver(error) {
		// Handle errors in error resolver
		console.error(error);
	}
})();