Zuletzt bearbeitet vor einem Monat
von Daniel Quathamer

Modul Berichtsassistent Konfigurationshandbuch

Installation

Voraussetzungen

  • Sie benötigen
    • in SuperX das Kernmodul 4.8 oder höher
    • als Liefersystem HIS-SVA, MACH oder SAP-HR

Vorgehen bei Neuinstallation - kurz und knapp

  • Laden Sie das Modul sva*.tgz herunter und speichern Sie es in $SUPERX_DIR (bei SuperX) bzw. im webapps-Ordner bei HISinOne-BI
  • Achten Sie dabei darauf, daß Sie die richtige Version laden (Zeichencodierung ISO oder UTF-8, Datenbanksystem Postgres oder Informix)
  • Entpacken Sie das Modul mit
 tar -xzvf Dateiname

Fügen Sie dann den Pfad Ihrer SQL_ENV hinzu: cat $SUPERX_DIR/db/bin/SQL_ENV_sva.sam >> $SUPERX_DIR/db/bin/SQL_ENV Danach laden Sie die SQL_ENV neu und führen aus:

cd $SVA_PFAD
module_install sva .

Danach konfiguieren Sie die Entladeroutine aus dem Vorsystem.

Danach bitte Tomcat neu starten, und dann ist das Modul einsatzbereit.


Vorgehen beim Upgrade

Wenn Sie die Komponente bereits installiert haben, müssen Sie wie folgt vorgehen:

  • Laden Sie das Paket herunter und speichern Sie es
    • für SuperX-Installationen im Verzeichnis $SUPERX_DIR
    • für HISinOne-BI installationen im Verzeichnis .../webapps/superx
  • und entpacken Sie die jew. Datei
  • Führen Sie den Patch in der Shell im Verzeichnis $SUPERX_DIR/db/module/sva/upgrade mit
sva_upgrade.x

aus.

Danach bitte Tomcat neu starten, und dann ist das Modul einsatzbereit.

Bereitstellung von Rohdaten

Entladen von SVA-Daten

Da SVA ein datenschutzrelevantes System ist, kommt der Einrichtung der Entladeroutine eine große Bedeutung zu: Zum einen muss das generelle Verfahren für den Datentransfer von SVA nach SuperX geplant werden, zum anderen muss entschieden werden, welche Daten über Parametrisierung gesteuert entladen werden sollen (Stichtage und Löschen, Pseudonymisierung).

Filter beim Entladen

Es gibt bereits beim Entladen aus dem Vorsystem einige Filter, die im folgenden beschrieben werden.

Quellsystem SVA-GX Beim Quellsystem SVA-GX werden folgende Filter genutzt:

  • Nur gültige Datensätze werden entladen (*_status=0).
  • Bei Finanzierungen werden nur Datensätze entladen, die im Feld pfi_uebernahme nicht den Wert 900 haben. Datensätze mit 900 entstanden bei der Migration nach SVA 9.02 (Zusammenlegung POZ und PFI) und kennzeichnen Fälle, in denen es mehrere gleichzeitig gültige PBL-Datensätze gibt.
  • Weitere Filter, z. B. das Entladedatum, sind über die Parameter möglich (s.u.).

Parametrisierung des Entladens

Beim Entladen der SVA-Daten werden Datentabellen und Schlüsseltabellen entladen, um sie nach SuperX zu übernehmen. Speziell für das Personalmodul gibt des datenschutzrelevante Entlademodi, die in der Entladekonfiguration eingestellt und im Folgenden beschrieben werden.

Entladen ab Stichtag

Beim Entladen können wahlweise alle Stammdaten oder nur die Stammdaten, die ab einem definierten Zeitpunkt des Entladens in SVA gültig sind, entladen werden. "Gültig" heißt hier, dass die Datensätze im Bereich Personal ein gültiges Beschäftigungsverhältnis (Datum zwischen pbv_von und pbv_bis, Status="0") haben, und im Bereich Stellen in der Tabelle sgd gültig sind (Datum im Zeitraum sgd_von und sgd_bis, Status="0"). Wenn Sie immer alle Stammdaten entladen wollen, setzen Sie das Entladedatum auf den 01.01.1900.

Die zugehörigen Schlüsseltabellen werden immer komplett übernommen.

Pseudonymisierung

Aus Datenschutzgründen wurde die Möglichkeit zur Pseudonymisierung von Personalnummern implementiert. Das bedeutet: In HISSVA wird eine Tabelle erzeugt, in der die tatsächlichen Personalnummern einer arbiträren Laufnummer dauerhaft zugeordnet werden, und beim Entladen nur die arbiträre Laufnummer in die HISinOne-BI übernommen wird. Bei der arbiträren Laufnummer handelt es sich um einen Zähler, der mit einer Initial-Zufallszahl von 1-100 belegt wird und dann in 1er-Schritten hochzählt.

Setzen Sie dazu den Schalter:

ANONYM="true"

(s.u.)

Ausblenden einzelner Felder

Weiterhin können aus Datenschutzgründen weitere Persongrunddaten beim Entladen ein- oder ausgeblendet werden. Dazu sind im Entladeparameter vorgesehen (z. B. PGD_TITEL), die denen der Personagrunddaten-Tabelle (PGD) in SVA entsprechen. Wenn sie auf 1 gesetzt werden, wird das Feld entladen, wenn sie auf 0 gesetzt sind, wird ein Leerstring entladen.

attention.svg Standardmäßig in der Auslieferung des Personalmoduls werden nur die in den SuperX-Abfragen benötigten Felder entladen. Wenn Sie diese Felder (z. B. Geburtsdatum) auf 0 setzen, sind gewisse Auswertungen nicht mehr möglich (z. B. die Abfrage Altersstruktur der Beschäftigten).

Externes Berichtswesen Dies gilt nur für SuperX: Wenn Sie das Personalmodul nur für die Datenlieferung an das KENN-Modul (und somit für das externe Berichtswesen) einsetzen, können Sie das Quellsystem so ändern, dass nur die Daten entladen werden, die direkt oder indirekt für das externe Berichtswesen benötigt werden.

Da in SVA-GX viele Schlüssel eine interne und externe Ausprägung haben, z. B. Amtsdienstbezeichnung, und die Daten erst bei der Übergabe von SuperX-SVA nach SuperX-KENN umgeschlüsselt werden, müssen die internen Schlüssel zunächst in das SuperX-Personalmodul entladen und verarbeitet werden. Nur Schlüssel, die nicht benötigt werden, werden direkt beim Entladen ausgeklammert, z. B. BVL-Gruppen.

Die Änderung hat zur Folge, dass einige Berichte im SuperX-Personalmodul zwar technisch funktionieren, aber inhaltlich nicht aussagekräftig sind. Beispiel: Der Bericht Altersstruktur der Beschäftigten ergibt nur eine Statistik zu Alter unbekannt, weil das Alter in SuperX-KENN nicht benötigt wird und daher nicht geladen wird. Auch die BVL-Gruppe wird derzeit nicht entladen.

Um das Entladen entsprechend zu konfigurieren, setzen Sie den Schalter:

ANONYM="true" 

sowie die Variable:

SOURCESYSTEM=sva_fuer_kenn

Einrichtung der Entladeskripte

Vor dem Start des Entladens müssen einige Parameter gesetzt werden:

Parametername Beschreibung Defaultwert Wertebereich ab Version Parametergruppe Priorität Vorsystem BI-Komponente
SOURCESYSTEM Datenquelle/Quellsystem eduetl z.B. sva >6.0 Systemparameter 1 0 Personal/Stellen
DATABASE Quell-DBMS POSTGRES POSTGRES, INFORMIX >6.0 Systemparameter 1 0 Personal/Stellen
ANONYM Pseudonymisierung Wenn ANONYM = "true",dann wird in SVA_PER der Name /Vorname auf "leer" gesetzt, und die Personalnummer wird pseudonymisiert. Sofern Tabelle pat entladen wird, bleibt Feld zusatz bei Anonymisierung leer false ja: true, nein: false >6.0 Datenschutzparameter 1 2 Personal, Stellen
pat_unload Soll die Tabelle pat entladen werden? false ja: true, nein: false >6.0 Personalattribute (pat) 0 2 Personal, Stellen
pbv_inhaber Feld Inhaber (pbv.pbv_inhaber ) entladen ? null::char(1) ja: 'pgd_inhaber', nein: 'null::char(1)' 2019.06 Personalverwaltung (pbv) 0 2 Personal, Stellen
pgd_ablauf_probe Feld Ablauf der Probezeit (pgd.pgd_ablauf_probe) entladen? null::char(1) ja: 'pgd_ablauf_probe', nein: 'null::char(1)' >6.0 Personen-Grund-Daten (pgd) 0 2 Personal, Stellen
pgd_account Feld Account aus Personalgrunddaten (pgd.pgd_account) entladen? null::char(1) ja: 'pgd_account', nein: 'null::char(1)' >6.0 Personen-Grund-Daten (pgd) 0 2 Personal, Stellen
pgd_akad_grad Feld Akademischer Grad (pgd.pgd_akad_grad) entladen? null::char(1) ja: 'pgd_akad_grad', nein: 'null::char(1)' >6.0 Personen-Grund-Daten (pgd) 0 2 Personal, Stellen
pgd_austrittsdatum Feld Datum des Ausscheidens aus dem Hochschuldienst (pgd.pgd_austrittsdatum) entladen? null::char(1) ja: 'pgd_austrittsdatum', nein: 'null::char(1)' >6.0 Personen-Grund-Daten (pgd) 0 2 Personal, Stellen
pgd_berufungsjahr Feld Jahr der 1. Berufung zum Professor (Ernennung) (pgd.pgd_berufungsjahr) entladen? null::char(1) ja: 'pgd_berufungsjahr', nein: 'null::char(1)' >6.0 Personen-Grund-Daten (pgd) 0 2 Personal, Stellen
pgd_beschaeft_von Feld Beginn der Beschäftigungszeit (pgd.pgd_beschaeft_von) entladen? null::char(1) ja: 'pgd_beschaeft_von', nein: 'null::char(1)' >6.0 Personen-Grund-Daten (pgd) 0 2 Personal, Stellen
pgd_besold_dienst Feld Besoldungsdienstalter (pgd.pgd_besold_dienst) entladen? null::char(1) ja: 'pgd_besold_dienst', nein: 'null::char(1)' >6.0 Personen-Grund-Daten (pgd) 0 2 Personal, Stellen
pgd_dienstzeit Feld Beginn der Dienstzeit (pgd.pgd_dienstzeit) entladen? null::char(1) ja: 'pgd_dienstzeit', nein: 'null::char(1)' >6.0 Personen-Grund-Daten (pgd) 0 2 Personal, Stellen
pgd_eintritt_land Feld Datum des Eintritts in den Landesdienst (pgd.pgd_eintritt_land) entladen? null::char(1) ja: 'pgd_eintritt_land', nein: 'null::char(1)' >6.0 Personen-Grund-Daten (pgd) 0 2 Personal, Stellen
pgd_eintrittsdatum Feld Datum des Eintritts in den Hochschuldienst (pgd.pgd_eintrittsdatum) entladen? null::char(1) ja: 'pgd_eintrittsdatum', nein: 'null::char(1)' >6.0 Personen-Grund-Daten (pgd) 0 2 Personal, Stellen
pgd_email Feld Email-Adresse (pgd.pgd_email) entladen? null::char(1) ja: 'pgd_email', nein: 'null::char(1)' >6.0 Personen-Grund-Daten (pgd) 0 2 Personal, Stellen
pgd_fam_stand Feld Familienstand (pgd.pgd_fam_stand) entladen? null::char(1) ja: 'pgd_fam_stand', nein: 'null::char(1)' >6.0 Personen-Grund-Daten (pgd) 0 2 Personal, Stellen
pgd_fax Feld Fax-Nummer (pgd.pgd_fax) entladen? null::char(1) ja: 'pgd_fax', nein: 'null::char(1)' >6.0 Personen-Grund-Daten (pgd) 0 2 Personal, Stellen
pgd_geburtsdatum Feld Geburtsdatum (pgd.pgd_geburtsdatum) entladen ? pgd_geburtsdatum ja: 'pgd_geburtsdatum', nein: 'null::char(1)' >6.0 Personen-Grund-Daten (pgd) 0 2 Personal, Stellen
pgd_geschlecht Feld Geschlecht (pgd.pgd_geschlecht) entladen? pgd_geschlecht ja: 'pgd_geschlecht', nein: 'null::char(1)' >6.0 Personen-Grund-Daten (pgd) 0 2 Personal, Stellen
pgd_habil_fach Feld Fachgebiet der Hablitation (pgd.pgd_habil_fach) entladen ? null::char(1) ja: 'pgd_habil_fach', nein: 'null::char(1)' >6.0 Personen-Grund-Daten (pgd) 0 2 Personal, Stellen
pgd_habil_hochsch Feld Hochschule der Habilitation (pgd.pgd_habil_hochsch) entladen ? null::char(1) ja: 'pgd_habil_hochsch', nein: 'null::char(1)' >6.0 Personen-Grund-Daten (pgd) 0 2 Personal, Stellen
pgd_habil_jahr Feld Jahr der Habilitation (pgd.pgd_habil_jahr) entladen ? null::char(1) ja: 'pgd_habil_jahr', nein: 'null::char(1)' >6.0 Personen-Grund-Daten (pgd) 0 2 Personal, Stellen
pgd_inhaber Feld zuständige(r) Sachbearbeiter/-in (pgd.pgd_inhaber) entladen ? null::char(1) ja: 'pgd_inhaber', nein: 'null::char(1)' >6.0 Personen-Grund-Daten (pgd) 0 2 Personal, Stellen
pgd_jubi_25_datum Feld Datum des 25-jährigen Dienstjubiläums (pgd.pgd_jubi_25_datum) entladen ? null::char(1) ja: 'pgd_jubi_25_datum', nein: 'null::char(1)' >6.0 Personen-Grund-Daten (pgd) 0 2 Personal, Stellen
pgd_jubi_40_datum Feld Datum des 40-jährigen Dienstjubiläums (pgd.pgd_jubi_40_datum) entladen ? null::char(1) ja: 'pgd_jubi_40_datum', nein: 'null::char(1)' >6.0 Personen-Grund-Daten (pgd) 0 2 Personal, Stellen
pgd_jubi_50_datum Feld Datum des 50-jährigen Dienstjubiläums (pgd.pgd_jubi_50_datum) entladen ? null::char(1) ja: 'pgd_jubi_50_datum', nein: 'null::char(1)' >6.0 Personen-Grund-Daten (pgd) 0 2 Personal, Stellen
pgd_jubi_berech Feld Berechnungsgrundlage für Jubiläen (pgd.pgd_jubi_berech) entladen ? null::char(1) ja: 'pgd_jubi_berech', nein: 'null::char(1)' >6.0 Personen-Grund-Daten (pgd) 0 2 Personal, Stellen
pgd_kategorie Feld Personalkategorie(pgd.pgd_kategorie) entladen ? null::char(1) ja: 'pgd_kategorie', nein: 'null::char(1)' >6.0 Personen-Grund-Daten (pgd) 0 2 Personal, Stellen
pgd_land Feld Angabe des Staates bei Auslandswohnsitz (pgd.pgd_land) entladen ? null::char(1) ja: 'pgd_land', nein: 'null::char(1)' >6.0 Personen-Grund-Daten (pgd) 0 2 Personal, Stellen
pgd_leb_alterstufe Feld Lebensaltersstufe bei Einstellung (pgd.pgd_leb_alterstufe) entladen ? null::char(1) ja: 'pgd_leb_alterstufe', nein: 'null::char(1) >6.0 Personen-Grund-Daten (pgd) 0 2 Personal, Stellen
pgd_lehrfach_einw Feld Lehrfach laut Einweisung (pgd.pgd_lehrfach_einw) entladen ? null::char(1) ja: 'pgd_lehrfach_einw', nein: 'null::char(1)' >6.0 Personen-Grund-Daten (pgd) 0 2 Personal, Stellen
pgd_matrikelnummer Feld Matrikelnummer (pgd.pgd_matrikelnummer) entladen ? null::char(1) ja: 'pgd_matrikelnummer', nein: 'null::char(1)' >6.0 Personen-Grund-Daten (pgd) 0 2 Personal, Stellen
pgd_mobiltelefon Feld Telefonnummer Mobiltelefon (pgd.pgd_mobiltelefon) entladen ? null::char(1) ja: 'pgd_mobiltelefon', nein: 'null::char(1)' >6.0 Personen-Grund-Daten (pgd) 0 2 Personal, Stellen
pgd_name Feld Familien-/Nachname ( pgd.pgd_name) entladen ? pgd_name ja: 'pgd_name', nein: 'null::char(1)' >6.0 Personen-Grund-Daten (pgd) 0 2 Personal, Stellen
pgd_plz Feld Postleitzahl (pgd.pgd_plz) entladen ? null::char(1) ja: 'pgd_plz', nein: 'null::char(1)' >6.0 Personen-Grund-Daten (pgd) 0 2 Personal, Stellen
pgd_rentendatum Feld Eintritt in den Ruhestand (pgd.pgd_rentendatum) entladen ? null::char(1) ja: 'pgd_rentendatum', nein: 'null::char(1)' >6.0 Personen-Grund-Daten (pgd) 0 2 Personal, Stellen
pgd_staatsangeh_2 Feld 2. Staatsangehörigkeit (pgd.pgd_staatsangeh_2) entladen ? pgd_staatsangeh_2 ja: 'pgd_staatsangeh_2', nein: 'null::char(1)' >6.0 Personen-Grund-Daten (pgd) 0 2 Personal, Stellen
pgd_staatsangehoer Feld Staatsangehörigkeit (pgd.pgd_staatsangehoer) entladen ? pgd_staatsangehoer ja: 'pgd_staatsangehoer', nein: 'null::char(1)' >6.0 Personen-Grund-Daten (pgd) 0 2 Personal, Stellen
pgd_steuernummer Feld Steuernummer (pgd.pgd_steuernummer) entladen ? null::char(1) ja: 'pgd_steuernummer', nein: 'null::char(1)' >6.0 Personen-Grund-Daten (pgd) 0 2 Personal, Stellen
pgd_titel Feld Anrede/Titel (pgd.pgd_titel) entladen ? null::char(1) ja: 'pgd_titel', nein: 'null::char(1)' >6.0 Personen-Grund-Daten (pgd) 0 2 Personal, Stellen
pgd_verleihung Feld Verleihung der Eigenschaft als Beamter auf Lebenszeit (pgd.pgd_verleihung) entladen ? null::char(1) ja: 'pgd_verleihung', nein: 'null::char(1)' >6.0 Personen-Grund-Daten (pgd) 0 2 Personal, Stellen
pgd_vornamen Feld Vorname(n) (pgd.pgd_vornamen) entladen ? pgd_vornamen ja: 'pgd_vornamen', nein: 'null::char(1)' >6.0 Personen-Grund-Daten (pgd) 0 2 Personal, Stellen
pgd_widerrufdatum Feld Ablaufdatum Beamter auf Widerruf (pgd.pgd_widerrufdatum) entladen ? null::char(1) ja: 'pgd_widerrufdatum', nein: 'null::char(1)' >6.0 Personen-Grund-Daten (pgd) 0 2 Personal, Stellen
pgd_wohnort Feld Wohnort (pgd.pgd_wohnort) entladen ? null::char(1) ja: 'pgd_wohnort', nein: 'null::char(1)' >6.0 Personen-Grund-Daten (pgd) 0 2 Personal, Stellen
DATABASE Quell-DBMS POSTGRES POSTGRES, INFORMIX >6.0 Systemparameter 1 0 Personal, Stellen
JDBC_PARAM Spezieller Datenbankparameter Wenn Postgres und SVA-Version 12 oder höher eingesetzt wird, sollte der Parameter auf set search_path to sva4; gesetzt werden. Wenn nicht, dann leer lassen. set search_path to sva4; >6.0 Systemparameter 1 2 Personal, Stellen
SOURCESYSTEM Datenquelle/Quellsystem erp z.B. sospos, sva oder hisinone >6.0 Systemparameter 1 0 Personal, Stellen
SVA_AKTIV Entladestichtag Ab welchem Datum sollen Beschäftigungen und Stellen entladen werden? 01.01.1900 (JJJJ) >6.0 Systemparameter 1 2 Personal, Stellen
VERSION Version des Vorsystems. Wird nicht mehr gepflegt, ab SVA-Version 15 immer auf 15 setzen 15 12 >6.0 Systemparameter 1 2 Personal, Stellen
pbv_to_pbz_unload Sollen die Daten des Bezügeverteilers also Bezügedaten je Beschäftigungsverhältnissen (Tabelle pbv_to_pbz) entladen werden ? false ja: true, nein: false >6.0 Zahlungen pro Beschäftigungsverhältnis (pbz) 0 2 Personal, Stellen
pbz_aus_mon_soll Feld außerhalb Monatssoll (pbz.pbz_aus_mon_soll) entladen ? null::char(1) ja: 'pbz_aus_mon_soll', nein: 'null::char(1)' >6.0 Zahlungen pro Beschäftigungsverhältnis (pbz) 0 2 Personal, Stellen
pbz_av_zuschuss Feld Anteil des Arbeitgebers an der Arbeitslosenversicherung (pbz.pbz_av_zuschuss) entladen ? null::char(1) ja: 'pbz_av_zuschuss', nein: 'null::char(1)' >6.0 Zahlungen pro Beschäftigungsverhältnis (pbz) 0 2 Personal, Stellen
pbz_berech_datum Feld Abrechnungs-/Nachberechnungsdatum (pbz.pbz_berech_datum) entladen ? null::char(1) ja: 'pbz_berech_datum', nein: 'null::char(1)' >6.0 Zahlungen pro Beschäftigungsverhältnis (pbz) 0 2 Personal, Stellen
pbz_bis Feld Gültigkeitsende (pbz.pbz_bis) entladen ? null::char(1) ja: 'pbz_bis', nein: 'null::char(1)' >6.0 Zahlungen pro Beschäftigungsverhältnis (pbz) 0 2 Personal, Stellen
pbz_gesamtbetrag Feld Summe aller Beträge (pbz.pbz_gesamtbetrag) entladen ? null::char(1) ja: 'pbz_gesamtbetrag', nein: 'null::char(1)' >6.0 Zahlungen pro Beschäftigungsverhältnis (pbz) 0 2 Personal, Stellen
pbz_grundverguet Feld Grundvergütung (pbz.pbz_grundverguet) entladen ? null::char(1) ja: 'pbz_grundverguet', nein: 'null::char(1)' >6.0 Zahlungen pro Beschäftigungsverhältnis (pbz) 0 2 Personal, Stellen
pbz_imp_serial Feld eindeutige Identifikationsnummer aus der LBV/DAISY (pbz.pbz_imp_serial) entladen ? (Importtabelle imp_pbz_lbv bzw. imp_pbz_daisy) null::char(1) ja: 'pbz_imp_serial', nein: 'null::char(1)' >6.0 Zahlungen pro Beschäftigungsverhältnis (pbz) 0 2 Personal, Stellen
pbz_info_1 Feld Zusatzinfos (1) (derzeit: Kapitel und Titel) (pbz.pbz_info_1) entladen ? null::char(1) ja: 'pbz_info_1', nein: 'null::char(1)' >6.0 Zahlungen pro Beschäftigungsverhältnis (pbz) 0 2 Personal, Stellen
pbz_info_2 Feld Zusatzinfos (2) (pbz.pbz_info_2) entladen ? null::char(1) ja: 'pbz_info_2', nein: 'null::char(1)' >6.0 Zahlungen pro Beschäftigungsverhältnis (pbz) 0 2 Personal, Stellen
pbz_kindergeld Feld Gezahltes Kindergeld (pbz.pbz_kindergeld) entladen ? null::char(1) ja: 'pbz_kindergeld', nein: 'null::char(1)' >6.0 Zahlungen pro Beschäftigungsverhältnis (pbz) 0 2 Personal, Stellen
pbz_kuerzungen Feld Kürzungen (gesamt) (pbz.pbz_kuerzungen) entladen ? null::char(1) ja: 'pbz_kuerzungen', nein: 'null::char(1)' >6.0 Zahlungen pro Beschäftigungsverhältnis (pbz) 0 2 Personal, Stellen
pbz_kv_zuschuss Feld Arbeitgerberzuschuss zur Krankenversicherung (pbz.pbz_kv_zuschuss) entladen ? null::char(1) ja: 'pgd_email', nein: 'null::char(1)' >6.0 Zahlungen pro Beschäftigungsverhältnis (pbz) 0 2 Personal, Stellen
pbz_ortszuschlag Feld Ortszuschlag (pbz.pbz_ortszuschlag) entladen ? null::char(1) ja: 'pbz_ortszuschlag', nein: 'null::char(1)' >6.0 Zahlungen pro Beschäftigungsverhältnis (pbz) 0 2 Personal, Stellen
pbz_pbv_nr Feld Beschäftigungsverhältnisnummer(pbz.pbz_pbv_nr) entladen ? null::char(1) ja: 'pbz_pbv_nr', nein: 'null::char(1)' >6.0 Zahlungen pro Beschäftigungsverhältnis (pbz) 0 2 Personal, Stellen
pbz_pbv_serial Feld Referenz zu Tabelle sva_pbv (pbz.pbz_serial) entladen ? null::char(1) ja: 'pbz_serial', nein: 'null::char(1)' >6.0 Zahlungen pro Beschäftigungsverhältnis (pbz) 0 2 Personal, Stellen
pbz_pfi_serial Feld Referenz zu Tabelle sva_pfi (pbz.pbz_pfi_serial) entladen ? null::char(1) ja: 'pbz_pfi_serial', nein: 'null::char(1)' >6.0 Zahlungen pro Beschäftigungsverhältnis (pbz) 0 2 Personal, Stellen
pbz_pgd_join_id Tabelle Zahlungen pro Beschäftigungsverhältnis (pbz) + Feld Personalnummer (pbz.pbz_pgd_join_id) entladen  ? null::char(1) ja: 'pbz_pgd_join_id', nein: 'null::char(1)' >6.0 Zahlungen pro Beschäftigungsverhältnis (pbz) 0 2 Personal, Stellen
pbz_pv_zuschuss Feld Arbeitgerberzuschuss zur Pflegeversicherung (pbz.pbz_pv_zuschuss) entladen ? null::char(1) ja: 'pbz_pv_zuschuss', nein: 'null::char(1)' >6.0 Zahlungen pro Beschäftigungsverhältnis (pbz) 0 2 Personal, Stellen
pbz_rv_zuschuss Feld Anteil des Arbeitgebers an der Rentenversicherung (pbz.pbz_rv_zuschuss) entladen ? null::char(1) ja: 'pbz_rv_zuschuss', nein: 'null::char(1)' >6.0 Zahlungen pro Beschäftigungsverhältnis (pbz) 0 2 Personal, Stellen
pbz_serial Feld Internes Identifikationsfeld (pbz.pbz_pbv_serial) entladen ? null::char(1) ja: 'pbz_pbv_serial', nein: 'null::char(1)' >6.0 Zahlungen pro Beschäftigungsverhältnis (pbz) 0 2 Personal, Stellen
pbz_sonstige1 Feld Höhe des Urlaubsgeldes (pbz.pbz_sonstige1) entladen ? null::char(1) ja: 'pbz_sonstige1', nein: 'null::char(1)' >6.0 Zahlungen pro Beschäftigungsverhältnis (pbz) 0 2 Personal, Stellen
pbz_sonstige2 Feld Höhe von Zuwendungen (pbz.pbz_sonstige2) entladen ? null::char(1) ja: 'pbz_sonstige2', nein: 'null::char(1)' >6.0 Zahlungen pro Beschäftigungsverhältnis (pbz) 0 2 Personal, Stellen
pbz_sonstige3 Feld VBL-Betrag (pbz.pbz_sonstige3) entladen ? null::char(1) ja: 'pbz_sonstige3', nein: 'null::char(1)' >6.0 Zahlungen pro Beschäftigungsverhältnis (pbz) 0 2 Personal, Stellen
pbz_sonstige4 Feld Höhe des Aufstockung Altersteilzeit-Betrags (pbz.pbz_sonstige4) entladen ? null::char(1) ja: 'pbz_sonstige4', nein: 'null::char(1)' >6.0 Zahlungen pro Beschäftigungsverhältnis (pbz) 0 2 Personal, Stellen
pbz_sonstige5 Feld Höhe der Zahlungen für Mehrarbeit (pbz.pbz_sonstige5) entladen ? null::char(1) ja: 'pbz_sonstige5', nein: 'null::char(1)' >6.0 Zahlungen pro Beschäftigungsverhältnis (pbz) 0 2 Personal, Stellen
pbz_sonstige6 Feld Höhe der Zahlungen für Überstunden (pbz.pbz_sonstige6) entladen ? null::char(1) ja: 'pbz_sonstige6', nein: 'null::char(1)' >6.0 Zahlungen pro Beschäftigungsverhältnis (pbz) 0 2 Personal, Stellen
pbz_sv_gesamt Feld Sozialversicherungsgesamtbetrag (AG-Anteil) (pbz.pbz_sv_gesamt) entladen ? null::char(1) ja: 'pbz_sv_gesamt', nein: 'null::char(1)' >6.0 Zahlungen pro Beschäftigungsverhältnis (pbz) 0 2 Personal, Stellen
pbz_vbl_steuer Feld VBL-Steuer (pbz.pbz_vbl_steuer) entladen ? null::char(1) ja: 'pbz_vbl_steuer', nein: 'null::char(1)' >6.0 Zahlungen pro Beschäftigungsverhältnis (pbz) 0 2 Personal, Stellen
pbz_vermoegenlst Feld Vermögenswirksame Leistungen (pbz.pbz_vermoegenlst) entladen ? null::char(1) ja: 'pbz_vermoegenlst', nein: 'null::char(1)' >6.0 Zahlungen pro Beschäftigungsverhältnis (pbz) 0 2 Personal, Stellen
pbz_von Feld Gültigkeitsbeginn (pbz.pbz_von) entladen ? null::char(1) ja: 'pbz_von', nein: 'null::char(1)' >6.0 Zahlungen pro Beschäftigungsverhältnis (pbz) 0 2 Personal, Stellen
pbz_vr_betrag Feld Relevanter Betrag für Vergaberahmen (pbz.pbz_vr_betrag) entladen ? null::char(1) ja: 'pbz_vr_betrag', nein: 'null::char(1)' >6.0 Zahlungen pro Beschäftigungsverhältnis (pbz) 0 2 Personal, Stellen
pbz_vr_zulagen Feld Relevante Zulagen für Vergaberahmen (pbz.pbz_vr_zulagen) entladen ? null::char(1) ja: 'pbz_vr_zulagen', nein: 'null::char(1)' >6.0 Zahlungen pro Beschäftigungsverhältnis (pbz) 0 2 Personal, Stellen
pbz_zulage1 Feld Höhe der allgemeinen Zulage (pbz.pbz_zulage1) entladen ? null::char(1) ja: 'pbz_zulage1', nein: 'null::char(1)' >6.0 Zahlungen pro Beschäftigungsverhältnis (pbz) 0 2 Personal, Stellen
pbz_zulage2 Feld Höhe aller anderen Zulagen (pbz.pbz_zulage2) entladen ? (bei DAISY: Gehaltsdaten Summe aller anderen Zulagen, die nicht Allgemeine Zulage sind) null::char(1) ja: 'pbz_zulage2', nein: 'null::char(1)' >6.0 Zahlungen pro Beschäftigungsverhältnis (pbz) 0 2 Personal, Stellen
pbz_zuschuss_405 Feld Zuschuss nach §405 RVO (pbz.pbz_zuschuss_405) entladen ? null::char(1) ja: 'pbz_zuschuss_405', nein: 'null::char(1)' >6.0 Zahlungen pro Beschäftigungsverhältnis (pbz) 0 2 Personal, Stellen

Konfiguration

Layoutanpassung mit Styles

Der Berichtsassistent bindet defaultmäßig eine Datei "simple_table.jrtx" ein, die im gleichen Ordner wie die normalen JRXML-Dateien liegt (.../webapps/superx/WEB-INF/reports ).

Sie können die Layouts anpassen und so alle exportierten Berichte in einem "Corporate Design" gestalten. Details zu Styles und ausgelagerten Styles siehe unser JasperReports-Handbuch.

attention.svg Die Datei "simple_table.jrtx" wird beim Installieren des Pakets überschrieben, bitte sichern Sie daher die Datei nach Anpassungen. In Zukunft wollen wir die Style-Datei parametrisierbar machen.

Direkt-Exportbuttons einrichten

Wenn Sie im Berichtsassistenten ein Exportformat eingerichtet haben, können Sie dies in die Oberfläche als "Direktlink" einrichten, also als Link direkt auf das jew. Exportformat (z.B. Excel) ohne den Assistenten. Damit können Sie den regulären Excel-Export ersetzen, d.h. bei Ergebnisberichten mit Aufklappstruktur erhalten sie auch den gewohnten Dialog bzgl. der Zeilen.

In der Auslieferung ist dies das Excel-Format, hier ein Screenshot, wie das aussieht:

rpta export btn excel2.png

Nach dem Bestätigen erhalten Sie direkt die fertige Excel-Datei:

rpta export btn excel3.png

Das Beispiel läßt sich für alle von JasperReports unterstützte Formate umsetzen, z.B. auch PDF. Dazu müssen Sie nur das vorhandene Stylesheet "tabelle_jrxml_a4_quer.xsl" kopieren und den Contenttype ändern, für PDF z.B. "application/pdf". Auch das Icon können Sie ändern.

Berichtserstellung via Kommandozeile

Viele Hochschulen erzeugen die Berichtslayouts auch per Kommandozeile, dies ist auch hier möglich. Wir haben für diesen Zweck mehrere ANT-Targets erstellt. Das Vorgehen:

  1. Richten Sie zunächst ANT ein und Klonen sie das RPTA-Repository mit
git clone https://git.campussource.de/git/SuperX/rpta.git
  1. Gehen Sie in das geklonte root-Verzeichnis des git-Repository, wo die Datei build.xml liegt
  2. Speichern Sie einen SuperX-XML-Export eines Berichts lokal, z.B. in test.xml
  3. Um das normale A4-Quer Layout zu erzeugen, führen Sie dort aus:
ant -DXML=test.xml -DWEBAPP=$WEBAPP -DTARGET_NAME=test xml2jrxml_tabelle_a4_quer

Es wird im Unterordner test/tabelle_a4_quer eine Datei test.jrxml erzeugt

Sie können auch aus den Berichtslayouts PDF-Berichte erzeugen, indem Sie danach eingeben:

ant -DXML=test.xml -DWEBAPP=$WEBAPP -DTARGET_NAME=test jrxml2pdf_tabelle_a4_quer 

Damit wird die jrxml-Datei mit der XML-Datenquelle verbunden und ein formatierter Export erzeugt.

Neben dem A4-quer Layout haben wir auch ein Template, das aus einem Makrobericht ein Booklet erzeugen kann. Auch hier beginnt die Verarbeitung mit einem XML-Export eines Makroberichts, z.B. in der Datei testmakro.xml

ant -DXML=testmakro.xml -DWEBAPP=$WEBAPP -DTARGET_NAME=test xml2jrxml_booklet_ohne_cover

Damit werden einige Dateien erzeugt:

  • eine Datei ./test/booklet_ohne_cover/testmakro.jrxml mit dem Gesamtbericht
  • die einzelnen Unterberichte ./test/booklet_ohne_cover/testmakro_sub_1.jrxml etc.
  • damit der Bericht direkt nutzbar ist werden auch kompilierte .jasper-Dateien der Unterberichte erzeugt

Den Hauptbericht und die Unterberichte können Sie in JasperSoft Studio weiterverarbeiten, oder daraus ein PDF-Buch erzeugen:

ant -DXML=testmakro.xml -DWEBAPP=$WEBAPP -DTARGET_NAME=test jrxml2pdf_booklet_ohne_cover

Dies erzeugt eine Datei ./test/booklet_ohne_cover/testmakro.pdf Die beiden Beispiele können in eigenen ANT-Targets angepaßt und genutzt werden, z.B. um statt PDF das Format XLSX zu erzeugen.