FIXME **This page is not fully translated, yet. Please help completing the translation.**\\ //(remove this paragraph once the translation is finished)//

=======ImportProcessEntitiesHandler========
==== Description ====
This action handler can read documents, process variables, and the current user from open tasks in a user-defined instance. These may then be imported into the process instance, which is called by the handler.
------
==== Action Class ====
<code>
com.dooris.bpm.actionhandler.ImportProcessEntitiesHandler
</code>
\\
----
==== Event Type ==== 
any
==== Action Name ==== 
any
==== Mandatory Fields ==== 
-
----
==== Parameter ==== 
== processInstanceId ==
ID of the process instance from which the importation occurs. A variable may also be passed here (see [[#example 1]])

\\ == variables ==
Denotes if an importation of variables is desired. Set to true by default (see [[#example 1]]). Possible values are:
  *true
  *false

\\ == excludedVariables  ==
This parameter is used to exclude variables from the import process. Exclude variables are separated by commas (see [[#example 2]]).

>> **ATTENTION!**  If excludedVariables is not provided, all process variables will be imported!

\\ == includedVariables  ==
This parameter is used to include variables in the import process. Exclude variables are separated by commas (see [[#example 3]]).


>> **ATTENTION!**  If includedVariables is not provided, all process variables will be imported!

\\ == docs  ==
Denotes if documents should be imported. Set to true by default (see [[#example 1]]). Possible values are:
  *true
  *false


\\ == currentAssignees  ==
Denotes if the current status of the process instance should be imported. Set to true by default (see [[#example 1]]). Possible values are:
  *true
  *false

>> **ATTENTION!** 
If "true" is given here, new process variables will be created, if possible:
  *currentAssigneesNodeName[n] -> Current open activity
  *currentAssigneesTaskName[n] -> Current open task
  *currentAssigneesPoolAssignment[n] -> Current assigned group
  *currentAssigneesFirstName[n] -> First name of the assignee
  *currentAssigneesLastName[n] -> Last name of the assignee
  *currentAssigneesEmail[n] -> E-mail of the assignee
  *currentAssigneesPhoneNumber[n] -> Phone number of the assignee

[n] is determined by the number of open tasks (0-x). 
----

==== Example 1 ====
{{:software:tim:actionhandler:importprocessentitieshandler.png?400|}}

----

==== Example 2 ====
{{:software:tim:actionhandler:importprocessentitieshandler_-_excludedvariables.png?400|}}

----

==== Example 3 ====
{{:software:tim:actionhandler:importprocessentitieshandler_-_includedvariables.png?400|}}

----