Dienstplan als PDF im Browser: Unterschied zwischen den Versionen

Zeile 2: Zeile 2:


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


=== Voraussetzungen ===
=== Voraussetzungen ===

Version vom 17. Juli 2023, 15:15 Uhr

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

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 minimaler Status für Webservice-Ausdruck von Dienstplan[2] ausgewählt werden. Weitere Informationen zur Statustreppe finden Sie hier.
    • Bei Nichterfüllen des minimalen Status wird eine Fehlermeldung in folgendem Format angezeigt:
{ "request" : "/AlexPrintPlanPerioddate=10.07.2023&employeeId=1111", "status" : "error", "details" : "Dienstplan mit Status >Planung< noch nicht verfĆ¼gbar." }
  • 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
Dienstplan PDF.PNG

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

Fußnoten