Zum Inhalt springen

Änderungen von Dokument Datenübergabe Einreicheprozess

Zuletzt geändert von MACH ProForms GmbH am 24.06.2024
Von Version 2.1
bearbeitet von MACH ProForms GmbH
am 11.10.2021
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 3.1
bearbeitet von MACH ProForms GmbH
am 24.06.2024
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Dokument-Autor
... ... @@ -1,1 +1,1 @@
1 -xwiki:XWiki.Dokumentation
1 +xwiki:XWiki.fweise
Inhalt
... ... @@ -21,7 +21,7 @@
21 21  
22 22  ### Datenabholung über das Mail/CMS-Key Verfahren
23 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 Form-Solutions erhalten, Voraussetzung.
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 25  
26 26  #### Beispiel:
27 27  
... ... @@ -30,19 +30,16 @@
30 30  
31 31  #### Übergabeparameter:
32 32  
33 -- **cmskey**<br/>
34 -Eindeutiger Schlüssel des Kunden, erhält er von Form-Solutions
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.
35 35  
36 -- **templatename**<br/>
37 - Vorgangs-ID (aus Mail geparst) incl. der Dateiendung. Die Dateiendung wird benötigt, weil sonst keine Datei abgeholt werden kann.
38 -
39 -- **d**<br/>
40 -Angabe, ob im Browser oder nur herunterladen angeboten werden soll, `d=1` im Browser
41 -öffnen, `d=0` herunterladen.
42 -
43 43  Rückgabe: Die jeweilige Datei entweder im Browser oder als Download. Für jede Datei muss der Aufruf separat durchgeführt werden.
44 44  
45 -___
42 +---
46 46  
47 47  ## Datenübergabe via Webservice
48 48  
... ... @@ -50,75 +50,56 @@
50 50  
51 51  **Notwendige Einstellung:**
52 52  
53 -1. Empfänger-URL muss in der Oberfläche des Formularservers oder im Link als Parameter beim Formularaufruf angegeben werden<br/>
50 +1. Empfänger-URL muss in der Oberfläche des Formularservers oder im Link als Parameter beim Formularaufruf angegeben werden
54 54  (`&ofsXX1_to_smail3=http://...`)
52 +1. Sendeparameter für den Webservice (`&send=8`)
55 55  
56 -2. Sendeparameter für den Webservice (`&send=8`)
57 -
58 58  **Optionale Einstellungen:**
59 59  
60 60  1. Weiterleitung auf eine bestimmte URL - Parameter: `webserviceRedirect`, der Wert ist URL-encdoed zu übergeben
61 -2. Abschaltung Anlagenhandling: `anzahlAnlagen=keine`
57 +1. Abschaltung Anlagenhandling: `anzahlAnlagen=keine`
62 62  
63 -Der zu implementierende Webservice muss dabei die Methode `getFormularInhaltsdaten(String pdffields[], String files[])` mit einem Rückgabewert vom Typ `boolean` (` true`/`false `) zur Verfügung stellen.
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.
64 64  
65 65  In `pdf-Fields` sind die folgenden Werte aus dem Formular enthalten:
66 66  
67 -- **userID**<br/>
68 -Benutzernummer
69 -z.B. 22222222-2222-0000
70 -
71 -- **ofsXX1_knr_std**<br/>
63 +* **userID**
64 +Benutzernummer z.B. 22222222-2222-0000
65 +* **ofsXX1_knr_std**
72 72  Kundennummer
73 -
74 -- **b12c96nfBehoerde_Amt**<br/>
75 -Amt des Benutzers,<br/>
67 +* **b12c96nfBehoerde_Amt**
68 +Amt des Benutzers,
76 76  z.B. Medienbüro, Finanzamt
77 -
78 -- **b12c96nfBehoerde_Strasse**<br/>
70 +* **b12c96nfBehoerde_Strasse**
79 79  Straßenname der Behördenanschrift
80 -
81 -- **b12c96nfBehoerde_PLZ_Ort**<br/>
82 -PLZ, Ort der Behördenanschrift,<br/>
72 +* **b12c96nfBehoerde_PLZ_Ort**
73 +PLZ, Ort der Behördenanschrift,
83 83  z.B. 75217 Birkenfeld
84 -
85 -- **b12c96nfBehoerde_Sachbearbeiter_Name**<br/>
75 +* **b12c96nfBehoerde_Sachbearbeiter_Name**
86 86  Name des Sachbearbeiters
87 -
88 -- **b12c96nfSachbearbeiter_Zimmernummer**<br/>
77 +* **b12c96nfSachbearbeiter_Zimmernummer**
89 89  Zimmernummer des Sachbearbeiters
90 -
91 -- **b12c96nfSachbearbeiter_Telefon**<br/>
79 +* **b12c96nfSachbearbeiter_Telefon**
92 92  Telefonnummer des Sachbearbeiters
93 -
94 -- **b12c96nfSachbearbeiter_Telefax**<br/>
81 +* **b12c96nfSachbearbeiter_Telefax**
95 95  Telefax des Sachbearbeiters
96 -
97 -- **b12c96nfSachbearbeiter_E_Mail**<br/>
83 +* **b12c96nfSachbearbeiter_E_Mail**
98 98  E-Mail-Adresse des Sachbearbeiters
99 -
100 -- **b12c96nfAntragsteller_Name**<br/>
85 +* **b12c96nfAntragsteller_Name**
101 101  Name / Nachname des Antragstellers
102 -
103 -- **b12c96nfAntragsteller_Vorname**<br/>
87 +* **b12c96nfAntragsteller_Vorname**
104 104  Vorname des Antragstellers
105 -
106 -- **b12c96nfAntragsteller_Strasse**<br/>
89 +* **b12c96nfAntragsteller_Strasse**
107 107  Straße des Antragstellers - Wohnortes
108 -
109 -- **b12c96nfAntragsteller_PLZ**<br/>
91 +* **b12c96nfAntragsteller_PLZ**
110 110  Postleitzahl des Antragstellers – Wohnortes
111 -
112 -- **b12c96nfAntragsteller_Ort**<br/>
93 +* **b12c96nfAntragsteller_Ort**
113 113  Ortsname des Antragstellers – Wohnortes
114 -
115 -- **b12c96nfAntragsteller_E_Mail**<br/>
95 +* **b12c96nfAntragsteller_E_Mail**
116 116  E-Mail-Adresse des Antragstellers
117 -
118 -- **AS_Telefon**<br/>
97 +* **AS_Telefon**
119 119  Telefonnummer des Antragstellers
120 -
121 -- **AS_Telefax**<br/>
99 +* **AS_Telefax**
122 122  Telefaxnummer des Antragstellers
123 123  
124 124  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.