Wiki-Quellcode von ePayBL Setup

Zeige letzte Bearbeiter
1 [[**Plugin download**>>url:https://customer.formcycle.eu/index.php/apps/files/?dir=/FORMCYCLE%20-%20Plugins%20Customer/ePayBL%3A%20Epayment%20Plugin%20(plugin-bundle-epaybl)&fileid=50473||rel="noopener noreferrer" target="_blank"]] (Anmeldung erforderlich)
2
3 {{content/}}
4
5 == Vertragliche Voraussetzungen ==
6
7 Damit das ePayment in FORMCYCLE eingerichtet werden kann, muss zuvor ein Vertrag mit dem ePayBL Anbieter geschlossen werden.
8
9 Ist bereits ein Vertrag über das ePayment mit dem ePayBL Anbieter vorhanden, so kann dieser herangezogen werden und mit dem Schritt der Installation als Systemadministrator fortgesetzt werden.
10
11
12 === Voraussetzungen ===
13
14 * Die notwendigen Daten des ePayBL-EPayment Mandanten liegen vor.
15 * Ein Zertifikat für den Zugriff auf den ePayment-Webservice ist vorhanden.
16 ** Sollte bereits das Live-System vom **AKDB Bürgerkonto-Service / Postkorb** angebunden sein, so kann dieses Zertifikat für den Zugriff verwendet werden.
17 * Das Plugin-Bundle //**plugin-bundle-epaybl.jar**// ist vorhanden und kompatibel mit der installierten FORMCYCLE-Version.
18
19 == Migration einer bestehenden Installation ==
20
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
23
24 1. Notieren Sie sich Ihre bisherigen Angaben
25 1.1 Mandant-Nummer, Bewirtschafter-Nummer,
26 1. Listenpunkt
27 1. Listenpunkt
28
29 ; Notieren Sie sich Ihre bisherigen Angaben
30 : Mandant-Nummer, Bewirtschafter-Nummer, Haushaltsstelle, Objektnummer und Kennzeichen-Mahnverfahren sowie Angaben Ihres Proxy falls vorhanden.
31 ; Stellen Sie Zertifikat und Passwort sicher, dieses wird auch für Ihr Testsystem benötigt.
32 ; Prüfen Sie die URL Ihres ePayBL-Providers
33 : Für das Testsystem war dies bisher **//epay-pre.akdb.de//**.
34 : Für das Livesystem war dies bisher **//epay.akdb.de//**.
35
36 Nun muss das alte //AKDB: EPayment-Plugin// im Mandanten deaktiviert werden. Ansonsten ist der Menüpunkt //ePayBL Setup// im Mandanten nicht sichtbar. Das neue //ePayBL: EPayment-Plugin// wird nur ausgeführt, wenn das alte //AKDB: EPayment-Plugin// deaktiviert wurde. Die Umstellung auf das neue Plugin kann sukzessiv erfolgen, das heißt das alte //AKDB: EPayment-Plugin// muss nicht sofort in jedem Mandanten deaktiviert werden. Somit kann die Installation erst einmal in einem (Test-)Mandanten erfolgen.
37
38 {{info}}
39 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.
40 {{/info}}
41
42 == Installation als Systemadministrator ==
43
44 {{figure image="epaybl-system.png"}}
45 Der **sadmin** gibt hier URL des Providers, Zertifikat sowie Passwort und Proxy vor.
46 {{/figure}}
47
48 Das Plugin wird als System-Plugin installiert.
49
50
51 === Obligatorische Installationsschritte ===
52
53 * Anmeldung als **sadmin **am FORMCYCLE-System.
54 * Registrierung des **//plugin-bundle-epaybl.jar//** Plugins im Bereich der System-Plugins.
55
56 === Fakultative Installationsschritte ===
57
58 * Jetzt ist ein neuer Menüpunkt **ePayBL Setup** vorhanden, welcher aufgerufen werden kann.
59 {{info}}Hinweis: Sollte der Menüpunkt nicht sofort ersichtlich sein, ist ein Abmelden und anschließendes Anmelden als sadmin notwendig.{{/info}}
60 * Hier kann der {{formcycle/}} Systemadministrator Default-Werte hinterlegen, welche den Mandanten als Platzhalter angezeigt werden und jenes Feld nicht ausfüllen müssen.
61 * Für genauere Informationen zu den einzelnen Eingabefeldern siehe //Eingabefelder//.
62
63 == ePayBL Setup - Mandant ==
64
65 {{figure image="epaybl-client.png"}}
66 Der Mandant muss hier alle weiteren Felder ausfüllen, um das Setup zu speichern.
67 {{/figure}}
68
69 Der Mandant vervollständigt das **ePayBL Setup**.
70
71 === Obligatorische Installationsschritte ===
72
73 * Anmeldung in den FORMCYCLE-Mandanten, welcher eine Anbindung erhalten soll.
74 * Jetzt ist ein neuer Menüpunkt **ePayBL Setup** vorhanden, welcher aufgerufen werden muss.
75 * Nun müssen alle Werte hinterlegt werden, außer es existieren bereits Default-Werte:
76
77 {{info}}
78 Hinweis: Nur wenn sowohl Hostname als auch Port angegeben sind, wird die Verbindung darüber aufgebaut.
79 {{/info}}
80
81 * Abschließend kann ein Verbindungstest durchgeführt werden. Dabei wird auch das Zertifikat geprüft, weswegen auch das Passwort stimmen muss.
82 * Wenn der ePayment-Webservice nicht erreicht werden kann, so sind gegebenenfalls Firewall-Einstellungen zu prüfen. Die konkrete URL zum Webservice wird dabei in der Fehlermeldung angezeigt. Der Aufbau der Webservice-Verbindung muss dabei vom FORMCYCLE Master-Server oder Frontend-Server aus möglich sein (siehe Hinweis oben).
83
84 Damit ist die Konfiguration abgeschlossen.
85
86
87 {{warning}}
88 **Hinweise zur Erreichbarkeit notwendiger System-URLs**
89
90 Bitte konfigurieren Sie gegebenenfalls ihre Firewall hinsichtlich der Erreichbarkeit der nachfolgenden URL(s).
91 \\Folgende URL(s) müssen von **Extern erreichbar** sein, damit eine Rückmeldung vom ePayBL-Portal korrekt verarbeitet werden kann:
92
93 * https:~/~/<//Domain-Adresse des Master-Servers//>/formcycle/plugin (Master-Server)
94 ODER
95 * https:~/~/<//Domain-Adresse des Frontend-Servers//>/frontend-server/plugin (Frontend-Server)
96
97 Die URL der anzubindenden Umgebung muss **vom FORMCYCLE Master-Server aus erreichbar** sein.
98 {{/warning}}
99
100
101 == Eingabefelder ==
102
103 Falls bereits eine Eingabe durch den {{formcycle/}} Systemadministrator getätigt wurde, ist das Eingabefeld für den Mandanten kein Pflichtfeld mehr und der Default-Wert wird als Platzhalter angezeigt. Jeder Mandant kann die Default-Werte überschreiben, indem das entsprechende Eingabefeld ausgefüllt wird.
104
105 ; URL des Providers
106 : Die URL der anzubindenen Umgebung. Default-Wert wird als Platzhalter angezeigt.
107 ; Mandant-Nummer
108 : Die Mandant-Nummer ist den ePayBL Vertragsdaten zu entnehmen. Default-Wert wird als Platzhalter angezeigt.
109 ; Bewirtschafter-Nummer
110 : Die Bewirtschafter-Nummer ist den ePayBL Vertragsdaten zu entnehmen. Default-Wert wird als Platzhalter angezeigt.
111 ; Haushaltsstelle
112 : Die Haushaltsstelle ist den ePayBL Vertragsdaten zu entnehmen. Default-Wert wird als Platzhalter angezeigt.
113 ; Objekt-Nummer
114 : Die Objekt-Nummer ist den ePayBL Vertragsdaten zu entnehmen. Default-Wert wird als Platzhalter angezeigt.
115 ; Kennzeichen-Mahnverfahren
116 : Das Kennzeichen-Mahnverfahren ist den ePayBL Vertragsdaten zu entnehmen. Default-Wert wird als Platzhalter angezeigt.
117 ; Fälligkeitszeitraum (in Tagen)
118 : Der Fälligkeitszeitraum ist frei wählbar. Default-Wert wird als Platzhalter angezeigt.
119 ; Buchungstext auf der PayPage
120 : Der Buchungstext ist frei wählbar. Default-Wert wird als Platzhalter angezeigt.
121 ; Unterstütze Zahlverfahren
122 : Eingrenzung der Zahlverfahren nötig. Default-Auswahl wird initial übernommen.
123 ; Zertifikat
124 : Dieses muss im Format **//p12//** sein. Name des Default-Zertifikats wird angezeigt.
125 ; Passwort
126 : Passwort zum entschlüsseln des Zertifikats. Default-Passwort wird initial übernommen.
127 ; Hostname oder IP des zu verwenden Proxy-Servers
128 : Default-Wert wird als Platzhalter angezeigt.
129 ; Port
130 : Der Port zum Proxy-Host. Default-Wert wird als Platzhalter angezeigt.