Vergleichsreport

Zweck und Ablauf

• Die Personen werden aus der konfigurierten Auswahl ermittelt, optional nur aktive Personen.
• Die Berichtsaufteilung bestimmt, für welche Objekte ein Report erstellt wird.
• Ein optionaler Filter und ein JavaScript-Filter können die Objekte weiter einschränken.
• Die Report-URL wird mit format, showResult=true, showAll=true und den konfigurierten Aktionsparametern aufgebaut.
• Die Reports werden parallel erzeugt und im gewählten Ziel gespeichert.

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. URL und Dateiname werden nur protokolliert.
• Anzahl gleichzeitiger Threads: Wenn leer, wird ein sinnvoller Standardwert aus der Anzahl der CPUs verwendet.
• Webdesk-URL: Basis-URL der Installation. Fehlt das Protokoll, wird http:// ergänzt.
• Login als Sysadmin: Alle Aufrufe werden im Kontext des Sysadmins ausgeführt. Diese Option nur bewusst verwenden.
• Speicherziel: Lokales Verzeichnis, Repository oder Metastruktur.
• Überschreibe bestehende Dateien: Vorhandene Dateien werden ersetzt, wenn diese Option aktiviert ist.
• Format: PRINT, PDF oder XLS.
• Export Attachments: 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 besitzen. 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.

Zweck

Der Job ruft eine Webdesk-Reportaktion im Kontext jeder ausgewählten Person auf und speichert die Ergebnisse als PDF, Print-HTML oder XLS. Als Ziel können Repository, Metastruktur oder SFTP konfiguriert werden. Der Job versendet keine E-Mails.

Personenauswahl

Verarbeitet werden Personen aus Personen-, Gruppen- und Mandanteneinschränkungen; der dem Job zugeordnete Mandant wirkt als zusätzliche harte Einschränkung. Mit Nur aktive Personen können inaktive Benutzer ausgeschlossen werden.

Schleifentypen

• Ohne Schleifentyp bzw. once: genau ein Report je Person.
• months: ein Reportobjekt je relevantem Kalendermonat.
• processInstances: ein Reportobjekt je passender Workflow-Prozessinstanz, sofern aktiv.
• ta_bookingMonths: ein Reportobjekt je Buchungsmonat der TA-Person.
• ta_employments: ein Reportobjekt je aktuell berücksichtigter, gemappter und nicht geplanter TA-Beschäftigung; die technische Kennung steht unter object.taID.
• ta_employmentCalendarMonths: ein abgegrenztes Reportobjekt je TA-Beschäftigung und Kalendermonat, höchstens bis zum Vortag und unter Berücksichtigung der Beschäftigungs- und Berichtsgrenzen; zusätzlich stehen object.from und object.to zur Verfügung.

Wichtige Konfiguration

• Webdesk-URL, Aktion, Format und optional Ausrichtung.
• Ziel: Repository, Metastruktur oder SFTP.
• Dateiname/Pfad als Velocity-Ausdruck: Der Kontext enthält person, object, action und simpleDateFormat. Bei Beschäftigungs- oder Monats-Schleifen müssen Beschäftigungs- und Datumsbestandteile im Dateinamen enthalten sein, damit Dateien nicht überschrieben werden.
• Überschreiben vorhandener Dateien, Anhänge exportieren, PDF validieren, Vorschau und Threadanzahl.
• Berichtszeitraum: Von-/Bis-Datum können als TA-Datum oder JavaScript-Ausdruck ermittelt werden.
• Filter und optionaler JavaScript-Filter: Der Filter läuft je Schleifenobjekt; kein Boolean bedeutet Verarbeitung.
• Zusätzliche Aktionsparameter: Werte können aus dem aktuellen JavaScript-Kontext berechnet werden.

Mehrere TA-Beschäftigungen

ta_employments und ta_employmentCalendarMonths verarbeiten Beschäftigungen getrennt, wodurch mehrere Dateien je Person entstehen. Verwenden Sie mindestens $object.taID, bei Monatsintervallen zusätzlich $object.from und/oder $object.to. Prüfen Sie, ob die Reportaktion die Parameter uid, taId, from und to erwartet.

Fehler und Unterbrechung

Fehler bei einer Person werden protokolliert und die nächste Person verarbeitet. Eine Unterbrechung stoppt die weitere Verarbeitung.