Job Execute and Store Reports

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.