Vergleichsreport

Dieser Job 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 abgelegtFür jede ausgewählte Person werden – abhängig von der Berichtsaufteilung – ein oder mehrere Berichte erzeugt. Der Report wird ueber über eine Webdesk-Aktion per HTTP erzeugterstellt.

Zweck und Ablauf

• Die Personen werden aus der konfigurierten Auswahl ermitteln (ermittelt, optional nur aktive Personen).
• Schleifentyp bestimmt die Objekte, fuer die Reports erzeugt werden.
• Optionales Filter und Die Berichtsaufteilung bestimmt, für welche Objekte ein Report erstellt wird.
• Ein optionaler Filter und ein JavaScript-Filter schraenken können die Objekte einweiter einschränken.
• Die Report-URL wird mit Parametern erstellt: format, showResult=true, showAll=true plus Jobparameter. und den konfigurierten Aktionsparametern aufgebaut.
• Die Reports werden parallel in Threads erzeugt und im gewählten Ziel gespeichert.

Konfiguration

Allgemein

Mehrere TA-Beschäftigungen ab Webdesk 4.64

Für das monatliche Journal (ta_getJournal oder eine davon abgeleitete Aktion) gibt es zwei neue Berichtsaufteilungen. Sie sind für Personen mit mehreren TA-Beschäftigungen vorgesehen. Die Standardauswahl Ein Bericht pro Person bleibt unverändert und exportiert weiterhin nur den für die Person wirksamen TA-Kontext.

Ein Bericht pro TA-Beschäftigung

• Im Feld Berichtsaufteilung wird Ein Bericht pro TA-Beschäftigung ausgewählt. Der technische Wert lautet ta_employments.
• Für jede zugeordnete, nicht geplante TA-Beschäftigung wird ein eigener Report erstellt. Dadurch können auch sekundäre und bereits beendete Beschäftigungen archiviert werden, sofern sie in Webdesk zugeordnet sind.
• Der Report verwendet den Standardmonat der ausgewählten Journal-Aktion. Die Felder Report von und Report bis sind für diese Variante nicht relevant.

Ein Bericht pro TA-Beschäftigung und Kalendermonat

• Im Feld Berichtsaufteilung wird Ein Bericht pro TA-Beschäftigung und Kalendermonat ausgewählt. Der technische Wert lautet ta_employmentCalendarMonths.
• Für jeden Kalendermonat jeder zugeordneten, nicht geplanten TA-Beschäftigung wird ein eigener Report erstellt.
• Mit Report von und Report bis werden die zu exportierenden Monate ausgewählt. Diese Werte werden nicht als ein zusammenhängender Zeitraum an das Journal übergeben.
• Der erste und letzte Monat werden an den tatsächlichen Beschäftigungszeitraum und den gewählten Berichtszeitraum angepasst. Zukünftige Tage werden nicht exportiert.

Welche Variante soll verwendet werden?

• Für eine jährliche oder vollständige Archivierung je Beschäftigung: Ein Bericht pro TA-Beschäftigung.
• Für eine monatliche Ablage, etwa einen PDF-Bericht je Beschäftigung und Monat: Ein Bericht pro TA-Beschäftigung und Kalendermonat.
• Pro Job wird genau eine Berichtsaufteilung verwendet. Die beiden Beschäftigungsvarianten werden nicht miteinander kombiniert.

Konfiguration der Beschäftigungsvarianten

1. Als Aktion das monatliche Journal oder eine darauf basierende Aktion auswählen.
2. Unter Berichtsaufteilung eine der beiden Beschäftigungsvarianten auswählen.
3. Die automatisch vorgeschlagenen Journalparameter übernehmen. Die erforderlichen Zuordnungen für Person und Beschäftigung werden beim Wechsel der Berichtsaufteilung automatisch ergänzt.
4. Nur wenn zusätzliche Aktionsparameter benötigt werden, die erweiterten Parameterzuordnungen öffnen.
5. Vor dem produktiven Lauf eine Vorschau mit einer Person testen, die mindestens zwei TA-Beschäftigungen besitzt. Dabei sowohl die Anzahl der Dateien als auch den Inhalt der Dateien prüfen.

Für die Beschäftigungsvarianten werden insbesondere folgende Werte benötigt:

• uid: person.UID
• taId: object.taID
• Bei der Monatsvariante zusätzlich die Datumsparameter für from und to, abgeleitet aus object.from und object.to.

Die JavaScript-Vorschläge werden abhängig vom Namen, Typ und Datumsformat der Aktionsparameter automatisch erzeugt. Manuelle Änderungen an diesen Zuordnungen können dazu führen, dass mehrere Reports dieselbe Beschäftigung exportieren oder die Konfiguration als ungültig erkannt wird.

Dateipfad und Dateiname

Der Standard-Dateiname enthält die zur Unterscheidung erforderlichen Werte:

• Bei Ein Bericht pro TA-Beschäftigung die TA-ID über $object.taID.
• Bei Ein Bericht pro TA-Beschäftigung und Kalendermonat zusätzlich die Monatsgrenzen über $object.from und $object.to.

Der Standard-Dateiname sollte verwendet werden. Bei einer eigenen Velocity-Vorlage müssen mindestens $object.taID und bei der Monatsvariante zusätzlich $object.from und $object.to enthalten sein. So werden Reports verschiedener Beschäftigungen oder Monate nicht überschrieben oder übersprungen.

Für Dateipfad, Metastruktur-Script und JavaScript-Filter stehen unter anderem person, object, action und appCtx zur Verfügung. Das jeweilige object ist bei den Beschäftigungsvarianten entweder eine TA-Beschäftigung oder ein auf diese Beschäftigung begrenztes Monatsintervall.

Allgemeine Einstellungen

• Vorschau: Es werden keine Reports erzeugt. Es werden nur URL und Dateiname geloggtwerden nur protokolliert.
• Anzahl gleichzeitiger Threads: Wenn leer, wird ein sinnvoller Default Standardwert aus der CPU- Anzahl der CPUs verwendet.
• Webdesk-URL: Basis-URL der Installation. Wenn ohne Fehlt das Protokoll, wird http:// davor gesetzt ergänzt.
• Login als Sysadmin: Fuehrt alle Alle Aufrufe werden im Kontext des Sysadmins aus. Vorsichtausgeführt. Diese Option nur bewusst verwenden.
• 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 Überschreibe 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: Vorhandene Dateien werden ersetzt, wenn diese Option aktiviert ist.
• 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

• Anhänge des Schleifenobjekts werden exportiert, sofern der jeweilige Provider dies unterstützt.

Fehleranalyse

Keine oder zu wenige Reports

Prüfen, ob die TA-Beschäftigungen in Webdesk zugeordnet sind. Geplante Beschäftigungen werden nicht berücksichtigt. Bei der Monatsvariante außerdem den Berichtszeitraum und die Beschäftigungsgrenzen prüfen.

Report enthält die falsche Beschäftigung

Die Aktionsparameter uid und taId sowie bei der Monatsvariante from und to müssen die automatisch vorgeschlagenen Scripts verwenden. Die TA-ID im Report muss mit der TA-ID im Dateinamen übereinstimmen.

Dateien werden überschrieben oder übersprungen

Den Standard-Dateinamen wiederherstellen oder die erforderlichen Beschäftigungs- und Monatswerte in die eigene Velocity-Vorlage aufnehmen. Zusätzlich die Option Überschreibe bestehende Dateien prüfen.

Export schlägt technisch fehl

Die Logs mindestens auf INFO prüfen. Im Benutzerkontext muss die Person Zugriff auf die verwendete 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 in po - SeleniumOptions - pathToGeckDriver gesetzt sein, und Firefox muss installiert sein. Die Aktionskonfiguration muss den PDF-Export zulassenbesitzen. Für browserbasierte Exporte müssen Firefox und der konfigurierte Selenium-Treiber verfügbar sein.

Die Beschäftigungs-Berichtsaufteilungen werden nach demselben Prinzip auch vom Job executeAndSendReports für Mail-Anhänge verwendet.