Vergleichsreport

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

Purpose

The job calls a Webdesk report action in the context of each selected person and stores the results as PDF, print HTML or XLS. The target can be configured as repository, meta structure or SFTP. The job does not send any e-mails.

Person selection

Persons from person, group and client restrictions are processed; the client assigned to the job acts as an additional hard restriction. With Active persons only, inactive users can be excluded.

Loop types

• Without a loop type or once: exactly one report per person.
• months: one report object per relevant calendar month.
• processInstances: one report object per matching workflow process instance, if active.
• ta_bookingMonths: one report object per booking month of the TA person.
• ta_employments: one report object per currently considered, mapped and non-planned TA employment; the technical identifier is found under 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 one delimited report object per TA employment and calendar month, at most up to the previous day and taking the employment and reporting limits into account; additionally object.from and object.to are available.

Important configuration

• Webdesk URL, Action, Format and optionally Orientation.
• Target: repository, meta structure or SFTP.
• File name/path as Velocity expression: The context contains 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

• and simpleDateFormat. For employment or month loops, employment and date components must be included in the file name so that files are not overwritten.
• Overwrite existing files, Export attachments, Validate PDF, Preview and Number of threads.
• Reporting period: From/To dates can be determined as a TA date or JavaScript expression.
• Filter and optional JavaScript filter: The filter runs per loop object; if no Boolean is returned, the object is processed.
• Additional action parameters: Values can be calculated from the current JavaScript context.

Multiple TA employments

ta_employments and ta_employmentCalendarMonths process employments separately, resulting in several files per person. Use at least $object.taID, and for monthly intervals additionally $object.from and/or $object.to. Check whether the report action expects the parameters uid, taId, from and to.

Errors and interruption

Errors for one person are logged and the next person is processed. An interruption stops further processing.