| ... |
... |
@@ -559,54 +559,6 @@ |
| 559 |
559 |
|contest-portal.title.html|Titel der Gewinnspiel-Portalseite |
| 560 |
560 |
|expired-overlay.png|Overlay-Grafik welche über dem Gewinnspielbanner angezeigt wird sobald dieses abgelaufen ist |
| 561 |
561 |
|
| 562 |
|
-{{id name="config_quartz"/}} |
| 563 |
|
- |
| 564 |
|
-== Konfiguration des Quartz-Jobs {{version major="1" minor="7"}}{{/version}} == |
| 565 |
|
- |
| 566 |
|
-{{figure image="contest_quartz_config_de" clear="h2"}} |
| 567 |
|
-Konfiguration der Cron-Expression Property und Beschreibung des Quartz-Jobs |
| 568 |
|
-{{/figure}} |
| 569 |
|
- |
| 570 |
|
-Das automatisierte Löschen und die damit verbundene Überprüfung der [[Löschfristen>>doc:Formcycle.PluginDocumentation.ContestPortalPlugin.WebHome||anchor="deletions"]] aller Gewinnspiele wird durch einen Quartz-Job ermöglicht, welcher eine Cron-Expression benötigt, die angibt, wann dieser Job ausgeführt wird. Standardmäßig ist kein Quartz-Job mit Cron-Expression hinterlegt. |
| 571 |
|
- |
| 572 |
|
-; portal.contestent.deletion.cron |
| 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 |
|
- |
| 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 |
|
- |
| 610 |
610 |
== JavaScript-Schnittstellen == |
| 611 |
611 |
|
| 612 |
612 |
=== Allgemein === |
| ... |
... |
@@ -839,15 +839,6 @@ |
| 839 |
839 |
|
| 840 |
840 |
== Versionshistorie == |
| 841 |
841 |
|
| 842 |
|
-=== 1.7.0 === |
| 843 |
|
- |
| 844 |
|
-* Funktionalität zur Pflegung von Löschfristen und Ausführung eines Quartz-Jobs zur Anwendung der gepflegten Löschfristen |
| 845 |
|
- |
| 846 |
|
-=== 1.6.0 === |
| 847 |
|
- |
| 848 |
|
-* Funktionalität zur Pflegung von Gewinnen eines Gewinnspiels und Import von Gewinnen aus Excel-Dateien |
| 849 |
|
-* Aktion zur Ermittlung und Prüfung von Gewinnen anhand von Gewinncodes oder konfigurierbarer Wahrscheinlichkeit |
| 850 |
|
- |
| 851 |
851 |
=== 1.5.0 === |
| 852 |
852 |
|
| 853 |
853 |
* Funktionalität zum Exportieren der aktuellen Teilnehmer-Liste anhand der Porjekt-spezifischen Postfach-Ansicht |