Eingangszähler-Plugin - FORMCYCLE Wiki

author	version	line-number	content
1	Das Eingangszähler-Plugin ist ein Verarbeitungsplugin mit dem Formulare abhängig von einem formularspezifischen Zähler //online// bzw. //offline// geschaltet werden können. Das Plugin kann als [[Mandant->>doc:Formcycle.UserInterface.Client.Plugins.WebHome]] oder [[Systemplugin>>doc:Formcycle.SystemSettings.UserInterface.SystemPlugins.WebHome]] installiert werden.
2
3	== Anwendungsbeispiel ==
4	{{id name="fig_plugin_offline_counter_up"/}}
5	{{figure image="plugin_offline_counter_up_de.png"}}Verwendung des Eingangszähler-Plugins, um die Anzahl an Registrierungen durch ein Formular zu beschränken. Mit jedem Formulareingang wird der Zähler um eins erhöht. Wenn 20 Vorgänge eingegangen sind, wird das Formular //offline// geschaltet.{{/figure}}
6
7	Das Plugin wird typischerweise eingesetzt, um bspw. die Anzahl an Formularvorgängen zu zählen und das Formular ab einer bestimmten Anzahl von Vorgängen //offline// zu schalten. Dies ist bspw. bei Registrierungsformularen für Veranstaltungen erforderlich, welche eine begrenzte Anzahl an Teilnehmern erlaubt. Melden sich Nutzer von der Veranstaltung wieder ab, kann das Plugin genutzt werden, um das Formular wieder //online// zu schalten.
8
9	== Pluginparameter ==
10	{{id name="fig_plugin_offline_counter_down"/}}
11	{{figure image="plugin_offline_counter_down_de.png"}}Verwendung des Eingangszähler-Plugins, um das Formular wieder online zu schalten, wenn Nutzer absagen. Mit Benutzerabmeldung wird der Zähler um eins erniedrigt. Erreicht der Zähler einen Wert von 19 wird, wird das Formular wieder //online// geschaltet.{{/figure}}
12
13	Um das Plugin zu verwenden muss in der Aktionsverarbeitung eine Aktion des Typs Submit-Count-Plugin erstellt werden. Diese Aktion besitzt drei Parameter:
14
15	; COUNT_DIRECTION
16	: Dieser Parameter kann die Werte {{code}}UP{{/code}} oder {{code}}DOWN{{/code}} annehemen, welche angeben ob der Zähler um eins erhöht oder erniedrigt werden soll.
17	; COUNT_SET_OFFLINE
18	: Diese Parameter nimmt einen Ganzzahlwert an, welcher angibt ab welchem Zählerwert das Formular //offline// geschaltet werden soll.
19	; COUNT_SET_ONLINE
20	: Diese Parameter nimmt einen Ganzzahlwert an, welcher angibt ab welchem Zählerwert das Formular //online// geschaltet werden soll.

1

Das Eingangszähler-Plugin ist ein Verarbeitungsplugin mit dem Formulare abhängig von einem formularspezifischen Zähler //online// bzw. //offline// geschaltet werden können. Das Plugin kann als [[Mandant->>doc:Formcycle.UserInterface.Client.Plugins.WebHome]] oder [[Systemplugin>>doc:Formcycle.SystemSettings.UserInterface.SystemPlugins.WebHome]] installiert werden.

2

3

== Anwendungsbeispiel ==

4

5

{{figure image="plugin_offline_counter_up_de.png"}}Verwendung des Eingangszähler-Plugins, um die Anzahl an Registrierungen durch ein Formular zu beschränken. Mit jedem Formulareingang wird der Zähler um eins erhöht. Wenn 20 Vorgänge eingegangen sind, wird das Formular //offline// geschaltet.{{/figure}}

6

7

Das Plugin wird typischerweise eingesetzt, um bspw. die Anzahl an Formularvorgängen zu zählen und das Formular ab einer bestimmten Anzahl von Vorgängen //offline// zu schalten. Dies ist bspw. bei Registrierungsformularen für Veranstaltungen erforderlich, welche eine begrenzte Anzahl an Teilnehmern erlaubt. Melden sich Nutzer von der Veranstaltung wieder ab, kann das Plugin genutzt werden, um das Formular wieder //online// zu schalten.

8

9

== Pluginparameter ==

10

11

{{figure image="plugin_offline_counter_down_de.png"}}Verwendung des Eingangszähler-Plugins, um das Formular wieder online zu schalten, wenn Nutzer absagen. Mit Benutzerabmeldung wird der Zähler um eins erniedrigt. Erreicht der Zähler einen Wert von 19 wird, wird das Formular wieder //online// geschaltet.{{/figure}}

12

13

Um das Plugin zu verwenden muss in der Aktionsverarbeitung eine Aktion des Typs **Submit-Count-Plugin** erstellt werden. Diese Aktion besitzt drei Parameter:

14

15

; **COUNT_DIRECTION**

16

: Dieser Parameter kann die Werte {{code}}UP{{/code}} oder {{code}}DOWN{{/code}} annehemen, welche angeben ob der Zähler um eins erhöht oder erniedrigt werden soll.

17

; **COUNT_SET_OFFLINE**

18

: Diese Parameter nimmt einen Ganzzahlwert an, welcher angibt ab welchem Zählerwert das Formular //offline// geschaltet werden soll.

19

; **COUNT_SET_ONLINE**

20

: Diese Parameter nimmt einen Ganzzahlwert an, welcher angibt ab welchem Zählerwert das Formular //online// geschaltet werden soll.

Wiki-Quellcode von Eingangszähler-Plugin

Navigation