$doc.fireStateTransition

Description

Déclenche une transition d'état

Syntaxe

$doc.fireStateTransition( context , transition [, options ] )

Paramètres

context string / map

Object décrivant le contexte du dossier à traiter. Le paramètre peut désigner soit un contexte (exprimé en tant que string en clair, p.ex. "listeArticle[123]" ou sous forme de hash) ou un map décrivant le contexte. Dans ce cas, le map doit a minima contenir une valeur pour les entrées modelName et docId.

transition string

Nom de la transition à déclencher

options map

Map d'options. Les options reconnues sont:

ignorePolicies boolean

Flag indiquant de ne pas tenir compte des policies lors du traitement.

Par défaut, les policies sont vérifiées si l'application gère des policies et si le thread courant est un thread "client", c'est-à-dire un thread initié par une requête du client. Si la méthode est invoquée par un script démarré par le scheduler, les policies ne seront pas vérifiées par défaut.

notify boolean

Flag true/false indiquant si le moteur doit déclencher les notifications doc-enterstate et doc-leavestate, ainsi que les éventuelles notifications définies au niveau des états eux-mêmes et des transitions.

Par défaut le flag est false.

Voir la description détaillée dans la documentation de la méthode $doc.create.

notificationParams map

Paramètres supplémentaires à passer lors des notifications. N'est pris en compte que lorsque notify est true.

Le paramètre attendu est un map de clés-valeurs. Les clés modelName, docId, prevState, nextState, transition, allowStateChange et step sont réservées et renseignées automatiquement par la méthode.

Le fait de spécifier des paramètres de notification active automatiquement l'option notify (pour autant qu'elle ne soit pas explicitement définir à false).

events boolean / array / string

Cette valeur permet de gérer l'exécution des événements. Pour rappel, les événements sont les notifications onenter, onleave et ontransition déclarées au niveau des états, c'est-à-dire des éléments <state> et <transition> du modèle d'états (fichier states.xml).

La valeur peut avoir différentes formes:

• valeur booléenne (true/false): sous cette forme, la propriété indique d'activer (valeur true) ou d'ignorer (valeur false) tous les événements
• chaîne de caractères: ce format permet d'indiquer quel(s) événements activer. Les événements reconnus sont onenter, onleave, ontransition, ou une combinaison des trois (séparés par une virgule ou un espace).
• tableau de String: la méthode s'attend à retrouver les noms d'événements à déclencher en valeurs du tableau

La valeur par défaut est true.

Retour

Retourne le nom du nouvel état ou null en cas d'erreur.

Exemple

Non disponible