Änderungen von Dokument Verwendung


Von Version 11.5
bearbeitet von rth
am 06.01.2022, 13:33
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 10.5
bearbeitet von rth
am 04.10.2021, 14:07
Änderungskommentar: (Autosaved)

Zusammenfassung

Details

Seiteneigenschaften
Inhalt
... ... @@ -30,11 +30,9 @@
30 30  {{/figure}}
31 31  
32 32  Über das Formular-Element //EPayment Artikel// werden die für eine Bestell-Transaktion notwendigen Artikel definiert.
33 -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.
33 +Das Formular-Element dient dabei zum Einen für eine visuelle Darstellung des Artikels (mit Bild, Preisangabe, Eingabemöglichkeit für Bestellmenge) innerhalb eines Formulars, als auch als Vorlage für die Erstellung einer
34 +konkreten Bestell-Position zum Zeitpunkt der Ausführung einer Bezahl-Transaktion.
34 34  
35 -Ab Plugin-Version {{version major="3" minor="3" patch="0"}}{{/version}} können Bestellpositionen auch direkt in der Workflow-Aktion definiert werden.
36 -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.
37 -
38 38  __Grundeigenschaften:__
39 39  
40 40  ; Versteckt
... ... @@ -55,7 +55,7 @@
55 55  ; Max. Bestellmenge
56 56  : Hier kann die für den Nutzer maximal auswählbare Bestellmenge für einen Artikel definiert werden.
57 57  ; Belegnummer
58 -: Die Belegnummer ist ein optionaler Wert, welcher zur weiterführenden Verarbeitung auf Seiten von ePay-BL dient.
56 +: Die Belegnummer ist ein optionaler Wert, welcher zur weiterführenden Verarbeitung auf Seiten von ePay-BL dient
59 59  
60 60  {{info}}
61 61  Bei Übermittlung einer Bestellung werden nur die Artikelnummer, sowie die jeweilige Anzahl von einem Bestellartikel, zum Server übertragen. Damit ein Artikel innerhalb einer Bestellung übermittelt wird, muss die "Bestellen"-Option angehakt sein.
... ... @@ -85,7 +85,8 @@
85 85  === 1.3. Bestellung an den Server übermitteln: ===
86 86  
87 87  Um eine Bestellung auszulösen und die bestellten Artikel zum Server zu übertragen muss dem Formular eine //Senden//-Schaltfläche hinzugefügt werden.
88 -\\{{id name="config_process"/}}
86 +
87 +{{id name="config_process"/}}
89 89  
90 90  == 2. Workflow für EPayment konfigurieren ==
91 91  
... ... @@ -97,10 +97,8 @@
97 97  
98 98  Ein Workflow für einen einfachen Fall kann folgendermaßen konfiguriert sein:
99 99  
100 -{{figure image="hilfe_workflow.png"}}
101 -Workflow mit EPayment Anbindung
102 -{{/figure}}
103 -
99 +(% style="background-color:transparent; border:none" %)
100 +|(% style="border-style:none; width:180px" %)[[image:hilfe_workflow.png||alt="Workflow mit EPayment Anbindung"]]|(% style="border-style:none; width:800px" %)(((
104 104  __Kurze Ablaufbeschreibung zum dargestellten Workflow:__
105 105  
106 106  ~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.
... ... @@ -111,6 +111,8 @@
111 111  
112 112  4. 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
113 113  wird eine entsprechende Abschlussseite angezeigt.
111 +
112 +)))
114 114  
115 115  {{id name="plugin_epay_init"/}}
116 116  
... ... @@ -172,25 +172,6 @@
172 172  : Der hier festgelegte Buchungstext wird dem Benutzer auf der PayPage angezeigt.
173 173  {{/panel}}
174 174  
175 -{{panel title="Kundenstammdaten" fullwidth="true" initial="visible" triggerable="true"}}
176 -
177 -{{figure image="plugin_init_config_akdb_bestellposition.png"}}
178 -Konfiguration von zusätzlichen Bestellpositionen
179 -{{/figure}}
180 -
181 -; Anzahl
182 -: Definiert die für die Bestellposition geltende Anzahl. Der hier definierte Wert muss zur Laufzeit einer Zahl größer 0 entsprechen, damit die Bestellposition mit in die aktuelle Bestellung einbezogen wird. Die Anzahl dient weiterhin zur Berechnung des Gesamtpreises der Bestellposition innerhalb der Bestellung
183 -; Buchungstext
184 -: Der hier definierte Text wird als Buchungstext übermittelt. Er darf nur aus SEPA-konformen Zeichen bestehen und maximal 21 Zeichen lang sein. Der Text kann dabei auch aus Platzhaltern stammen. Er wird, wenn dies notwendig ist, automatisch auf 21 Zeichen eingekürzt.
185 -; Preis (in Euro)
186 -: Der (Einzel)Preis für die Bestellposition. Der an dieser Stelle konfigurierte Wert muss sich in eine kommaseparierte Zahl umwandeln lassen und dient zur Berechnung der Gesamtsumme für die Bestellposition. (Berechnung: Gesamtpreis = Anzahl x Preis)
187 -; Beschreibung
188 -: Dient der interne Beschreibung der Bestellposition. Diese Information wird nicht an ePay-BL weiter gegeben.
189 -; Belegnummer
190 -: Die Belegnummer ist ein optionaler Wert, welcher zur weiterführenden Verarbeitung auf Seiten von ePay-BL dient.
191 -
192 -{{/panel}}
193 -
194 194  {{panel title="Konfiguration AKDB ePayment-Mandant" fullwidth="true" initial="visible" triggerable="true"}}
195 195  
196 196  {{figure image="plugin_init_config_akdb_mandant.png"}}
... ... @@ -243,7 +243,7 @@
243 243  : Bezeichnung des Status, wie er vom ePay-BL Portal zurückgeliefert wird.
244 244  : Folgende Werte sind möglich:
245 245  : **AKTIV**: Die Bezahlung über die PayPage ist noch nicht erfolgt.
246 -: **MANDANT_NICHT_GEFUNDEN**: Der Mandant wurde im ePayment-System nicht gefunden.
226 +: **MANDANT_NICHT_GEFUNDEN**: Der Mandant wurde im ePayment-System nicht gefunden.
247 247  : **MANDANT_INAKTIV**: Der Mandant ist im ePayment-System derzeit als inaktiv gekennzeichnet.
248 248  : **VERBINDUNG_OHNE_HTTPS**: Die Verbindung zum Webservice erfolgte nicht über HTTPS mit Client-Zertifikaten.
249 249  : **VERBINDUNG_ZERTIFIKAT_FEHLER**: Das für die Verbindung verwendete Client-Zertifikat darf nicht für den gewählten Mandanten verwendet werden.
... ... @@ -258,54 +258,8 @@
258 258  
259 259  == 3. Ergebnisanzeige ==
260 260  
261 -Die Anzeige des Ergebnisses bzw. des Status einer Bezahl-Transaktion erfolgt standardmäßig mittels einer extra Abschluss-Seite.
262 -Dafür stellt das Plugin 3 HTML-Templates bereit:
241 +Für die Anzeige des Ergebnisses bzw. dem Status einer Bezahl-Transaktion
263 263  
264 -* **AKDB ePayment Bezahlung Erfolg**: Standard-Template für Anzeige bei erfolgreich abgeschlossener Bezahlung.
265 -* **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.
266 -* **AKDB ePayment Fehler**: Standard-Template für Anzeige bei allgemeinen technischen Fehlern. Der genaue Fehler wird mittels enthaltener Platzhalter ausgewiesen.
267 -
268 -{{info}}
269 -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.
270 -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.
271 -{{/info}}
272 -
273 -== Versionshistorie ==
274 -
275 -=== 3.2.0 ===
276 -
277 -* Erweiterung EPayment Bestellartikel: Am Element ist der Gesamtpreis (Anzahl * Einzelpreis) als verstecktes Element verfügbar. Dieser kann über die CSS-Klasse 'CXOrderItemTotalPrice' eingeblendet werden.
278 -* Erweiterung Anzahl-Eingabe-Element am EPayment Bestellartikel: Bei einer direkten Werteingabe wird diese sofort gegen die definierte untere und obere Wertgrenze validiert.
279 -
280 -=== 3.1.4 ===
281 -
282 -* Formatierung des Rückgabewertes für den Gesamtbetrag auf #0,00 €
283 -
284 -=== 3.1.3 ===
285 -
286 -* Fehlerbehebung: Es wurden Problem behoben, welche beim Öffnen von EPayment-Formularen im Designe aufgetreten sind.
287 -
288 -=== 3.1.2 ===
289 -
290 -* Neuer Pluginparameter *epayment.webservice.timeout* zum Konfigurieren des Timeouts zum Webservice in Sekunden.
291 -
292 -=== 3.1.1 ===
293 -
294 -* Fehlerbehebung: Bei EPayment-Artikel Objekt werden bei fehlenden Werten, Defaultwerte angenommen.
295 -
296 -=== 3.1.0 ===
297 -
298 -* Neue Eigenschaften am EPayment-Artikel Objekte hinzugefügt:
299 -** 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
300 -** Maximale Bestellmenge: Die durch den Nutzer maximal auswählbare Bestellmenge lässt sich begrenzen
301 -
302 -=== 3.0.1 ===
303 -
304 -* Plugin benötigt mindestens {{formcycle/}} in der Version {{version major="7" minor="0" patch="1"}}{{/version}}
305 -** Anpassungen der Validierungen im Designer für EPayment-Artikel Objekte
306 -
307 -=== 3.0.0 ===
308 -
309 -* Plugin benötigt mindestens {{formcycle/}} in der Version {{version major="7" minor="0" patch="0"}}{{/version}}
310 -** Neue Workflow-Aktion für Initialisierung der Bezahl-Transaktion
311 -** Einführung Ereignisse für Absenden der Bestellung, sowie Verifizierung der erfolgreichen / nicht erfolgreichen Bezahltransaktion
243 +* HTML-Template **AKDB ePayment Bezahlung Erfolg**: Standard-Template für Anzeige bei erfolgreich abgeschlossener Bezahlung.
244 +* HTML-Template **AKDB ePayment Bezahlung Fehler**: Standard-Template für Anzeige bei offenen bzw. fehlerhaft beendeten Bezahlvorgang
245 +* HTML-Template **AKDB ePayment Fehler**: Standard-Template für Anzeige bei allgemeinen technischen Fehlern