Zum Inhalt springen
Version 3.1 von MACH formsolutions am 24.06.2024
Zeige letzte Bearbeiter
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
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.
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
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.
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
42 ---
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
50 1. Empfänger-URL muss in der Oberfläche des Formularservers oder im Link als Parameter beim Formularaufruf angegeben werden
51 (`&ofsXX1_to_smail3=http://...`)
52 1. Sendeparameter für den Webservice (`&send=8`)
53
54 **Optionale Einstellungen:**
55
56 1. Weiterleitung auf eine bestimmte URL - Parameter: `webserviceRedirect`, der Wert ist URL-encdoed zu übergeben
57 1. Abschaltung Anlagenhandling: `anzahlAnlagen=keine`
58
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.
60
61 In `pdf-Fields` sind die folgenden Werte aus dem Formular enthalten:
62
63 * **userID**
64 Benutzernummer z.B. 22222222-2222-0000
65 * **ofsXX1_knr_std**
66 Kundennummer
67 * **b12c96nfBehoerde_Amt**
68 Amt des Benutzers,
69 z.B. Medienbüro, Finanzamt
70 * **b12c96nfBehoerde_Strasse**
71 Straßenname der Behördenanschrift
72 * **b12c96nfBehoerde_PLZ_Ort**
73 PLZ, Ort der Behördenanschrift,
74 z.B. 75217 Birkenfeld
75 * **b12c96nfBehoerde_Sachbearbeiter_Name**
76 Name des Sachbearbeiters
77 * **b12c96nfSachbearbeiter_Zimmernummer**
78 Zimmernummer des Sachbearbeiters
79 * **b12c96nfSachbearbeiter_Telefon**
80 Telefonnummer des Sachbearbeiters
81 * **b12c96nfSachbearbeiter_Telefax**
82 Telefax des Sachbearbeiters
83 * **b12c96nfSachbearbeiter_E_Mail**
84 E-Mail-Adresse des Sachbearbeiters
85 * **b12c96nfAntragsteller_Name**
86 Name / Nachname des Antragstellers
87 * **b12c96nfAntragsteller_Vorname**
88 Vorname des Antragstellers
89 * **b12c96nfAntragsteller_Strasse**
90 Straße des Antragstellers - Wohnortes
91 * **b12c96nfAntragsteller_PLZ**
92 Postleitzahl des Antragstellers – Wohnortes
93 * **b12c96nfAntragsteller_Ort**
94 Ortsname des Antragstellers – Wohnortes
95 * **b12c96nfAntragsteller_E_Mail**
96 E-Mail-Adresse des Antragstellers
97 * **AS_Telefon**
98 Telefonnummer des Antragstellers
99 * **AS_Telefax**
100 Telefaxnummer des Antragstellers
101
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.