| ... |
... |
@@ -220,6 +220,58 @@ |
| 220 |
220 |
|
| 221 |
221 |
{{/panel}} |
| 222 |
222 |
|
|
223 |
+==== 2.1.1 Rückgabewerte der Workflow-Aktion ==== |
|
224 |
+ |
|
225 |
+{{figure image="plugin_init_result.png"}} |
|
226 |
+Rückgabewert und Fehlercodes der Aktion |
|
227 |
+{{/figure}} |
|
228 |
+ |
|
229 |
+__Rückgabewerte__ |
|
230 |
+ |
|
231 |
+; [%$[Name der Aktion].RESULT.BestellPosition[i]['key']%] |
|
232 |
+: ((( |
|
233 |
+ Eine Auflistung über alle Bestell-Positionen, welche in der aktuellen Bestellung enthalten sind. |
|
234 |
+ Zu jeder Bestell-Position können folgende Werte abgefragt werden: |
|
235 |
+ |
|
236 |
+* Artikelnummer: Die am //EPayment Artikel// hinterlegte eindeutige Kennung für den Artikel |
|
237 |
+* Buchungstext: Der übermittelte Buchungstext (max.21 Zeichen, SEPA konform) |
|
238 |
+* Menge: Die bestellte Menge für die aktuelle Bestell-Position |
|
239 |
+* Beschreibung: Die am //EPayment Artikel// hinterlegte Artikel-Beschreibung |
|
240 |
+* Einzelpreis: Der am //EPayment Artikel// hinterlegte Preis für ein Stück. Ausgabe mit Währungssymbol. |
|
241 |
+* Preis: Der errechnete Gesamtpreis für die aktuelle Bestell-Position. Ergibt sich aus //Menge x Einzelpreis//. Ausgabe mit Währungssysmbol |
|
242 |
+ |
|
243 |
+ Nachfolgend einige Beispiele für die Datenabfrage aus den Bestellpositionen: |
|
244 |
+ Für die Beispiele wird folgender durch die Aktion bereitgestellter Platzhalter zu Grunde gelegt *[%$Bestellung übermitteln.RESULT.Bestellung[i][''key'']%]* |
|
245 |
+ Die in den eckigen Klammern hinterlegten Werte sind variabel und haben folgende Bedeutung: |
|
246 |
+ |
|
247 |
+* i: Zählvariable für den Zugriff auf eine Bestell-Position aus der Gruppe aller Bestell-Positionen. Ein möglicher Wert muss sich im Bereich von 0 bis zum Wert der BestellPositionAnzahl -1 befinden. |
|
248 |
+* key: Schlüssel für den Zugriff auf die jeweilige Eigenschaft |
|
249 |
+ |
|
250 |
+ Beispiele (mit einer Aktion Namens //Bestellung übermitteln//): |
|
251 |
+ Abfrage des Einzelpreises an der 1. Bestell-Position: *[%$Bestellung übermitteln.RESULT.Bestellung[0][''Einzelpreis'']%]* |
|
252 |
+ Abfrage der Menge an der 3. Bestell-Position: *[%$Bestellung übermitteln.RESULT.Bestellung[2][''Menge'']%]* |
|
253 |
+))) |
|
254 |
+; [%$[Name der Aktion].RESULT.BestellPositionAnzahl%] |
|
255 |
+: Die Gesamtanzahl der Bestellpositionen, welche in der aktuellen Bestellung enthalten sind |
|
256 |
+; [%$[Name der Aktion].RESULT.Gesamtbetrag%] |
|
257 |
+: Der in der Zahlungstransaktion ausgewiesene zu zahlende Geldbetrag. Angabe in Euro |
|
258 |
+; [%$[Name der Aktion].RESULT.Kassenzeichen%] |
|
259 |
+: Das aktuelle Kassenzeichen unter dem die Zahlungstransaktion im ePay-BL Portal geführt wird. |
|
260 |
+; [%$[Name der Aktion].RESULT.UrlToPaypage%] |
|
261 |
+: Die URL zur Bezahlseite auf Seiten von ePay-BL, wo die Bezahlung der aktuellen Transaktion durchgeführt werden kann. |
|
262 |
+ |
|
263 |
+__Fehlercodes__ |
|
264 |
+ |
|
265 |
+; NO_ORDER_DATA |
|
266 |
+: Fehlercode, wenn zur Laufzeit keine Bestellpositionen übermittelt wurden. Diese kann beispielweise auftreten, wenn der Formular-Nutzer beispielsweise keine Artikel zum Bestellen ausgewählt hatte. |
|
267 |
+; SRV_NOT_AVIALABLE |
|
268 |
+: Fehlercode, wenn der ePay-BL Service nicht verfügbar ist. |
|
269 |
+; SRV_METHOD_ERROR |
|
270 |
+: Fehlercode, wenn eine ePay-BL Webservice-Methode einen Fehler lieferte. Bei Auftreten von solchen Fehlertypen sollte das |
|
271 |
+{{formcycle/}} interne Fehler-Protokoll für eine tiefere Analyse einbezogen werden. |
|
272 |
+; INTERNAL_ERROR |
|
273 |
+: Fehlercode für einen nicht nähere beschriebenen Fehler. Bei Auftreten von solchen Fehlertypen sollte das |
|
274 |
+{{formcycle/}} interne Fehler-Protokoll für eine tiefere Analyse einbezogen werden. |
| 223 |
223 |
{{id name="plugin_event_epay_success"/}} |
| 224 |
224 |
|
| 225 |
225 |
=== 2.2. Workflow-Ereignis //Bezahlung erfolgreich// === |
