This shows you the differences between two versions of the page.
Next revision | Previous revision | ||
en:software:tim:bausteine:email_link_and_manual_decision [2018/05/04 10:19] Julian Le created |
en:software:tim:bausteine:email_link_and_manual_decision [2021/07/01 09:52] (current) |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | FIXME **This page is not fully translated, yet. Please help completing the translation.** \\ | + | ==== Purpose of the component ==== |
- | //(remove this paragraph once the translation is finished)// | + | |
- | ==== Sinn und Zweck des Bausteins ==== | + | |
- | Oftmals werden in T!M - Task !n Motion Entscheidungen per [[:software:tim:mail|E-Mail]] getroffen. Es kann jedoch gewünscht sein, diese Entscheidung auch manuell in T!M - Task !n Motion tätigen zu können. Zum Beispiel falls Entscheider welcher die [[:software:tim:mail|E-Mail]] bekommt nicht auf diese Mail reagieren kann. In diesem Baustein wird die Implementierung einer Entscheidung per [[:software:tim:mail|E-Mail]] sowie manuell erläutert. | + | 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. |
---- | ---- | ||
- | ==== Was benötige ich im Prozess an Aktivitäten und Gateways? ==== | + | ==== Which actitvities and gateways do I need in a process? ==== |
- | Aktivitäten und Gateways welche für die Implementierung benötigt werden: | + | Activities and gateways that ar needed for implementation: |
- | * [[:software:tim:mailnode|Mailnode]] an Entscheider | + | * [[:en:software:tim:mailnode|Mailnode]] to the decision-maker |
- | * Task zum manuellen erledigen | + | * Task for manually finishing |
- | * XOR Gateway (2x öffnend, 1x schließend) | + | * XOR Gateway (2x opnening, 1x closing) |
- | * Verbindungslinien | + | * Connection lines |
- | * Start- & Endknoten | + | * Start- & Endnode |
---- | ---- | ||
- | ==== Was benötige ich an Actionhandlern und Webservices? ==== | + | ==== Which actionhandlers and webservices do I need? ==== |
- | Actionhandler welche für die Implementierung benötigt werden: | + | Actionhandler that are needed for implementation: |
- | * Actionhandler: [[:software:tim:actionhandler:variabledecisionhandler|SmartFormDecissionHandler]] | + | * Actionhandler: [[:en:software:tim:actionhandler:variabledecisionhandler|VariableDecisionHandler]] |
- | * Actionhandler: [[:software:tim:actionhandler:processvariablesetter|ProcessVariableSetter]] (2x) | + | * Actionhandler: [[:en:software:tim:actionhandler:processvariablesetter|ProcessVariableSetter]] (2x) |
- | * Webservice: [[:software:tim:timer:setprocessvariableandsignalprocessinstancebytransitionname|setProcessVariableAndSignalProcessInstanceByTransitionName]] | + | * Webservice: [[:en:software:tim:timer:setprocessvariableandsignalprocessinstancebytransitionname|setProcessVariableAndSignalProcessInstanceByTransitionName]] |
---- | ---- | ||
- | ==== Einbindung ==== | + | ==== Integration ==== |
- | {{ :software:tim:bausteine:entscheidung_per_e-mail_und_humandecision.png?800 }} | + | {{ :en:software:tim:bausteine:email_link_and_human_decision.png?800 }} |
== Mailnode == | == Mailnode == | ||
- | Die Mailnode benötigt neben dem Text die Links um freizugeben oder abzulehnen. Diese setzen sich wie folgt zusammen: | + | The Mailnode needs besides the text the links to accept or deny. These are built as follows: |
<code> | <code> | ||
- | http://URL des Servers/loom-portal/ProcessInstanceManager/setProcessVariableAndSignalProcessInstanceByTransitionName.soap?args[0]=${processInstanceId}&args[1]=freigabe&args[2]=true&args[3]=Manuell_entscheiden&args[4]=freigabe&i=1&uid=eWl0L3BtOnRhc2shbm1vdGlvbg | + | 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 |
</code> | </code> | ||
<code> | <code> | ||
- | http://URL des Servers/loom-portal/ kann ab [[software:tim:changelog:tim35|T!M Version 3.5]] durch ${baseLink} ersetzt werden. | + | http://URL of the server/loom-portal/ can be subsituted by ${baseLink} after [[software:tim:changelog:tim35|TIM Version 3.5]]. |
</code> | </code> | ||
- | Die Parameter des Links: | + | Parameter of the links}} |
- | * args[0]: Prozessinstanz ID des Prozesses. Dieser Parameter kann so übernommen werden | + | * args[0]: Processinstance ID of the process. This parameter can be taken like this |
- | * args[1]: Variablenname welcher gesetzt werden soll | + | * args[1]: Variablename which should be set |
- | * args[2]: Wert welcher in die Variable geschrieben werden soll | + | * args[2]: Value which the varible be set as |
- | * args[3]: Name der Aktivität welche gesignalled werden soll (Im Beispielbild "Manuell_entscheiden") | + | * args[3]: Name of the activity which should be signalled (in the example "Manually_deciding") |
- | * args[4]: Technisch eindeutige Bezeichnung der Transition welche aus der gesignallten Aktivität austritt | + | * args[4]: Tehcnical unique name of the transtition which follows the signalled activity |
- | * uid: Logindaten für T!M Base64 kodiert (mandant/user:passwort) | + | * uid: Login data coded for TIM Base64 (client/user:password) |
- | >Achtung: Es wird zusätzlich noch ein Link zum Ablehnen benötigt. Hierbei ändert sich nur Parameter 2 (args[2]). >Achtung: Die ausgehende Transition aus der Aktivität "Manuell_entscheiden" benötigt eine technisch eindeutige Bezeichnung. Im Beispiel "freigabe". | + | >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". |
== Tasknode == | == Tasknode == | ||
- | Aktivität welche beim Aufruf des Links gesignalled werden soll. Diese Aktivität benötigt eine Aufgabe wie zum Beispiel "Entscheiden Sie manuell". Die ausgehende Transition dieser Aktivität benötigt eine Technisch eindeutige Bezeichnung (Im Beispiel "freigabe"). | + | 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". |
- | == Erstes XOR == | + | == First XOR == |
- | Auf dem ersten XOR wird ein [[:software:tim:actionhandler:variabledecisionhandler|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 [[:en:software:tim:actionhandler:variabledecisionhandler|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 "Release via Mail", "Decline via Mail" or "Manual Release" transistion are selected. |
- | == Zweites XOR == | + | == Second XOR == |
- | Hier wird kein [[:software:tim:actionhandler|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. | + | Here no [[en:software:tim:actionhandler|actionhandler]] is needed. This XOR is only reached, if the task "Manually_deciding" is checked by hand and no processvariable is set via the link. If this XOR is reached, a dialogue in TIM appears, in which the processor can decide over the following process sequence. Depening on the decision one of the Scriptnodes are executed. |
- | == Die Scriptnodes == | + | == The Scriptnodes == |
- | Auf den Scriptnodes der manuellen Entscheidung wird ein [[:software:tim:actionhandler:processvariablesetter|ProcessVariableSetter]] hinterlegt, welcher die Variablen aus dem Link je nach dem setzt. Dies dient zur späteren Dokumentation des Prozessverlaufs. | + | On the scriptnodes it the manual decision a [[en:software:tim:actionhandler:processvariablesetter|ProcessVariableSetter]] set, which sets the variables from link. This is for later documentation of the process sequence. |