Zuletzt bearbeitet vor einem Monat
von Daniel Quathamer

Modul Berichtsassistent Konfigurationshandbuch: Unterschied zwischen den Versionen
 
(18 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt)
Zeile 2: Zeile 2:
==Voraussetzungen==
==Voraussetzungen==
* Sie benötigen  
* Sie benötigen  
** in SuperX das Kernmodul 4.8 oder höher
** in SuperX das Kernmodul 5.0 oder höher
** als Liefersystem HIS-SVA, MACH oder SAP-HR
** in HISinOne-BI die Version 2023.06 oder höher
** Fürs Deployment der Entwicklungsversion aus dem git Repository die Software [https://ant.apache.org ANT], Anleitung zur Installation siehe [[Memtext_Hochschul-git#Entwicklung_mit_dem_Repository|hier]].
 
==Vorgehen bei Neuinstallation - kurz und knapp==
==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
===Installation des Download-Pakets===
* Achten Sie dabei darauf, daß Sie die richtige Version laden (Zeichencodierung ISO oder UTF-8, Datenbanksystem Postgres oder Informix)
====Installation des Download-Pakets unter SuperX====
 
* Laden Sie das Modul rpta*superx_utf8_POSTGRES.tar.gz herunter und speichern Sie es in $SUPERX_DIR.
 
{{Achtung|Beim Download des Pakets wird die Datei $SUPERX_DIR/webserver/tomcat/webapps/superx/WEB-INF/reports/simple_table.jrtx überschrieben. Wenn Sie die angepaßt haben müssen Sie die sichern.}}
 
* Entpacken Sie das Modul mit
* Entpacken Sie das Modul mit


   tar -xzvf Dateiname
   tar -xzvf Dateiname
Fügen Sie dann den Pfad Ihrer SQL_ENV hinzu:
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
<source lang="sh">
cat $SUPERX_DIR/db/bin/SQL_ENV_rpta.sam >> $SUPERX_DIR/db/bin/SQL_ENV
</source>
Danach laden Sie die SQL_ENV neu und führen aus:
Danach laden Sie die SQL_ENV neu und führen aus:
  cd $SVA_PFAD
  <source lang="sh">
  module_install sva .
cd $RPTA_PFAD
Danach konfiguieren Sie die Entladeroutine aus dem Vorsystem.
  module_install rpta .
</source>
Danach bitte Tomcat neu starten, und dann ist das Modul einsatzbereit. Eine Hauptladeroutine gibt es in diesem Modul nicht.
====Installation des Download-Pakets unter HISinOne-BI====
* Laden Sie das Modul rpta*his1_utf8_POSTGRES.tar.gz herunter und speichern Sie es in dem Ordner $WEBAPP bzw. .../webapps/superx.


Danach bitte Tomcat neu starten, und dann ist das Modul einsatzbereit.  
{{Achtung|Beim Download des Pakets wird die Datei $WEBAPP/WEB-INF/reports/simple_table.jrtx überschrieben. Wenn Sie die angepaßt haben müssen Sie die sichern.}}


* Entpacken Sie das Modul mit


==Vorgehen beim Upgrade==
  tar -xzvf Dateiname
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
Danach können Sie das Modul über die Komponentenverwaltung installieren:
* Wenn Sie die mit Version 2024.06 aktiv geschaltete "neue Komponentenverwaltung" nutzen, müssen Sie nach dem Entpacken den Tomcat neu starten oder im Menüpunkt "Komponenten verwalten" -> ganz unten in der Liste den Button "Komponentenkonfiguration neu in die Datenbank einlesen" wählen, damit die Jobs eingelesen werden.


aus.
{{ImagePara |imgsrc=rpta_h1_install_neue_kv1.png|width=800px|caption=Neue Komp. Verwaltung BI}}


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 des Entladens |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).
* Wenn Sie über die vor 2024.06 aktive "alte Komponentenverwaltung" installieren, dann wählen Sie das Modul "Berichtsassistent" und den Installieren Button aus:
* 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 ===
{{ImagePara |imgsrc=rpta_h1_install_alte_kv1.png|width=800px|caption=Komp. Verwaltung BI}}
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  [[#Einrichtung der Entladescripte|Entladekonfiguration]] eingestellt und im Folgenden beschrieben werden.  


'''Entladen ab Stichtag'''
Danach starten Sie Tomcat neu, bzw. leeren den Cache im  Webanwendung Manager. Eine Hauptladeroutine gibt es derzeit nicht, wohl aber eine Upgrade Funktion. Nach einer Neuanmeldung sollten Sie im Menü "Standardberichte konfigurieren" ganz oben  den Menüpunkt "Berichtsassistent" finden.


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''.
===Installation aus dem git Repository===


Die zugehörigen Schlüsseltabellen werden immer komplett übernommen.
Laden Sie zunächst das Environment von SuperX, so dass die Umgebungsvariables $SUPERX_DIR und $WEBAPP gesetzt sind. Führen Sie dann folgende Shell-Befehle aus:


'''Pseudonymisierung'''
git clone https://git.campussource.de/git/SuperX/rpta.git
cd rpta
cat superx/WEB-INF/conf/edustore/db/bin/SQL_ENV_rpta.sam >> $SUPERX_DIR/db/bin/SQL_ENV
. $SUPERX_DIR/db/bin/SQL_ENV
ant  -DMODULE_PATH=$RPTA_PFAD -DBASE_DIR=. -DWEBAPP=$WEBAPP -DMODULE=rpta all
cd $RPTA_PFAD
module_install.x rpta .


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.
Danach bitte Tomcat neu starten, und dann ist das Modul einsatzbereit.


Setzen Sie dazu den Schalter:
{{Achtung|Beim Download des Pakets wird die Datei $WEBAPP/WEB-INF/reports/simple_table.jrtx überschrieben. Wenn Sie die angepaßt haben müssen Sie die sichern.}}


ANONYM="true"
==Vorgehen beim Upgrade==
(s.u.)
Wenn Sie die Komponente bereits installiert haben, müssen Sie wie folgt vorgehen:
* Sichern Sie die Datei .../webapps/superx/WEB-INF/reports/simple_table.jrtx, sie wird sonst überschrieben
* 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/rpta/upgrade mit


'''Ausblenden einzelner Felder'''
rpta_upgrade.x


Weiterhin können aus Datenschutzgründen '''weitere Persongrunddaten''' beim Entladen ein- oder ausgeblendet werden. Dazu sind im [[Entladeparameter - HISinOne-BI|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.
aus.
{{Achtung| 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''').}}
Danach bitte Tomcat neu starten, und dann ist das Modul einsatzbereit.


'''Externes Berichtswesen'''
=Konfiguration=
'''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.
==Virtuelle Tabellen, Spalten und Spaltenlayouts verwalten==
 
Im Berichtswesen gibt es oft die Notwendigkeit, häufig wiederkehrende Abfragen in speziellen Spaltenlayouts zu speichern. Früher bot SuperX nur die Möglichkeit
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.
* neue Masken zu erzeugen, oder
 
* Lesezeichen anzulegen
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.
In dem Modul können Sie auf der Basis des SuperX-Datenmodells
 
* virtuelle Tabellen anlegen
Um das Entladen entsprechend zu konfigurieren, setzen Sie den Schalter:
* diesen virtuellen Tabellen beliebig viele Spaltenlayouts zuordnen
 
* die Spaltenlayouts dann flexibel anpassen bzgl. Namen, Sortierung, Sichtbarkeit, Inhalt und Erläuterungstext
ANONYM="true"
 
sowie die Variable:
 
SOURCESYSTEM=sva_fuer_kenn
 
== Einrichtung der Entladeskripte ==
 
Vor dem Start des Entladens müssen einige Parameter gesetzt werden:
{| class="prettytable sortable" width="99%"
!  width="10%" bgcolor="#CCE1EF"| Parametername || width="20%" bgcolor="#CCE1EF"| Beschreibung || width="5%" bgcolor="#CCE1EF"| Defaultwert || width="5%" bgcolor="#CCE1EF"| Wertebereich || width="5%" bgcolor="#CCE1EF"| ab Version ||  width="10%" bgcolor="#CCE1EF"| Parametergruppe ||  width="5%" bgcolor="#CCE1EF"| Priorität||  width="10%" bgcolor="#CCE1EF"| Vorsystem|| width="10%" bgcolor="#CCE1EF"| BI-Komponente
|-
 
| SOURCESYSTEM
| Datenquelle/Quellsystem
| eduetl
| z.B. sva
| >6.0
| Systemparameter
| style="text-align:right;" | 1
|  style="text-align:right;" | 0
| Personal/Stellen
 
|-
| DATABASE
| Quell-DBMS
| POSTGRES
| POSTGRES, INFORMIX
| >6.0
| Systemparameter
|  style="text-align:right;" | 1
|  style="text-align:right;" | 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


|-
Siehe auch:
| pgd_account
* [https://superxhosting.de/superx/edit/kb/kb_media_ansehen.jsp?id=26 Lehrfilm Berichtsassistent Spaltenlayouts Teil 1]
| Feld Account aus Personalgrunddaten (pgd.pgd_account) entladen?
* [https://superxhosting.de/superx/edit/kb/kb_media_ansehen.jsp?id=27 Lehrfilm Berichtsassistent Spaltenlayouts Teil 2]
| 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


|-
===Beispiel eines Spaltenlayouts im Bereich Studierende===
| pgd_austrittsdatum
In der Auslieferung gibt es eine Beispielanwendung, die Studierendenauswertungen flexibel für Landes- oder interne Zwecke ausgeben kann. Das Ziel ist z.B. die beigefügte Tabelle fürs Ministerium in NRW:
| 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


|-
{{ImagePara |imgsrc=rpta_spaltenlayout_sos_stud_astat_rsz_mwk1.png|width=600px|caption=Muster MKW NRW}}
| 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


|-
Die Datengrundlage ist eine Tabelle mit Studierendendaten. Diese wird im folgenden beschrieben.
| pgd_beschaeft_von
===Virtuelle Tabelle Studierende amtlich und intern===
| Feld Beginn der Beschäftigungszeit (pgd.pgd_beschaeft_von) entladen?
Nach Login mit einer Admin-Kennung haben Sie Zugriff auf das Menü Abfragen - Berichtsassistent - Administration Berichtsassistent, dort die Maske Spalten und Spaltenlayouts verwalten. Dort unter "Weitere Einstellungen" finden Sie die Verwaltung der virtuellen Tabellen.
| null::char(1)
| ja: 'pgd_beschaeft_von', nein: 'null::char(1)'
| >6.0
| Personen-Grund-Daten (pgd)
|| 0
|| 2
| Personal, Stellen


|-
{{ImagePara |imgsrc=rpta_spaltenlayout_verwalten3.png|width=600px|caption=Liste}}
| 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


|-
Die virtuelle Tabelle "Studierende amtlich und intern"  beinhaltet
| pgd_eintritt_land
* die Studierenden-Statistik, und dazu verlinkt
| Feld Datum des Eintritts in den Landesdienst (pgd.pgd_eintritt_land) entladen?
* die Merkmale der Studiengänge (amtlich und intern)
| null::char(1)
* die amtlichen Studienformen
| ja: 'pgd_eintritt_land', nein: 'null::char(1)'
* die amtlichen Studientypen
| >6.0
* die amtlichen Studienarten
| Personen-Grund-Daten (pgd)
* die amtlichen Standorte
|| 0
* die Hörerstatus
|| 2
| Personal, Stellen


|-
Das Detailformular zeigt die Quelltabellen und Felder:
| 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


|-
{{ImagePara |imgsrc=rpta_spaltenlayout_verwalten4.png|width=600px|caption=Liste}}
| 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


|-
Dieses Beispiel sollten Sie nicht ändern, es dient nur als Beispiel in der Auslieferung.
| 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


|-
=== Spalten verwalten===
| pgd_fax
Nach Login mit einer Admin-Kennung haben Sie Zugriff auf das Menü Abfragen - Berichtsassistent - Administration Berichtsassistent, dort die Maske Spalten und Spaltenlayouts verwalten:
| 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


|-
{{ImagePara |imgsrc=rpta_spaltenlayout_verwalten1.png|width=600px|caption=Maske}}
| 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


|-
Im Ergebnis finden Sie die definierten Spalten:
| 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


|-
{{ImagePara |imgsrc=rpta_spaltenlayout_verwalten2.png|width=600px|caption=Tabelle}}
| 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


|-
Sie können die Definition der Spalten abrufen, hier das Beispiel des Standortes (amtlich):
| 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


|-
{{ImagePara |imgsrc=rpta_spaltenlayout_verwalten5.png|width=600px|caption=Einzelbearbeitung }}
| 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


|-
Es gibt folgende Spaltentypen:
| pgd_inhaber
* Physische Spalten: direkte Übergabe des Wertes aus der Quelltabelle
| Feld zuständige(r) Sachbearbeiter/-in (pgd.pgd_inhaber) entladen ?
* Logische Spalten: SQL-Formeln oder Transformationen von physischen Spalten in neue Spalten, z.B. Alterswerte zu Altersgruppen. Im Feld "Funktion" wird die Formel hinterlegt, siehe unsere Beispiele
| null::char(1)
* Lookup-Spalten: Ein Feld wird aus  anderen Tabelle/n nachgeladen
| ja: 'pgd_inhaber', nein: 'null::char(1)'
* Weiterverarbeitende Spalten: Nachdem die Basisdaten geladen wurden, können diese in einem 2. Schritt (Anlegen einer weiteren tmp_table) weiterverarbeitet werden.
| >6.0
* Berechnete Spalten: Kurz vor Berichtsausgabe kann man Berechnungen vornehmen, z.B. Prozentwerte berechnen. Im Feld "Funktion" wird die Formel hinterlegt, siehe unsere Beispiele.
| 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
Die folgende Abbildung zeigt den Zusammenhang:-->
| 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


|-
===Spaltenlayouts verwalten===
| pgd_jubi_50_datum
Ausgehend vom obigen Beispiel-[[Modul_Berichtsassistent_Konfigurationshandbuch#Beispiel_eines_Spaltenlayouts_im_Bereich_Studierende|Muster]] benötigen wir eine Tabelle mit Studierendensummen mit einem Filter auf
| Feld Datum des 50-jährigen Dienstjubiläums (pgd.pgd_jubi_50_datum) entladen ?
* Haupt- und Nebenhörer
| null::char(1)
* Stichtag amtl. Statistik
| ja: 'pgd_jubi_50_datum', nein: 'null::char(1)'
* ohne Beurlaubte
| >6.0
* 1. und 2. Studiengang, 1.-4. Fach
| Personen-Grund-Daten (pgd)
* Studierende in der Regelstudienzeit
|| 0
Die Tabelle enthält folgende Spalten:
|| 2
*Hochschulnummer Statistik (amtl. Standortnummer)
| Personal, Stellen
*HSF-Schlüssel (amtl. Studienfach)
*Art des Studiums (amtl. Studienform)
*Abschlussschlüssel Statistik NRW (amtl. Abschluss)
*Vollzeit / Teilzeit / ausbildungsintegriert / praxisintegriert / berufsintegriert (amtl. Studiumstyp)
*Angabe der Regelstudienzeit (in Semestern)
*Anzahl der Studierenden in der Regelstudienzeit
Die Benennung der Spalten sollte exakt mit dem  [[Modul_Berichtsassistent_Konfigurationshandbuch#Beispiel_eines_Spaltenlayouts_im_Bereich_Studierende|Muster]] übereinstimmen.


|-
Zunächst die Tabellendefinition: Filter wie Stichtag, Hörerstatus und Status können wir wie gewohnt in der Maske als Felder anbieten, und die Filter
| pgd_jubi_berech
* 1. und 2. Studiengang, 1.-4. Fach
| Feld  Berechnungsgrundlage für Jubiläen (pgd.pgd_jubi_berech) entladen ?
* Studierende in der Regelstudienzeit
| null::char(1)
definieren wir direkt im Spaltenlayout. Wir gehen dazu in das Menü Abfragen - Berichtsassistent - Administration Berichtsassistent, dort die Maske Spalten und Spaltenlayouts verwalten. Dort unter "Weitere Einstellungen" finden Sie die Verwaltung der Spaltenlayouts: 
| ja: 'pgd_jubi_berech', nein: 'null::char(1)'
| >6.0
| Personen-Grund-Daten (pgd)
|| 0
|| 2
| Personal, Stellen


|-
[[Bild:rpta_spaltenlayout_sos_stud_astat_rsz_mwk10.png|800px]]
| 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


|-
Das Feld "Bedingung (optional)" definiert die Filter auf der virtuellen Tabelle. Da manche Hochschulen Studiengänge ohne Regelstudienzeit mit einem sehr hohen Wert versehen (z.B. 99), wird ein Filter auf eine "übliche" Regelstudienzeit zwischen 1 und 20 Semestern gesetzt.
| 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


|-
Im Beschreibungsfeld darunter wird eine textuelle Beschreibung im Sinne einer Legende angeboten. Diese wird in der späteren Berichtsausgabe dann unter der Legende erscheinen.
| 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


|-
Die eigentlichen Spalten werden in dem Unterformular angezeigt, mit Klick auf die jew. Details können Sie die Bezeichnung der Spalte und Layoutmerkmale angeben, sowie einen Erläuterungstext:
| 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


|-
[[Bild:rpta_spaltenlayout_sos_stud_astat_rsz_mwk8.png|800px]]
| 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


|-
Den fertigen Bericht können Sie hier abrufen: In der Maske definieren Sie die Ergebnismenge
| 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


|-
[[Bild:rpta_spaltenlayout_sos_stud_astat_rsz_mwk20.png|800px]]
| 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


|-
und die Tabelle gibt die Studierendensummen exakt im Layout des [[Modul_Berichtsassistent_Konfigurationshandbuch#Beispiel_eines_Spaltenlayouts_im_Bereich_Studierende|Musters]] aus:
| 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


|-
[[Bild:rpta_spaltenlayout_sos_stud_astat_rsz_mwk30.png|800px]]
| 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


|-
Die Sortierung erfolgt in der Reihenfolge der Spalten jeweils aufsteigend.
| 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==
==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 ).
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 ).

Aktuelle Version vom 28. Februar 2025, 07:15 Uhr

Installation

Voraussetzungen

  • Sie benötigen
    • in SuperX das Kernmodul 5.0 oder höher
    • in HISinOne-BI die Version 2023.06 oder höher
    • Fürs Deployment der Entwicklungsversion aus dem git Repository die Software ANT, Anleitung zur Installation siehe hier.

Vorgehen bei Neuinstallation - kurz und knapp

Installation des Download-Pakets

Installation des Download-Pakets unter SuperX

  • Laden Sie das Modul rpta*superx_utf8_POSTGRES.tar.gz herunter und speichern Sie es in $SUPERX_DIR.
attention.svg Beim Download des Pakets wird die Datei $SUPERX_DIR/webserver/tomcat/webapps/superx/WEB-INF/reports/simple_table.jrtx überschrieben. Wenn Sie die angepaßt haben müssen Sie die sichern.
  • 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_rpta.sam >> $SUPERX_DIR/db/bin/SQL_ENV

Danach laden Sie die SQL_ENV neu und führen aus: 

cd $RPTA_PFAD
 module_install rpta .

Danach bitte Tomcat neu starten, und dann ist das Modul einsatzbereit. Eine Hauptladeroutine gibt es in diesem Modul nicht.

Installation des Download-Pakets unter HISinOne-BI

  • Laden Sie das Modul rpta*his1_utf8_POSTGRES.tar.gz herunter und speichern Sie es in dem Ordner $WEBAPP bzw. .../webapps/superx.
attention.svg Beim Download des Pakets wird die Datei $WEBAPP/WEB-INF/reports/simple_table.jrtx überschrieben. Wenn Sie die angepaßt haben müssen Sie die sichern.
  • Entpacken Sie das Modul mit
 tar -xzvf Dateiname

Danach können Sie das Modul über die Komponentenverwaltung installieren:

  • Wenn Sie die mit Version 2024.06 aktiv geschaltete "neue Komponentenverwaltung" nutzen, müssen Sie nach dem Entpacken den Tomcat neu starten oder im Menüpunkt "Komponenten verwalten" -> ganz unten in der Liste den Button "Komponentenkonfiguration neu in die Datenbank einlesen" wählen, damit die Jobs eingelesen werden.

Neue Komp. Verwaltung BI


  • Wenn Sie über die vor 2024.06 aktive "alte Komponentenverwaltung" installieren, dann wählen Sie das Modul "Berichtsassistent" und den Installieren Button aus:

Komp. Verwaltung BI

Danach starten Sie Tomcat neu, bzw. leeren den Cache im Webanwendung Manager. Eine Hauptladeroutine gibt es derzeit nicht, wohl aber eine Upgrade Funktion. Nach einer Neuanmeldung sollten Sie im Menü "Standardberichte konfigurieren" ganz oben den Menüpunkt "Berichtsassistent" finden.

Installation aus dem git Repository

Laden Sie zunächst das Environment von SuperX, so dass die Umgebungsvariables $SUPERX_DIR und $WEBAPP gesetzt sind. Führen Sie dann folgende Shell-Befehle aus: 

git clone https://git.campussource.de/git/SuperX/rpta.git
cd rpta
cat superx/WEB-INF/conf/edustore/db/bin/SQL_ENV_rpta.sam >> $SUPERX_DIR/db/bin/SQL_ENV
. $SUPERX_DIR/db/bin/SQL_ENV
ant  -DMODULE_PATH=$RPTA_PFAD -DBASE_DIR=. -DWEBAPP=$WEBAPP -DMODULE=rpta all
cd $RPTA_PFAD
module_install.x rpta .

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

attention.svg Beim Download des Pakets wird die Datei $WEBAPP/WEB-INF/reports/simple_table.jrtx überschrieben. Wenn Sie die angepaßt haben müssen Sie die sichern.

Vorgehen beim Upgrade

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

  • Sichern Sie die Datei .../webapps/superx/WEB-INF/reports/simple_table.jrtx, sie wird sonst überschrieben
  • 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/rpta/upgrade mit
rpta_upgrade.x

aus.

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

Konfiguration

Virtuelle Tabellen, Spalten und Spaltenlayouts verwalten

Im Berichtswesen gibt es oft die Notwendigkeit, häufig wiederkehrende Abfragen in speziellen Spaltenlayouts zu speichern. Früher bot SuperX nur die Möglichkeit

  • neue Masken zu erzeugen, oder
  • Lesezeichen anzulegen

In dem Modul können Sie auf der Basis des SuperX-Datenmodells

  • virtuelle Tabellen anlegen
  • diesen virtuellen Tabellen beliebig viele Spaltenlayouts zuordnen
  • die Spaltenlayouts dann flexibel anpassen bzgl. Namen, Sortierung, Sichtbarkeit, Inhalt und Erläuterungstext

Siehe auch:


Beispiel eines Spaltenlayouts im Bereich Studierende

In der Auslieferung gibt es eine Beispielanwendung, die Studierendenauswertungen flexibel für Landes- oder interne Zwecke ausgeben kann. Das Ziel ist z.B. die beigefügte Tabelle fürs Ministerium in NRW:

Muster MKW NRW

Die Datengrundlage ist eine Tabelle mit Studierendendaten. Diese wird im folgenden beschrieben.

Virtuelle Tabelle Studierende amtlich und intern

Nach Login mit einer Admin-Kennung haben Sie Zugriff auf das Menü Abfragen - Berichtsassistent - Administration Berichtsassistent, dort die Maske Spalten und Spaltenlayouts verwalten. Dort unter "Weitere Einstellungen" finden Sie die Verwaltung der virtuellen Tabellen.

Liste


Die virtuelle Tabelle "Studierende amtlich und intern" beinhaltet

  • die Studierenden-Statistik, und dazu verlinkt
  • die Merkmale der Studiengänge (amtlich und intern)
  • die amtlichen Studienformen
  • die amtlichen Studientypen
  • die amtlichen Studienarten
  • die amtlichen Standorte
  • die Hörerstatus

Das Detailformular zeigt die Quelltabellen und Felder:

Liste

Dieses Beispiel sollten Sie nicht ändern, es dient nur als Beispiel in der Auslieferung.

Spalten verwalten

Nach Login mit einer Admin-Kennung haben Sie Zugriff auf das Menü Abfragen - Berichtsassistent - Administration Berichtsassistent, dort die Maske Spalten und Spaltenlayouts verwalten:

Maske

Im Ergebnis finden Sie die definierten Spalten:

Tabelle

Sie können die Definition der Spalten abrufen, hier das Beispiel des Standortes (amtlich):

Einzelbearbeitung

Es gibt folgende Spaltentypen:

  • Physische Spalten: direkte Übergabe des Wertes aus der Quelltabelle
  • Logische Spalten: SQL-Formeln oder Transformationen von physischen Spalten in neue Spalten, z.B. Alterswerte zu Altersgruppen. Im Feld "Funktion" wird die Formel hinterlegt, siehe unsere Beispiele
  • Lookup-Spalten: Ein Feld wird aus anderen Tabelle/n nachgeladen
  • Weiterverarbeitende Spalten: Nachdem die Basisdaten geladen wurden, können diese in einem 2. Schritt (Anlegen einer weiteren tmp_table) weiterverarbeitet werden.
  • Berechnete Spalten: Kurz vor Berichtsausgabe kann man Berechnungen vornehmen, z.B. Prozentwerte berechnen. Im Feld "Funktion" wird die Formel hinterlegt, siehe unsere Beispiele.


Spaltenlayouts verwalten

Ausgehend vom obigen Beispiel-Muster benötigen wir eine Tabelle mit Studierendensummen mit einem Filter auf

  • Haupt- und Nebenhörer
  • Stichtag amtl. Statistik
  • ohne Beurlaubte
  • 1. und 2. Studiengang, 1.-4. Fach
  • Studierende in der Regelstudienzeit

Die Tabelle enthält folgende Spalten:

  • Hochschulnummer Statistik (amtl. Standortnummer)
  • HSF-Schlüssel (amtl. Studienfach)
  • Art des Studiums (amtl. Studienform)
  • Abschlussschlüssel Statistik NRW (amtl. Abschluss)
  • Vollzeit / Teilzeit / ausbildungsintegriert / praxisintegriert / berufsintegriert (amtl. Studiumstyp)
  • Angabe der Regelstudienzeit (in Semestern)
  • Anzahl der Studierenden in der Regelstudienzeit

Die Benennung der Spalten sollte exakt mit dem Muster übereinstimmen.

Zunächst die Tabellendefinition: Filter wie Stichtag, Hörerstatus und Status können wir wie gewohnt in der Maske als Felder anbieten, und die Filter

  • 1. und 2. Studiengang, 1.-4. Fach
  • Studierende in der Regelstudienzeit

definieren wir direkt im Spaltenlayout. Wir gehen dazu in das Menü Abfragen - Berichtsassistent - Administration Berichtsassistent, dort die Maske Spalten und Spaltenlayouts verwalten. Dort unter "Weitere Einstellungen" finden Sie die Verwaltung der Spaltenlayouts:

rpta spaltenlayout sos stud astat rsz mwk10.png

Das Feld "Bedingung (optional)" definiert die Filter auf der virtuellen Tabelle. Da manche Hochschulen Studiengänge ohne Regelstudienzeit mit einem sehr hohen Wert versehen (z.B. 99), wird ein Filter auf eine "übliche" Regelstudienzeit zwischen 1 und 20 Semestern gesetzt.

Im Beschreibungsfeld darunter wird eine textuelle Beschreibung im Sinne einer Legende angeboten. Diese wird in der späteren Berichtsausgabe dann unter der Legende erscheinen.

Die eigentlichen Spalten werden in dem Unterformular angezeigt, mit Klick auf die jew. Details können Sie die Bezeichnung der Spalte und Layoutmerkmale angeben, sowie einen Erläuterungstext:

rpta spaltenlayout sos stud astat rsz mwk8.png

Den fertigen Bericht können Sie hier abrufen: In der Maske definieren Sie die Ergebnismenge

rpta spaltenlayout sos stud astat rsz mwk20.png

und die Tabelle gibt die Studierendensummen exakt im Layout des Musters aus:

rpta spaltenlayout sos stud astat rsz mwk30.png

Die Sortierung erfolgt in der Reihenfolge der Spalten jeweils aufsteigend.

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.

Abgerufen von „https://superxhosting.de/wiki/index.php?title=Modul_Berichtsassistent_Konfigurationshandbuch&oldid=14029“