| ... |
... |
@@ -371,6 +371,9 @@ |
| 371 |
371 |
; **Kategorie** |
| 372 |
372 |
: Frei definierbare Kategorisierung eines Gewinns. Wird in der Plugin-Aktion //Gewinn ermitteln// genutzt für eine möglichen Limitierung der Gewinnziehung auf eine Kategorie. |
| 373 |
373 |
|
|
374 |
+; **Gruppe** |
|
375 |
+: Frei definierbare Gruppe eines Gewinns. Wird für das Ausspielen der Meta-Daten eines Preises innerhalb des Formulars benutzt. Ein Preis ohne Gruppe steht für die Visualisierung innerhalb des Formulars nicht zur Verfügung. Bei gleichen Gruppen-Namen werden ausschließlich die Daten des ersten Preises bereitgestellt. |
|
376 |
+: |
| 374 |
374 |
; **Gewinncode** |
| 375 |
375 |
: Code des Gewinns, welcher im Gewinnspiel-Portal eingeben werden kann, um über die Plugin-Aktion //Gewinn ermitteln// einen Gewinner-Vorgang zuzuweisen. |
| 376 |
376 |
|
| ... |
... |
@@ -413,7 +413,7 @@ |
| 413 |
413 |
Auf der linken Seite der Fußzeile im Verwaltungsdialog der Gewinne befindet sich die Schaltfläche //+ Excel Import//. Nach dem Klicken auf die Schaltfläche öffnet sich ein Dateiauswahldialog, über den eine bereits bestehende lokale Excel-Datei selektiert werden kann. Die Excel-Datei muss weder vom Dateityp //.xls// oder //.xlsx// sein. |
| 414 |
414 |
|
| 415 |
415 |
Falls es sich bei der ausgewählten Datei um eine Excel-Datei handelt, öffnet sich ein Dialog zur Konfiguration des Imports der Gewinne aus der Excel-Datei. Hierbei kann zuerst das Excel-Blatt ausgewählt werden, in welchem sich die Gewinne in der Excel-Datei befinden. Über das Ankreuzfeld //Erste Zeile ignorieren// kann bei ggf. bestehenden Spaltenbeschriftungen der Gewinne die erste Zeile des Excel-Blatts ignoriert werden. |
| 416 |
|
-Über die fünf Eingabefelder können die zugehörigen Spaltennummern der Exceltabelle angegeben werden. Jedes Gewinnattribut (Name, Kategorie, Gewinncode, Gewinn-Link, Beschreibung, Bild-URL) wird genau einer Spalte in der Exceltabelle zugeordnet. Nach dem Drücken auf den Button //Importieren// werden die Gewinne erstellt auf Grundlage der Exceltabelle und sind danach im Verwaltungsdialog der Gewinne zu sehen. |
|
419 |
+Über die fünf Eingabefelder können die zugehörigen Spaltennummern der Exceltabelle angegeben werden. Jedes Gewinnattribut (Name, Kategorie, Gruppe, Gewinncode, Gewinn-Link, Beschreibung, Bild-URL) wird genau einer Spalte in der Exceltabelle zugeordnet. Nach dem Drücken auf den Button //Importieren// werden die Gewinne erstellt auf Grundlage der Exceltabelle und sind danach im Verwaltungsdialog der Gewinne zu sehen. |
| 417 |
417 |
\\{{id name="backend_prize_import"/}} |
| 418 |
418 |
|
| 419 |
419 |
|
| ... |
... |
@@ -559,6 +559,54 @@ |
| 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 |
|
|
565 |
+{{id name="config_quartz"/}} |
|
566 |
+ |
|
567 |
+== Konfiguration des Quartz-Jobs {{version major="1" minor="7"}}{{/version}} == |
|
568 |
+ |
|
569 |
+{{figure image="contest_quartz_config_de" clear="h2"}} |
|
570 |
+Konfiguration der Cron-Expression Property und Beschreibung des Quartz-Jobs |
|
571 |
+{{/figure}} |
|
572 |
+ |
|
573 |
+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. |
|
574 |
+ |
|
575 |
+; portal.contestent.deletion.cron |
|
576 |
+: Ü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. |
|
577 |
+ |
|
578 |
+== Plugin-Aktion: Gewinn ermitteln {{version major="1" minor="6"}}{{/version}} == |
|
579 |
+ |
|
580 |
+{{figure image="aktion_prize_chance.png" clear="h2"}} |
|
581 |
+Nutzeroberfläche für Plugin-Aktion vom Typ //Gewinn ermitteln// |
|
582 |
+{{/figure}} |
|
583 |
+ |
|
584 |
+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. |
|
585 |
+ |
|
586 |
+=== Parameter === |
|
587 |
+ |
|
588 |
+==== Ziehmodus ==== |
|
589 |
+ |
|
590 |
+; **Gewinncode** |
|
591 |
+: 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. |
|
592 |
+ |
|
593 |
+; **Gewinnchance** |
|
594 |
+: Durch den Zieh-Modus //Gewinnchance// kann das Ziehen auf eine bestehende Kategorie der Gewinne beschränkt werden, durch das Auswahlmenü //Limitieren auf Kategorie//. |
|
595 |
+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. |
|
596 |
+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. |
|
597 |
+ |
|
598 |
+=== Rückgabewert der Plugin-Aktion === |
|
599 |
+ |
|
600 |
+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.Designer.Workflow.LegacyWorkflow.ActionConditions]] einer Aktion vom Typ [[Statusänderung>>doc:Formcycle.Designer.Workflow.LegacyWorkflow.Actions.ChangeState]] bei Erfolg der Aktion //Gewinn ermitteln//. Hier könnte im geänderten Status nun über eine Aktion vom Typ [[Abschlussseite>>doc:Formcycle.Designer.Workflow.LegacyWorkflow.Actions.ResponsePage]] ein bestimmtes HTML-Template angezeigt werden. |
|
601 |
+ |
|
602 |
+**Über die folgenden Aktionsplatzhalter kann auf die zurückgegebenen Attribute der Plugin-Aktion in FORMCYCLE zugegriffen werden:** |
|
603 |
+ |
|
604 |
+|=Rückgabewert|=Beschreibung |
|
605 |
+|[%$Aktionsname.SUCCESS%]|Aktion war erfolgreich und der abgeschickte Vorgang hat einen Gewinn gezogen. Dieser Wert kann true oder false sein |
|
606 |
+|[%$Aktionsname.RESULT[0].uuid%]|Eindeutige UUID des erhaltenen Gewinns |
|
607 |
+|[%$Aktionsname.RESULT[0].description%]|Beschreibung des erhaltenen Gewinns |
|
608 |
+|[%$Aktionsname.RESULT[0].category%]|Kategorie des erhaltenen Gewinns |
|
609 |
+|[%$Aktionsname.RESULT[0].process%]|Eindeutige UUID des Gewinner-Vorgangs |
|
610 |
+|[%$Aktionsname.RESULT[0].picture%]|Bild-URL des erhaltenen Gewinns |
|
611 |
+|[%$Aktionsname.RESULT[0].link%]|Gewinn-Link des erhaltenen Gewinns |
|
612 |
+ |
| 562 |
562 |
== JavaScript-Schnittstellen == |
| 563 |
563 |
|
| 564 |
564 |
=== Allgemein === |
| ... |
... |
@@ -791,6 +791,20 @@ |
| 791 |
791 |
|
| 792 |
792 |
== Versionshistorie == |
| 793 |
793 |
|
|
845 |
+=== 1.7.1 === |
|
846 |
+ |
|
847 |
+* Funktionalität zum Bereitstellen der MetaDaten von Preisen für die Visualisierung innerhalb des Formulars (PreRender-Plugin) |
|
848 |
+* Preis-Gruppen für die Zusammenfassung der zu visualisierenden Preise |
|
849 |
+ |
|
850 |
+=== 1.7.0 === |
|
851 |
+ |
|
852 |
+* Funktionalität zur Pflegung von Löschfristen und Ausführung eines Quartz-Jobs zur Anwendung der gepflegten Löschfristen |
|
853 |
+ |
|
854 |
+=== 1.6.0 === |
|
855 |
+ |
|
856 |
+* Funktionalität zur Pflegung von Gewinnen eines Gewinnspiels und Import von Gewinnen aus Excel-Dateien |
|
857 |
+* Aktion zur Ermittlung und Prüfung von Gewinnen anhand von Gewinncodes oder konfigurierbarer Wahrscheinlichkeit |
|
858 |
+ |
| 794 |
794 |
=== 1.5.0 === |
| 795 |
795 |
|
| 796 |
796 |
* Funktionalität zum Exportieren der aktuellen Teilnehmer-Liste anhand der Porjekt-spezifischen Postfach-Ansicht |
