... |
... |
@@ -20,54 +20,23 @@ |
20 |
20 |
|
21 |
21 |
Falls Sie bereits das [[**AKDB: EPayment-Plugin** >>url:https://help.formcycle.de/xwiki/bin/view/Formcycle/PluginDocumentation/AkdbEPaymentPlugin/]] in Ihren Mandanten installiert haben, können Sie wie folgt vorgehen: |
22 |
22 |
|
23 |
|
-=== Vorbereitung === |
|
23 |
+1. Gehen Sie in den Menüpunkt //AKDB ePay Setup// |
|
24 |
+1. Notieren Sie sich Ihre bisherigen Angaben |
|
25 |
+1.1 Mandant-Nummer |
|
26 |
+1.2 Bewirtschafter-Nummer |
|
27 |
+1.3 Haushaltsstelle |
|
28 |
+1.4 Objektnummer |
|
29 |
+1.5 Kennzeichen-Manverfahren |
|
30 |
+1.6 Proxy (falls vorhanden) |
|
31 |
+1. Ermitteln Sie die URL Ihres ePayBL Providers |
|
32 |
+1. Stellen Sie Zertifikat und Zertifikatspasswort sicher |
|
33 |
+1. Ermitteln Sie die erlaubten Zahlverfahren Ihres ePayBL Providers |
|
34 |
+1. Deaktivieren Sie das //AKDB: EPayment-Plugin// in Ihrem Mandanten |
|
35 |
+1. Loggen Sie sich als Systemadministrator an |
|
36 |
+1. Hinterlegen Sie das //ePayBL: EPayment-Plugin// in den System-Plugins |
|
37 |
+1. Gehen Sie in den neuen Menüpunkt //ePayBL Setup// |
|
38 |
+1. Hinterlegen Sie Ihre notierten Angaben, nähere Informationen sind in den folgenden Abschnitten hinterlegt. |
24 |
24 |
|
25 |
|
-Um die neue ePayBL Schnittstelle anzubinden, benötigen Sie ein Zertifikat von der AKDB. Wenn Sie es für die Produktivumgebung noch nicht haben, wenden Sie sich an Ihren Ansprechpartner bei der AKDB. |
26 |
|
- |
27 |
|
-=== Migration === |
28 |
|
- |
29 |
|
-1. Datensicherung |
30 |
|
-1.1 Gehen Sie im FORMCYCLE Hauptmenü auf **AKDB ePay Setup**. |
31 |
|
-1.2 Klicken Sie auf **Zur Anbindung ePay-BL Umgebung**. |
32 |
|
-1.3 Notieren Sie die Informationen für Mandant-Nummer, Bewirtschafter-Nummer, Haushaltsstelle, Objektnummer, Kennzeichen-Mahnverfahren, Fälligkeitszeitraum (in Tagen) und Buchungstext für die PayPage. |
33 |
|
-1. Bestimmen der URL Ihres ePayBL Providers |
34 |
|
-2.1 Wenn unter "Anzubindende Umgebung" der Wert "TEST" ausgewählt ist, verwenden Sie in Zukunft die Adresse "https://epay-pre.akdb.de" zur Anbindung. |
35 |
|
-2.2 Wenn unter "Anzubindende Umgebung" der Wert "LIVE" ausgewählt ist, verwenden Sie in Zukunft die Adresse "https://epay.akdb.de" zur Anbindung. |
36 |
|
-1. Deaktivieren des AKDB: EPayment-Plugin |
37 |
|
-3.1 Gehen Sie im FORMCYCLE Hauptmenü auf "Mandant" -> "Plugin". |
38 |
|
-3.2 Fahren Sie mit der Maus über den Eintrag //plugin-bundle-akdb-epayment.jar//. Es erscheint das Symbol zum Deaktivieren des Plugins. |
39 |
|
-3.3 Klicken Sie auf das Symbol, um das Plugin zu deaktivieren. |
40 |
|
-3.4 Das Plugin wird nun durchgestrichen dargestellt. |
41 |
|
-1. Löschen der Datei //epay_wf_result.js// |
42 |
|
-4.1 Gehen Sie im FORMCYCLE Hauptmenü auf "Dateien & Templates" -> "Dateien". |
43 |
|
-4.2 Wählen Sie den Eintrag //epay_wf_result.js// aus indem Sie das Kästchen links davon anhaken. |
44 |
|
-4.3 Klicken Sie auf das löschen Symbolüberhalb der Auflistung. |
45 |
|
-1. Installation des //plugin-bundle-epaybl.jar// |
46 |
|
-5.1 Melden Sie sich als Systemadministrator (sadmin) am FORMCYCLE Backend an. |
47 |
|
-5.2 Gehen Sie im FORMCYCLE Hauptmenü auf "System" -> "Systemplugins". |
48 |
|
-5.3 Klicken Sie auf den Plus-Button, um die Datei //plugin-bundle-epaybl.jar// hinzuzufügen. |
49 |
|
-1. Einrichten mit ePayBL Setup |
50 |
|
-6.1 Im FORMCYCLE Hauptmenü steht Ihnen nun ein neuer Punkt **ePayBL Setup** zur Verfügung. |
51 |
|
-6.2 Klicken Sie auf dem Menüpunk **ePayBL Setup** |
52 |
|
-6.3 Tragen Sie die URL aus Schritt 2 ein. |
53 |
|
-6.4 Geben Sie nun die Informationen für Mandant-Nummer, Bewirtschafter-Nummer, Haushaltsstelle, Objektnummer, Kennzeichen-Mahnverfahren, Fälligkeitszeitraum (in Tagen) und Buchungstext für die PayPage ein, die für alle Mandanten gelten sollen. |
54 |
|
-6.5 Laden Sie das Zertifikat hoch, das Sie von der AKDB erhalten haben, und geben Sie das dazugehörige Passwort ein. |
55 |
|
-6.6 Klicken Sie auf „Speichern“. |
56 |
|
-6.7 Alle Angaben, die Sie als Systemadministrator in den Systemeinstellungen hinterlegen, sind optional und sind als Standardeinstellungen, die für alle Mandanten in Ihrer FORMCYCLE Umgebung gelten zu verstehen. |
57 |
|
-6.8 Informationen, die nicht durch den Systemadministrator hinterlegt wurden, werden im Mandanten als Pflichtangabe angezeigt und müssen später dort angegeben werden. |
58 |
|
-1. Vervollständigung des Setups im Mandanten |
59 |
|
-7.1 Melden Sie sich beim Mandanten an, in dem Sie zuvor das AKDB: EPayment-Plugin deaktiviert haben. |
60 |
|
-7.2 Klicken Sie auf dem Menüpunk **ePayBL Setup** |
61 |
|
-7.3 Ergänzen Sie ggf. noch fehlende Informationen. |
62 |
|
-7.4 Klicken Sie auf **Verbindung prüfen**. Es sollten nun entsprechende Erfolgsmeldungen angezeigt werden. |
63 |
|
-7.5 Klicken Sie auf „Speichern“. |
64 |
|
- |
65 |
|
-==== Checklist ==== |
66 |
|
- |
67 |
|
-1. Testen Sie die Anbindung durch Auslösen einer Testzahlung. |
68 |
|
-1. Überprüfen Sie, ob die Testzahlung erfolgreich durchgeführt wurde. |
69 |
|
-1. Wenn alles funktioniert hat, können Sie nun die ePayBL Schnittstelle produktiv nutzen. |
70 |
|
- |
71 |
71 |
{{info}} |
72 |
72 |
Es müssen keine Änderungen am Formular, weder Designer noch Workflow, durchgeführt werden. Jedoch gibt es keine Unterstützung für Formulare mit altem {{formcycle/}} Workflow. |
73 |
73 |
{{/info}} |