Wiki-Quellcode von Datenübergabe Einreicheprozess

Zuletzt geändert von MACH ProForms GmbH am 24.06.2024

version	line-number	content
1.1	1	## Datenübergabe über E-Mail (Attachements oder HTTPS)
	2
	3	Die Standardübermittlung der Formularinhaltsdaten erfolgt per E-Mail. Hierbei wird zusätzlich zwischen einer sicheren und unsicheren Übertragung unterschieden. Bei der sicheren Übertragung (Parameter im veröffentlichten Link `send=1`) wird an die in der Datenbank definierte E-Mail-Adresse eine E-Mail versendet, welche drei bzw. vier Verweise zu den Inhaltsdaten im PDF-, XML, FDF, und ZIP-Format enthält. Zur automatischen Übernahme dieser Daten können diese Verweise ausgelesen und in den Link der Username und das Passwort eingetragen werden (Htaccess-Vefahren). Bei unsicheren E-Mails werden die Formulardaten in den Anhang der E-Mail beigelegt. Diese können demnach direkt vom System oder User übernommen werden.
	4
	5	### Beispiel für Zustellung über E-Mail:
	6
	7	Inbox (Verzeichnis eingegangener Formulare)
	8	<https://pdf.form-solutions.net/jmp.php?inb=YWVqRnZydnM=>
	9
	10	PDF-Formular (Direktstart)
	11	<https://pdf.form-solutions.net/cust/22222222-2222_formsolutions/process/010040-aejFvrvs.pdf>
	12
	13	XML-Datensatz
	14	<https://pdf.form-solutions.net/cust/22222222-2222_formsolutions/process/010040-aejFvrvs.xml>
	15
	16	Anlagen
	17	<https://pdf.form-solutions.net/cust/22222222-2222_formsolutions/process/010040-aejFvrvs_attachments.zip>
	18
	19	Benutzername und Passwort
	20	<https://Mustermann:Passwort@pdf.form-solutions.net/cust/22222222-2222_formsolutions/process/010040-aejFvrvs.pdf>
	21
	22	### Datenabholung über das Mail/CMS-Key Verfahren
	23
3.1	24	Zur automatisierten Abholung hat der Formularserver zum oben beschriebenen Abholverfahren mit Htaccess-Vefahren ein alternatives Verfahren namens Mail/CMS-Key entwickelt. Dazu muss das entsprechende System die Vorgangs-ID ermitteln. Mittels dieser ID und dem CMS-Key wird anschließend ein entsprechendes Servlet aufgerufen. Für dieses Verfahren ist der Besitz eines CMS-Keys, den Sie von MACH ProForms erhalten, Voraussetzung.
1.1	25
	26	#### Beispiel:
	27
	28	<https://pdf.form-solutions.net/servlet/FileDownload?cmskey=22222222-2222js&templatename=010040-aejFvrvs.pdf&d=1>
	29	(Öffnet das PDF-Formular im Browser)
	30
	31	#### Übergabeparameter:
	32
3.1	33	* cmskey
	34	Eindeutiger Schlüssel des Kunden, erhält er von MACH ProForms
	35	* templatename
	36	Vorgangs-ID (aus Mail geparst) incl. der Dateiendung. Die Dateiendung wird benötigt, weil sonst keine Datei abgeholt werden kann.
	37	* d
	38	Angabe, ob im Browser oder nur herunterladen angeboten werden soll, `d=1` im Browser öffnen, `d=0` herunterladen.
1.1	39
	40	Rückgabe: Die jeweilige Datei entweder im Browser oder als Download. Für jede Datei muss der Aufruf separat durchgeführt werden.
	41
3.1	42	---
1.1	43
	44	## Datenübergabe via Webservice
	45
	46	Alternativ zur Datenübertragung über E-Mail wird vom Formularserver die Übertragung der Formularinhaltsdaten via Webservice an eine beliebige URL angeboten.
	47
	48	Notwendige Einstellung:
	49
3.1	50	1. Empfänger-URL muss in der Oberfläche des Formularservers oder im Link als Parameter beim Formularaufruf angegeben werden
1.1	51	(`&ofsXX1_to_smail3=http://...`)
3.1	52	1. Sendeparameter für den Webservice (`&send=8`)
1.1	53
	54	Optionale Einstellungen:
	55
	56	1. Weiterleitung auf eine bestimmte URL - Parameter: `webserviceRedirect`, der Wert ist URL-encdoed zu übergeben
3.1	57	1. Abschaltung Anlagenhandling: `anzahlAnlagen=keine`
1.1	58
3.1	59	Der zu implementierende Webservice muss dabei die Methode `getFormularInhaltsdaten(String pdffields[], String files[])` mit einem Rückgabewert vom Typ `boolean` ![[accept\|accept]]`false `) zur Verfügung stellen.
1.1	60
	61	In `pdf-Fields` sind die folgenden Werte aus dem Formular enthalten:
	62
3.1	63	* userID
	64	Benutzernummer z.B. 22222222-2222-0000
	65	* ofsXX1_knr_std
1.1	66	Kundennummer
3.1	67	* b12c96nfBehoerde_Amt
	68	Amt des Benutzers,
1.1	69	z.B. Medienbüro, Finanzamt
3.1	70	* b12c96nfBehoerde_Strasse
1.1	71	Straßenname der Behördenanschrift
3.1	72	* b12c96nfBehoerde_PLZ_Ort
	73	PLZ, Ort der Behördenanschrift,
1.1	74	z.B. 75217 Birkenfeld
3.1	75	* b12c96nfBehoerde_Sachbearbeiter_Name
1.1	76	Name des Sachbearbeiters
3.1	77	* b12c96nfSachbearbeiter_Zimmernummer
1.1	78	Zimmernummer des Sachbearbeiters
3.1	79	* b12c96nfSachbearbeiter_Telefon
1.1	80	Telefonnummer des Sachbearbeiters
3.1	81	* b12c96nfSachbearbeiter_Telefax
1.1	82	Telefax des Sachbearbeiters
3.1	83	* b12c96nfSachbearbeiter_E_Mail
1.1	84	E-Mail-Adresse des Sachbearbeiters
3.1	85	* b12c96nfAntragsteller_Name
1.1	86	Name / Nachname des Antragstellers
3.1	87	* b12c96nfAntragsteller_Vorname
1.1	88	Vorname des Antragstellers
3.1	89	* b12c96nfAntragsteller_Strasse
1.1	90	Straße des Antragstellers - Wohnortes
3.1	91	* b12c96nfAntragsteller_PLZ
1.1	92	Postleitzahl des Antragstellers – Wohnortes
3.1	93	* b12c96nfAntragsteller_Ort
1.1	94	Ortsname des Antragstellers – Wohnortes
3.1	95	* b12c96nfAntragsteller_E_Mail
1.1	96	E-Mail-Adresse des Antragstellers
3.1	97	* AS_Telefon
2.1	98	Telefonnummer des Antragstellers
3.1	99	* AS_Telefax
2.1	100	Telefaxnummer des Antragstellers
	101
1.1	102	Jedes Formularfeld entspricht dabei einem Eintrag in dem Array. Sollte ein Formularfeld nicht befüllt sein, so wird hierfür ein leerer String verwendet. `Files` enthält die Dateien, `pdf`, `fdf`, `xml` und wenn vorhanden auch `zip`. Die Daten sind dabei jeweils base64-codiert.