Job Execute and Store Reports

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 abgelegt. Der Report wird ueber eine Webdesk Aktion per HTTP erzeugt.

Zweck und Ablauf

  • Personen aus der Auswahl ermitteln (optional nur aktive Personen).
  • Schleifentyp bestimmt die Objekte, fuer die Reports erzeugt werden.
  • Optionales Filter und JavaScript-Filter schraenken die Objekte ein.
  • Report-URL wird mit Parametern erstellt: format, showResult=true, showAll=true plus Jobparameter.
  • Reports werden parallel in Threads erzeugt und gespeichert.

Konfiguration

Allgemein

  • Vorschau: Es werden keine Reports erzeugt. Es werden nur URL und Dateiname geloggt.
  • Anzahl gleichzeitiger Threads: Wenn leer, wird ein sinnvoller Default aus der CPU-Anzahl verwendet.
  • Webdesk URL: Basis-URL der Installation. Wenn ohne Protokoll, wird http:// davor gesetzt.
  • Login als Sysadmin: Fuehrt alle Aufrufe im Kontext des Sysadmins aus. Vorsicht.

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 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: 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

Logs pruefen (mindestens INFO). Bei User-Kontext muss die Person Zugriff auf die 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 zulassen.

Kommentare (0)