... |
... |
@@ -76,25
+76,25 @@ |
76 |
76 |
|
77 |
77 |
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: |
78 |
78 |
|
79 |
|
-{{code}} |
|
79 |
+{{code language="none"}} |
80 |
80 |
[%$DBCOUNTER.<Zählername>%] |
81 |
81 |
{{/code}} |
82 |
82 |
|
83 |
83 |
Um also etwa auf den Zähler mit dem Namen //test// zuzugreifen, muss der folgende Platzhalter genutzt werden: |
84 |
84 |
|
85 |
|
-{{code}} |
|
85 |
+{{code language="none"}} |
86 |
86 |
[%$DBCOUNTER.test%] |
87 |
87 |
{{/code}} |
88 |
88 |
|
89 |
89 |
Falls auf einen Zähler zugegriffen werden soll, bei dem nicht bekannt ist, ob es diesen schon gibt, muss der Startwert für den Zähler mit angegeben werden. Falls der Zähler noch nicht existiert, wird dann ein neuer Zähler mit diesem Startwert erstellt. Der Platzhalter baut sich dann nach folgendem Schema auf: |
90 |
90 |
|
91 |
|
-{{code}} |
|
91 |
+{{code language="none"}} |
92 |
92 |
[%$DBCOUNTER(<Zählername>, <Startwert>)%] |
93 |
93 |
{{/code}} |
94 |
94 |
|
95 |
95 |
Angenommen, der Zähler heiße //teilnehmer-2020-03-17// und soll den Wert //0// erhalten, falls er noch nicht existiert. Dann kann der folgende Platzhalter genutzt werden: |
96 |
96 |
|
97 |
|
-{{code}} |
|
97 |
+{{code language="none"}} |
98 |
98 |
[%$DBCOUNTER(teilnehmer-2020-03-17, 0)%] |
99 |
99 |
{{/code}} |
100 |
100 |
|
... |
... |
@@ -139,12
+139,14 @@ |
139 |
139 |
; counter-initial |
140 |
140 |
: Optional. Initialer Wert des Counters, wenn dieser noch nicht existiert. Dieser Parameter darf nur angegeben werden, wenn auch //counter-name// angegeben wird. |
141 |
141 |
; counter-array |
142 |
|
-: Optional. Liefert statt einem JSON-Objekt ein Array zurück. In dem können mehrere Namen oder UUID übergeben werden. Dieser Parameter darf nur angegeben werden, wenn auch //counter-name// angegeben wird. |
|
142 |
+: Optional. Entweder //true// oder //false// (Standard). Wenn auf //true// gesetzt, darf der Parameter //counter-name// beziehungsweise //id// mehrfach angegeben werden. Es wird dann Array mit den Werten den Informationen zu den einzelnen Zählern angegeben. Diese Option sollte genutzt werden, wenn in einem Formular per AJAX mehrere Zähler auf einmal abgefragt werden sollen. So kann die Anzahl an HTTP-Anfrage reduziert werden. |
143 |
143 |
|
144 |
144 |
=== HTTP-Antwort |
145 |
145 |
|
146 |
|
-Nach Ausführung des Servlet-Aktions-Plugin wird das Ergebnis als JSON-Objekt zurückgeliefert, siehe hierzu auch die Abbildung. Dieses JSON-Objekt hat die folgenden Einträge: |
|
146 |
+Nach Ausführung des Servlet-Aktions-Plugin wird das Ergebnis als JSON-Objekt zurückgeliefert, siehe hierzu auch die Abbildung. Falls der Parameter //counter-array// auf //true// gesetzt wurde, wird stattdessem ein JSON-Array zurückgegeben, wobei jeder Eintrag ein JSON-Objekt mit den unten beschriebenen Einträgen ist. |
147 |
147 |
|
|
148 |
+Das JSON-Objekt hat die folgenden Einträge: |
|
149 |
+ |
148 |
148 |
; Status |
149 |
149 |
: Gibt an, ob der Servlet-Aufruf erfolgreich war. Der Wert ist ein weiteres JSON-Objekt mit folgenden Einträgen: |
150 |
150 |
:; Msg |