Datenübergabe Einreicheprozess
Datenübergabe über E-Mail (Attachements oder HTTPS)
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.
Beispiel für Zustellung über E-Mail:
Inbox (Verzeichnis eingegangener Formulare)
https://pdf.form-solutions.net/jmp.php?inb=YWVqRnZydnM=
PDF-Formular (Direktstart)
https://pdf.form-solutions.net/cust/22222222-2222_formsolutions/process/010040-aejFvrvs.pdf
XML-Datensatz
https://pdf.form-solutions.net/cust/22222222-2222_formsolutions/process/010040-aejFvrvs.xml
Benutzername und Passwort
https://Mustermann:Passwort@pdf.form-solutions.net/cust/22222222-2222_formsolutions/process/010040-aejFvrvs.pdf
Datenabholung über das Mail/CMS-Key Verfahren
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.
Beispiel:
https://pdf.form-solutions.net/servlet/FileDownload?cmskey=22222222-2222js&templatename=010040-aejFvrvs.pdf&d=1
(Öffnet das PDF-Formular im Browser)
Übergabeparameter:
- cmskey
Eindeutiger Schlüssel des Kunden, erhält er von MACH ProForms - templatename
Vorgangs-ID (aus Mail geparst) incl. der Dateiendung. Die Dateiendung wird benötigt, weil sonst keine Datei abgeholt werden kann. - d
Angabe, ob im Browser oder nur herunterladen angeboten werden soll, d=1 im Browser öffnen, d=0 herunterladen.
Rückgabe: Die jeweilige Datei entweder im Browser oder als Download. Für jede Datei muss der Aufruf separat durchgeführt werden.
Datenübergabe via Webservice
Alternativ zur Datenübertragung über E-Mail wird vom Formularserver die Übertragung der Formularinhaltsdaten via Webservice an eine beliebige URL angeboten.
Notwendige Einstellung:
- Empfänger-URL muss in der Oberfläche des Formularservers oder im Link als Parameter beim Formularaufruf angegeben werden
(&ofsXX1_to_smail3=http://...) - Sendeparameter für den Webservice (&send=8)
Optionale Einstellungen:
- Weiterleitung auf eine bestimmte URL - Parameter: webserviceRedirect, der Wert ist URL-encdoed zu übergeben
- Abschaltung Anlagenhandling: anzahlAnlagen=keine
Der zu implementierende Webservice muss dabei die Methode getFormularInhaltsdaten(String pdffields[], String files[]) mit einem Rückgabewert vom Typ boolean false ) zur Verfügung stellen.
In pdf-Fields sind die folgenden Werte aus dem Formular enthalten:
- userID
Benutzernummer z.B. 22222222-2222-0000 - ofsXX1_knr_std
Kundennummer - b12c96nfBehoerde_Amt
Amt des Benutzers,
z.B. Medienbüro, Finanzamt - b12c96nfBehoerde_Strasse
Straßenname der Behördenanschrift - b12c96nfBehoerde_PLZ_Ort
PLZ, Ort der Behördenanschrift,
z.B. 75217 Birkenfeld - b12c96nfBehoerde_Sachbearbeiter_Name
Name des Sachbearbeiters - b12c96nfSachbearbeiter_Zimmernummer
Zimmernummer des Sachbearbeiters - b12c96nfSachbearbeiter_Telefon
Telefonnummer des Sachbearbeiters - b12c96nfSachbearbeiter_Telefax
Telefax des Sachbearbeiters - b12c96nfSachbearbeiter_E_Mail
E-Mail-Adresse des Sachbearbeiters - b12c96nfAntragsteller_Name
Name / Nachname des Antragstellers - b12c96nfAntragsteller_Vorname
Vorname des Antragstellers - b12c96nfAntragsteller_Strasse
Straße des Antragstellers - Wohnortes - b12c96nfAntragsteller_PLZ
Postleitzahl des Antragstellers – Wohnortes - b12c96nfAntragsteller_Ort
Ortsname des Antragstellers – Wohnortes - b12c96nfAntragsteller_E_Mail
E-Mail-Adresse des Antragstellers - AS_Telefon
Telefonnummer des Antragstellers - AS_Telefax
Telefaxnummer des Antragstellers
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.