Dienstplan als PDF im Browser

Das WebUI-Webservice - Dienstplan PDF ist eine Programmfunktion zur Abfrage des Dienstplans pro Personal oder Planungseinheit und Datum im Dateiformat PDF.

Ausgangssituation

1. Alle Voraussetzungen werden erfüllt
   • Dienstplan lässt sich über die URL in PDF Format abrufen
2. Nichterfüllen des minimalen Status für Webservice-Ausdruck von Dienstplan
   • Es erscheint die Fehlermeldung "Dienstplan mit Status >Planung< noch nicht verfügbar."

Voraussetzungen

• Es müssen die Voraussetzungen für den Betrieb des WebUI-Webservice erfüllt sein sein.
• Es muss ein Benutzer mit den gewünschten Druckeinstellungen konfiguriert werden.
  • Systemeinstellungen: Druck-Einstellungen: Benutzer für Webservice Ausdruck von Monatsplan
• Der Benutzer muss mindestens die Rechte Dienstplan lesen besitzen.

Ausdruck Benutzer

• Es kann ein minimaler Status für Webservice-Ausdruck von Dienstplan ausgewählt werden. Danach werden nur Pläne ab diesem Status angezeigt.
  • Systemeinstellungen: Druck-Einstellungen: minimaler für Webservice-Ausdruck von Dienstplan

Formatierung der Anfrage

Die Daten werden dem Webservice in der URL kodiert als GET-Argumentübertragung übergeben.

Ein Datum wird immer als DD.MM.YYYY übertragen.

Schema für URL-Kodierung

Der Prozent-Encodierte Query-String der URL muss folgendes Format haben. Parameter in eckigen Klammern sind optional:

/AlexPrintPlanPeriod
[?planCode=]
[&employeeId=]
[&date=]

Parameter	Wertebereich	Beschreibung
planCode	Zeichenkette	Kurzzeichen einer Planungseinheit
employeeId	Datum	Eine Personalnummer, die Planungseinheit ergibt sich aus der Stammzuteilung
date	Datum	Datum des Monats des gewünschten Stundennachweises, wenn nicht angegeben Heute

Beispiel:

• http://192.168.0.100:8080/AlexPrintPlanPeriod?date=10.06.2023&employeeId=123

Formatierung der Ausgabe

Bei einer erfolgreichen Anfrage gibt das Webservice eine Datei im PDF-Format zurück

Bei einem Fehler wird ein JSON-String nach folgendem Schema zurückgegeben:

{
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "title": "New/Set-Result",
   "description": "Format für Fehlerausgabe des Webservice",
   "type": "object",
   "properties": {
       "request": {
           "type": "string",
           "description": "Angeforderter Request als 'Handshake'"
       },
       "status": {
           "type": "string",
           "description": "'error'"
       },
       "details": {
           "type": "string",
           "description": "Optionale Detailinformationen des Fehlers"
       }
   },
   "required": [
       "request",
       "status"
   ]
}

Falls der Status des Dienstplans nicht erfüllt ist, wird folgende Fehlermeldung zurückgegeben:

{
   "request": "/AlexPrintPlanPerioddate=<date>&employeeId=<id>",
   "status": "error",
   "details": "Dienstplan mit Status >Planung< noch nicht verfügbar."
}