Wiki-Quellcode von Parkausweis
Version 1.1 von MACH ProForms GmbH am 10.03.2020
Zeige letzte Bearbeiter
| author | version | line-number | content |
|---|---|---|---|
| 1 | # Allgemeines | ||
| 2 | |||
| 3 | ## Voraussetzungen | ||
| 4 | |||
| 5 | - Ein [[Paymentanbieter|Main.07_Einstellungen-Fachadministration.03_Module.01_Payment]] ist bereits eingerichtet. | ||
| 6 | - Assistentenrechte für den [[Mandanten|Main.07_Einstellungen-Fachadministration.01_Mandanten.01_Rechte]] sowie den [[Benutzer|Main.07_Einstellungen-Fachadministration.02_Benutzer.02_Benutzereinzelrechte]] sind vorhanden. | ||
| 7 | - Modulkonfigurationsrechte für den [[Mandanten|Main.07_Einstellungen-Fachadministration.01_Mandanten.01_Rechte]] sowie für den [[Benutzer|Main.07_Einstellungen-Fachadministration.02_Benutzer.02_Benutzereinzelrechte]] sind vorhanden. | ||
| 8 | |||
| 9 | ## Relevante Daten | ||
| 10 | |||
| 11 | - WebService-Url | ||
| 12 | - X-ApiKey | ||
| 13 | - Referer | ||
| 14 | |||
| 15 | ___ | ||
| 16 | |||
| 17 | # Konfiguration des WebServices | ||
| 18 | |||
| 19 | Es muss sichergestellt werden, dass der WebService "HSH Parkausweis" zur Verfügung steht (siehe hierzu "[[Webservice Einrichten|Main.07_Einstellungen-Fachadministration.03_Module.06_Webservice.01_WebserviceEinrichten]])". Hierzu kann entweder der Reiter "Web Services" - "WebService-Definition" oder "WebService-Konfiguration" genutzt werden. Ist die Replikation eingerichtet, sollte der WebService bereits vorhanden sein. | ||
| 20 | |||
| 21 | Unter "WebService-Konfiguration" müssen anschließend die obigen erwähnten Daten erfasst werden. Hierzu wird der WebService-Name "HSH-Parkausweis", die WebService-OrganisationsID "22222222-2222", sowie die von dem Anbieter bereitgestellte, bestenfalls aktuellste WebService-Version ausgewählt. Anschließend wird die WebService-URL eingetragen, beispielsweise "https://www.meldebehoerde.de:443/cebit/IRWSBV/soap/olav/v2/parkausweis". | ||
| 22 | |||
| 23 | "Werte für HTTP-Basic Authentifikation" sind standardmäßig nicht zu befüllen. | ||
| 24 | |||
| 25 | "Werte für Zertifikatsauthentifizierung" sind standardmäßig nicht zu befüllen. Eine Einrichtung wird von Form-Solutions jedoch empfohlen. | ||
| 26 | |||
| 27 | "Werte für Queue-Messaging Konfiguration" sind standardmäßig nicht zu befüllen. Eine Einrichtung wird von Form-Solutions jedoch empfohlen (siehe hierzu "[[Security Paket|Main.07_Einstellungen-Fachadministration.03_Module.09_Security-Paket]])". | ||
| 28 | |||
| 29 | Die Aktionsparameter sind zu definieren (siehe hierzu "[[Webservice Einrichten|Main.07_Einstellungen-Fachadministration.03_Module.06_Webservice.01_WebserviceEinrichten]]"). | ||
| 30 | |||
| 31 | Die Werte der Parameter sind je nach Kunden spezifisch anzupassen. | ||
| 32 | |||
| 33 | Nachfolgend werden die Aktionsparameter für "HSH Parkausweis" aufgelistet. | ||
| 34 | |||
| 35 | ``` | ||
| 36 | Aktionsname des WebServices | ||
| 37 | suche | ||
| 38 | Parametername | ||
| 39 | {http://parkausweis.v2.olav.services.endpoint.ireg.web.hshsoft.de/}suche:fassung | ||
| 40 | Wert des Parameters | ||
| 41 | 2019-01-01 | ||
| 42 | |||
| 43 | Aktionsname des WebServices | ||
| 44 | suche | ||
| 45 | Parametername | ||
| 46 | {http://parkausweis.v2.olav.services.endpoint.ireg.web.hshsoft.de/}suche:test | ||
| 47 | Wert des Parameters | ||
| 48 | ? | ||
| 49 | |||
| 50 | Aktionsname des WebServices | ||
| 51 | suche | ||
| 52 | Parametername | ||
| 53 | {http://parkausweis.v2.olav.services.endpoint.ireg.web.hshsoft.de/}suche:responsewithoutrequest | ||
| 54 | Wert des Parameters | ||
| 55 | ? | ||
| 56 | |||
| 57 | Aktionsname des WebServices | ||
| 58 | suche | ||
| 59 | Parametername | ||
| 60 | {http://parkausweis.v2.olav.services.endpoint.ireg.web.hshsoft.de/}suche:produkt | ||
| 61 | Wert des Parameters | ||
| 62 | Informationsregister | ||
| 63 | |||
| 64 | Aktionsname des WebServices | ||
| 65 | suche | ||
| 66 | Parametername | ||
| 67 | {http://parkausweis.v2.olav.services.endpoint.ireg.web.hshsoft.de/}suche:produkthersteller | ||
| 68 | Wert des Parameters | ||
| 69 | HSH Soft- und Hardware Vertriebs GmbH | ||
| 70 | |||
| 71 | Aktionsname des WebServices | ||
| 72 | suche | ||
| 73 | Parametername | ||
| 74 | {http://parkausweis.v2.olav.services.endpoint.ireg.web.hshsoft.de/}suche:produktversion | ||
| 75 | Wert des Parameters | ||
| 76 | 1.10 | ||
| 77 | |||
| 78 | Aktionsname des WebServices | ||
| 79 | suche | ||
| 80 | Parametername | ||
| 81 | {http://parkausweis.v2.olav.services.endpoint.ireg.web.hshsoft.de/}suche:version | ||
| 82 | Wert des Parameters | ||
| 83 | 1.0 | ||
| 84 | ``` | ||
| 85 | |||
| 86 | ![[Webservice Header Parameter|@WebServiceHeaderParameter.jpg]] | ||
| 87 | |||
| 88 | Unter "WebService-HeaderParameter" ist der obige erwähnte X-ApiKey sowie ein Referer einzutragen. | ||
| 89 | |||
| 90 | ___ | ||
| 91 | |||
| 92 | # Konfiguration der Veröffentlichung | ||
| 93 | |||
| 94 | Beim entsprechenden Assistent muss eine WebService-Einreichung konfiguriert werden (siehe hierzu "[[Webservice Einrichten|Main.07_Einstellungen-Fachadministration.03_Module.06_Webservice.01_WebserviceEinrichten]])". | ||
| 95 | Für die Einreichung wird der WebService "HSH Parkausweis" ausgewählt. | ||
| 96 | |||
| 97 | ![[WebService Einreichung|@Einreichung.jpg]] | ||
| 98 | |||
| 99 | Damit diese Konfiguration genutzt wird, müssen über Formularkonfiguration weitere Veröffentlichungskonfigurationen definiert werden (siehe hierzu "[[Webservice Einrichten|Main.05_Assistenten.02_VeröffentlichungvonAssistenten]])". | ||
| 100 | |||
| 101 | Das Formular muss per "Senden per E-Mail/Webservice" versendet werden. | ||
| 102 | |||
| 103 | ![[Auswahl Sendeart|@PHP12.jpg]] | ||
| 104 | |||
| 105 | |||
| 106 | Auf der nachfolgenden Seite muss die Option "Senden mit Webservice" ausgewählt und die entsprechende WebService-Url (siehe oben) hinterlegt werden. | ||
| 107 | |||
| 108 | ![[Hinterlegung Webservice URL|@PHP34.jpg]] | ||
| 109 | |||
| 110 | Nach Bestätigen der Seite ist die Konfiguration abgeschlossen. |