TIM Wiki / NEW TIM 6 Documentation

Often decisions are made in TIM via E-Mail. It could sometimes be desired to be able to make these decisions manually in TIM. For example if the decision-maker, who gets the E-Mail cannot respond. In this component the implementation of decisions via mail and manually are explained.

Activities and gateways that ar needed for implementation:

• Mailnode to the decision-maker
• Task for manually finishing
• XOR Gateway (2x opnening, 1x closing)
• Connection lines
• Start- & Endnode

Actionhandler welche für die Implementierung benötigt werden:

• Actionhandler: VariableDecisionHandler
• Actionhandler: ProcessVariableSetter (2x)
• Webservice: setProcessVariableAndSignalProcessInstanceByTransitionName

The Mailnode needs besides the text the links to accept or deny. These are built as follows:

 http://URL of the Server/loom-portal/ProcessInstanceManager/setProcessVariableAndSignalProcessInstanceByTransitionName.soap?args[0]=${processInstanceId}&args[1]=freigabe&args[2]=true&args[3]=Manuelly_deciding&args[4]=release&i=1&uid=eWl0L3BtOnRhc2shbm1vdGlvbg

 http://URL of the server/loom-portal/ can be subsituted by ${baseLink} after {{ :en:software:tim:bausteine:email_link_and_human_decision.png? 800 |}}

[[software:tim:changelog:tim35|TIM Version 3.5]].

Parameter of the links}}

• args[0]: Processinstance ID of the process. This parameter can be taken like this
• args[1]: Variablename which should be set
• args[2]: Value which the varible be set as
• args[3]: Name of the activity which should be signalled (in the example “Manually_deciding”)
• args[4]: Tehcnical unique name of the transtition which follows the signalled activity
• uid: Login data coded for TIM Base64 (client/user:password)

Attention: A link for declining is also needed. Hereby parameter 2 (args[2]) is changed. >Attention: The transition following the activity “Manuall_deciding” needs a technical unique name. In this example “release”.

Activity which is to be signalled when callingthe link. This activity needs a task like for example “Please decide manually”. The transition following the activity needs a technical unique name. In this example “release”.

Auf dem ersten XOR wird ein SmartFormDecissionHandler mit einer defaultTransition, für die manuelle Entscheidung, auf das zweite XOR gelegt. Dieses XOR entscheidet anhand der im Link gesetzten Variable. Je nach gesetzem Wert wird der “Freigabe per Mail”, “Ablehnung per Mail” oder “Manuelle Freigabe” Weg gewählt. On the first XOR a VariableDecisionHandler is set with defaultTransition, for the manual descision, to the second XOR. This XOR decides by means of the in the link set variable. Depending on the set variable “

Hier wird kein Actionhandler benötigt. Dieses XOR wird nur erreicht, falls die Aufgabe “Manuell_entscheiden” von Hand abgehakt wurde und somit keine Prozessvariable über den Link gesetzt werden konnte. Wird dieses XOR erreicht, popt in T!M ein Dialog auf, in dem der Bearbeiter über den weiteren Prozessverlauf entscheiden kann. Je nach getätigter Auwahl wird eine der Scriptnodes angesteuert.

Auf den Scriptnodes der manuellen Entscheidung wird ein ProcessVariableSetter hinterlegt, welcher die Variablen aus dem Link je nach dem setzt. Dies dient zur späteren Dokumentation des Prozessverlaufs.