... |
... |
@@ -371,9 +371,6 @@ |
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 |
|
-: |
377 |
377 |
; **Gewinncode** |
378 |
378 |
: Code des Gewinns, welcher im Gewinnspiel-Portal eingeben werden kann, um über die Plugin-Aktion //Gewinn ermitteln// einen Gewinner-Vorgang zuzuweisen. |
379 |
379 |
|
... |
... |
@@ -416,7 +416,7 @@ |
416 |
416 |
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. |
417 |
417 |
|
418 |
418 |
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. |
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. |
|
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. |
420 |
420 |
\\{{id name="backend_prize_import"/}} |
421 |
421 |
|
422 |
422 |
|
... |
... |
@@ -575,41 +575,6 @@ |
575 |
575 |
; portal.contestent.deletion.cron |
576 |
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 |
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 |
|
- |
613 |
613 |
== JavaScript-Schnittstellen == |
614 |
614 |
|
615 |
615 |
=== Allgemein === |
... |
... |
@@ -842,20 +842,6 @@ |
842 |
842 |
|
843 |
843 |
== Versionshistorie == |
844 |
844 |
|
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 |
|
- |
859 |
859 |
=== 1.5.0 === |
860 |
860 |
|
861 |
861 |
* Funktionalität zum Exportieren der aktuellen Teilnehmer-Liste anhand der Porjekt-spezifischen Postfach-Ansicht |