=======VariableAssignmentActionHandler========
==== Description ====
This [[en:software:tim:actionhandler:|handler]] assigns a [[en:software:tim:swimlanes|swimlane]] to a user, which has been given in either a smartform or a process variable. 

During process modeling, an [[en:software:tim:swimlanes|assignment]] must still be given to the affected  [[en:software:tim:swimlanes|swimlane]].


in order to assign the instance starter to a specific swim lane, the following handler may be employed: [[en:software:tim:actionhandler:assignstartertoswimlanehandler|AssignStarterToSwimlaneHandler]] 


------
==== Action Class ====
<code>
com.dooris.bpm.actionhandler.VariableAssignmentActionHandler
</code>
\\
----
==== Event Type ====
any 

==== Action Name ==== 
any

==== Mandatory Fields ==== 
none
-
==== Parameter ==== 
==swimlane = name_of_swimlane ==
Explanation (see [[#example]])

\\ == variable = id_of_variable ==
In order to execute the assignment, the variable may take one of the following forms in order to choose a user/group:
  * user(UserName)
  * E-mail address of the user
  * User ID
  * Username of the user
  * group(GroupName)
  * Group name 
  * ID of the group

<note important> If only a name is entered for the variable, the list of users will be searched for this name; if a match is found, this user will be chosen. If no match is found, the groups are then searched and the match will be assigned to the swimlane.</note>

\\ == assignmentReset ==

This indicates if all previous assignments should be deleted before beginning the new assignment. This is set to false by default.\\
In order to restore the assignment, "assignmentReset=true" must be given. 

<note important>Attention: The assignmentReset parameter is available only for TIM Version 4.3 and higher!</note>

Explanation (see [[#Example]])

----

==== Example ====
{{ :software:tim:actionhandler:variableassignmentactionhandler.png }}