Änderungen von Dokument Datenübergabe Einreicheprozess

Zuletzt geändert von MACH ProForms GmbH am 24.06.2024

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

Zusammenfassung

Details

Seiteneigenschaften
Dokument-Autor
... ... @@ -1,1 +1,1 @@
1 -xwiki:XWiki.fweise
1 +xwiki:XWiki.Dokumentation
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 MACH ProForms 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 Form-Solutions erhalten, Voraussetzung.
25 25  
26 26  #### Beispiel:
27 27  
... ... @@ -30,16 +30,19 @@
30 30  
31 31  #### Übergabeparameter:
32 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.
33 +- **cmskey**<br/>
34 +Eindeutiger Schlüssel des Kunden, erhält er von Form-Solutions
39 39  
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 +
40 40  Rückgabe: Die jeweilige Datei entweder im Browser oder als Download. Für jede Datei muss der Aufruf separat durchgeführt werden.
41 41  
42 ----
45 +___
43 43  
44 44  ## Datenübergabe via Webservice
45 45  
... ... @@ -47,56 +47,75 @@
47 47  
48 48  **Notwendige Einstellung:**
49 49  
50 -1. Empfänger-URL muss in der Oberfläche des Formularservers oder im Link als Parameter beim Formularaufruf angegeben werden
53 +1. Empfänger-URL muss in der Oberfläche des Formularservers oder im Link als Parameter beim Formularaufruf angegeben werden<br/>
51 51  (`&ofsXX1_to_smail3=http://...`)
52 -1. Sendeparameter für den Webservice (`&send=8`)
53 53  
56 +2. Sendeparameter für den Webservice (`&send=8`)
57 +
54 54  **Optionale Einstellungen:**
55 55  
56 56  1. Weiterleitung auf eine bestimmte URL - Parameter: `webserviceRedirect`, der Wert ist URL-encdoed zu übergeben
57 -1. Abschaltung Anlagenhandling: `anzahlAnlagen=keine`
61 +2. Abschaltung Anlagenhandling: `anzahlAnlagen=keine`
58 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.
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.
60 60  
61 61  In `pdf-Fields` sind die folgenden Werte aus dem Formular enthalten:
62 62  
63 -* **userID**
64 -Benutzernummer z.B. 22222222-2222-0000
65 -* **ofsXX1_knr_std**
67 +- **userID**<br/>
68 +Benutzernummer
69 +z.B. 22222222-2222-0000
70 +
71 +- **ofsXX1_knr_std**<br/>
66 66  Kundennummer
67 -* **b12c96nfBehoerde_Amt**
68 -Amt des Benutzers,
73 +
74 +- **b12c96nfBehoerde_Amt**<br/>
75 +Amt des Benutzers,<br/>
69 69  z.B. Medienbüro, Finanzamt
70 -* **b12c96nfBehoerde_Strasse**
77 +
78 +- **b12c96nfBehoerde_Strasse**<br/>
71 71  Straßenname der Behördenanschrift
72 -* **b12c96nfBehoerde_PLZ_Ort**
73 -PLZ, Ort der Behördenanschrift,
80 +
81 +- **b12c96nfBehoerde_PLZ_Ort**<br/>
82 +PLZ, Ort der Behördenanschrift,<br/>
74 74  z.B. 75217 Birkenfeld
75 -* **b12c96nfBehoerde_Sachbearbeiter_Name**
84 +
85 +- **b12c96nfBehoerde_Sachbearbeiter_Name**<br/>
76 76  Name des Sachbearbeiters
77 -* **b12c96nfSachbearbeiter_Zimmernummer**
87 +
88 +- **b12c96nfSachbearbeiter_Zimmernummer**<br/>
78 78  Zimmernummer des Sachbearbeiters
79 -* **b12c96nfSachbearbeiter_Telefon**
90 +
91 +- **b12c96nfSachbearbeiter_Telefon**<br/>
80 80  Telefonnummer des Sachbearbeiters
81 -* **b12c96nfSachbearbeiter_Telefax**
93 +
94 +- **b12c96nfSachbearbeiter_Telefax**<br/>
82 82  Telefax des Sachbearbeiters
83 -* **b12c96nfSachbearbeiter_E_Mail**
96 +
97 +- **b12c96nfSachbearbeiter_E_Mail**<br/>
84 84  E-Mail-Adresse des Sachbearbeiters
85 -* **b12c96nfAntragsteller_Name**
99 +
100 +- **b12c96nfAntragsteller_Name**<br/>
86 86  Name / Nachname des Antragstellers
87 -* **b12c96nfAntragsteller_Vorname**
102 +
103 +- **b12c96nfAntragsteller_Vorname**<br/>
88 88  Vorname des Antragstellers
89 -* **b12c96nfAntragsteller_Strasse**
105 +
106 +- **b12c96nfAntragsteller_Strasse**<br/>
90 90  Straße des Antragstellers - Wohnortes
91 -* **b12c96nfAntragsteller_PLZ**
108 +
109 +- **b12c96nfAntragsteller_PLZ**<br/>
92 92  Postleitzahl des Antragstellers – Wohnortes
93 -* **b12c96nfAntragsteller_Ort**
111 +
112 +- **b12c96nfAntragsteller_Ort**<br/>
94 94  Ortsname des Antragstellers – Wohnortes
95 -* **b12c96nfAntragsteller_E_Mail**
114 +
115 +- **b12c96nfAntragsteller_E_Mail**<br/>
96 96  E-Mail-Adresse des Antragstellers
97 -* **AS_Telefon**
117 +
118 +- **AS_Telefon**<br/>
98 98  Telefonnummer des Antragstellers
99 -* **AS_Telefax**
120 +
121 +- **AS_Telefax**<br/>
100 100  Telefaxnummer des Antragstellers
101 101  
102 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.