Vergleichsreport

Zweck

Der Job ruft eine Webdesk-Reportaktion im Kontext jeder ausgewählten Person auf und versendet die Ergebnisse als Anhänge einer E-Mail an diese Person. Unterstützt werden PDF, Print-HTML und XLS.

Personenauswahl und Konfiguration

• Personen werden aus Personen-, Gruppen- und Mandanteneinschränkungen aufgelöst; der dem Job zugeordnete Mandant wirkt als harte Einschränkung.
• Webdesk - URL, Aktion, Format, Mail Betreff, Inhalt Mail Text, Datumsformat und zusätzliche URL-Parameter werden aus der Konfiguration gelesen.
• Betreff und Inhalt unterstützen $date; der Mailinhalt zusätzlich $person. $date wird im Standard-Datumsformat des Servers ausgegeben; das Datumsformat wirkt nur auf Datums-URL-Parameter.
• Der Dateiname der Anlage (Dateiname der Mail-Anlage) kann als Velocity-Ausdruck mit person, object und action konfiguriert werden; die Dateiendung wird formatabhängig ergänzt. Bleibt das Feld leer, wird der Aktionsname bzw. der Standarddateiname des gewählten Schleifentyps verwendet.

Schleifentypen

Der Schleifentyp wird im Feld Berichtsaufteilung gewählt.

• Ohne Schleifentyp: genau ein Report je Person.
• Ein Schleifentyp kann mehrere Objekte je Person liefern; je Objekt entsteht ein eigener Anhang.
• ta_bookingMonths verarbeitet Buchungsmonate.
• ta_employments verarbeitet jede aktuell berücksichtigte TA-Beschäftigung getrennt; object.taID ist die technische Beschäftigungskennung.
• ta_employmentCalendarMonths verarbeitet jede TA-Beschäftigung und jeden abgegrenzten Kalendermonat getrennt; zusätzlich stehen object.from und object.to zur Verfügung.

Mehrere TA-Beschäftigungen

Bei mehreren berücksichtigten TA-Beschäftigungen wird je Beschäftigung ein eigener Report erzeugt. Bei ta_employmentCalendarMonths entstehen je Beschäftigung und Monat eigene Anhänge. Alle Anhänge derselben Person werden in einer E-Mail zusammengefasst.

Verwenden Sie einen eindeutigen Dateinamen, zum Beispiel mit $object.taID und bei Monatsintervallen zusätzlich mit $object.from und/oder $object.to. Gleiche Dateinamen innerhalb einer Person lösen einen Fehler aus und verhindern den Versand dieser Person.

Reportaufruf und URL-Parameter

• Der Export läuft über eine kurzlebige Login-Token-Anmeldung im Benutzerkontext der Person.
• Die URL enthält unter anderem format, showResult=true und showAll=true.
• Zusätzliche Parameter können als Datum (heute, gestern, nächster Arbeitstag, erster Tag des Monats, letzter oder erster Tag des Vormonats), JavaScript-Ausdruck oder fixer Wert konfiguriert werden.
• Bei Beschäftigungs-Schleifen steht das aktuelle Schleifenobjekt als object zur Verfügung. Prüfen Sie die von der Reportaktion erwarteten Parameter, insbesondere uid, taId, from und to.
• Beim Speichern prüft die Konfiguration, ob die vom gewählten Schleifentyp benötigten Parameter der Reportaktion als Skript gesetzt sind (z. B. uid = person.UID, taId = object.taID, bei Kalendermonaten die Datumsparameter from/to aus object.from/object.to). Fehlende Parameter werden automatisch ergänzt, abweichend konfigurierte als Fehler markiert.

Fehler und Versand

Reports werden je Person erzeugt und gesammelt. Ist kein Anhang entstanden, wird keine Mail versendet. Ein Fehler bei einer Person wird protokolliert und die nächste Person verarbeitet. Eine Unterbrechung stoppt die Verarbeitung.