Änderungen von Dokument Verwendung


Von Version 26.1
bearbeitet von fse
am 15.02.2023, 15:59
Änderungskommentar: Neues Bild plugin_init_config_mandant.png hochladen
Auf Version 1.6
bearbeitet von fse
am 23.12.2022, 15:26
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Inhalt
... ... @@ -3,7 +3,7 @@
3 3  {{info}}
4 4  **Achtung:**
5 5  Seit Plugin-Version {{version major="4" minor="0" patch="0"}}{{/version}} ist ein Anbindung an von der AKDB unabhängigen Anbietern möglich. Alte AKDB spezifische Plugin-Versionen sind [[**unter diesem Link **>>url:https://customer.formcycle.eu/index.php/apps/files/?dir=/FORMCYCLE%20-%20Plugins%20Customer/AKDB%3A%20EPayment%20plugin%20(plugin-bundle-akdb-epayment)&fileid=2674||rel="noopener noreferrer" target="_blank"]] (Anmeldung erforderlich) zu finden.
6 -Bezahlvorgänge, welche in einer früheren Version abgebrochen wurden, können nicht in der Plugin-Version {{version major="4" minor="0" patch="0"}}{{/version}} abgeschlossen werden.
6 +**Es wird eine minor Version folgen, welche die Migration von alten Plugin-Versionen erleichtert.**
7 7  {{/info}}
8 8  
9 9  {{content/}}
... ... @@ -40,9 +40,9 @@
40 40  {{/figure}}
41 41  
42 42  Über das Formular-Element //EPayment Artikel// werden die für eine Bestell-Transaktion notwendigen Artikel definiert.
43 -Das Formular-Element dient dabei zum Einen für eine visuelle Darstellung des Artikels (mit Bild, Beschreibung, Preisangabe, Eingabemöglichkeit für Bestellmenge) innerhalb eines Formulars, als auch als Vorlage für die Erstellung einer konkreten Bestellposition zum Zeitpunkt der Ausführung einer Bezahl-Transaktion.
43 +Das Formular-Element dient dabei zum Einen für eine visuelle Darstellung des Artikels (mit Bild, Beschreibung, Preisangabe, Eingabemöglichkeit für Bestellmenge) innerhalb eines Formulars, als auch als Vorlage für die Erstellung einer konkreten Bestellposition zum Zeitpunkt der Ausführung einer Bezahl-Transaktion.
44 44  
45 -Bestellpositionen können auch direkt in der Workflow-Aktion definiert werden.
45 +Ab Plugin-Version {{version major="3" minor="3" patch="0"}}{{/version}} können Bestellpositionen auch direkt in der Workflow-Aktion definiert werden.
46 46  Dadurch muss kein //EPayment Artikel// zwingend im Formular vorhanden sein. Bei Konfiguration der Workflow-Aktion **[[Bestellung übermitteln>>doc:||anchor="plugin_epay_init"]]** wird geprüft, dass mindestens ein //EPayment Artikel// im Formular oder eine Bestellposition direkt in der Workflow-Aktion vorhanden ist.
47 47  
48 48  __Grundeigenschaften:__
... ... @@ -203,27 +203,28 @@
203 203  
204 204  {{/panel}}
205 205  
206 -{{panel title="Konfiguration ePayBL ePayment-Mandant" fullwidth="true" initial="visible" triggerable="true"}}
206 +{{panel title="Konfiguration AKDB ePayment-Mandant" fullwidth="true" initial="visible" triggerable="true"}}
207 207  
208 -{{figure image="plugin_init_config_mandant.png"}}
208 +{{figure image="plugin_init_config_akdb_mandant.png"}}
209 209  Konfiguration ePayBL EPayment-Mandant
210 210  {{/figure}}
211 211  
212 -In diesem Bereich können die globalen Einstellungen für den zu verwendenden ePayBL Mandanten übersteuert werden. Die Einstellungen zum ePayBL Mandanten sind notwendig, um später die Transaktion auf Seiten von ePayBL der richtigen Behörde (entspricht der festgelegten Mandant-Nummer), dem Bewirtschafter und der Haushaltsstelle zuzuordnen.
213 -Diese Einstellungen wurden möglicherweise bereits durch einen Xima® Formcycle-Administrator und/oder Mandant-Administrator global hinterlegt. Entsprechende Werte werden als Platzhalter angezeigt.
212 +In diesem Bereich können die globalen Einstellungen für den zu verwendenden ePayBL Mandanten übersteuert werden. Die Einstellungen zum ePayBL Mandanten sind notwendig, um später die Transaktion auf Seiten von ePayBL
213 +der richtigen Behörde (entspricht der festgelegten Mandant-Nummer), dem Bewirtschafter und der Haushaltsstelle zuzuordnen.
214 +In den meisten Fällen sind diese Einstellungen bereits durch einen Plugin-Administrator global hinterlegt worden, sodass an dieser Stelle keine Konfiguration notwendig ist.
214 214  
215 215  Die einzelnen Parameter können per Platzhalter oder fest definiert hinterlegt werden. Weiterhin kann über den Button [[image:icon_update.png]] //Webservice Erreichbarkeit prüfen// die generelle Erreichbarkeit des EPayment Webservice geprüft werden.
216 216  
217 217  ; Mandant-Nummer
218 -: ePayBL-Mandantennummer des aufrufenden eShops (FORMCYCLE) (Wird durch ePayBL-System vorgegeben)
219 +: AKDB-Mandantennummer des aufrufenden eShops (FORMCYCLE) (Wird durch ePay-BL-System vorgegeben)
219 219  ; Bewirtschafter-Nummer
220 -: Bewirtschafternummer (Wird durch ePayBL-System vorgegeben)
221 +: Bewirtschafternummer (Wird durch ePay-BL-System vorgegeben)
221 221  ; Haushaltsstelle
222 -: Nummer der Haushaltsstelle, welcher die Buchung zugeordnet werden soll. (Wird durch ePayBL-System vorgegeben)
223 +: Nummer der Haushaltsstelle, welcher die Buchung zugeordnet werden soll. (Wird durch ePay-BL-System vorgegeben)
223 223  ; Objektnummer
224 -: Dient der internen Verbuchung im EPayment-System. (Wird durch ePayBL-System vorgegeben)
225 +: Dient der internen Verbuchung im EPayment-System. (Wird durch ePay-BL-System vorgegeben)
225 225  ; Kennzeichen-Mahnverfahren
226 -: Einstellung für das Kennzeichen in einem Mahnverfahren. (Mögliche Werte werden durch ePayBL-System vorgegeben)
227 +: Einstellung für das Kennzeichen in einem Mahnverfahren. (Mögliche Werte werden durch ePay-BL-System vorgegeben)
227 227  ; Fälligkeitszeitraum
228 228  : Einstellung für die Berechnung des Fälligkeitszeitraumes der Zahlung (Dauer in Tagen).
229 229  
... ... @@ -268,19 +268,19 @@
268 268  ; [%$[Name der Aktion].RESULT.Gesamtbetrag%]
269 269  : Der in der Zahlungstransaktion ausgewiesene zu zahlende Geldbetrag. Angabe in Euro
270 270  ; [%$[Name der Aktion].RESULT.Kassenzeichen%]
271 -: Das aktuelle Kassenzeichen unter dem die Zahlungstransaktion im ePayBL Portal geführt wird.
272 +: Das aktuelle Kassenzeichen unter dem die Zahlungstransaktion im ePay-BL Portal geführt wird.
272 272  ; [%$[Name der Aktion].RESULT.UrlToPaypage%]
273 -: Die URL zur Bezahlseite auf Seiten von ePayBL, wo die Bezahlung der aktuellen Transaktion durchgeführt werden kann.
274 +: Die URL zur Bezahlseite auf Seiten von ePay-BL, wo die Bezahlung der aktuellen Transaktion durchgeführt werden kann.
274 274  
275 275  __Fehlercodes__
276 276  
277 277  ; NO_ORDER_DATA
278 -: Fehlercode, wenn zur Laufzeit keine Bestellpositionen übermittelt wurden. Diese kann beispielweise auftreten, wenn der Formular-Nutzer beispielsweise keine Artikel zum Bestellen ausgewählt hatte.
279 +: Fehlercode, wenn zur Laufzeit keine Bestellpositionen übermittelt wurden. Diese kann beispielweise auftreten, wenn der Formular-Nutzer beispielsweise keine Artikel zum Bestellen ausgewählt hatte.
279 279  ; SRV_NOT_AVIALABLE
280 -: Fehlercode, wenn der ePayBL Service nicht verfügbar ist.
281 +: Fehlercode, wenn der ePay-BL Service nicht verfügbar ist.
281 281  ; SRV_METHOD_ERROR
282 -: Fehlercode, wenn eine ePayBL Webservice-Methode einen Fehler lieferte. Bei Auftreten von solchen Fehlertypen sollte das
283 -{{formcycle/}} interne Fehler-Protokoll für eine tiefere Analyse einbezogen werden.
283 +: Fehlercode, wenn eine ePay-BL Webservice-Methode einen Fehler lieferte. Bei Auftreten von solchen Fehlertypen sollte das
284 +{{formcycle/}} interne Fehler-Protokoll für eine tiefere Analyse einbezogen werden.
284 284  ; INTERNAL_ERROR
285 285  : Fehlercode für einen nicht nähere beschriebenen Fehler. Bei Auftreten von solchen Fehlertypen sollte das
286 286  {{formcycle/}} interne Fehler-Protokoll für eine tiefere Analyse einbezogen werden.
... ... @@ -292,12 +292,12 @@
292 292  Workflow-Ereignis bei erfolgreicher Bezahlung
293 293  {{/figure}}
294 294  
295 -Eine Workflow-Verarbeitungskette mit diesem Ereignis wird ausgeführt, wenn eine Rückleitung aus dem ePayBL Portal erfolgt
296 +Eine Workflow-Verarbeitungskette mit diesem Ereignis wird ausgeführt, wenn eine Rückleitung aus dem ePay-BL Portal erfolgt
296 296  und die Bezahlung erfolgreich durchgeführt wurde. Pro Formular-Vorgang kann dieses Ereignis genau einmal eintreten.
297 297  Das Ereignis stellt dabei folgende Werte bereit, die per Platzhalter in nachfolgenden Aktionen ausgewertet werden können:
298 298  
299 299  ; **[%$TRIGGER.paymentStatus%]**
300 -: Bezeichnung des Status, wie er vom ePayBL Portal zurück geliefert wird. (Möglicher Wert: INAKTIV)
301 +: Bezeichnung des Status, wie er vom ePay-BL Portal zurück geliefert wird. (Möglicher Wert: INAKTIV)
301 301  ; **[%$TRIGGER.paymentStatusText%]**
302 302  : Eine Nachricht, die den zurück gelieferten Status näher beschreibt
303 303  ; **[%$TRIGGER.paymentMethod%] {{version major="3" minor="5"}}{{/version}}**
... ... @@ -311,14 +311,14 @@
311 311  Workflow-Ereignis bei nicht erfolgreicher Bezahlung
312 312  {{/figure}}
313 313  
314 -Eine Workflow-Verarbeitungskette mit diesem Ereignis wird immer dann ausgeführt, wenn eine Rückleitung aus dem ePayBL Portal erfolgte
315 -und die Bezahlung nicht durchgeführt wurde. Pro Formular-Vorgang kann dieses Ereignis mehrfach eintreten (Bei Fehlern im ePayBL Portal oder bei Abbruch des Bezahlvorgangs durch den Nutzer).
315 +Eine Workflow-Verarbeitungskette mit diesem Ereignis wird immer dann ausgeführt, wenn eine Rückleitung aus dem ePay-BL Portal erfolgte
316 +und die Bezahlung nicht durchgeführt wurde. Pro Formular-Vorgang kann dieses Ereignis mehrfach eintreten (Bei Fehlern im ePay-BL Portal oder bei Abbruch des Bezahlvorgangs durch den Nutzer).
316 316  Das Ereignis stellt folgende Werte bereit, die per Platzhalter in nachfolgenden Aktionen ausgewertet werden können:
317 317  
318 318  ; **[%$TRIGGER.paymentStatus%]**
319 -: Bezeichnung des Status, wie er vom ePayBL Portal zurückgeliefert wird.
320 +: Bezeichnung des Status, wie er vom ePay-BL Portal zurückgeliefert wird.
320 320  : Folgende Werte sind möglich:
321 -: **AKTIV**: Die Bezahlung über die PayPage ist noch nicht erfolgt (z.B. weil der Nutzer den Bezahlvorgang auf Seiten von ePayBL abgebrochen hat).
322 +: **AKTIV**: Die Bezahlung über die PayPage ist noch nicht erfolgt (z.B. weil der Nutzer den Bezahlvorgang auf Seiten von ePay-BL abgebrochen hat).
322 322  : **MANDANT_NICHT_GEFUNDEN**: Der Mandant wurde im ePayment-System nicht gefunden.
323 323  : **MANDANT_INAKTIV**: Der Mandant ist im ePayment-System derzeit als inaktiv gekennzeichnet.
324 324  : **VERBINDUNG_OHNE_HTTPS**: Die Verbindung zum Webservice erfolgte nicht über HTTPS mit Client-Zertifikaten.
... ... @@ -341,9 +341,9 @@
341 341  Die Anzeige des Ergebnisses bzw. des Status einer Bezahl-Transaktion erfolgt standardmäßig mittels einer extra Abschluss-Seite.
342 342  Dafür stellt das Plugin 3 HTML-Templates bereit:
343 343  
344 -* **ePayBL ePayment Bezahlung Erfolg**: Standard-Template für Anzeige bei erfolgreich abgeschlossener Bezahlung.
345 -* **ePayBL ePayment Bezahlung Fehler**: Standard-Template für Anzeige bei offenen bzw. fehlerhaft beendeten Bezahlvorgang. Dieser Template enthält Platzhalter für Anzeige des konkreten Fehlers und einen Link zum Wiederaufruf des noch ausstehenden Bezahlvorgangs.
346 -* **ePayBL ePayment Fehler**: Standard-Template für Anzeige bei allgemeinen technischen Fehlern. Der genaue Fehler wird mittels enthaltener Platzhalter ausgewiesen.
345 +* **AKDB ePayment Bezahlung Erfolg**: Standard-Template für Anzeige bei erfolgreich abgeschlossener Bezahlung.
346 +* **AKDB ePayment Bezahlung Fehler**: Standard-Template für Anzeige bei offenen bzw. fehlerhaft beendeten Bezahlvorgang. Dieser Template enthält Platzhalter für Anzeige des konkreten Fehlers und einen Link zum Wiederaufruf des noch ausstehenden Bezahlvorgangs.
347 +* **AKDB ePayment Fehler**: Standard-Template für Anzeige bei allgemeinen technischen Fehlern. Der genaue Fehler wird mittels enthaltener Platzhalter ausgewiesen.
347 347  
348 348  {{info}}
349 349  Die durch das Plugin bereitgestellten HTML-Templates können bearbeitet werden. Änderungen haben dabei auf alle Formulare mit Bezahl-Workflow Auswirkungen, wenn Sie diese Standard-Templates nutzen.
... ... @@ -352,12 +352,85 @@
352 352  
353 353  == Versionshistorie ==
354 354  
355 -=== 4.0.0 ===
356 +=== 3.6.0 ===
356 356  
357 -**//Re-Release des AKDB: ePayment Plugins als ePayBL: ePayment//**
358 +* Erweiterung AKDB ePay Setup: Konfigurationsmöglichkeit für Proxy-Server-Einstellungen
359 +* Platzhalter für Payment Verify-Url: Mit dem Platzhalter [%$PAYMENT_VERIFY_URL%] kann Status-übergreifend auf den URL zum nochmaligen Prüfen des Status einer Bezahltransaktion zugegriffen werden.
358 358  
359 -* Wechsel von der SOAP Schnittstelle zu REST. Dadurch ist immer ein Zertifikat und Passwort notwendig sowie die Angabe der Zahlverfahren.
360 -* Umstellung von AKDB spezifischer ePayBL Umgebung zu einer freien Festlegung der anzubindenden Umgebung.
361 -* Umbennung aller Vorkommnisse von AKDB zu ePayBL.
362 -* Umstellung auf System-Plugin.
363 -* Überarbeitung der Konfigurationsoberfläche.
361 +=== 3.5.1 ===
362 +
363 +* Fehlerbehebung: Im Zusammenspiel mit der {{formcycle/}} Version {{version major="7" patch="10"}}{{/version}} konnten Zertifikatsdateien nicht über das AKDB ePay Setup hochgeladen werden. Dieser Fehler wurde behoben.
364 +
365 +=== 3.5.0 ===
366 +
367 +* Erweiterungen: EPayment-Verifikation-Aktion (V6) um 'Zahlverfahren' erweitert.
368 +Trigger (Workflow V7) um genutztes 'Zahlverfahren' innerhalb der Rückgabewerte erweitert.
369 +Error-Trigger (Workflow V7) um 'PaymentVerifyUrl' erweitert. Dieser Parameter kann zum nochmaligen Aufruf der Verifizierung einer Bezahlung genutzt werden.
370 +* Erweiterung AKDB ePay Setup: Eingabemöglichkeit für Daten des anzubindenden ePayment-Mandanten; Zusätzlicher Hinweis auf freizugebende URLs (notwendige Firewall-Freigaben)
371 +
372 +=== 3.4.3 ===
373 +
374 +* Fehlerbehebung bei Rückleitung von der PayPage zum Formular: In einigen Fällen, insbesondere bei Kommunikation über den Frontend-Server, kam es zu Störungen beim Auslösen der nachgelagerten Workflow-Verarbeitung. Dies wurde behoben.
375 +
376 +=== 3.4.2 ===
377 +
378 +* Fehlerbehebung: ein Anzeige-Fehler bei der Berechnung des Gesamtpreises für einen EPayment-Bestellartikel wurde behoben
379 +* Fehlerbehebung: Aufgrund von Fehlern beim Decodieren und Entschlüsseln von URL-Parametern, wurde die Verschlüsselungs-Routine angepasst.
380 +
381 +=== 3.4.1 ===
382 +
383 +* Fehlerbehebung EPayment Bestellartikel: Die Werte der widget-internen HTML-Elemente sind bei einer Zwischenspeicherung nicht berücksichtigt worden. Dies wurde behoben.
384 +
385 +=== 3.4.0 ===
386 +
387 +* Erweiterung AKDB ePay Setup: Ein Verbindungstest ist jetzt auch ohne Konfiguration eines AKDB-Mandanten möglich.
388 +* Anpassung EPayment Bestellartikel: HTML-Elemente innerhalb des Widgets um 'data-' Präfix erweitert
389 +* Fehlerbehebung: Session-Replacer werden bei Verarbeitung der Workflow-Ereignisse berücksichtigt. 
390 +
391 +=== 3.3.1 ===
392 +
393 +* Fehlerbehebung: Mehrfache Anfragen auf den gleichen Vorgang bei Rückleitung vom ePay-BL-Portal werden jetzt vom System abgelehnt, solange der aktuell angefragte Vorgang sich in Verarbeitung befindet.
394 +
395 +=== 3.3.0 ===
396 +
397 +* Plugin benötigt mindestens {{formcycle/}} in der Version {{version major="7" patch="9"}}{{/version}}
398 +* Erweiterung Workflow-Aktion //Bestellung übermitteln//: Möglichkeit für serverseitige Definition von Bestellpositionen
399 +* Einführung AKDB ePay Setup: Je nach Umgebung (Test oder Live) werden die korrekten URL's zum WS-Endpoint und zur PayPage hinterlegt. Weiterhin kann das Zertifikat für die Anbindung des ePay-Live Systems hinterlegt werden.
400 +
401 +=== 3.2.0 ===
402 +
403 +* Erweiterung EPayment Bestellartikel: Am Element ist der Gesamtpreis (Anzahl * Einzelpreis) als verstecktes Element verfügbar. Dieser kann über die CSS-Klasse 'CXOrderItemTotalPrice' eingeblendet werden.
404 +* Erweiterung Anzahl-Eingabe-Element am EPayment Bestellartikel: Bei einer direkten Werteingabe wird diese sofort gegen die definierte untere und obere Wertgrenze validiert.
405 +
406 +=== 3.1.4 ===
407 +
408 +* Formatierung des Rückgabewertes für den Gesamtbetrag auf #0,00 €
409 +
410 +=== 3.1.3 ===
411 +
412 +* Fehlerbehebung: Es wurden Problem behoben, welche beim Öffnen von EPayment-Formularen im Designe aufgetreten sind.
413 +
414 +=== 3.1.2 ===
415 +
416 +* Neuer Pluginparameter *epayment.webservice.timeout* zum Konfigurieren des Timeouts zum Webservice in Sekunden.
417 +
418 +=== 3.1.1 ===
419 +
420 +* Fehlerbehebung: Bei EPayment-Artikel Objekt werden bei fehlenden Werten, Defaultwerte angenommen.
421 +
422 +=== 3.1.0 ===
423 +
424 +* Neue Eigenschaften am EPayment-Artikel Objekte hinzugefügt:
425 +** Pflicht-Artikel: Ein Artikel kann als Pflicht definiert werden und wird dadurch automatisch der Bestellung hinzugefügt, egal ob dieser durch Manipulation vor dem Absenden aus der Bestellung entfernt wurde
426 +** Maximale Bestellmenge: Die durch den Nutzer maximal auswählbare Bestellmenge lässt sich begrenzen
427 +
428 +=== 3.0.1 ===
429 +
430 +* Plugin benötigt mindestens {{formcycle/}} in der Version {{version major="7" minor="0" patch="1"}}{{/version}}
431 +** Anpassungen der Validierungen im Designer für EPayment-Artikel Objekte
432 +
433 +=== 3.0.0 ===
434 +
435 +* Plugin benötigt mindestens {{formcycle/}} in der Version {{version major="7" minor="0" patch="0"}}{{/version}}
436 +** Neue Workflow-Aktion für Initialisierung der Bezahl-Transaktion
437 +** Einführung Ereignisse für Absenden der Bestellung, sowie Verifizierung der erfolgreichen / nicht erfolgreichen Bezahltransaktion
hilfe_epay_artikel_form.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.fse
Größe
... ... @@ -1,1 +1,0 @@
1 -148.2 KB
Inhalt
hilfe_epay_vorlagen_form.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.fse
Größe
... ... @@ -1,1 +1,0 @@
1 -139.2 KB
Inhalt
hilfe_workflow.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.fse
Größe
... ... @@ -1,1 +1,0 @@
1 -40.8 KB
Inhalt
icon_add.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.fse
Größe
... ... @@ -1,1 +1,0 @@
1 -384 bytes
Inhalt
icon_del.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.fse
Größe
... ... @@ -1,1 +1,0 @@
1 -307 bytes
Inhalt
icon_update.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.fse
Größe
... ... @@ -1,1 +1,0 @@
1 -410 bytes
Inhalt
plugin_init_config_bestellposition.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.fse
Größe
... ... @@ -1,1 +1,0 @@
1 -32.2 KB
Inhalt
plugin_init_config_kundenstammdaten.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.fse
Größe
... ... @@ -1,1 +1,0 @@
1 -25.6 KB
Inhalt
plugin_init_config_mandant.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.fse
Größe
... ... @@ -1,1 +1,0 @@
1 -28.6 KB
Inhalt
plugin_init_config_paypage.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.fse
Größe
... ... @@ -1,1 +1,0 @@
1 -10.1 KB
Inhalt
plugin_init_result.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.fse
Größe
... ... @@ -1,1 +1,0 @@
1 -95.8 KB
Inhalt
trigger_error.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.fse
Größe
... ... @@ -1,1 +1,0 @@
1 -58.3 KB
Inhalt
trigger_success.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.fse
Größe
... ... @@ -1,1 +1,0 @@
1 -54.7 KB
Inhalt