Änderungen von Dokument Verwendung

Von 15.1 nach 15.2 Von 18.4 nach 18.5

Von Version 15.2

bearbeitet von rth
am 06.01.2022, 14:58

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

Auf Version 18.4

bearbeitet von rth
am 10.02.2022, 12:01

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

Rohform
Im Layout

Zusammenfassung

Seiteneigenschaften (1 geändert, 0 hinzugefügt, 0 gelöscht)
Anhänge (0 geändert, 2 hinzugefügt, 0 gelöscht)
- trigger_error.png
- trigger_success.png

Details

Seiteneigenschaften

Inhalt

@@ -1,4 +1,13 @@
++[[**Plugin download**>>url:https://customer.formcycle.eu/index.php/apps/files/?dir=/FORMCYCLE%20-%20Plugins%20Customer/plugin-bundle-akdb-epayment&fileid=2674||rel="noopener noreferrer" target="_blank"]] (Anmeldung erforderlich)
++
  {{info}}
++**Hinweis zur Inbetriebnahme des Plugins:**
++Im Download-Ordner der jeweilige Plugin-Version befindet sich eine Anleitung zur initialen Inbetriebnahme, sowie zu weiter reichenden Information die den allgemeinen Betrieb dieses Plugins betreffen.
++{{/info}}
++
++{{content/}}
++
++{{info}}
  **Achtung:**
  Bevor Sie die AKDB EPayment in ihren Formular-Prozessen einbinden, stellen Sie bitte sicher, dass die konfigurative Anbindung des Dienstes durch den {{formcycle/}}-Administrator erfolgt ist!
  {{/info}}
@@ -231,24 +231,29 @@
  ; [%$[Name der Aktion].RESULT.BestellPosition[i]['key']%]
  : Eine Auflistung über alle Bestell-Positionen, welche in der aktuellen Bestellung enthalten sind.
  Zu jeder Bestell-Position können folgende Werte abgefragt werden:
--* Artikelnummer: Die am <i>EPayment Artikel</i> hinterlegte eindeutige Kennung für den Artikel
--* Buchungstext: Der übermittelte Buchungstext (max.21 Zeichen, SEPA konform)
--* Menge: Die bestellte Menge für die aktuelle Bestell-Position
--* Beschreibung: Die am <i>EPayment Artikel</i> hinterlegte Artikel-Beschreibung
--* Einzelpreis: Der am <i>EPayment Artikel</i> hinterlegte Preis für ein Stück. Ausgabe mit Währungssymbol.
--* Preis: Der errechnete Gesamtpreis für die aktuelle Bestell-Position. Ergibt sich aus <i>Menge x Einzelpreis</i>. Ausgabe mit Währungssysmbol
--Nachfolgend einige Beispiele für die Datenabfrage aus den Bestellpositionen:
++(((
++* **Artikelnummer**: Die am //EPayment Artikel// hinterlegte eindeutige Kennung für den Artikel
++* **Buchungstext**: Der übermittelte Buchungstext (max.21 Zeichen, SEPA konform)
++* **Menge**: Die bestellte Menge für die aktuelle Bestell-Position
++* **Beschreibung**: Die am //EPayment Artikel// hinterlegte Artikel-Beschreibung
++* **Einzelpreis**: Der am //EPayment Artikel// hinterlegte Preis für ein Stück. Ausgabe mit Währungssymbol.
++* **Preis**: Der errechnete Gesamtpreis für die aktuelle Bestell-Position. Ergibt sich aus //Menge x Einzelpreis//. Ausgabe mit Währungssysmbol
++
++       Nachfolgend einige Beispiele für die Datenabfrage aus den Bestellpositionen:
++       Für die Beispiele wird folgender durch eine Aktion mit Namen //Bestellung übermitteln// bereitgestellter Platzhalter zu Grunde
++       gelegt: **[%$Bestellung übermitteln.RESULT.Bestellung[i][''key'']%]**
++       Die in den eckigen Klammern hinterlegten Werte sind variabel und haben folgende Bedeutung:
--Für die Beispiele wird folgender durch die Aktion bereitgestellter Platzhalter zu Grunde gelegt <b>[%$Bestellung übermitteln.RESULT.Bestellung[i][''key'']%]</b>
--Die in den eckigen Klammern hinterlegten Werte sind variabel und haben folgende Bedeutung:
--* 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.
--* key: Schlüssel für den Zugriff auf die jeweilige Eigenschaft
--Beispiele:
--Abfrage des Einzelpreises an der 1. Bestell-Position: [%$Bestellung übermitteln.RESULT.Bestellung[0][''Einzelpreis'']%]</b><br/>
--Abfrage der Menge an der 3. Bestell-Position: [%$Bestellung übermitteln.RESULT.Bestellung[2][''Menge'']%]</b>
++* **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.
++* **key**: Schlüssel für den Zugriff auf die jeweilige Eigenschaft
++
++       Beispiele:
++       Abfrage des Einzelpreises an der 1. Bestell-Position: **[%$Bestellung übermitteln.RESULT.Bestellung[0][''Einzelpreis'']%]**
++       Abfrage der Menge an der 3. Bestell-Position: **[%$Bestellung übermitteln.RESULT.Bestellung[2][''Menge'']%]**
++)))
++
  ; [%$[Name der Aktion].RESULT.BestellPositionAnzahl%]
  : Die Gesamtanzahl der Bestellpositionen, welche in der aktuellen Bestellung enthalten sind
  ; [%$[Name der Aktion].RESULT.Gesamtbetrag%]
@@ -266,27 +266,37 @@
  : Fehlercode, wenn der ePay-BL Service nicht verfügbar ist.
  ; SRV_METHOD_ERROR
  : Fehlercode, wenn eine ePay-BL Webservice-Methode einen Fehler lieferte. Bei Auftreten von solchen Fehlertypen sollte das
-- {{formcycle/}} interne Fehler-Protokoll für eine tiefere Analyse einbezogen werden.
++{{formcycle/}} interne Fehler-Protokoll für eine tiefere Analyse einbezogen werden.
  ; INTERNAL_ERROR
  : Fehlercode für einen nicht nähere beschriebenen Fehler. Bei Auftreten von solchen Fehlertypen sollte das
-- {{formcycle/}} interne Fehler-Protokoll für eine tiefere Analyse einbezogen werden.
++{{formcycle/}} interne Fehler-Protokoll für eine tiefere Analyse einbezogen werden.
  {{id name="plugin_event_epay_success"/}}
  === 2.2. Workflow-Ereignis //Bezahlung erfolgreich// ===
++{{figure image="trigger_success.png"}}
++Workflow-Ereignis bei erfolgreicher Bezahlung
++{{/figure}}
++
  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:
  ; **[%$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ück geliefert wird. (Möglicher Wert: INAKTIV)
  ; **[%$TRIGGER.paymentStatusText%]**
--: Eine Nachricht, die den zurückgelieferten Status näher beschreibt
++: Eine Nachricht, die den zurück gelieferten Status näher beschreibt
++; **[%$TRIGGER.paymentMethod%] {{version major="3" minor="5"}}{{/version}}**
++: Parameter gibt Auskunft über das in der Bezahl-Transaktion angewendete Zahlverfahren
  {{id name="plugin_event_epay_error"/}}
  === 2.3. Workflow-Ereignis //Bezahlung nicht erfolgreich// ===
++{{figure image="trigger_error.png"}}
++Workflow-Ereignis bei nicht erfolgreicher Bezahlung
++{{/figure}}
++
  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:
@@ -307,6 +307,10 @@
  : 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.
++; **[%$TRIGGER.paymentMethod%]** {{version major="3" minor="5"}}{{/version}}
++: Parameter gibt Auskunft über das in der Bezahl-Transaktion angewendete Zahlverfahren
++; **[%$TRIGGER.paymentVerifyUrl%] {{version major="3" minor="5"}}{{/version}}**
++: URL zum erneuten Prüfen des Bezahlstatus. Ein Aufruf der URL löst im Anschluss, an die Überprüfung des aktuellen Bezahlstatus, die entsprechenden Workflow-Ereignisse aus
  == 3. Ergebnisanzeige ==
@@ -324,6 +324,36 @@
  == Versionshistorie ==
++=== 3.5.0 ===
++
++* Erweiterungen: EPayment-Verifikation-Aktion (V6) um 'Zahlverfahren' erweitert.
++Trigger (Workflow V7) um genutztes 'Zahlverfahren' innerhalb der Rückgabewerte erweitert.
++Error-Trigger (Workflow V7) um 'PaymentVerifyUrl' erweitert. Dieser Parameter kann zum nochmaligen Aufruf der Verifizierung einer Bezahlung genutzt werden.
++* Erweiterung AKDB ePay Setup: Eingabemöglichkeit für Daten des anzubindenden ePayment-Mandanten; Zusätzlicher Hinweis auf freizugebende URLs (notwendige Firewall-Freigaben)
++
++=== 3.4.3 ===
++
++* 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.
++
++=== 3.4.2 ===
++
++* Fehlerbehebung: ein Anzeige-Fehler bei der Berechnung des Gesamtpreises für einen EPayment-Bestellartikel wurde behoben
++* Fehlerbehebung: Aufgrund von Fehlern beim Decodieren und Entschlüsseln von URL-Parametern, wurde die Verschlüsselungs-Routine angepasst.
++
++=== 3.4.1 ===
++
++* Fehlerbehebung EPayment Bestellartikel: Die Werte der widget-internen HTML-Elemente sind bei einer Zwischenspeicherung nicht berücksichtigt worden. Dies wurde behoben.
++
++=== 3.4.0 ===
++
++* Erweiterung AKDB ePay Setup: Ein Verbindungstest ist jetzt auch ohne Konfiguration eines AKDB-Mandanten möglich.
++* Anpassung EPayment Bestellartikel: HTML-Elemente innerhalb des Widgets um 'data-' Präfix erweitert
++* Fehlerbehebung: Session-Replacer werden bei Verarbeitung der Workflow-Ereignisse berücksichtigt.
++
++=== 3.3.1 ===
++
++* 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.
++
  === 3.3.0 ===
  * Plugin benötigt mindestens {{formcycle/}} in der Version {{version major="7" patch="9"}}{{/version}}

trigger_error.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.rth

Größe

...	...	@@ -1,0 +1,1 @@
	1	+58.3 KB

Inhalt

trigger_success.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.rth

Größe

...	...	@@ -1,0 +1,1 @@
	1	+54.7 KB

Inhalt