=======YearIDGenerator======= ==== Beschreibung ==== Der [[software:tim:actionhandler|Handler]] erzeugt eine Zahl, die im Prozess als eindeutige Zuordnung verarbeitet werden kann. Meistens wird die erzeugte ID über den [[software:tim:actionhandler:renameinstancehandler|RenameInstanceHandler]] eingebunden. Die erzeugte ID setzt sich wie folgt zusammen: JJJJxxxx; Wobei JJJJ das aktuelle Jahr und xxxx eine fortlaufende Nummer darstellt (Bsp: 20110001). ------ ==== Klasse ==== com.dooris.bpm.actionhandler.YearIDGenerator ---- == Event Type == beliebig == Action Name == beliebig == Mandatory Fields == Hier kann eine Variable bestimmt werden, in der der erzeugte Wert geschrieben wird. Siehe [[#Beispiel]] Achtung: Der Variablenname "id" darf nicht verwendet werden! ---- ==== Parameter ==== Die erzeugte ID kann über die Variable #{key} abgefragt werden und im Handler verarbeitet werden. Sollte die Variable im weiteren Prozessverlauf als [[:glossar#Prozessvariable]] benötigt werden, muss das Mandatoryfield gesetzt werden! \\ == pattern == Der Parameter ist optional und kann genutzt werden um [[:glossar#Prozessvariable|Prozessvariable(n)]] in den [[:glossar#Prozessinstanz|Prozessinstanznamen]] einzubauen. Hier kann die Variable #{key} abgefragt werden. Siehe [[#Beispiel]] == length == Der Parameter "length" verlängert die ID um eine bestimmte Anzahl an fortlaufenden Zahlen.\\ "length" kann manuell gesetzt werden. Wird zum Beispiel "length=5" gesetzt, besteht die ID aus dem aktuellen Jahr + 5 fortlaufenden Zahlen. > Wird manuell nichts gesetzt, besteht die ID standardmäßig aus dem aktuellen Jahr + 4 fortlaufenden Zahlen. == prefix == Setzt vor die erzeugte ID das entsprechende Prefix mit einem Leerzeichen zwischen dem Wert des Prefixes und der ID > Dieses Parameter wird __**nur**__ aufgerufen, wenn der Parameter **pattern** nicht gesetzt ist! ---- ==== Beispiel ==== Beispiel 1\\ \\ {{ :software:tim:actionhandler:yearidgenerator1.png? }}\\ Vierstellige ID wird erzeugt und an Instanznamen angehängt. Die ID wird in der Prozessvariable yearId gespeichert.\\ \\ Beispiel 2\\ \\ {{ :software:tim:actionhandler:yearidgenerator2.png }}\\ Vierstellige ID wird erzeugt und das Pattern als Instanzname festgelegt. Die ID wird in der Prozessvariable yearId gespeichert. Die Prozessinstanz in diesem Beispiel heisst nun "ERSETZ MICH 20140003".\\ \\ Beispiel 3\\ {{ :software:tim:actionhandler:yearidgenerator3.png }}\\ **Fünfstellige** ID wird erzeugt und das Pattern als Instanzname festgelegt. Die ID wird in der Prozessvariable yearId gespeichert. Die Prozessinstanz in diesem Beispiel heisst nun "ERSETZ MICH 201400004".\\ \\ Beispiel 4\\ {{ :software:tim:actionhandler:yearidgenerator4.png }}\\ \\ Fünfstellige ID wird erzeugt. Der Instanzname setzt sich nun aus dem vergebenen Instanznamen, dem Prefix sowie der ID zusammen. Die ID wird in der Prozessvariable yearId gespeichert. Die Prozessinstanz in diesem Beispiel heisst nun "Instanzname PREFIX 201400005".\\