FlowAPI - Inclus dans le périmètre, global
FlowAPI fournit des méthodes pour exécuter des actions, des flux ou des flux secondaires dans des scripts côté serveur à l’aide de méthodes bloquantes ou non.
Accédez aux méthodes FlowAPI dans les scripts globaux et inclus dans le champ d’application à l’aide de l’espace de noms sn_fd . Créez des appels à vos flux à l’aide de l’action Extrait de code dans Concepteur de flux ou utilisez les méthodes détaillées ici pour mettre à jour les scripts manuellement.
Remarque :
Dans les instances séparées par domaine, les flux, les flux secondaires et les actions déclenchés par cette API s’exécutent dans le domaine de l’utilisateur qui a démarré le script. Par exemple, si un utilisateur du domaine ACME démarre un script qui déclenche un flux, le flux s’exécute dans le domaine ACME et ne peut accéder qu’aux données ACME, même si le flux s’exécute en tant qu’utilisateur système.
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.
FlowAPI : annuler (String contextId, String reason)
Annule un flux, un flux secondaire ou une action en pause ou en cours d’exécution.
| Nom | Type | Description |
|---|---|---|
| contextId | Chaîne | Sys_id de l’enregistrement des détails de l’exécution pour le flux, le flux secondaire ou l’action. Accédez aux détails de l’exécution en accédant à l’onglet Exécutions de flux dans Concepteur de flux, ou transmettez la sys_id de l’enregistrement de contexte renvoyé par les méthodes startFlow(),startSubflow() ou startAction( ). Remarque : Il peut y avoir un léger délai lors de l’annulation si le contexte cible est en cours d’exécution sur un autre nœud de l’instance. Les contextes s’exécutant sur le même nœud sont immédiatement annulés. Les contextes s’exécutant sur un autre nœud doivent d’abord attendre que l’annulation soit transférée au nœud approprié. |
| motif | Chaîne | Facultatif. Motif d’annulation du flux, du flux secondaire ou de l’action. S’affiche dans le champ Message de la table des entrées de journal du moteur de flux [sys_flow_log]. |
| Type | Description |
|---|---|
| nul |
Cet exemple utilise la valeur de retour de la méthode startFlow() pour annuler tous les flux de longue durée.
(function() {
var now_GR = new GlideRecord('incident');
now_GR.addQuery('number', 'INC0000050');
now_GR.query();
now_GR.next();
try {
var inputs = {};
inputs['current'] = now_GR; // GlideRecord of table:
inputs['table_name'] = 'incident';
// Starts the flow asynchronously.
var result = sn_fd.FlowAPI.getRunner()
.flow('global.myFlow')
.inBackground()
.withInputs(inputs)
.run();
var contextId = result.getContextId();
var dateRun = result.getDate();
var domainUsed = result.getDomainId();
var flowName = result.getFlowObjectName();
var flowObjectType = result.getFlowObjectType();
} catch (ex) {
var message = ex.getMessage();
gs.error(message);
}
})();
// Call the cancel() method using the context Id returned from the startFlow() method
sn_fd.FlowAPI.cancel(contextId, 'Flow took too long to execute.');Cet exemple annule tous les flux nommés Flux de test.
var now_GR = new GlideRecord("sys_flow_context");
now_GR.addQuery("name", "Test Flow");
now_GR.query();
while (now_GR.next()) {
sn_fd.FlowAPI.cancel(now_GR.getUniqueValue(), 'Canceling Test Flows');
} FlowAPI : executeAction(nom de chaîne, entrées de carte, délai d’expiration du numéro)
Exécute une action à partir d’un script côté serveur de manière synchrone.
Exécutez une action à partir d’une règle métier, d’un script include ou de tout autre script côté serveur. Les actions exécutées à l’aide de cette méthode s’exécutent de façon synchrone, de sorte que la méthode a accès aux sorties créées par l’action. Utilisez startAction pour exécuter une action de manière asynchrone.
Remarque :
Cette API est remplacée par ScriptableFlowRunner : inclus dans le périmètre, qui déconseille les méthodes existantes utilisées pour créer des objets et exécuter Concepteur de flux des flux et des actions. Utilisez la méthode getRunner() dans la classe FlowAPI pour renvoyer un objet ScriptableFlowRunner et utilisez les méthodes associées. Utilisez les méthodes ScriptableFlowRunner si vous devez prendre en charge Domain Separation.
Remarque :
Cette méthode exécute l’action en tant qu’utilisateur qui initie la session.
| Nom | Type | Description |
|---|---|---|
| nom | Chaîne | Périmètre et nom de l’action à exécuter, par exemple global.action_name. |
| entrées | Carte | Paires nom-valeur qui définissent les entrées d’action. Utilisez le nom de l’entrée, pas l’étiquette d’entrée. |
| timeout | Numéro | Facultatif. Délai d’expiration en millisecondes. Cette valeur remplace le délai d’expiration par défaut de 30 secondes spécifié par la com.glide.hub.flow_api.default_execution_time propriété système. Une fois le délai d’expiration expiré, une exception est levée. |
| Type | Description |
|---|---|
| Objet | Les résultats de l’action. |
Dans cet exemple, le script utilise sn_fd. FlowAPI.executeAction pour exécuter une action appelée actionforpassword2test dans le champ d’application global. Une variable appelée « entrées » contient les entrées de l’action. Dans ce cas, un nom et un mot de passe. Les sorties de l’action sont stockées dans la variable outputs, qui dans ce cas, est un objet de mot de passe chiffré. Le code est encapsulé dans une instruction try/catch pour capturer toutes les erreurs qui peuvent se produire lors de l’exécution du flux.
(function() {
try {
var inputs = {};
inputs['name'] = ; // String
inputs['password2'] = ; // Password (2 Way Encrypted)
// Execute Synchronously: Run in foreground. Code snippet has access to outputs.
// var timeout = ; //timeout in ms
//sn_fd.FlowAPI.executeAction('global.actionforpassword2test', inputs, timeout)
var outputs = sn_fd.FlowAPI.executeAction('global.actionforpassword2test', inputs);
// Get Outputs:
// Note: outputs can only be retrieved when executing synchronously.
var output = outputs['output']; // Password (2 Way Encrypted)
} catch (ex) {
var message = ex.getMessage();
gs.error(message);
}
})();FlowAPI : executeActionQuick(nom de chaîne, entrées de carte, délai d’expiration du numéro)
exécuter une action à partir d’un script côté serveur de façon synchrone à partir de la session utilisateur actuelle sans créer de détails d’exécution ou d’autres enregistrements connexes. Améliorez les performances en éliminant les frais généraux liés à la tenue des dossiers. Utilisez cette API pour augmenter la vitesse de traitement de gros volumes, par exemple plusieurs exécutions par seconde, dans un environnement de production.
- Rapports et enregistrements générés
- Cette méthode ne crée pas de détails d’exécution ni d’enregistrements de contexte, quels que soient les Concepteur de flux paramètres.
- Support d’attente
- Cette méthode ne prend pas en charge la mise en pause de l’action en attente des conditions. Les étapes qui s’interrompent pour des conditions d’attente telles que Demander l’approbation ou Attendre une condition ne sont pas prises en charge.
- Prise en charge du MID Server
- Cette méthode ne prend pas en charge la mise en pause d’une action à exécuter à partir d’un MID Server.
Remarque :
Cette API est remplacée par ScriptableFlowRunner : inclus dans le périmètre, qui déconseille les méthodes existantes utilisées pour créer des objets et exécuter Concepteur de flux des flux et des actions. Utilisez la méthode getRunner() dans la classe FlowAPI pour renvoyer un objet ScriptableFlowRunner et utilisez les méthodes associées. Utilisez les méthodes ScriptableFlowRunner si vous devez prendre en charge Domain Separation.
| Nom | Type | Description |
|---|---|---|
| nom | Chaîne | Périmètre et nom interne de l’action à exécuter. Par exemple, global.action_name. Localisez le champ Nom interne dans la liste des Concepteur de flux actions. |
| entrées | Carte | Paires nom-valeur qui définissent les entrées d’action. Vous pouvez trouver les entrées d’action disponibles et les types de données requis sous Entrées dans le plan d’action. Utilisez le nom de l’entrée, pas l’étiquette d’entrée. Par exemple, {'table' :'incident','sys_id' :'a39d8e3cf0212300964feeefe80ff0ed'}. |
| timeout | Numéro | Facultatif. Délai d’expiration en millisecondes. Cette valeur remplace le délai d’expiration par défaut de 30 secondes spécifié par la com.glide.hub.flow_api.default_execution_time propriété système. Une fois le délai d’expiration expiré, une exception est levée. |
| Type | Description |
|---|---|
| Objet | Objet contenant des sorties définies par l’action. Vous pouvez trouver les sorties de l’action sous Sorties dans le plan d’action. |
(function() {
try {
var grIncident = new GlideRecord('incident');
grIncident.get('57af7aec73d423002728660c4cf6a71c');
var inputs = {};
inputs['variable'] = grIncident;
var outputs = sn_fd.FlowAPI.executeActionQuick('global.update_record_test', inputs);
// Get Outputs:
// Note: outputs can only be retrieved when executing synchronously.
var output1 = outputs['output1'];
} catch (ex) {
var message = ex.getMessage();
gs.error(message);
}
})();FlowAPI : executeDataStreamAction(nom de chaîne, entrées de carte, délai d’expiration du numéro)
Exécute une action de flux de données de manière synchrone à partir d’un script côté serveur et renvoie un objet ScriptableDataStream.
Pour plus d’informations sur les actions de flux de données, consultez Actions et pagination de flux de données.
Remarque :
Cette API est remplacée par ScriptableFlowRunner : inclus dans le périmètre, qui déconseille les méthodes existantes utilisées pour créer des objets et exécuter Concepteur de flux des flux et des actions. Utilisez la méthode getRunner() dans la classe FlowAPI pour renvoyer un objet ScriptableFlowRunner et utilisez les méthodes associées. Utilisez les méthodes ScriptableFlowRunner si vous devez prendre en charge Domain Separation.
Remarque :
Enveloppez toujours la logique de flux de données dans un bloc
try/catch pour intercepter les erreurs. Incluez toujours une instruction finally qui se termine par la méthode close() de la classe ScriptableDataStream pour fermer le flux de données et éviter les problèmes de performances.| Nom | Type | Description |
|---|---|---|
| nom | Chaîne | Champ d’application et nom de l’action de flux de données à exécuter. Par exemple, global.data_stream_action_name. |
| entrées | Carte | Paires nom-valeur qui définissent les entrées d’action. Utilisez le nom de l’entrée, pas l’étiquette d’entrée. Si l’action n’a pas d’entrées, n’incluez pas ce paramètre. |
| timeout | Numéro | Facultatif. Durée avant que l’action n’expire. Une fois le délai d’expiration expiré, une exception est levée. Le délai d’expiration s’applique uniquement à la méthode executeDataStreamAction , et non aux méthodes de la classe ScriptableDataStream . Valeur par défaut : 30 000, spécifié par la com.glide.hub.flow_api.default_execution_time propriété système Unité : millisecondes |
| Type | Description |
|---|---|
| Flux de données scriptables | Objet utilisé pour itérer à travers les éléments du flux de données. Utilisez les méthodes de la classe ScriptableDataStream pour interagir avec cet objet. Consultez l’API ScriptableDataStream. |
Cet exemple crée un enregistrement d’incident pour chaque élément renvoyé dans le flux de données.
(function() {
try {
// Execute Data Stream Action.
var stream = sn_fd.FlowAPI.executeDataStreamAction('x_my_scope.data_stream_name');
// Process each item in the data stream
while (stream.hasNext()) {
// Get a single item from the data stream.
var item = stream.next();
// Use the item.
var now_GR = new GlideRecord('incident');
now_GR.setValue('number',item.id);
now_GR.setValue('short_description',item.name);
now_GR.insert();
// By default, this code snippet will terminate after 10 items.
// Remove or modify this limit after testing your code.
if (stream.getItemIndex() >= 9) {
break;
}
}
} catch (ex) {
var message = ex.getMessage();
gs.error(message);
} finally {
stream.close();
}
})();FlowAPI : executeFlow(nom de chaîne, entrées de carte, délai d’expiration du numéro)
Exécute un flux à partir d’un script côté serveur de façon synchrone.
Exécutez un flux à partir d’une règle métier, d’un script include ou de tout autre script côté serveur. Les flux s’exécutent à l’aide de cette méthode de façon synchrone. Utilisez startFlow pour exécuter un flux de manière asynchrone.
Remarque :
Cette API est remplacée par ScriptableFlowRunner : inclus dans le périmètre, qui déconseille les méthodes existantes utilisées pour créer des objets et exécuter Concepteur de flux des flux et des actions. Utilisez la méthode getRunner() dans la classe FlowAPI pour renvoyer un objet ScriptableFlowRunner et utilisez les méthodes associées. Utilisez les méthodes ScriptableFlowRunner si vous devez prendre en charge Domain Separation.
Remarque :
Cette méthode exécute le flux en tant qu’utilisateur spécifié dans les propriétés de flux.
| Nom | Type | Description |
|---|---|---|
| nom | Chaîne | Champ d’application et nom du flux à exécuter, par exemple global.flow_name. |
| entrées | Carte | Paires nom-valeur qui définissent les entrées de déclencheur. Utilisez le nom de l’entrée, pas l’étiquette d’entrée. |
| timeout | Numéro | Facultatif. Délai d’expiration en millisecondes. Cette valeur remplace le délai d’expiration par défaut de 30 secondes spécifié par la com.glide.hub.flow_api.default_execution_time propriété système. Une fois le délai d’expiration expiré, une exception est levée. |
| Type | Description |
|---|---|
| Néant | Un fonctionnement normal ne produit aucune valeur de retour. |
| Exception : | L’API lève une exception lorsqu’un flux appelé se met en pause de façon synchrone. L’exécution actuelle est à l’état En attente. Dans la plupart des cas, l’exception est supprimée lorsque le flux reprend. Toutefois, l’API ne peut pas reprendre un flux qui a été envoyé à un MID Server. |
Cet exemple utilise sn_fd. FlowAPI.executeFlow pour exécuter un flux global appelé test_flow. Ce flux est normalement déclenché lorsqu’un enregistrement de la table d’incidents est mis à jour. Étant donné que vous activez le flux à partir d’un script, vous devez fournir ces informations. Le code crée une variable d’entrée qui contient l’enregistrement actuel et la table de l’enregistrement. Le code est encapsulé dans une instruction try/catch pour capturer toutes les erreurs qui peuvent se produire lors de l’exécution du flux.
(function() {
try {
var inputs = {};
inputs['current'] = ; // GlideRecord of table:
inputs['table_name'] = 'incident';
// Execute Synchronously: Run in foreground.
// var timeout = ; //timeout in ms
//sn_fd.FlowAPI.executeFlow('global.test_flow', inputs, timeout)
sn_fd.FlowAPI.executeFlow('global.test_flow', inputs);
} catch (ex) {
var message = ex.getMessage();
gs.error(message);
}
})();FlowAPI : executeFlowQuick(nom de chaîne, entrées de carte, délai d’expiration du numéro)
Exécute un flux, un flux secondaire, une action ou une action de flux de données à partir d’un script côté serveur de manière synchrone ou asynchrone sans créer de détails d’exécution ou d’autres enregistrements connexes. Améliore les performances en éliminant les frais généraux liés à la tenue des dossiers. Utilisez cette API pour augmenter la vitesse de traitement de gros volumes, par exemple plusieurs exécutions par seconde, dans un environnement de production.
- Rapports et enregistrements générés
- Cette méthode ne crée pas de détails d’exécution ni d’enregistrements de contexte, quels que soient les Concepteur de flux paramètres.
- Exécuter en tant qu'utilisateur
- Cette méthode exécute le flux en tant qu’utilisateur qui initie la session. Il n’est pas possible de définir le flux pour qu’il s’exécute en tant qu’utilisateur système ou d’emprunter l’identité d’un utilisateur.
- Support d’attente
- Cette méthode ne prend pas en charge la mise en pause du flux pour attendre les conditions. Les actions ou la logique de flux qui s’interrompent dans des conditions d’attente telles que Demander l’approbation, Attendre une condition ou Attendre pendant une certaine durée ne sont pas prises en charge.
- Prise en charge du MID Server
- Cette méthode ne prend pas en charge la mise en pause d’un flux à exécuter à partir d’un MID Server.
Remarque :
Cette API est remplacée par ScriptableFlowRunner : inclus dans le périmètre, qui déconseille les méthodes existantes utilisées pour créer des objets et exécuter Concepteur de flux des flux et des actions. Utilisez la méthode getRunner() dans la classe FlowAPI pour renvoyer un objet ScriptableFlowRunner et utilisez les méthodes associées. Utilisez les méthodes ScriptableFlowRunner si vous devez prendre en charge Domain Separation.
| Nom | Type | Description |
|---|---|---|
| nom | Chaîne | Périmètre et nom interne du flux à exécuter. Par exemple, global.flow_name. Localisez le champ Nom interne dans la liste des Concepteur de flux flux. |
| entrées | Carte | Paires nom-valeur qui définissent les entrées de déclencheur. Vous pouvez trouver les entrées de déclencheur disponibles et les types de données requis dans la section Déclencheur du flux. Utilisez le nom de l’entrée, pas l’étiquette d’entrée. Par exemple, {'table' :'incident','sys_id' :'a39d8e3cf0212300964feeefe80ff0ed'}. |
| timeout | Numéro | Facultatif. Délai d’expiration en millisecondes. Cette valeur remplace le délai d’expiration par défaut de 30 secondes spécifié par la com.glide.hub.flow_api.default_execution_time propriété système. Une fois le délai d’expiration expiré, une exception est levée. |
| Type | Description |
|---|---|
| nul |
(function() {
try {
var grIncident = new GlideRecord('incident');
grIncident.get('ed92e8d173d023002728660c4cf6a7bc');
var inputs = {};
inputs['current'] = grIncident;
inputs['table_name'] = 'incident';
sn_fd.FlowAPI.executeFlowQuick('global.test_quick_flow', inputs);
} catch (ex) {
var message = ex.getMessage();
gs.error(message);
}
})();FlowAPI : executeSubflow(nom de chaîne, entrées de carte, délai d’expiration du numéro)
Exécute un flux secondaire à partir d’un script côté serveur de façon synchrone.
Exécutez un flux secondaire à partir d’une règle métier, d’un script include ou de tout autre script côté serveur. Les flux secondaires s’exécutent à l’aide de cette méthode et s’exécutent de façon synchrone. Utilisez startSubflow pour exécuter un flux secondaire de manière asynchrone.
Remarque :
Cette API est remplacée par ScriptableFlowRunner : inclus dans le périmètre, qui déconseille les méthodes existantes utilisées pour créer des objets et exécuter Concepteur de flux des flux et des actions. Utilisez la méthode getRunner() dans la classe FlowAPI pour renvoyer un objet ScriptableFlowRunner et utilisez les méthodes associées. Utilisez les méthodes ScriptableFlowRunner si vous devez prendre en charge Domain Separation.
Remarque :
Cette méthode exécute le flux en tant qu’utilisateur spécifié dans les propriétés de flux.
| Nom | Type | Description |
|---|---|---|
| nom | Chaîne | Champ d’application et nom du flux secondaire à exécuter, par exemple global.subflow_name. |
| entrées | Carte | Paires nom-valeur qui définissent les entrées de flux secondaire. Utilisez le nom de l’entrée, pas l’étiquette d’entrée. |
| timeout | Numéro | Facultatif. Délai d’expiration en millisecondes. Cette valeur remplace le délai d’expiration par défaut de 30 secondes spécifié par la com.glide.hub.flow_api.default_execution_time propriété système. Une fois le délai d’expiration expiré, une exception est levée. |
| Type | Description |
|---|---|
| Objet | Objet contenant les sorties de flux secondaire. |
| Exception : | L’API lève une exception lorsqu’un flux appelé se met en pause de façon synchrone. L’exécution actuelle est à l’état En attente. Dans la plupart des cas, l’exception est supprimée lorsque le flux reprend. Toutefois, l’API ne peut pas reprendre un flux qui a été envoyé à un MID Server. |
Dans cet exemple, le script utilise sn_fd. FlowAPI.executeSubflow pour exécuter un flux secondaire appelé subflowTest dans le champ d’application global. Une variable appelée « entrées » contient les entrées du flux secondaire. Dans ce cas, un nom et un mot de passe. Le code est encapsulé dans une instruction try/catch pour capturer toutes les erreurs qui peuvent se produire lors de l’exécution du flux.
(function() {
try {
var inputs = {};
inputs['name'] = ; // String
inputs['password2'] = ; // Password (2 Way Encrypted)
// Execute Synchronously: Run in foreground.
// var timeout = ; //timeout in ms
//sn_fd.FlowAPI.executeSubflow('global.subflowTest', inputs, timeout)
var outputs = sn_fd.FlowAPI.executeSubflow('global.subflowTest', inputs);
} catch (ex) {
var message = ex.getMessage();
gs.error(message);
}
})();FlowAPI : executeSubflowQuick(nom de chaîne, entrées de carte, délai d’expiration du numéro)
Exécuter un flux secondaire à partir d’un script côté serveur de façon synchrone à partir de la session utilisateur actuelle sans créer de détails d’exécution ou d’autres enregistrements connexes. Améliorez les performances en éliminant les frais généraux liés à la tenue des dossiers. Utilisez cette API pour augmenter la vitesse de traitement de gros volumes, par exemple plusieurs exécutions par seconde, dans un environnement de production.
- Rapports et enregistrements générés
- Cette méthode ne crée pas de détails d’exécution ni d’enregistrements de contexte, quels que soient les Concepteur de flux paramètres.
- Exécuter en tant qu'utilisateur
- Cette méthode exécute le flux en tant qu’utilisateur qui initie la session. Il n’est pas possible de définir le flux pour qu’il s’exécute en tant qu’utilisateur système ou d’emprunter l’identité d’un utilisateur.
- Support d’attente
- Cette méthode ne prend pas en charge la mise en pause du flux pour attendre les conditions. Les actions ou la logique de flux qui s’interrompent dans des conditions d’attente telles que Demander l’approbation, Attendre une condition ou Attendre pendant une certaine durée ne sont pas prises en charge.
- Prise en charge du MID Server
- Cette méthode ne prend pas en charge la mise en pause d’un flux à exécuter à partir d’un MID Server.
Remarque :
Cette API est remplacée par ScriptableFlowRunner : inclus dans le périmètre, qui déconseille les méthodes existantes utilisées pour créer des objets et exécuter Concepteur de flux des flux et des actions. Utilisez la méthode getRunner() dans la classe FlowAPI pour renvoyer un objet ScriptableFlowRunner et utilisez les méthodes associées. Utilisez les méthodes ScriptableFlowRunner si vous devez prendre en charge Domain Separation.
| Nom | Type | Description |
|---|---|---|
| nom | Chaîne | Périmètre et nom interne du flux secondaire à exécuter. Par exemple, global.subflow_name. Localisez le champ Nom interne dans la liste des Concepteur de flux flux secondaires. |
| entrées | Carte | Paires nom-valeur qui définissent les entrées de flux secondaire. Vous pouvez trouver les entrées de flux secondaire disponibles et les types de données requis sous Entrées dans le flux secondaire. Utilisez le nom de l’entrée, pas l’étiquette d’entrée. Par exemple, {'table' :'incident','sys_id' :'a39d8e3cf0212300964feeefe80ff0ed'}. |
| timeout | Numéro | Facultatif. Délai d’expiration en millisecondes. Cette valeur remplace le délai d’expiration par défaut de 30 secondes spécifié par la com.glide.hub.flow_api.default_execution_time propriété système. Une fois le délai d’expiration expiré, une exception est levée. |
| Type | Description |
|---|---|
| Objet | Objet contenant des sorties définies par le flux secondaire. Vous pouvez trouver les sorties du flux secondaire sous Entrées et sorties de flux secondaire dans le plan du flux secondaire. |
(function() {
try {
var grIncident = new GlideRecord('incident');
grIncident.get('57af7aec73d423002728660c4cf6a71c');
var inputs = {};
inputs['variable'] = grIncident;
var outputs = sn_fd.FlowAPI.executeSubflowQuick('global.test_quick_run_subflow', inputs);
// Get Outputs:
// Note: outputs can only be retrieved when executing synchronously.
var output1 = outputs['output1'];
} catch (ex) {
var message = ex.getMessage();
gs.error(message);
}
})();FlowAPI : getErrorMessage(String contextId)
Renvoie les messages d’erreur produits par un flux, un flux secondaire ou une action. Cette méthode ne peut pas renvoyer de messages à partir de flux, de flux secondaires ou d’actions exécutés avec l’API quick().
| Nom | Type | Description |
|---|---|---|
| contextId | Chaîne | La sys_id du flux, du flux secondaire ou de l’action dont vous souhaitez obtenir les messages d’erreur. |
| Type | Description |
|---|---|
| Chaîne | La dernière opération exécutée et le message d’erreur qu’elle a produit. |
Cet exemple démarre un flux secondaire global appelé test_error_subflow et renvoie tous les messages d’erreur qu’il génère. Normalement, un seul script n’exécute pas un flux et n’obtient pas ses messages d’erreur. En règle générale, il s’agit d’un autre script ou d’un autre script ayant Concepteur de flux déjà exécuté le flux. Le code est encapsulé dans une instruction try/catch pour capturer toutes les erreurs qui peuvent se produire lors de l’exécution du flux.
(function() {
try {
// Gather inputs to call flow
var inputs = {};
inputs['ah_task'] = myTaskRecord; // GlideRecord of table: task
inputs['ah_comment'] ='Test Comment' ; // String
// Call flow with known errors
var contextId = sn_fd.FlowAPI.startSubflow('global.test_error_subflow', inputs);
// Get flow error message
var errormsg = sn_fd.FlowAPI.getErrorMessage(contextId);
return errormsg;
} catch (ex) {
var message = ex.getMessage();
gs.error(message);
}
})();
Sortie :
Operation (test_error_flow.574033f6db6811102166e2291396199f.274073f6db6811102166e22913961908.0be0d916c31332002841b63b12d3ae13) failed with error: com.snc.process_flow.exception.OpException: Value of field record is not a GlideRecord
at com.snc.process_flow.operation.FieldValue.getGlideRecord(FieldValue.java:145)
at com.snc.process_flow.operation.CRUDOperation.getInputValidGlideRecord(CRUDOperation.java:54)
at com.snc.process_flow.operation.RecordDeleteOperation.run(RecordDeleteOperation.java:26)
at com.snc.process_flow.engine.Operation.execute(Operation.java:212)
at com.snc.process_flow.engine.restricted_caller_access.ExecuteWithCallerAccessTracking.executeWithMetaStack(ExecuteWithCallerAccessTracking.java:31)
at com.snc.process_flow.engine.ProcessEngine.executeOps(ProcessEngine.java:570)
at com.snc.process_flow.engine.ProcessEngine.runInternal(ProcessEngine.java:476)
at com.snc.process_flow.engine.ProcessEngine.run(ProcessEngine.java:462)
at com.snc.process_flow.engine.ProcessAutomation.run(ProcessAutomation.java:86)
at com.snc.process_flow.engine.GlideProcessAutomation.runSync(GlideProcessAutomation.java:155)
at com.snc.process_flow.engine.GlideProcessAutomation.runWithDomain(GlideProcessAutomation.java:270)
at com.snc.process_flow.engine.GlideProcessAutomation.lambda$runAsUserSync$1(GlideProcessAutomation.java:237)
at com.snc.process_flow.engine.PFSessionClone.run(PFSessionClone.java:70)
at com.snc.process_flow.engine.GlidePFSession.runPlanAsUserSession(GlidePFSession.java:42)
at com.snc.process_flow.engine.GlideProcessAutomation.runAsUserSync(GlideProcessAutomation.java:235)
at com.snc.process_flow.engine.GlideProcessAutomation.messageFlow(GlideProcessAutomation.java:330)
at com.snc.process_flow.engine.GlideProcessAutomation.messageFlow(GlideProcessAutomation.java:309)
at com.snc.process_flow.engine.ProcessHubEventHandler.doSendMessage(ProcessHubEventHandler.java:475)
at com.snc.process_flow.engine.ProcessHubEventHandler.process(ProcessHubEventHandler.java:119)
at com.snc.process_flow.engine.ProcessHubEventHandler.process(ProcessHubEventHandler.java:91)
at com.snc.process_flow.engine.FlowEventManager.processEvents(FlowEventManager.java:122)
at com.glide.job.EventHandlerJob.execute(EventHandlerJob.java:38)
at com.glide.schedule.JobExecutor.lambda$executeJob$0(JobExecutor.java:129)
at com.snc.db.data_replicate.replicator.DataReplicationAdvisors.runInOriginatorContext(DataReplicationAdvisors.java:73)
at com.glide.schedule.JobExecutor.lambda$inDataReplicationContext$2(JobExecutor.java:159)
at com.glide.schedule.JobExecutor.executeJob(JobExecutor.java:132)
at com.glide.schedule.JobExecutor.execute(JobExecutor.java:116)
at com.glide.schedule_v2.SchedulerWorkerThread.executeJob(SchedulerWorkerThread.java:338)
at com.glide.schedule_v2.SchedulerWorkerThread.lambda$process$0(SchedulerWorkerThread.java:220)
at com.glide.worker.TransactionalWorkerThread.executeInTransaction(TransactionalWorkerThread.java:35)
at com.glide.schedule_v2.SchedulerWorkerThread.process(SchedulerWorkerThread.java:220)
at com.glide.schedule_v2.SchedulerWorkerThread.run(SchedulerWorkerThread.java:101)FlowAPI : getFlowStages(String scopedFlowName)
Renvoie une chaîne JSON contenant la liste des étapes du flux.
| Nom | Type | Description |
|---|---|---|
| scopedFlowName (en anglais seulement) | Chaîne | Le périmètre de l’application et le nom du flux dont vous souhaitez obtenir les étapes. |
| Type | Description |
|---|---|
| Chaîne | Chaîne au format JSON qui répertorie les étapes du flux par leurs valeurs d’enregistrement d’étape. |
Cet exemple montre l’obtention des étapes pour le flux de demande d’élément de Service Catalog.
(function() {
try {
// Name of flow with stages
var flowName = "service_catalog_item_request";
// Get flow stages
var flowStages = sn_fd.FlowAPI.getFlowStages(flowName);
//Print JSON as info message
gs.info(flowStages);
return flowStages;
} catch (ex) {
var message = ex.getMessage();
gs.error(message);
}
})();
Sortie :
La chaîne JSON contient des paires nom-valeur pour un champ d’étape. Consultez pour plus d'informations.
[
{
"label": "Manager Approval",
"value": "manager_approval",
"type": "standard",
"duration": "1970-01-03 00:00:00",
"states": {
"pending": "Pending - has not started",
"inprogress": "In progress",
"skipped": "Skipped",
"complete": "Completed",
"error": "Error"
},
"flow": "30f3d26187e92300e0ef0cf888cb0b91",
"alwaysShow": true,
"order": 0
},
{
"label": "Set current stage state to: [Error]",
"value": "Set current stage state to: [Error]",
"type": "error",
"duration": "1970-01-01 00:00:00",
"states": {
"pending": "Pending - has not started",
"inprogress": "In progress",
"skipped": "Skipped",
"complete": "Completed",
"error": "Error"
},
"flow": "30f3d26187e92300e0ef0cf888cb0b91",
"alwaysShow": false,
"order": 0
},
{
"label": "Dept. Head Approval",
"value": "Dept. Head Approval",
"type": "standard",
"duration": "1970-01-03 00:00:00",
"states": {
"pending": "Pending - has not started",
"inprogress": "In progress",
"skipped": "Skipped",
"complete": "Completed",
"error": "Error"
},
"flow": "30f3d26187e92300e0ef0cf888cb0b91",
"alwaysShow": true,
"order": 1
},
{
"label": "CIO Approval",
"value": "CIO Approval",
"type": "standard",
"duration": "1970-01-03 00:00:00",
"states": {
"pending": "Pending - has not started",
"inprogress": "In progress",
"skipped": "Skipped",
"complete": "Completed",
"error": "Error"
},
"flow": "30f3d26187e92300e0ef0cf888cb0b91",
"alwaysShow": true,
"order": 2
},
{
"label": "Order Fulfillment",
"value": "Order Fulfillment",
"type": "standard",
"duration": "1970-01-05 00:00:00",
"states": {
"pending": "Pending - has not started",
"inprogress": "In progress",
"skipped": "Skipped",
"complete": "Completed",
"error": "Error"
},
"flow": "30f3d26187e92300e0ef0cf888cb0b91",
"alwaysShow": true,
"order": 3
},
{
"label": "Backordered",
"value": "Backordered",
"type": "standard",
"duration": "1970-01-15 00:00:00",
"states": {
"pending": "Pending - has not started",
"inprogress": "In progress",
"skipped": "Skipped",
"complete": "Completed",
"error": "Error"
},
"flow": "30f3d26187e92300e0ef0cf888cb0b91",
"alwaysShow": true,
"order": 4
},
{
"label": "Deployment",
"value": "Deployment",
"type": "standard",
"duration": "1970-01-02 00:00:00",
"states": {
"pending": "Pending - has not started",
"inprogress": "In progress",
"skipped": "Skipped",
"complete": "Completed",
"error": "Error"
},
"flow": "30f3d26187e92300e0ef0cf888cb0b91",
"alwaysShow": true,
"order": 5
},
{
"label": "Request Cancelled",
"value": "Request Cancelled",
"type": "standard",
"duration": "1970-01-01 00:00:00",
"states": {
"pending": "Pending - has not started",
"inprogress": "In progress",
"skipped": "Skipped",
"complete": "Completed",
"error": "Error"
},
"flow": "30f3d26187e92300e0ef0cf888cb0b91",
"alwaysShow": true,
"order": 6
},
{
"label": "Completed",
"value": "complete",
"type": "standard",
"duration": "1970-01-01 00:00:00",
"states": {
"pending": "Pending - has not started",
"inprogress": "In progress",
"skipped": "Skipped",
"complete": "Completed",
"error": "Error"
},
"flow": "30f3d26187e92300e0ef0cf888cb0b91",
"alwaysShow": true,
"order": 7
}
]FlowAPI : getOutputs(String contextId)
Renvoie les sorties d’une action terminée ou d’un flux secondaire.
Vous pouvez utiliser les valeurs de retour des méthodes startAction() oustartSubflow() comme paramètre contextId.
Remarque :
Cette API est remplacée par ScriptableFlowRunner : inclus dans le périmètre, qui déconseille les méthodes existantes utilisées pour créer des objets et exécuter Concepteur de flux des flux et des actions. Utilisez la méthode getRunner() dans la classe FlowAPI pour renvoyer un objet ScriptableFlowRunner et utilisez les méthodes associées. Utilisez les méthodes ScriptableFlowRunner si vous devez prendre en charge Domain Separation.
| Nom | Type | Description |
|---|---|---|
| contextId | Chaîne | La sys_id de l’action ou du flux secondaire dont vous souhaitez obtenir les sorties. |
| Type | Description |
|---|---|
| Objet | Objet contenant les sorties d’action ou de flux secondaire. |
Cet exemple démarre un flux secondaire global appelé test_subflow, attend que le flux se termine, puis obtient ses valeurs de sortie. Normalement, un seul script n’exécute pas un flux et n’obtient pas ses valeurs de sortie. Étant donné qu’un flux peut ne pas se terminer avant l’appel getOutputs(), cet exemple utilise un temps d’attente. En règle générale, il s’agit d’un autre script ou d’un autre script ayant Concepteur de flux déjà exécuté le flux. Le code est encapsulé dans une instruction try/catch pour capturer toutes les erreurs qui peuvent se produire lors de l’exécution du flux.
(function() {
try {
// Gather inputs to call flow
var inputs = {};
inputs['ah_task'] = myTaskRecord; // GlideRecord of table: task
inputs['ah_comment'] ='Test Comment' ; // String
// Call flow
var contextId = sn_fd.FlowAPI.startSubflow('global.test_subflow', inputs);
// Wait for the flow to finish running
// Get flow outputs
var outputs = sn_fd.FlowAPI.getOutputs(contextId);
var output1 = outputs['output1'];
return output1;
} catch (ex) {
var message = ex.getMessage();
gs.error(message);
}
})();
FlowAPI : getRunner()
Renvoie un objet générateur ScriptableFlowRunner pour un flux ou une action que vous souhaitez exécuter.
| Nom | Type | Description |
|---|---|---|
| Aucun |
| Type | Description |
|---|---|
| Exécuteur de flux scriptable | Objet du générateur utilisé pour exécuter une action, un flux ou un Concepteur de flux flux secondaire. |
Cet exemple exécute un flux de façon synchrone.
(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);
}
})();
FlowAPI : hasApprovals(String scopedFlowName)
Vérifie si un flux dans un champ d’application donné contient des actions de demande d’approbation.
La méthode hasApprovals() détermine si un flux dans un champ d’application donné contient des actions de demande d’approbation. Cette méthode vérifie également si des actions de demande d’approbation dans le flux sont imbriquées sous Si les blocs logiques de flux. Pour plus d’informations, consultez Actions Demander l’approbation.
| Nom | Type | Description |
|---|---|---|
| scopedFlowName (en anglais seulement) | Chaîne | Périmètre et nom interne du flux à exécuter. Par exemple, global.flow_name. Localisez le champ Nom interne dans la liste des Concepteur de flux flux. |
| Type | Description |
|---|---|
| Chaîne | Renvoie l’une des valeurs de chaîne suivantes :
|
L’exemple suivant vérifie si le flux example_flow dans le champ d’application global contient des actions de demande d’approbation et journalise le résultat.
(function() {
try {
var result = sn_fd.FlowAPI.hasApprovals('global.example_flow');
gs.log('Result: ' + result);
}
catch (ex) {
var message = ex.getMessage();
gs.error(message);
}
})();FlowAPI : restartFlowFromContext(String ContextId, carte providedInputs)
Redémarre un flux, un flux secondaire ou une action qui a été exécuté en arrière-plan. Vous pouvez fournir de nouvelles entrées ou les omettre pour réutiliser les entrées précédemment fournies.
| Nom | Type | Description |
|---|---|---|
| contextId | Chaîne | sys_id du flux, du flux secondaire ou de l’action que vous souhaitez redémarrer. Ce flux, flux secondaire ou action doit s’être exécuté en arrière-plan et avoir un enregistrement sysevent associé. |
| Entrées fournies | Objet | Facultatif. Objet de carte contenant les paires nom-valeur qui définissent les entrées de remplacement pour le flux, le flux secondaire ou l’action. Si vous omettez ou fournissez une valeur Null pour ce paramètre, le flux, le flux secondaire ou l’action s’exécute à l’aide des entrées fournies précédemment. |
| Type | Description |
|---|---|
| ScriptableFlowRunnerResultsScoped | Objet contenant les détails d’exécution d’une action, d’un flux ou d’un Concepteur de flux flux secondaire. |
Redémarre un exemple de flux qui a un déclencheur basé sur les enregistrements sur la table Incident. Le flux d’origine utilisait l’exemple de INC0008112 d’incident comme entrée. Lorsque le flux redémarre, il utilise à la place un exemple de INC0008111 d’incident comme entrée.
(function() {
try {
var flowContextID = '4216396ffd7d11107edcf07204c30fd5'; // sys_id of sys_flow_context record
var oldIncidentRecord = '552c48888c033300964f4932b03eb092'; // sys_id of INC0008112
var newIncidentRecord = 'a83820b58f723300e7e16c7827bdeed2'; // sys_id of INC0008111
var inputs = {};
var gr = new GlideRecord('incident'); // Create new incident object
gr.get(newIncidentRecord); // Get GlideRecord object for INC0008111
inputs['current'] = gr; // Set new Incident record as input
inputs['table_name'] = 'incident'; // Set table name to Incident
var result = sn_fd.FlowAPI.getRunner() // Create a ScriptableFlowRunner builder object.
.restartFlowFromContext(flowContextID, inputs); // Restart flow with new inputs.
var contextId = result.getContextId(); // Retrieve the context ID from the result
var dateRun = result.getDate();
gs.info(contextId + ' ' + dateRun);
} catch (ex) {
var message = ex.getMessage();
gs.error(message);
}
})();
FlowAPI : scheduleCancel(String contextId, String reason, Integer delaySeconds)
Planifiez un événement système dans la file d’attente du moteur de flux pour annuler un flux qui est à l’état En cours, Présumé interrompu ou En attente après un certain délai.
| Nom | Type | Description |
|---|---|---|
| contextId | Chaîne | Sys_id de l’enregistrement des détails de l’exécution pour le flux, le flux secondaire ou l’action. Le flux, le flux secondaire ou l’action cible doit être dans l’état En cours, Présumé interrompu ou En attente. Accédez aux détails de l’exécution en naviguant vers l’onglet Exécutions de flux dans Concepteur de flux, ou transmettez la sys_id de l’enregistrement de contexte renvoyé par la méthode. Remarque : Il peut y avoir un léger délai lors de l’annulation si le contexte cible est en cours d’exécution sur un autre nœud de l’instance. Les contextes s’exécutant sur le même nœud sont immédiatement annulés. Les contextes s’exécutant sur un autre nœud doivent d’abord attendre que l’annulation soit transférée au nœud approprié. |
| motif | Chaîne | Motif d’annulation du flux, du flux secondaire ou de l’action. S’affiche dans le champ Message de la table des entrées de journal du moteur de flux [sys_flow_log]. |
| delaySeconds | Entier | Facultatif. Nombre de secondes à attendre avant de traiter un événement d’annulation dans la file d’attente du moteur de flux. Si vous omettez ce paramètre, la méthode utilise la valeur par défaut de 1 seconde. Vous pouvez utiliser ce paramètre pour éviter l’impact sur les performances de la planification de l’annulation de milliers de contextes de flux en même temps. Plutôt que d’exécuter toutes les annulations simultanément, planifiez un lot d’annulations de flux avec un certain retard. Vous pouvez également utiliser le délai comme valeur de délai d’expiration pour un flux asynchrone. |
| Type | Description |
|---|---|
| Néant |
Cet exemple utilise la valeur de retour de la méthode startFlow() pour planifier l’annulation de tous les flux de longue durée.
(function() {
var now_GR = new GlideRecord('incident');
now_GR.addQuery('number', 'INC0000050');
now_GR.query();
now_GR.next();
try {
var inputs = {};
inputs['current'] = now_GR; // GlideRecord of table:
inputs['table_name'] = 'incident';
// Starts the flow asynchronously.
var contextId = sn_fd.FlowAPI.startFlow('global.myFlow', inputs);
} catch (ex) {
var message = ex.getMessage();
gs.error(message);
}
})();
// Call the scheduleCancel() method using the context Id returned from the startFlow() method
sn_fd.FlowAPI.scheduleCancel(contextId, 'Flow took too long to execute.', 60);Cet exemple planifie l’annulation de tous les flux nommés Flux de test.
var now_GR = new GlideRecord("sys_flow_context");
now_GR.addQuery("name", "Test Flow");
now_GR.query();
while (now_GR.next()) {
sn_fd.FlowAPI.scheduleCancel(now_GR.getUniqueValue(), 'Canceling Test Flows', 60);
} Cet exemple utilise le paramètre delaySeconds pour exécuter des tâches d’annulation de flux par lots. Utilisez des lots pour annuler des milliers de contextes de flux.
var delaySeconds = 1;
for (var i; i < sys_flow_context.length; ++i) {
if (i % 100 === 0) {
delaySeconds = delaySeconds + 60;
}
var contextId = sys_flow_context[i];
var reason = "Example reason";
sn_fd.FlowAPI.scheduleCancel(contextId, reason, delaySeconds);
}FlowAPI : setEncryptedOutput(mot de passe de chaîne)
Crée les valeurs password2 à l’intérieur d’une étape de script.
Identifiez une valeur password2 chiffrée renvoyée à partir d’un GlideRecord, ce qui permet au système d’afficher la valeur sous forme de mot de passe masqué plutôt que sous forme de chaîne chiffrée.
| Nom | Type | Description |
|---|---|---|
| mot de passe | Chaîne | Valeur password2 chiffrée. |
| Type | Description |
|---|---|
| Chaîne | Valeur password2 chiffrée, reconnue par le moteur comme une valeur de mot de passe. |
Cet exemple renvoie la valeur d’un champ password2 à partir d’un enregistrement utilisateur et est stocké dans une variable. Cette variable est transmise à la méthode setEncryptedOutput, qui est appelée à l’aide de sn_fd. GlideActionUtil.setEncryptedOutput. L’instance reconnaît la valeur renvoyée comme un mot de passe.
(function execute(inputs, outputs) {
// ...code...
var now_GR = new GlideRecord('sys_user');
now_GR.addQuery('first_name' , 'Abel');
now_GR.query();
now_GR.next();
var pwVal = now_GR.getValue('pw2');
outputs['usedSetEncrypted'] = sn_fd.GlideActionUtil.setEncryptedOutput(pwVal);
outputs['justSetDirectly'] = pwVal;
})(inputs, outputs);FlowAPI - startAction(nom de chaîne, entrées de carte)
Exécute une action à partir d’un script côté serveur de manière asynchrone.
Exécutez une action à partir d’une règle métier, d’un script include ou de tout autre script côté serveur. Les actions exécutées à l’aide de cette méthode s’exécutent de façon asynchrone, de sorte que les scripts utilisant cette méthode n’ont pas accès aux sorties créées par l’action. Utilisez executeAction pour exécuter une action de manière synchrone et accéder aux sorties qu’elle génère.
Remarque :
Cette API est remplacée par ScriptableFlowRunner : inclus dans le périmètre, qui déconseille les méthodes existantes utilisées pour créer des objets et exécuter Concepteur de flux des flux et des actions. Utilisez la méthode getRunner() dans la classe FlowAPI pour renvoyer un objet ScriptableFlowRunner et utilisez les méthodes associées. Utilisez les méthodes ScriptableFlowRunner si vous devez prendre en charge Domain Separation.
Remarque :
Cette méthode exécute l’action en tant qu’utilisateur qui initie la session.
| Nom | Type | Description |
|---|---|---|
| nom | Chaîne | Périmètre et nom de l’action à exécuter, par exemple global.action_name. |
| entrées | Carte | Paires nom-valeur qui définissent les entrées d’action. Utilisez le nom de l’entrée, pas l’étiquette d’entrée. |
| Type | Description |
|---|---|
| Chaîne | ID système de l’enregistrement de contexte pour l’action. Accédez à l’enregistrement de contexte en naviguant vers l’onglet Exécutions de flux dans , en Concepteur de fluxsélectionnant une exécution de flux, puis en cliquant sur Ouvrir l’enregistrement de contexte. |
Cet exemple utilise sn_fd. FlowAPI.startAction pour exécuter une action appelée add_comment dans le périmètre sn_itsm_spoke. L’objet d’entrées contient un enregistrement cible et un commentaire à ajouter à cet enregistrement. Le code est encapsulé dans une instruction try/catch pour capturer toutes les erreurs qui peuvent se produire lors de l’exécution du flux.
(function() {
try {
var inputs = {};
inputs['ah_task'] = myTaskRecord; // GlideRecord of table: task
inputs['ah_comment'] ='Test Comment' ; // String
var contextId = sn_fd.FlowAPI.startAction('sn_itsm_spoke.add_comment', inputs);
} catch (ex) {
var message = ex.getMessage();
gs.error(message);
}
})();FlowAPI : startActionQuick(nom de chaîne, entrées de carte)
Exécute une action à partir d’un script côté serveur de manière asynchrone sans créer de détails d’exécution ou d’autres enregistrements connexes. Améliorez les performances en éliminant les frais généraux liés à la tenue des dossiers. Utilisez cette API pour augmenter la vitesse de traitement de gros volumes, par exemple plusieurs exécutions par seconde, dans un environnement de production.
- Rapports et enregistrements générés
- Cette méthode ne crée pas de détails d’exécution ni d’enregistrements de contexte, quels que soient les Concepteur de flux paramètres.
- Support d’attente
- Cette méthode ne prend pas en charge la mise en pause de l’action en attente des conditions. Les étapes qui s’interrompent pour des conditions d’attente telles que Demander l’approbation ou Attendre une condition ne sont pas prises en charge.
- Prise en charge du MID Server
- Cette méthode ne prend pas en charge la mise en pause d’une action à exécuter à partir d’un MID Server.
Remarque :
Cette API est remplacée par ScriptableFlowRunner : inclus dans le périmètre, qui déconseille les méthodes existantes utilisées pour créer des objets et exécuter Concepteur de flux des flux et des actions. Utilisez la méthode getRunner() dans la classe FlowAPI pour renvoyer un objet ScriptableFlowRunner et utilisez les méthodes associées. Utilisez les méthodes ScriptableFlowRunner si vous devez prendre en charge Domain Separation.
| Nom | Type | Description |
|---|---|---|
| nom | Chaîne | Périmètre et nom interne de l’action à exécuter. Par exemple, global.action_name. Localisez le champ Nom interne dans la liste des Concepteur de flux actions. |
| entrées | Carte | Paires nom-valeur qui définissent les entrées d’action. Vous pouvez trouver les entrées d’action disponibles et les types de données requis sous Entrées dans le plan d’action. Utilisez le nom de l’entrée, pas l’étiquette d’entrée. Par exemple, {'table' :'incident','sys_id' :'a39d8e3cf0212300964feeefe80ff0ed'}. |
| Type | Description |
|---|---|
| nul |
(function() {
try {
var grIncident = new GlideRecord('incident');
grIncident.get('57af7aec73d423002728660c4cf6a71c');
var inputs = {};
inputs['variable'] = grIncident;
sn_fd.FlowAPI.startActionQuick('global.update_record_test', inputs);
} catch (ex) {
var message = ex.getMessage();
gs.error(message);
}
})();FlowAPI – startFlow(nom de chaîne, entrées de carte)
Exécute un flux à partir d’un script côté serveur.
Exécutez un flux à partir d’une règle métier, d’un script include ou de tout autre script côté serveur. Les flux exécutés avec cette méthode s’exécutent de manière asynchrone.
Remarque :
Cette API est remplacée par ScriptableFlowRunner : inclus dans le périmètre, qui déconseille les méthodes existantes utilisées pour créer des objets et exécuter Concepteur de flux des flux et des actions. Utilisez la méthode getRunner() dans la classe FlowAPI pour renvoyer un objet ScriptableFlowRunner et utilisez les méthodes associées. Utilisez les méthodes ScriptableFlowRunner si vous devez prendre en charge Domain Separation.
Remarque :
Cette méthode exécute le flux en tant qu’utilisateur spécifié dans les propriétés de flux.
| Nom | Type | Description |
|---|---|---|
| nom | Chaîne | Champ d’application et nom du flux à exécuter, par exemple global.flow_name. |
| entrées | Carte | Paires nom-valeur qui définissent les entrées de déclencheur. Utilisez le nom de l’entrée, pas l’étiquette d’entrée. |
| Type | Description |
|---|---|
| Chaîne | ID système de l’enregistrement de contexte pour le flux. Accédez à l’enregistrement de contexte en naviguant vers l’onglet Exécutions de flux dans , en Concepteur de fluxsélectionnant une exécution de flux, puis en cliquant sur Ouvrir l’enregistrement de contexte. |
Cet exemple utilise sn_fd. FlowAPI.startFlow pour exécuter un flux global appelé test_flow. Le code crée une variable d’entrées qui contient les entrées requises par le flux. Dans ce cas, l’enregistrement actuel et la table de l’enregistrement. Le code est encapsulé dans une instruction try/catch pour capturer toutes les erreurs qui peuvent se produire lors de l’exécution du flux.
(function() {
var now_GR = new GlideRecord('incident');
now_GR.addQuery('number', 'INC0009009');
now_GR.query();
now_GR.next();
try {
var inputs = {};
inputs['current'] = now_GR; // GlideRecord of table: Incident
inputs['table_name'] = 'incident';
var contextId = sn_fd.FlowAPI.startFlow('global.test_flow', inputs);
} catch (ex) {
var message = ex.getMessage();
gs.error(message);
}
})();FlowAPI – startFlowQuick(nom de chaîne, entrées de carte)
Exécute un flux à partir d’un script côté serveur de façon asynchrone sans créer de détails d’exécution ni d’autres enregistrements connexes. Améliorez les performances en éliminant les frais généraux liés à la tenue des dossiers. Utilisez cette API pour augmenter la vitesse de traitement de gros volumes, par exemple plusieurs exécutions par seconde, dans un environnement de production.
- Rapports et enregistrements générés
- Cette méthode ne crée pas de détails d’exécution ni d’enregistrements de contexte, quels que soient les Concepteur de flux paramètres.
- Exécuter en tant qu’utilisateur système
- Cette méthode exécute le flux en tant qu’utilisateur système. Il n’est pas possible de définir le flux pour qu’il s’exécute en tant qu’utilisateur qui lance la session ou d’emprunter l’identité d’un utilisateur.
- Support d’attente
- Cette méthode ne prend pas en charge la mise en pause du flux pour attendre les conditions. Les actions ou la logique de flux qui s’interrompent dans des conditions d’attente telles que Demander l’approbation, Attendre une condition ou Attendre pendant une certaine durée ne sont pas prises en charge.
- Prise en charge du MID Server
- Cette méthode ne prend pas en charge la mise en pause d’un flux à exécuter à partir d’un MID Server.
Remarque :
Cette API est remplacée par ScriptableFlowRunner : inclus dans le périmètre, qui déconseille les méthodes existantes utilisées pour créer des objets et exécuter Concepteur de flux des flux et des actions. Utilisez la méthode getRunner() dans la classe FlowAPI pour renvoyer un objet ScriptableFlowRunner et utilisez les méthodes associées. Utilisez les méthodes ScriptableFlowRunner si vous devez prendre en charge Domain Separation.
| Nom | Type | Description |
|---|---|---|
| nom | Chaîne | Périmètre et nom interne du flux à exécuter. Par exemple, global.flow_name. Localisez le champ Nom interne dans la liste des Concepteur de flux flux. |
| entrées | Carte | Paires nom-valeur qui définissent les entrées de déclencheur. Vous pouvez trouver les entrées de déclencheur disponibles et les types de données requis dans la section Déclencheur du flux. Utilisez le nom de l’entrée, pas l’étiquette d’entrée. Par exemple, {'table' :'incident','sys_id' :'a39d8e3cf0212300964feeefe80ff0ed'}. |
| Type | Description |
|---|---|
| nul |
(function() {
try {
var grIncident = new GlideRecord('incident');
grIncident.get('ed92e8d173d023002728660c4cf6a7bc');
var inputs = {};
inputs['current'] = grIncident;
inputs['table_name'] = 'incident';
sn_fd.FlowAPI.startFlowQuick('global.test_quick_flow', inputs);
} catch (ex) {
var message = ex.getMessage();
gs.error(message);
}
})();FlowAPI – startSubflow(nom de chaîne, entrée de carte)
Exécute un flux secondaire à partir d’un script côté serveur.
Exécutez un flux secondaire à partir d’une règle métier, d’un script include ou de tout autre script côté serveur. Les flux secondaires s’exécutent à l’aide de cette méthode S’exécutent de façon asynchrone Les scripts qui incluent cette méthode n’ont pas accès aux sorties créées par le flux. Utilisez executeSubflow pour exécuter un flux secondaire de manière synchrone et accéder aux sorties qu’il génère.
Remarque :
Cette API est remplacée par ScriptableFlowRunner : inclus dans le périmètre, qui déconseille les méthodes existantes utilisées pour créer des objets et exécuter Concepteur de flux des flux et des actions. Utilisez la méthode getRunner() dans la classe FlowAPI pour renvoyer un objet ScriptableFlowRunner et utilisez les méthodes associées. Utilisez les méthodes ScriptableFlowRunner si vous devez prendre en charge Domain Separation.
Remarque :
Cette méthode exécute le flux en tant qu’utilisateur spécifié dans les propriétés de flux.
| Nom | Type | Description |
|---|---|---|
| nom | Chaîne | Champ d’application et nom du flux secondaire à exécuter, par exemple global.subflow_name. |
| entrées | Carte | Paires nom-valeur qui définissent les entrées de flux secondaire. Utilisez le nom de l’entrée, pas l’étiquette d’entrée. |
| Type | Description |
|---|---|
| Chaîne | ID système de l’enregistrement de contexte pour le flux secondaire. Accédez à l’enregistrement de contexte en naviguant vers l’onglet Exécutions de flux dans , en Concepteur de fluxsélectionnant une exécution de flux, puis en cliquant sur Ouvrir l’enregistrement de contexte. |
Cet exemple utilise sn_fd. FlowAPI.startSubflow pour exécuter un flux global appelé test_subflow. Le code est encapsulé dans une instruction try/catch pour capturer toutes les erreurs qui peuvent se produire lors de l’exécution du flux.
(function() {
try {
var inputs = {};
inputs['ah_task'] = myTaskRecord; // GlideRecord of table: task
inputs['ah_comment'] ='Test Comment' ; // String
var contextId = sn_fd.FlowAPI.startSubflow('global.test_subflow', inputs);
} catch (ex) {
var message = ex.getMessage();
gs.error(message);
}
})();FlowAPI – startSubflowQuick (nom de chaîne, entrées de carte)
Exécute un flux secondaire à partir d’un script côté serveur de façon asynchrone sans créer de détails d’exécution ou d’autres enregistrements connexes. Améliorez les performances en éliminant les frais généraux liés à la tenue des dossiers. Utilisez cette API pour augmenter la vitesse de traitement de gros volumes, par exemple plusieurs exécutions par seconde, dans un environnement de production.
- Rapports et enregistrements générés
- Cette méthode ne crée pas de détails d’exécution ni d’enregistrements de contexte, quels que soient les Concepteur de flux paramètres.
- Exécuter en tant qu’utilisateur système
- Cette méthode exécute le flux en tant qu’utilisateur système. Il n’est pas possible de définir le flux pour qu’il s’exécute en tant qu’utilisateur qui lance la session ou d’emprunter l’identité d’un utilisateur.
- Support d’attente
- Cette méthode ne prend pas en charge la mise en pause du flux pour attendre les conditions. Les actions ou la logique de flux qui s’interrompent dans des conditions d’attente telles que Demander l’approbation, Attendre une condition ou Attendre pendant une certaine durée ne sont pas prises en charge.
- Prise en charge du MID Server
- Cette méthode ne prend pas en charge la mise en pause d’un flux à exécuter à partir d’un MID Server.
Remarque :
Cette API est remplacée par ScriptableFlowRunner : inclus dans le périmètre, qui déconseille les méthodes existantes utilisées pour créer des objets et exécuter Concepteur de flux des flux et des actions. Utilisez la méthode getRunner() dans la classe FlowAPI pour renvoyer un objet ScriptableFlowRunner et utilisez les méthodes associées. Utilisez les méthodes ScriptableFlowRunner si vous devez prendre en charge Domain Separation.
| Nom | Type | Description |
|---|---|---|
| nom | Chaîne | Périmètre et nom interne du flux secondaire à exécuter. Par exemple, global.subflow_name. Localisez le champ Nom interne dans la liste des Concepteur de flux flux secondaires. |
| entrées | Carte | Paires nom-valeur qui définissent les entrées de flux secondaire. Vous pouvez trouver les entrées de flux secondaire disponibles et les types de données requis sous Entrées dans le flux secondaire. Utilisez le nom de l’entrée, pas l’étiquette d’entrée. Par exemple, {'table' :'incident','sys_id' :'a39d8e3cf0212300964feeefe80ff0ed'}. |
| Type | Description |
|---|---|
| nul |
(function() {
try {
var grIncident = new GlideRecord('incident');
grIncident.get('57af7aec73d423002728660c4cf6a71c');
var inputs = {};
inputs['variable'] = grIncident;
sn_fd.FlowAPI.startSubflowQuick('global.test_quick_run_subflow', inputs);
} catch (ex) {
var message = ex.getMessage();
gs.error(message);
}
})();