Änderungen von Dokument Verwendung

Von 10.2 nach 10.1 Von 11.3 nach 11.2

Von Version 11.2

bearbeitet von rth
am 17.12.2021, 10:12

Änderungskommentar: Es gibt keinen Kommentar für diese Version

Auf Version 10.2

bearbeitet von rth
am 04.10.2021, 13:22

Änderungskommentar: (Autosaved)

Rohform
Im Layout

Zusammenfassung

Seiteneigenschaften (1 geändert, 0 hinzugefügt, 0 gelöscht)

Details

Seiteneigenschaften

Inhalt

@@ -83,7 +83,8 @@
  === 1.3. Bestellung an den Server übermitteln: ===
  Um eine Bestellung auszulösen und die bestellten Artikel zum Server zu übertragen muss dem Formular eine //Senden//-Schaltfläche hinzugefügt werden.
--\\{{id name="config_process"/}}
++
++{{id name="config_process"/}}
  == 2. Workflow für EPayment konfigurieren ==
@@ -92,13 +92,14 @@
  * Workflow-Aktion **[[Bestellung übermitteln>>doc:||anchor="plugin_epay_init"]]**: Diese erzeugt eine neue Bezahl-Transaktion auf Seiten der AKDB und leitet den Benutzer auf dessen Portalseite weiter.
  * Workflow-Ereignis **[[Bezahlung erfolgreich>>doc:||anchor="plugin_event_epay_success"]]**: Verarbeitet ein Ereignis, welches auf der Rückmeldung über eine erfolgreiche Bezahlung auf dem ePay-BL Portal basiert.
  * Workflow-Ereignis **[[Bezahlung nicht erfolgreich>>doc:||anchor="plugin_event_epay_error"]]**: Verarbeitet ein Ereignis, welches auf der Rückmeldung über eine noch offene Bezahlung auf dem ePay-BL Portal basiert. Dabei kann dies verschiedene Ursachen haben. Zum einen kann die Bezahlvorgang durch den Nutzer abgebrochen worden sein oder es ist zu einem Fehler im ePay-BL Portal gekommen.
++* HTML-Template **AKDB ePayment Bezahlung Erfolg**: Standard-Template für Anzeige bei erfolgreich abgeschlossener Bezahlung.
++* HTML-Template **AKDB ePayment Bezahlung Fehler**: Standard-Template für Anzeige bei offenen bzw. fehlerhaft beendeten Bezahlvorgang
++* HTML-Template **AKDB ePayment Fehler**: Standard-Template für Anzeige bei allgemeinen technischen Fehlern
  Ein Workflow für einen einfachen Fall kann folgendermaßen konfiguriert sein:
--{{figure image="hilfe_workflow.png"}}
--Workflow mit EPayment Anbindung
--{{/figure}}
--
++(% style="background-color:transparent; border:none" %)
++|(% style="border-style:none; width:180px" %)[[image:hilfe_workflow.png||alt="Workflow mit EPayment Anbindung"]]|(% style="border-style:none; width:800px" %)(((
  __Kurze Ablaufbeschreibung zum dargestellten Workflow:__
  ~1. Durch das Absenden des Bestellformulars wird das Ereignis //Bestellen// aufgerufen und dort das Aktions-Plugin **[[AKDB:Bestellung übermitteln>>doc:||anchor="plugin_epay_init"]]** ausgeführt. Dieses ermittelt die für den Bestellvorgang notwendigen Daten aus dem Formular und startet eine Bezahl-Transaktion auf Seiten der AKDB. Wenn dies erfolgreich war, wird der Benutzer zum [[ePay-BL>>https://www.epaybl.de/||rel="noopener noreferrer" target="_blank" title="E-Payment Bund und Länder"]] Portal der AKDB weitergeleitet.
@@ -109,6 +109,8 @@
 . Im Falle eines negativen Ergebnisses der Überprüfung des Bezahlvorgangs (z.B.: der Nutzer hat den Bezahlvorgang im ePay-BL Portal abgebrochen; während des Bezahlvorgangs ist ein Fehler aufgetreten), wird im vorliegenden Beispiel eine E-Mail erzeugt, in der der Benutzer auf die noch ausstehende Zahlung hingewiesen wird. Der Workflow wird in den Status //Nicht bezahlt// versetzt und dem Nutzer
  wird eine entsprechende Abschlussseite angezeigt.
++
++)))
  {{id name="plugin_epay_init"/}}
@@ -201,91 +201,20 @@
  === 2.2. Workflow-Ereignis //Bezahlung erfolgreich// ===
--Eine Workflow-Verarbeitungskette mit diesem Ereignis wird ausgeführt, wenn eine Rückleitung aus dem ePay-BL Portal erfolgt
--und die Bezahlung erfolgreich durchgeführt wurde. Pro Formular-Vorgang kann dieses Ereignis genau einmal eintreten.
--Das Ereignis stellt dabei folgende Werte bereit, die per Platzhalter in nachfolgenden Aktionen ausgewertet werden können:
++Eine Workflow-Verarbeitungskette mit diesem Ereignis wird immer dann ausgeführt, wenn eine Rückleitung aus dem ePay-BL Portal erfolgt
++und die Bezahlung erfolgreich durchgeführt wurde.
++Das Ereignis stellt dabei folgende Werte bereit, die per Platzhalter in nachfolgenden Aktionen ausgewertet werden können.
  ; **[%$TRIGGER.paymentStatus%]**
--: Bezeichnung des Status, wie er vom ePay-BL Portal zurückgeliefert wird. (Möglicher Wert: INAKTIV)
++: Bezeichnung des Status, wie er vom ePay-BL Portal zurückgeliefert wird (Möglicher Wert: INAKTIV)
  ; **[%$TRIGGER.paymentStatusText%]**
--: Eine Nachricht, die den zurückgelieferten Status näher beschreibt
++: Eine Nac
  {{id name="plugin_event_epay_error"/}}
  === 2.3. Workflow-Ereignis //Bezahlung nicht erfolgreich// ===
--Eine Workflow-Verarbeitungskette mit diesem Ereignis wird immer dann ausgeführt, wenn eine Rückleitung aus dem ePay-BL Portal erfolgte
--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).
--Das Ereignis stellt folgende Werte bereit, die per Platzhalter in nachfolgenden Aktionen ausgewertet werden können:
--
--; **[%$TRIGGER.paymentStatus%]**
--: Bezeichnung des Status, wie er vom ePay-BL Portal zurückgeliefert wird.
--: Folgende Werte sind möglich:
--: **AKTIV**: Die Bezahlung über die PayPage ist noch nicht erfolgt.
--: **MANDANT_NICHT_GEFUNDEN**: Der Mandant wurde im ePayment-System nicht gefunden.
--: **MANDANT_INAKTIV**: Der Mandant ist im ePayment-System derzeit als inaktiv gekennzeichnet.
--: **VERBINDUNG_OHNE_HTTPS**: Die Verbindung zum Webservice erfolgte nicht über HTTPS mit Client-Zertifikaten.
--: **VERBINDUNG_ZERTIFIKAT_FEHLER**: Das für die Verbindung verwendete Client-Zertifikat darf nicht für den gewählten Mandanten verwendet werden.
--: **KASSENZEICHEN_NICHT_VORHANDEN**: Das gewählte Kassenzeichen ist nicht vorhanden.
--: **KASSENZEICHEN_NICHT_GEFUNDEN**: Das gewählte Kassenzeichen konnte nicht gefunden werden.
--: **INTERNER_EPAYMENT_FEHLER**: Interner nicht dokumentierter Fehler im ePayment-System.
--: **UNDEFINIERT**: Ein im System nicht bekannter Status
--; **[%$TRIGGER.paymentStatusText%]**
--: Eine Nachricht, die den zurückgelieferten Status näher beschreibt
--; **[%$TRIGGER.paypageUrl%]**
--: URL zur Paypage mit der aktuellen Transaktionsnummer. Damit ist ein nochmaliges Aufrufen und Bezahlen der offenen Transaktion möglich.
--
--== 3. Ergebnisanzeige ==
--
--Die Anzeige des Ergebnisses bzw. des Status einer Bezahl-Transaktion erfolgt standardmäßig mittels einer extra Abschluss-Seite.
--Dafür stellt das Plugin 3 HTML-Templates bereit:
--
--* **AKDB ePayment Bezahlung Erfolg**: Standard-Template für Anzeige bei erfolgreich abgeschlossener Bezahlung.
--* **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.
--* **AKDB ePayment Fehler**: Standard-Template für Anzeige bei allgemeinen technischen Fehlern. Der genaue Fehler wird mittels enthaltener Platzhalter ausgewiesen.
--
--{{info}}
--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.
--Möchte man in einem einzelnen Bezahl-Workflow ein eigenes Abschluss-Seiten Template verwenden, so kann man dies über eine Aktion //HTML-Abschlussseite// in der jeweiligen Verarbeitungskette realisieren.
--{{/info}}
--
--== Versionshistorie ==
--
--(% class="wikigeneratedid" %)
--=== 3.2.0 ===
--
--* Erweiterung EPayment Bestellartikel: Am Element ist der Gesamtpreis (Anzahl * Einzelpreis) als verstecktes Element verfügbar. Dieser kann über die CSS-Klasse 'CXOrderItemTotalPrice' eingeblendet werden.
--* Erweiterung Anzahl-Eingabe-Element am EPayment Bestellartikel: Bei einer direkten Werteingabe wird diese sofort gegen die definierte untere und obere Wertgrenze validiert.
--
--=== 3.1.4 ===
--
--* Formatierung des Rückgabewertes für den Gesamtbetrag auf #0,00 €
--
--=== 3.1.3 ===
--
--* Fehlerbehebung: Es wurden Problem behoben, welche beim Öffnen von EPayment-Formularen im Designe aufgetreten sind.
--
--=== 3.1.2 ===
--
--* Neuer Pluginparameter *epayment.webservice.timeout* zum Konfigurieren des Timeouts zum Webservice in Sekunden.
--
--=== 3.1.1 ===
--
--* Fehlerbehebung: Bei EPayment-Artikel Objekt werden bei fehlenden Werten, Defaultwerte angenommen.
--
--=== 3.1.0 ===
--
--* Neue Eigenschaften am EPayment-Artikel Objekte hinzugefügt:
--** 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
--** Maximale Bestellmenge: Die durch den Nutzer maximal auswählbare Bestellmenge lässt sich begrenzen
--
--=== 3.0.1 ===
--
--* Plugin benötigt mindestens {{formcycle/}} in der Version {{version major="7" minor="0" patch="1"}}{{/version}}
--** Anpassungen der Validierungen im Designer für EPayment-Artikel Objekte
--
--=== 3.0.0 ===
--
--* Plugin benötigt mindestens {{formcycle/}} in der Version {{version major="7" minor="0" patch="0"}}{{/version}}
--** Neue Workflow-Aktion für Initialisierung der Bezahl-Transaktion
--** Einführung Ereignisse für Absenden der Bestellung, sowie Verifizierung der erfolgreichen / nicht erfolgreichen Bezahltransaktion
++Dieses Ereignis tritt ein, wenn eine Rückleitung aus dem ePay-BL Portal erfolgte
++und die Bezahlung nicht durchgeführt wurde.
++Die Überprüfung erfolgt dabei durch einen Aufruf der entsprechenden Webservice-Methode.
++Den genauen Grund für das Ausstehen der Bezahlung kann dabei dem ebenfalls übermittelten PayPageStatus entnommen werden.