... |
... |
@@ -16,31 +16,14 @@ |
16 |
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 |
17 |
* Das Plugin-Bundle //**plugin-bundle-epaybl.jar**// ist vorhanden und kompatibel mit der installierten FORMCYCLE-Version. |
18 |
18 |
|
|
19 |
+ |
19 |
19 |
== Migration einer bestehenden Installation == |
20 |
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 |
|
-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 Systemplugins |
37 |
|
-1. Gehen Sie in den neuen Menüpunkt //ePayBL Setup// |
38 |
|
- |
39 |
|
- |
40 |
40 |
{{info}} |
41 |
|
-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. |
|
23 |
+Bei einem Update von einem bestehenden [[**AKDB: EPayment-Plugin** >>url:https://help.formcycle.de/xwiki/bin/view/Formcycle/PluginDocumentation/AkdbEPaymentPlugin/]] muss vorher dieses in allen Mandanten deaktiviert werden. Ansonsten kann das Setup im Mandanten nicht abgeschlossen werden, da der Menüpunkt nicht sichtbar ist. |
42 |
42 |
{{/info}} |
43 |
43 |
|
|
26 |
+ |
44 |
44 |
== Installation als Systemadministrator == |
45 |
45 |
|
46 |
46 |
{{figure image="epaybl-system.png"}} |
... |
... |
@@ -55,13 +55,15 @@ |
55 |
55 |
* Anmeldung als **sadmin **am FORMCYCLE-System. |
56 |
56 |
* Registrierung des **//plugin-bundle-epaybl.jar//** Plugins im Bereich der System-Plugins. |
57 |
57 |
|
|
41 |
+ |
58 |
58 |
=== Fakultative Installationsschritte === |
59 |
59 |
|
60 |
60 |
* Jetzt ist ein neuer Menüpunkt **ePayBL Setup** vorhanden, welcher aufgerufen werden kann. |
61 |
61 |
{{info}}Hinweis: Sollte der Menüpunkt nicht sofort ersichtlich sein, ist ein Abmelden und anschließendes Anmelden als sadmin notwendig.{{/info}} |
62 |
|
-* Hier kann der {{formcycle/}} Systemadministrator Default-Werte hinterlegen, welche den Mandanten als Platzhalter angezeigt werden und jenes Feld nicht ausfüllen müssen. |
63 |
|
-* Für genauere Informationen zu den einzelnen Eingabefeldern siehe //Eingabefelder//. |
|
46 |
+* Hier kann der Xima® Formcycle-Administrator Default-Werte hinterlegen, welche den Mandanten als Platzhalter angezeigt werden und jenes Feld nicht ausfüllen müssen. |
|
47 |
+* Für genauere Informationen zu den einzelnen Eingabefeldern siehe //ePayBL Setup - Mandant//. |
64 |
64 |
|
|
49 |
+ |
65 |
65 |
== ePayBL Setup - Mandant == |
66 |
66 |
|
67 |
67 |
{{figure image="epaybl-client.png"}} |
... |
... |
@@ -68,8 +68,6 @@ |
68 |
68 |
Der Mandant muss hier alle weiteren Felder ausfüllen, um das Setup zu speichern. |
69 |
69 |
{{/figure}} |
70 |
70 |
|
71 |
|
-Der Mandant vervollständigt das **ePayBL Setup**. |
72 |
|
- |
73 |
73 |
=== Obligatorische Installationsschritte === |
74 |
74 |
|
75 |
75 |
* Anmeldung in den FORMCYCLE-Mandanten, welcher eine Anbindung erhalten soll. |
... |
... |
@@ -76,6 +76,33 @@ |
76 |
76 |
* Jetzt ist ein neuer Menüpunkt **ePayBL Setup** vorhanden, welcher aufgerufen werden muss. |
77 |
77 |
* Nun müssen alle Werte hinterlegt werden, außer es existieren bereits Default-Werte: |
78 |
78 |
|
|
62 |
+; URL des Providers |
|
63 |
+: Die URL der anzubindenen Umgebung. Default-Wert wird als Platzhalter angezeigt. Änderungen des Default-Wertes durch den Xima® Formcycle-Administrator werden im Platzhalter sichtbar. |
|
64 |
+; Mandant-Nummer |
|
65 |
+: Die Mandant-Nummer ist den ePayBL Vertragsdaten zu entnehmen. Default-Wert wird als Platzhalter angezeigt. Änderungen des Default-Wertes durch den Xima® Formcycle-Administrator werden im Platzhalter sichtbar. |
|
66 |
+; Bewirtschafter-Nummer |
|
67 |
+: Die Bewirtschafter-Nummer ist den ePayBL Vertragsdaten zu entnehmen. Default-Wert wird als Platzhalter angezeigt. Änderungen des Default-Wertes durch den Xima® Formcycle-Administrator werden im Platzhalter sichtbar. |
|
68 |
+; Haushaltsstelle |
|
69 |
+: Die Haushaltsstelle ist den ePayBL Vertragsdaten zu entnehmen. Default-Wert wird als Platzhalter angezeigt. Änderungen des Default-Wertes durch den Xima® Formcycle-Administrator werden im Platzhalter sichtbar. |
|
70 |
+; Objekt-Nummer |
|
71 |
+: Die Objekt-Nummer ist den ePayBL Vertragsdaten zu entnehmen. Default-Wert wird als Platzhalter angezeigt. Änderungen des Default-Wertes durch den Xima® Formcycle-Administrator werden im Platzhalter sichtbar. |
|
72 |
+; Kennzeichen-Mahnverfahren |
|
73 |
+: Das Kennzeichen-Mahnverfahren ist den ePayBL Vertragsdaten zu entnehmen. Default-Wert wird als Platzhalter angezeigt. Änderungen des Default-Wertes durch den Xima® Formcycle-Administrator werden im Platzhalter sichtbar. |
|
74 |
+; Fälligkeitszeitraum (in Tagen) |
|
75 |
+: Der Fälligkeitszeitraum ist frei wählbar. Default-Wert wird als Platzhalter angezeigt. Änderungen des Default-Wertes durch den Xima® Formcycle-Administrator werden im Platzhalter sichtbar. |
|
76 |
+; Buchungstext auf der PayPage |
|
77 |
+: Der Buchungstext ist frei wählbar. Default-Wert wird als Platzhalter angezeigt. Änderungen des Default-Wertes durch den Xima® Formcycle-Administrator werden im Platzhalter sichtbar. |
|
78 |
+; Unterstütze Zahlverfahren |
|
79 |
+: Eingrenzung der Zahlverfahren nötig. Default-Auswahl wird initial übernommen. Änderungen der Default-Auswahl durch den Xima® Formcycle-Administrator überschreibt keine bestehende Auswahl der Zahlverfahren in Mandanten. |
|
80 |
+; Zertifikat |
|
81 |
+: Dieses muss im Format **//p12//** sein. Default-Zertifikat wird initial übernommen. Änderungen des Default-Zertifikats durch den Xima® Formcycle-Administrator überschreibt kein bestehendes Zertifikat in Mandanten. |
|
82 |
+; Passwort |
|
83 |
+: Passwort zum entschlüsseln des Zertifikats. Default-Passwort wird initial übernommen. Änderungen des Default-Passwortes durch den Xima® Formcycle-Administrator überschreibt kein bestehendes Passwort in Mandanten. |
|
84 |
+; Hostname oder IP des zu verwenden Proxy-Servers |
|
85 |
+: Default-Wert wird als Platzhalter angezeigt. Änderungen des Default-Wertes durch den Xima® Formcycle-Administrator werden im Platzhalter sichtbar. |
|
86 |
+; Port |
|
87 |
+: Der Port zum Proxy-Host. Default-Wert wird als Platzhalter angezeigt. Änderungen des Default-Wertes durch den Xima® Formcycle-Administrator werden im Platzhalter sichtbar. |
|
88 |
+ |
79 |
79 |
{{info}} |
80 |
80 |
Hinweis: Nur wenn sowohl Hostname als auch Port angegeben sind, wird die Verbindung darüber aufgebaut. |
81 |
81 |
{{/info}} |
... |
... |
@@ -99,34 +99,14 @@ |
99 |
99 |
Die URL der anzubindenden Umgebung muss **vom FORMCYCLE Master-Server aus erreichbar** sein. |
100 |
100 |
{{/warning}} |
101 |
101 |
|
|
112 |
+== Anpassungen zum späteren Zeitpunkt == |
102 |
102 |
|
103 |
|
-== Eingabefelder == |
|
114 |
+=== Aktualisierung des Zugriffszertifikats für den ePayBL ePayment LIVE-Service === |
104 |
104 |
|
105 |
|
-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. |
|
116 |
+==== Vorbedingung ==== |
106 |
106 |
|
107 |
|
-; URL des Providers |
108 |
|
-: Die URL der anzubindenen Umgebung. Default-Wert wird als Platzhalter angezeigt. |
109 |
|
-; Mandant-Nummer |
110 |
|
-: Die Mandant-Nummer ist den ePayBL Vertragsdaten zu entnehmen. Default-Wert wird als Platzhalter angezeigt. |
111 |
|
-; Bewirtschafter-Nummer |
112 |
|
-: Die Bewirtschafter-Nummer ist den ePayBL Vertragsdaten zu entnehmen. Default-Wert wird als Platzhalter angezeigt. |
113 |
|
-; Haushaltsstelle |
114 |
|
-: Die Haushaltsstelle ist den ePayBL Vertragsdaten zu entnehmen. Default-Wert wird als Platzhalter angezeigt. |
115 |
|
-; Objekt-Nummer |
116 |
|
-: Die Objekt-Nummer ist den ePayBL Vertragsdaten zu entnehmen. Default-Wert wird als Platzhalter angezeigt. |
117 |
|
-; Kennzeichen-Mahnverfahren |
118 |
|
-: Das Kennzeichen-Mahnverfahren ist den ePayBL Vertragsdaten zu entnehmen. Default-Wert wird als Platzhalter angezeigt. |
119 |
|
-; Fälligkeitszeitraum (in Tagen) |
120 |
|
-: Der Fälligkeitszeitraum ist frei wählbar. Default-Wert wird als Platzhalter angezeigt. |
121 |
|
-; Buchungstext auf der PayPage |
122 |
|
-: Der Buchungstext ist frei wählbar. Default-Wert wird als Platzhalter angezeigt. |
123 |
|
-; Unterstütze Zahlverfahren |
124 |
|
-: Eingrenzung der Zahlverfahren nötig. Default-Auswahl wird initial übernommen. |
125 |
|
-; Zertifikat |
126 |
|
-: Dieses muss im Format **//p12//** sein. Name des Default-Zertifikats wird angezeigt. |
127 |
|
-; Passwort |
128 |
|
-: Passwort zum entschlüsseln des Zertifikats. Default-Passwort wird initial übernommen. |
129 |
|
-; Hostname oder IP des zu verwenden Proxy-Servers |
130 |
|
-: Default-Wert wird als Platzhalter angezeigt. |
131 |
|
-; Port |
132 |
|
-: Der Port zum Proxy-Host. Default-Wert wird als Platzhalter angezeigt. |
|
118 |
+Sie haben ein neues Zertifikat für den Zugriff auf den ePayBL Webservice erhalten, da ihr altes Zertifikat abgelaufen ist |
|
119 |
+ |
|
120 |
+==== Vorgehen ==== |
|
121 |
+ |
|
122 |
+Folgen Sie der Anleitung unter dem Punkt **ePayBL Setup** - Schritt 2: [[Installationsschritte>>doc:]] und aktualisieren Sie ihr Zertifikat. |