Webservice - Automatischer Konto-Report-Export

Das 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 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

Die URL muss folgendes Format aufweisen:

/<Dateiname>.<Dateiendung>

Formatierung der Ausgabe

Eine Datei im Format der hinterlegten Konto-Report Exporteinstellungen.

Der Ordner in dem die Datei abgelegt wird kann in den Exporteinstellungen hinterlegt werden.

Falls kein Ordner hinterlegt wird, wird der Ordner "AutomaticAccountsReportExport" im Ordner des ALEX-Config-Files verwendet.

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

Die Voraussetzungen für den Betrieb müssen erfüllt sein.

Arbeitsschritte	Beispielhafte Einstellung der Parameter
Konto-Report mit den gewünschten Zeitkonten anlegen
Format definieren
Automatischen Konto-Report-Export anlegen und am System hinterlegen.
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	Beispiele für den Aufruf: Report -> http://localhost:8080/AKRE.json Schema -> http://localhost:8080/AKRE.json_schema

Ergebnis

2 Dateien im JSON Format. Näheres hier zu möglichen Formaten hier: Konto-Report-Export

 AKRE.json
{"Zuname":"DIRTL","Vorname":"Daniela","Stichtag":"01.05.2023","PersonalNr":"312","DRZ V g.":6E0,"ZAg Dauer":0E0}
{"Zuname":"EDELBACHER","Vorname":"Jakob","Stichtag":"01.05.2023","PersonalNr":"382","DRZ V g.":-4E-1,"ZAg Dauer":0E0}
{"Zuname":"EIGNER","Vorname":"Annemarie","Stichtag":"01.05.2023","PersonalNr":"161","DRZ V g.":-2.97E0,"ZAg Dauer":0E0}
{"Zuname":"HEROLD","Vorname":"Petra","Stichtag":"01.05.2023","PersonalNr":"415","DRZ V g.":-2E-2,"ZAg Dauer":0E0}
{"Zuname":"LEITNER","Vorname":"Nadine","Stichtag":"01.05.2023","PersonalNr":"280","DRZ V g.":5.62E0,"ZAg Dauer":0E0}
{"Zuname":"MELCHUS","Vorname":"Gerald","Stichtag":"01.05.2023","PersonalNr":"320","DRZ V g.":-8.3E-1,"ZAg Dauer":0E0}

 AKRE.json_schema
{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"Konto-Report","description":"AKRE","type":"object","properties":{"Zuname":{"type":"string"},"Vorname":{"type":"string"},"Stichtag":{"type":"string"},"PersonalNr":{"type":"string"},"DRZ V g.":{"type":"number"},"ZAg Dauer":{"type":"number"}},"required":["Zuname","Vorname","Stichtag","PersonalNr","DRZ V g.","ZAg Dauer"]}

Datenbank für Beispiel

AutomatischerKontoReportExportDB

Fußnoten

• Issue 8011