Fonctions spécifiques à l’événement du workflow

Plusieurs fonctions se rapportent spécifiquement aux événements de workflow.

Tableau 1. Fonctions spécifiques à l’événement du workflow

Fonction	Description	Objectif	Utiliser	Thread	Source
registerForEvent (eventName)	Fonction dans l’environnement de workflow qui écrit les événements représentés sous forme de chaînes dans le champ wf_executing.registered_events .	Les événements du workflow ne sont que des chaînes. Lorsqu’une activité enregistrée pour un événement s’exécute, un ensemble d’événements séparés par des virgules est stocké avec l’enregistrement de l’activité d’exécution du workflow [wf_executing]. Lorsque l’événement est déclenché dans le contexte du workflow, la table wf_executing recherche tous les enregistrements en cours d’exécution qui contiennent la chaîne représentant l’événement dans le champ wf_executing.registered_events	La variable globale workflow disponible pour tous les enregistrements d’activité de workflow [wf_activity] est la source de l’appel. Par exemple, à l’intérieur d’une activité Run Script , un designer peut écrire : workflow.registerForEvent('myEventName') ;	Thread actuel, mutex actuel	Workflow des variables globales
unRegisterForEvent (eventName)	Fonction dans l’environnement de workflow qui supprime une valeur de chaîne représentant un événement qui a été écrit dans le champ wf_executing.registered_events .	Les événements de workflow ne sont que des chaînes écrites dans le champ wf_executing.registered_events . Lorsqu’une activité se désinscrit pour un événement, l’ensemble d’événements séparés par des virgules stocké dans l’enregistrement de l’activité d’exécution du workflow [wf_executing] est recherché et, si cette chaîne est trouvée, elle est supprimée.	La variable globale workflow disponible pour tous les enregistrements d’activité de workflow [wf_activity] est la source de l’appel. Par exemple, à l’intérieur d’une activité Run Script , un designer peut écrire : workflow.unRegisterForEvent('myEventName') ;	Thread actuel, mutex actuel	Workflow des variables globales
fireEvent (eventName)	Fonction dans l’environnement de workflow qui examine le contenu du champ wf_executing.registered_events , en comparant son contenu au eventName transmis.	Les événements de workflow ne sont que des chaînes écrites dans le champ wf_executing.registered_events . Lorsque fireEvent(eventName) est appelé par une activité de workflow, le moteur de workflow met en file d’attente tous les enregistrements en cours d’exécution qui contiennent la chaîne dans le champ enregistré.	La variable globale workflow disponible pour tous les enregistrements d’activité de workflow [wf_activity] est la source de l’appel. Par exemple, à l’intérieur d’une activité Run Script , un concepteur peut écrire : workflow.fireEvent('myEventName') ;	Thread actuel, mutex actuel	Workflow des variables globales
fireEvent (eventRecord, eventName)	Fonction dans l’environnement de workflow qui envoie un événement à un enregistrement spécifique d’activité d’exécution de workflow [wf_executing]. eventRecord est un GlideRecord du type wf_executing.	Cet appel d’événement attend un gestionnaire d’événements onMyEvent dans l’activité représentée dans l’enregistrement d’événement (table Activité d’exécution du workflow [wf_executing]). Lorsque fireEvent (eventRecord, eventName) est appelé par une activité de workflow, le moteur de workflow met en file d’attente l’enregistrement en cours d’exécution spécifique avec cet événement et transmet l’événement dans la définition d’activité pour que le gestionnaire on<eventName > le gère. Cet événement est mis en file d’attente dans son propre mutex, de sorte que la file d’attente actuelle se termine avant que cet événement ne soit traité.	L’include de script du workflow contient l’appel à cet effet. Par exemple, à l’intérieur d’une activité Exécuter un script , un concepteur peut écrire : var w = new Workflow() ; w.fireEvent(executing, eventName) ;	Thread actuel, mutex actuel	Script include du workflow
fireEvent (eventRecordSysId, eventName)	Fonction dans l’environnement de workflow qui envoie un événement à un enregistrement spécifique d’activité d’exécution de workflow [wf_executing]. eventRecordSysId est la sys_id d’un GlideRecord du type wf_executing.	Il s’agit de la même chose que le fireEvent ci-dessus, sauf qu’il accepte un ID et renvoie l’enregistrement de l’activité d’exécution du workflow [wf_executing].	L’include de script du workflow contient l’appel à cet effet. Par exemple, à l’intérieur d’une activité Exécuter un script , un concepteur peut écrire : var w = new Workflow() ; w.fireEvent(executing, eventName) ;	Thread actuel, mutex actuel	Script include du workflow
fireEvent (eventRecordSysId, eventName, optionalJSONObject)	Fonction dans l’environnement de workflow qui envoie un événement à un enregistrement spécifique d’activité d’exécution de workflow [wf_executing]. eventRecordSysId est la sys_id d’un GlideRecord du type wf_executing.	C’est la même chose que fireEvent ci-dessus, sauf qu’il accepte un objet JSON comme troisième paramètre. Cet objet peut spécifier n’importe quelle donnée exprimable au format JSON. Vous pouvez également spécifier des fonctionnalités supplémentaires lors de la création d’une activité de workflow.	L’include de script du workflow contient l’appel à cet effet. Par exemple, à l’intérieur d’une activité Exécuter un script , un concepteur peut écrire : var w = new Workflow() ; w.fireEvent(executing, eventName, JSONObject) ;	Thread actuel, mutex actuel	Script include du workflow
broadcastEvent (contextId, eventName)	Fonction dans l’environnement de workflow qui envoie un événement à tous les enregistrements d’activité d’exécution de workflow [wf_executing] en cours d’exécution dans un contexte spécifié, quel que soit leur état.	Il s’agit de la même chose que le fireEvent ci-dessus, sauf qu’il accepte un ID et renvoie l’enregistrement de l’activité d’exécution du workflow [wf_executing].	L’include de script du workflow contient l’appel à cet effet. Par exemple, à l’intérieur d’une activité Exécuter un script , un concepteur peut écrire : var w = new Workflow() ; w.broadcastEvent(contextId, eventName) ;	Thread actuel, mutex actuel	Script include du workflow
broadcastEvent (eventName)	Fonction dans l’environnement de workflow qui envoie un événement à tous les enregistrements d’activité d’exécution de workflow [wf_executing] en cours d’exécution dans le contexte actuel, quel que soit leur état.	Cela ne doit pas être confondu avec broadcastEvent ci-dessus. Cet événement n’est disponible que pour les enregistrements d’activité d’exécution de workflow [wf_executing] actuels.	Cette option n’est disponible que via la variable de workflow globale du contexte actuel. Voici un exemple de son utilisation dans le script d’une définition d’activité : workflow.broadcastEvent(eventName)	Thread actuel, mutex actuel	Workflow des variables globales