Wiki-Quellcode von Webservicenutzung
Zuletzt geändert von Form-Solutions GmbH am 15.02.2024
Zeige letzte Bearbeiter
| author | version | line-number | content |
|---|---|---|---|
| 1 | ## Webservice-Anfrage während einer Einreichung | ||
| 2 | |||
| 3 | Um beim Einreichen/Übergeben eines Assistenten einen Webservice anzusprechen, muss in der „[[Veröffentlichung|Main.05_Assistenten.02_VeröffentlichungvonAssistenten]]“ des Assistenten der Webservicedienst ausgewählt werden. Über Schaltfläche „Konfigurieren“ bei der Auswahl „Webservice-Anfrage“ gelangt man in die Übersichtsliste der Webservice-Dienste. Hier kann mittels der Schaltfläche „Hinzufügen“ die Eingabemaske geöffnet werden. Folgende Werte müssen hinterlegt werden: | ||
| 4 | |||
| 5 | * **Name des Webservice** | ||
| 6 | Hier muss der entsprechende Webservice ausgewählt werden. | ||
| 7 | * **Version des Webservice** | ||
| 8 | Hier muss die entsprechende Version des Webservices ausgewählt werden. | ||
| 9 | * **Webservice-Dienst** | ||
| 10 | Hier muss der entsprechende Webservicedienst ausgewählt werden. | ||
| 11 | * **Schlüsselwort** | ||
| 12 | Wenn das hinterlegte Schlüsselwort im Assistenten in einem Feld mit der technischen Bezeichnung "submission_webservice_execution_key" gefunden wurde, wird dieser Webservice bei der Einreichung angesprochen. Sind mehrere gleiche Schlüsselwörter definiert, findet keine Webservice-Einreichung statt. Ist kein Schlüsselwort definiert und mehrere Webservices konfiguriert, findet ebenfalls keine Einreichung statt. Ist nur ein Webservice ohne Schlüsselwort definiert, findet standardmäßig immer eine Einreichung statt. | ||
| 13 | * **Webservice-Nachricht und Antwort** | ||
| 14 | Hier muss nach der Hinterlegung des Webservices das [[Mapping|Main.05_Assistenten.04_Assistentenbauoberfläche.06_Mapping]] vorgenommen werden. | ||
| 15 | * **WebService ResponseCode** | ||
| 16 | Hier kann der nach einem Erfolgsfall gesendete Antwortcode (ResponseCode) des Webservices angegeben werden. | ||
| 17 | |||
| 18 | > {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_ | ||
| 19 | > | ||
| 20 | > Es können bis zu zehn Webservice-Dienste hinterlegt werden jedoch wird nur immer ein Webservice angesprochen. | ||
| 21 | |||
| 22 | ![[Webservice-Anfrage während einer Einreichung|@WebserviceNutzungVeröffentlichung.jpg]] | ||
| 23 | |||
| 24 | Zusätzlich muss auf der ersten Seite unter dem Formularkonfigurations-Assistenten in der Veröffentlichung der Haken bei „Senden per E-Mail/Webservice“ ausgewählt werden. Weiterhin muss auf der zweiten Seite der Haken bei „Senden mit Webservice“ sowie die entsprechende Webservice-URL unter „URL“ hinterlegt werden. | ||
| 25 | |||
| 26 | ![[Webservice Einstellung in der Veröffentlichung|@WebserviceKonfiAS.jpg]] | ||
| 27 | |||
| 28 | ## Webservice-Anfrage während dem Ausfüllprozess | ||
| 29 | |||
| 30 | Mit der Hilfe einer „[[Webservice-Komponente|Main.05_Assistenten.04_Assistentenbauoberfläche.03_Bibliothek]]“ kann während dem Ausfüllprozess eine Webservice-Anfrage stattfinden. Beispielsweise wird bei der Eingabe eines Kennzeichens geprüft, ob das Kennzeichen und die Zulassungsbehörde zulässig sind. Hierzu muss eine „Webservice-Komponente“ in das Panel eingefügt und konfiguriert werden. In der „Komponenten Konfiguration“ muss man hierzu den „Namen des Webservice“, die „Version des Webservice“ und den „Webservice-Dienst“ auswählen. Nach der Auswahl des Webservice-Dienstes kann über die Schaltfläche „Webservice-Nachricht“ und „Webservice-Antwort“ siehe auch [[Mapping Webservice|Main.05_Assistenten.04_Assistentenbauoberfläche.06_Mapping]]) jeweils die Formularinhaltsdaten gemappt werden. Eine Webservice-Komponente muss immer nach dem Einfügen in einen Assistenten konfiguriert werden, da ansonsten das Speichern des Assistenten nicht möglich ist. | ||
| 31 | |||
| 32 | > {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_ | ||
| 33 | > | ||
| 34 | > Die Schaltflächen um die Formularinhaltsdaten zu mappen sind erst nutzbar, wenn zuvor der Webservice-Dienst ausgewählt und über die Schaltfläche „Übernehmen“ die Konfiguration gespeichert wurde. | ||
| 35 | |||
| 36 | ![[Webservice-Anfrage während dem Ausfüllprozess|@WebserviceKomponente.jpg]] | ||
| 37 | |||
| 38 | ## Verfügbarkeitsprüfung eines Webservice | ||
| 39 | |||
| 40 | Zu Beginn eines Assistenten werden zusätzlich die hinterlegten Webservices auf ihre Erreichbarkeit geprüft. Hierzu wird vor dem eigentlichen Ausfüllprozess eine Seite dem Bürger angezeigt. Hier wird aufgeführt, ob alle Webservices momentan erreichbar sind. Sofern ein hinterlegter Webservice nicht erreichbar ist, kann der Bürger den Ausfüllprozess nicht beginnen. | ||
| 41 | |||
| 42 | [Details zur Webservice Erreichbarkeitsprüfung](https://wiki.form-solutions.de/wiki/admindoku/view/Main/04_Anbindungen/Webservice%20Erreichbarkeitspr%C3%BCfung/) | ||
| 43 | |||
| 44 | ![[Verfügbarkeitsprüfung|@WebserviceNutzungÜberprüfung.jpg]] |