| ... |
... |
@@ -572,6 +572,41 @@ |
| 572 |
572 |
; portal.contestent.deletion.cron |
| 573 |
573 |
: Über die Plugin-Property //portal.contestent.deletion.cron// kann eine Cron-Expression angegeben werden, damit ein Job mit dieser Cron-Expression angelegt wird. Um die Erstellung einer Cron-Expression zu erleichtern kann beispielsweise das Online-Tool CronMaker verwendet werden: [[cronmaker.com>>url:http://cronmaker.com]]. In der Beschreibung des Portalplugins wird nach Speicherung der Plugin-Property noch einmal erfasst, ob der Quartz-Job angelegt werden konnte bzw. ob die Cron-Expression damit valide ist und wann der Job als Nächstes ausgeführt wird. |
| 574 |
574 |
|
|
575 |
+== Plugin-Aktion: Gewinn ermitteln {{version major="1" minor="6"}}{{/version}} == |
|
576 |
+ |
|
577 |
+{{figure image="aktion_prize_chance.png" clear="h2"}} |
|
578 |
+Nutzeroberfläche für Plugin-Aktion vom Typ //Gewinn ermitteln// |
|
579 |
+{{/figure}} |
|
580 |
+ |
|
581 |
+Die Plugin-Aktion //Gewinn ermitteln// ermöglicht es, durch Eingabe eines Gewinncodes im Gewinnspiel-Formular oder durch eine konfigurierbare Wahrscheinlichkeit, Gewinne für eingegangene Vorgänge zu ermitteln. |
|
582 |
+ |
|
583 |
+=== Parameter === |
|
584 |
+ |
|
585 |
+==== Ziehmodus ==== |
|
586 |
+ |
|
587 |
+; **Gewinncode** |
|
588 |
+: Beim Zieh-Modus Gewinncode muss über das Gewinnspiel-Formular ein Gewinncode eingegeben werden, wobei bei Übereinstimmung mit dem Gewinncode eines bestehenden Gewinns des Gewinnspiels dies am Gewinn vermerkt wird. Hierfür muss über das Textfeld //Gewinncodefeld// das zugehörige Eingabetextfeldelement des Formulars für den Gewinncode angegeben werden. |
|
589 |
+ |
|
590 |
+; **Gewinnchance** |
|
591 |
+: Durch den Zieh-Modus //Gewinnchance// kann das Ziehen auf eine bestehende Kategorie der Gewinne beschränkt werden, durch das Auswahlmenü //Limitieren auf Kategorie//. |
|
592 |
+Die konfigurierbare Wahrscheinlichkeit wird über das Textfeld //Gewinnchance 1 zu// angegeben. Hierbei wird z.B. bei Eingabe einer 100 die Gewinnchance 1 zu 100 genutzt. |
|
593 |
+Falls ein Gewinner über die Gewinnchance ermittelt wird, wird in der ausgewählten limitierten Kategorie ebenfalls ein zufälliger Gewinn aus der Gewinnkategorie ausgewählt. |
|
594 |
+ |
|
595 |
+=== Rückgabewert der Plugin-Aktion === |
|
596 |
+ |
|
597 |
+Rückgabewert der Aktion sind die Attribute des möglichen Gewinns, welche über [[Aktionsplatzhalter>>doc:Formcycle.UserInterface.Variables||anchor="HAktionsplatzhalter"]] ausgelesen werden können. So können sie zum Beispiel in [[HTML-Templates>>Formcycle.UserInterface.FilesAndTemplates.HTML]] im Gewinnspiel-Portal angezeigt werden. Ein weiterer Anwendungsfall wäre die Verwendung als [[Abarbeitungsbedingung>>doc:Formcycle.UserInterface.MyForms.WorkflowProcessing.ActionConditions]] einer Aktion vom Typ [[Statusänderung>>doc:Formcycle.UserInterface.MyForms.WorkflowProcessing.Actions.ChangeState]] bei Erfolg der Aktion //Gewinn ermitteln//. Hier könnte im geänderten Status nun über eine Aktion vom Typ [[Abschlussseite>>doc:Formcycle.UserInterface.MyForms.WorkflowProcessing.Actions.ResponsePage]] ein bestimmtes HTML-Template angezeigt werden. |
|
598 |
+ |
|
599 |
+**Über die folgenden Aktionsplatzhalter kann auf die zurückgegebenen Attribute der Plugin-Aktion in FORMCYCLE zugegriffen werden:** |
|
600 |
+ |
|
601 |
+|=Rückgabewert|=Beschreibung |
|
602 |
+|[%$Aktionsname.SUCCESS%]|Aktion war erfolgreich und der abgeschickte Vorgang hat einen Gewinn gezogen. Dieser Wert kann true oder false sein |
|
603 |
+|[%$Aktionsname.RESULT[0].uuid%]|Eindeutige UUID des erhaltenen Gewinns |
|
604 |
+|[%$Aktionsname.RESULT[0].description%]|Beschreibung des erhaltenen Gewinns |
|
605 |
+|[%$Aktionsname.RESULT[0].category%]|Kategorie des erhaltenen Gewinns |
|
606 |
+|[%$Aktionsname.RESULT[0].process%]|Eindeutige UUID des Gewinner-Vorgangs |
|
607 |
+|[%$Aktionsname.RESULT[0].picture%]|Bild-URL des erhaltenen Gewinns |
|
608 |
+|[%$Aktionsname.RESULT[0].link%]|Gewinn-Link des erhaltenen Gewinns |
|
609 |
+ |
| 575 |
575 |
== JavaScript-Schnittstellen == |
| 576 |
576 |
|
| 577 |
577 |
=== Allgemein === |
