Veränderungen des Inhalts
Klicken Sie für eine detaillierte Beschreibung auf die geänderten Stellen:
Benutzen sie die linke oder die rechte Maustaste, um zur jeweils vorherigen bzw. nachfolgenden Änderung zu gelangen.
Dieser Job dient der Reporterstellung und Speicherung in einem zuvor eingestellten Ordner, um verschiedene Mitarbeiterstatistiken archivieren zu können.
Jobkonfiguration:
Vorschau: Diese Option dient der Überprüfung der JavaScripts für URL-Parameter und der Velocity Vorlage für Dateipfad und -name. Wenn gechecked, wird keine Aktion aufgerufen, kein Bericht generiert und keine Datei angelegt. Lediglich die URL, die zum Aufruf verwendet werden würde, und der Dateipfad und -name, unter dem der Bericht gespeichert werden würde, werden mit INFO Level geloggt.
Anzahl der gleichzeitigen Threads
Basisordner: hier wird der Speicherort für die Reports eingetragen
Überschreibe bestehende exportierte Reports im Basisverzeichnis
Webdesk URL: hier wird die URL angegeben unter welcher der Webdesk verfügbar ist, zumeist: http://localhost:8080/webdesk3/ Schleifentyp: hier wird ausgewählt welcher Report ausgeführt werden soll
-
Einmal
-
Monate
-
Prozessinstanzen
-
Buchungsmonate
-
Reisen
-
Fahrtenbuch
Filter: wenn als Schleifentyp Reisen ausgewählt ist kann damit nach verschiedenen Stadien der Reisen gefiltert werden Report von Datum: damit wird der Beginnzeitpunkt des Reportes festgelegt in einem Zeitrahmen von heute bis zu 1 Jahr aber auch benutzerdefiniert, in der Textbox darunter notiert das System die dafür notwendigen Pakete Report bis Datum: damit wird der Endzeitpunkt des Reportes festgelegt in einem Zeitrahmen von heute bis zu 1 Jahr aber auch benutzerdefiniert, in der Textbox darunter notiert das System die dafür notwendigen Pakete Schleifenobjekt: hier notiert das System welches Objekt vom ausgewählten Schleifentyp angesprochen wird Aktion: hier notiert das System welche Action vom ausgewählten Schleifentyp angesprochen wird, bzw kann hier auch selbst eine Aktion ausgewählt werdenLogin als Sysadmin:Wenn die Checkbox aktiviert ist werden alle Reportaufrufe im Kontext des Full System Administrators durchgeführt, auch wenn der Report logisch zu einem bestimmten User gehört. Mit Vorsicht zu verwenden!Format:hier kann zwischen print und PDF gewählt werden
Ausgabe als PDF validieren
Ausrichtung: hier kann zwischen Hoch-und Querformat gewählt werden Velocity Vorlage für Dateipfad und -name: hier werden die für den Report verwendeten Daten angezeigt
Aktionsparameter:
Name JavaScript: hier können JavaScripts ausgewählt und hinzugefügt werden
Nur aktive Personen
Personen
Gruppen
Mandanten
Troubleshooting
Export-Dateien werden nicht erstellt
Dies kann viele Ursachen haben. Zuerst sollten hier die Logausgaben des Jobs überprüft werden (Jobs sollten mindestends auf Loglevel INFO protokollieren!). Wird die Reporterzeugung im User-Kontext gestartet (Normalfall) so wird die dazugehörige Webdesk Aktion über einen HttpClient oder einen echten Browser als dieser User geöffnet. Wenn der entsprechende User keinen Zugriff auf die Aktion hat, so kommt es zu einem Fehler und die Exportdatei wird nicht erstellt.
Export-Datei wird bei Client-seitigen Aktionen nicht erstellt
In diesem Fall erfolgt der Export über einen Browser und dazu muss der Firefox Seleniumdriver am Server erzeugt Reports und speichert sie in einem konfigurierten Ziel. Pro ausgewaehlter Person werden - je nach Schleifentyp - Objekte ermittelt und fuer jedes Objekt ein Report generiert und abgelegt. Der Report wird ueber eine Webdesk Aktion per HTTP erzeugt.
Zweck und Ablauf
-
Personen aus der Auswahl ermitteln (optional nur aktive Personen).
-
Schleifentyp bestimmt die Objekte, fuer die Reports erzeugt werden.
-
Optionales Filter und JavaScript-Filter schraenken die Objekte ein.
-
Report-URL wird mit Parametern erstellt:
format, showResult=true, showAll=true plus Jobparameter.
-
Reports werden parallel in Threads erzeugt und gespeichert.
Konfiguration
Allgemein
-
Vorschau: Es werden keine Reports erzeugt. Es werden nur URL und Dateiname geloggt.
-
Anzahl gleichzeitiger Threads: Wenn leer, wird ein sinnvoller Default aus der CPU-Anzahl verwendet.
-
Webdesk URL: Basis-URL der Installation. Wenn ohne Protokoll, wird
http:// davor gesetzt.
-
Login als Sysadmin: Fuehrt alle Aufrufe im Kontext des Sysadmins aus. Vorsicht.
Speicherziel
-
Konfigurationstyp: Lokales Verzeichnis, Repository oder Metastruktur.
-
Lokales Verzeichnis: Basisordner fuer alle Reports. Ein fehlender Slash wird ergaenzt.
-
Repository: Repository und Root-Pfad des Ordners.
-
Metastruktur: Metastruktur, Root-Metafolder und ein Entity-Creation-Script, das ein PersistentObject liefert.
-
Ueberschreibe bestehende Dateien: Falls aktiv, werden vorhandene Dateien ersetzt.
Schleifentyp und Objekte
-
Schleifentyp: Definiert Quelle und Objekte (z.B. Einmal, Monate, Prozessinstanzen, Buchungsmonate, Reisen, Fahrtenbuch).
-
Schleifenobjekt: Wird im UI angezeigt und beschreibt das Objekt der Quelle.
-
Filter: Statischer Filterwert (z.B. Reise-Status).
-
JavaScript-Filter: Muss
true oder false liefern. Bei anderen Rueckgabewerten wird das Objekt verarbeitet.
Zeitraum
-
Report von / bis Datum: Auswahl ueber Selector oder Script.
-
Selector-Werte koennen z.B.
recordingStartDate oder resignationDate sein.
Aktion und Format
-
Aktion: Webdesk Aktion fuer den Report. Kann automatisch gesetzt oder manuell gewaehlt werden.
-
Format:
PRINT, PDF oder XLS (Grossschreibung).
-
Ausrichtung: Hoch- oder Querformat fuer PDF-Generierung.
-
Ausgabe als PDF validieren: Optional mit Prueftext.
-
Export Attachments: Exportiert Anhaenge des Objekts (falls vom Provider unterstuetzt).
Dateiname und Parameter
-
Velocity Vorlage fuer Dateipfad und -name: Wird mit Kontext erstellt. Kontext enthaelt
appCtx, action, person, object, simpleDateFormat.
-
Bei
PRINT und PDF wird .pdf angehaengt, bei XLS .xls.
-
Aktionsparameter: Reine Anzeige der von der Aktion unterstuetzten URL-Parameter.
-
Jobparameter: Name plus JavaScript, das den Wert fuer den URL-Parameter liefert.
Troubleshooting
Export-Dateien werden nicht erstellt
Logs pruefen (mindestens INFO). Bei User-Kontext muss die Person Zugriff auf die Aktion haben. Fehlender Zugriff fuehrt zu Exportfehlern.
Client-seitige Aktionen
Wenn der Export ueber einen Browser erfolgt, muss der Firefox Seleniumdriver installiert sein. Der Pfad zum geckodriver muss im Systemparameter in po - SeleniumOptions - pathToGeckDriver angegeben sein. Des weiteren muss auf dem Server auch ein Firefox Browser gesetzt sein, und Firefox muss installiert sein. Des weiteren muss die betreffende Webdesk Aktionskonfiguration auch den Export zulassen, da der Export am Browser via Javascript den Button "PDF" benötigtDie Aktionskonfiguration muss den PDF-Export zulassen.