Ä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 1.1
bearbeitet von MACH ProForms GmbH
am 08.10.2020
Ä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,65 @@
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 +- **ofsXX1_knr_std**<br/>
66 66  Kundennummer
67 -* **b12c96nfBehoerde_Amt**
68 -Amt des Benutzers,
69 +
70 +- **b12c96nfBehoerde_Amt**<br/>
71 +Amt des Benutzers,<br/>
69 69  z.B. Medienbüro, Finanzamt
70 -* **b12c96nfBehoerde_Strasse**
73 +
74 +- **b12c96nfBehoerde_Strasse**<br/>
71 71  Straßenname der Behördenanschrift
72 -* **b12c96nfBehoerde_PLZ_Ort**
73 -PLZ, Ort der Behördenanschrift,
76 +
77 +- **b12c96nfBehoerde_PLZ_Ort**<br/>
78 +PLZ, Ort der Behördenanschrift,<br/>
74 74  z.B. 75217 Birkenfeld
75 -* **b12c96nfBehoerde_Sachbearbeiter_Name**
80 +
81 +- **b12c96nfBehoerde_Sachbearbeiter_Name**<br/>
76 76  Name des Sachbearbeiters
77 -* **b12c96nfSachbearbeiter_Zimmernummer**
83 +
84 +- **b12c96nfSachbearbeiter_Zimmernummer**<br/>
78 78  Zimmernummer des Sachbearbeiters
79 -* **b12c96nfSachbearbeiter_Telefon**
86 +
87 +- **b12c96nfSachbearbeiter_Telefon**<br/>
80 80  Telefonnummer des Sachbearbeiters
81 -* **b12c96nfSachbearbeiter_Telefax**
89 +
90 +- **b12c96nfSachbearbeiter_Telefax**<br/>
82 82  Telefax des Sachbearbeiters
83 -* **b12c96nfSachbearbeiter_E_Mail**
92 +
93 +- **b12c96nfSachbearbeiter_E_Mail**<br/>
84 84  E-Mail-Adresse des Sachbearbeiters
85 -* **b12c96nfAntragsteller_Name**
95 +
96 +- **b12c96nfAntragsteller_Name**<br/>
86 86  Name / Nachname des Antragstellers
87 -* **b12c96nfAntragsteller_Vorname**
98 +
99 +- **b12c96nfAntragsteller_Vorname**<br/>
88 88  Vorname des Antragstellers
89 -* **b12c96nfAntragsteller_Strasse**
101 +
102 +- **b12c96nfAntragsteller_Strasse**<br/>
90 90  Straße des Antragstellers - Wohnortes
91 -* **b12c96nfAntragsteller_PLZ**
104 +
105 +- **b12c96nfAntragsteller_PLZ**<br/>
92 92  Postleitzahl des Antragstellers – Wohnortes
93 -* **b12c96nfAntragsteller_Ort**
107 +
108 +- **b12c96nfAntragsteller_Ort**<br/>
94 94  Ortsname des Antragstellers – Wohnortes
95 -* **b12c96nfAntragsteller_E_Mail**
110 +
111 +- **b12c96nfAntragsteller_E_Mail**<br/>
96 96  E-Mail-Adresse des Antragstellers
97 -* **AS_Telefon**
98 -Telefonnummer des Antragstellers
99 -* **AS_Telefax**
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.