Keine Bearbeitungszusammenfassung |
|||
| Zeile 79: | Zeile 79: | ||
===Ergebnis=== | ===Ergebnis=== | ||
{{AlexBild|Ergebnis über URL-Aufruf|[[Datei:Webservice - Automatischer Konto-Report-Export Ergebnis.png]]|}} | {{AlexBild|Ergebnis über URL-Aufruf|[[Datei:Webservice - Automatischer Konto-Report-Export Ergebnis.png]]|}} | ||
== Datenbank für Beispiel == | |||
[https://drive.google.com/file/d/1ecJWbBlqR2UjVAKcJwtPmmfIHpcILfaL/view?usp=share_link DokuDB] | |||
==Fußnoten== | ==Fußnoten== | ||
Version vom 3. Mai 2023, 17:48 Uhr
Das Wt-Webservice - Automatischer Konto-Report-Export ist eine Programmfunktion, die es ermöglicht, Dateien, welche durch einen automatischen Konto-Report-Export erzeugt wurden, abzurufen.
Diese Dateien können durch Fremdsysteme weiterverarbeitet werden.
Ausgangssituation
Voraussetzungen
Neben den Voraussetzungen für den Betrieb eines Wt-Webservices muss ein Automatischer-Konto-Report-Export konfiguriert sein.
Das Webservice stellt für jede exportierte Datei einen Zugriffspfad zur Verfügung.
Formatierung der Anfrage
Die Daten werden dem Webservice als GET-Argumentübertragung übergeben.
Schema für URL-Kodierung
| Parameter | Wertebereich | Beschreibung |
|---|---|---|
<Dateiname> |
Zeichenkette | Bezeichnung des Konto-Reports |
<Dateiendung> |
Zeichenkette | Laut Exporteinstellungen |
<WebApiServerKey> |
Zeichenkette | Sicherer Aufruf |
Die URL ohne WebAPIkey muss folgendes Format aufweisen:
/<Dateiname>.<Dateiendung>
Die URL mit WebAPIkey muss folgendes Format aufweisen:
/<Dateiname>.<Dateiendung>?WebApiServerKey=<1234-1234-1234-1234-1234>
Formatierung der Ausgabe
Eine Datei im Format der hinterlegten Konto-Report Exporteinstellungen.
Beispiel
Anforderung
Der Automatische Konto-Report-Export muss
- folgende Parameter und Zeitkonten aktuell (täglich aktualisiert)
- Zuname
- Vorname
- Personalnummer
- Zeitausgleichskonsum
- DRZ-Bilanz Vorschau gesamt
- verschlüsselt
- im JSON-Format
- über eine URL zur Verfügung stellen
Umsetzung
| Arbeitsschritte | Beispielhafte Einstellung der Parameter |
|---|---|
| Voraussetzungen für Webservice Automatischer Konto-Report-Export erfüllen | Siehe Wt-Webservices |
| Konto-Report mit den gewünschten Zeitkonten anlegen | 
|
| Format definieren | |
| Automatischen Konto-Report-Export anlegen | 
|
| Alex®Dienst neu starten | Damit der Einsprungspunkt für den Konto-Report erzeugt wird, muss der Dienst neu gestartet werden. |
| URL laut Kodierung im Browser eingeben und Ergebnis prüfen | http://localhost:8080/AKRE.json?WebApiServerKey=c371305d-4954-4113-8a3e-c6f5ed796c7a |
Ergebnis
| Ergebnis über URL-Aufruf |
|
Diskussionen