Änderungen von Dokument ePayBL Setup

Zusammenfassung

• Seiteneigenschaften (1 geändert, 0 hinzugefügt, 0 gelöscht)

Details

Seiteneigenschaften

Inhalt

...	...	@@ -20,20 +20,54 @@
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	23
24		-1. Listenpunkt
25		-1. Listenpunkt
26		-1. Listenpunkt
	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.
27	27
28		-; Notieren Sie sich Ihre bisherigen Angaben
29		-: Mandant-Nummer, Bewirtschafter-Nummer, Haushaltsstelle, Objektnummer und Kennzeichen-Mahnverfahren sowie Angaben Ihres Proxy falls vorhanden.
30		-; Stellen Sie Zertifikat und Passwort sicher, dieses wird auch für Ihr Testsystem benötigt.
31		-; Prüfen Sie die URL Ihres ePayBL-Providers
32		-: Für das Testsystem war dies bisher **//epay-pre.akdb.de//**.
33		-: Für das Livesystem war dies bisher **//epay.akdb.de//**.
	27	+=== Migration ===
34	34
35		-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.
	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://infra-pre.buergerserviceportal.de" oder "https://epay-pre.akdb.de" zur Anbindung. Welche Umgebung in Ihrem Fall greift können Sie bei der AKDB nachfragen.
	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. Eventuell müssen Sie sich erneut anmelden um diesen zu sehen.
	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“.
36	36
	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	+
37	37	{{info}}
38	38	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.
39	39	{{/info}}
...	...	@@ -49,7 +49,7 @@
49	49
50	50	=== Obligatorische Installationsschritte ===
51	51
52		-* Anmeldung als **sadmin **am FORMCYCLE-System.
	86	+* Anmeldung als **sadmin **am {{formcycle/}}-System.
53	53	* Registrierung des **//plugin-bundle-epaybl.jar//** Plugins im Bereich der System-Plugins.
54	54
55	55	=== Fakultative Installationsschritte ===
...	...	@@ -102,7 +102,8 @@
102	102	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.
103	103
104	104	; URL des Providers
105		-: Die URL der anzubindenen Umgebung. Default-Wert wird als Platzhalter angezeigt.
	139	+: Die URL der anzubindenen Umgebung. Der Default-Wert wird als Platzhalter angezeigt.
	140	+: Für die Anbindung ePayBL-Systeme der AKDB muss hier https://infra-pre.buergerserviceportal.de für das Testsytem und https://epay.akdb.de für das Livesystem eingetragen werden.
106	106	; Mandant-Nummer
107	107	: Die Mandant-Nummer ist den ePayBL Vertragsdaten zu entnehmen. Default-Wert wird als Platzhalter angezeigt.
108	108	; Bewirtschafter-Nummer
...	...	@@ -117,6 +117,7 @@
117	117	: Der Fälligkeitszeitraum ist frei wählbar. Default-Wert wird als Platzhalter angezeigt.
118	118	; Buchungstext auf der PayPage
119	119	: Der Buchungstext ist frei wählbar. Default-Wert wird als Platzhalter angezeigt.
	155	+: Eingabe muss dem Pattern //^[\w\-\./+\ @,\:\&\'\?\#{}\(\)\[\]\u00C0-\u017F\u1E9E]*$// entsprechen
120	120	; Unterstütze Zahlverfahren
121	121	: Eingrenzung der Zahlverfahren nötig. Default-Auswahl wird initial übernommen.
122	122	; Zertifikat
...	...	@@ -127,3 +127,16 @@
127	127	: Default-Wert wird als Platzhalter angezeigt.
128	128	; Port
129	129	: Der Port zum Proxy-Host. Default-Wert wird als Platzhalter angezeigt.
	166	+
	167	+=== Zahlverfahren ===
	168	+
	169	+In {{formcycle/}} müssen die verfügbaren Zahlverfahren ausgewählt werden, welche von Ihrem ePayBL-System unterstützt werden. Aktuell werden folgende Zahlverfahren unterstützt:
	170	+
	171	+; Giropay
	172	+; Kreditkarte
	173	+; PayPal
	174	+; PayDirekt
	175	+; Überweisung
	176	+; Lastschrift ohne Einzugsermächtigung
	177	+
	178	+Sobald in {{formcycle/}} Zahlverfahren angegeben werden, welche nicht im ePayBL-System erlaubt sind, kommt eine Fehlermeldung. Sie können die Zahlverfahren auf ein Minimum von einem Zahlverfahren eingrenzen.