Summary

• Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

...	...	@@ -111,25 +111,25 @@
111	111	; 5 - CounterAfterReset
112	112	: In case the counter was reset: The numerical value of the counter before the reset.
113	113
114		-== Systemplatzhalter-Plugin ==
	114	+== System variable plugin ==
115	115
116	116	{{figure image="dbcounter-plugin-placeholder_en.png"}}
117		-Ein Beispiel für den Platzhalter zum Auslesen des Zählwerts. Hier wird ein Zähler ausgelesen, der die Anzahl an Anmeldungen für eine Veranstaltung zählt. Dann wird geprüft, ob der Zählwert die maximale Anzahl an Anmeldungen übersteigt. Basierend auf dieser Prüfung kann dem Nutzer dann ein Fehler angezeigt werden, falls die Veranstaltung bereits ausgebucht ist. Hierbei handelt es sich um eine serverseitige Prüfung zur Validierung, bereits im Formular bei der Anmeldung sollte dem Nutzer natürlich schon die Information gegeben werden, ob überhaupt noch Plätze frei sind.
	117	+An example for how a counter value can be accessed via variables. Here we read the value of a counter that keeps track of the number of reservations for an event. When the user submits the reservation form, we check the current value of the counter against the limit for that event. When the limit is exceeded, we can return an appropriate error message to the users. Please note that this is meant as a server-side validation - to make the form user-friendly, you should indicate the number of free slots in the form itself.
118	118	{{/figure}}
119	119
120		-Nach Installation des Plugins ist ein neuer [[Systemplatzhalter>>doc:Formcycle.UserInterface.Variables]] verfügbar, über den auf den aktuellen Wert eines Zählers zugegriffen werden kann. Dies ist etwa nützlich, um in einer Aktionsbedingung den Zählwert nutzen und prüfen zu können. Der Platzhalter baut sich nach dem folgenden Schema auf:
	120	+Once the plugin is installed, you can access the current value of the plugin with a [[system variable>>doc:Formcycle.UserInterface.Variables]]. This can be used, for example, to access the counter value in the condition of a workflow action and compare it with a submitted value. The system variable has got the following pattern:
121	121
122	122	{{code}}
123		-[%$DBCOUNTER.<Zählername>%]
	123	+[%$DBCOUNTER.<CounterName>%]
124	124	{{/code}}
125	125
126		-Um also etwa auf den Zähler mit dem Name //test// zuzugreifen, muss der folgende Platzhalter genutzt werden:
	126	+So to access the value of a counter named //test//, you can use the following variable:
127	127
128	128	{{code}}
129	129	[%$DBCOUNTER.test%]
130	130	{{/code}}
131	131
132		-== Servlet-Aktions-Plugin ==
	132	+== Servlet action plugin ==
133	133
134	134	{{figure image="dbcounter_plugin_servlet_action.png"}}
135	135	Beispiel zum Auslesen eines Zählers im Formular mittels AJAX. Die URL wird anhand der im Formular zur Verfügung stehenden Metadaten aufgebaut. Hiermit wird vermieden, die URL hart im Quelltext zu hinterlegen, was zu Fehlern führt, wenn sich etwa der Server oder der Kontextpfad ändern sollte.