Modul COSTAGE Administrationshandbuch

Installation

Erstinstallation

Wenn Sie die Installationsdatei heruntergeladen und entpackt haben, gehen Sie wie folgt vor:

• Ergänzen Sie den Inhalt der Datei $SUPERX_DIR/db/bin/SQL_ENV und den Inhalt der Datei SQL_ENV_costage.sam im gleichen Verzeichnis:

cat $SUPERX_DIR/db/bin/SQL_ENV_costage.sam >>$SUPERX_DIR/db/bin/SQL_ENV

Danach laden Sie die SQL_ENV neu und starten die Installation:

. $SUPERX_DIR/db/bin/SQL_ENV
cd $COSTAGE_PFAD
module_install.x costage .

Upgrade

Wenn Sie die Installationsdatei heruntergeladen und entpackt haben, gehen Sie wie folgt vor:

. $SUPERX_DIR/db/bin/SQL_ENV
cd $COSTAGE_PFAD/upgrade
costage_upgrade.x

Rohdaten aus CAMPUSonline

Zum Bereitstellen der Rohdaten aus CAMPUSonline gibt es zwei Wege:

• Export in CSV-Dateien
• Direktes Entladen über ein SuperX Entladescript (JDBC)

Beide Wege werden im folgenden beschrieben.

Export in CSV Dateien

Wenn Sie aus CAMPUSonline entladen, müssen die Views der DWH-Schnittstelle nach CSV exportiert werden. Auf der Seite http://www.superx-projekt.de/doku/costage_modul/costage_unload.html finden Sie die aktuellen Views in der Spalte "Kurztitel". Beachten Sie, dass alle Spalten in der von CAMPUSonline vorgesehenen Reihenfolge vorliegen.

Der CSV "Dialekt" muss wahrscheinlich an SuperX angepaßt werden. Dazu wird ein Script mitgeliefert, das

• Ggf. vorhandene HEADER-Zeilen entfernt
• Spalten-Trennzeichen nach dem in SuperX üblichen "Dach" ändert
• Zeilenumbrüche in langen Textfeldern maskiert mit Backslash
• Ggf. vorhandene ISO Codierung nach UTF-8 ändert
• Wenn eine Datei gar nicht existiert wird eine leere UNL-Datei engelegt, damit der eigentliche SuperX-Konnektor nicht abbricht.
• Mit dem Script können Sie relativ schnell prüfen ob die Unload Dateien zur Schnittstellenbeschreibung passen.

Das Script liegt im Verzeichnis $COSTAGE_LOAD_PFAD. Es geht davor aus dass die CSV-Dateien im Unterverzeichnis unl liegen. Der Aufruf lautet

costage_prepare_unlfiles.x <Delimiter> HEADER<optional>"

Beispiel:

costage_prepare_unlfiles.x , HEADER

Damit werden CSV Daten mit "," getrennt und Spaltenüberschriften eingelesen. Danach werden sie im UNL-Format mit den richtigen Dateinamen für SuperX gespeichert.

Wenn Sie neben der Umformatierung auch Transformationen benötigen, wird auch ein Script mitgeliefert

rohdaten/csv_unloads2unl.sql

Sie können das Script anpassen an Ihre CSVs und dann mit DOSQL ausführen.

Entladen aus CAMPUSonline

Beim Entladen aus CAMPUSonline (CO) wird Der Entladeparameter DATABASE ist bei CO ohne Belang, denn das DMBS in CO ist in der Regel Oracle. Daher müssen Sie dem Tomcat-Server in .../webapps/superx/WEB-INF/lib den JDBC-Treiber von Oracle (Dateiname z.B. ojdbc6.jar) mitgeben.

Die Konfiguration wird in den Dateien

rohdaten/COSTAGE_ENV
rohdaten/db-co.properties

vorgenommen, für beide Dateien gibt es Musterdateien mit der Endung ".sam".

Details zur Konfiguration finden Sie im Kernmodul-Handbuch. Das Entladen starten Sie mit

costage_unload.x

Logmeldungen finden Sie in der Datei

costage_unload.err

Konfiguration

Entladeparameter

Nur für den Unload aus CO per JDBC: In der Datei $COSTAGE_LOAD_PFAD/COSTAGE_ENV können Sie folgende Variablen nutzen:

Entladeparameter

Parametername	Beschreibung	Defaultwert	Wertebereich	ab Version	Parametergruppe	Priorität	Vorsystem	Komponente
VERSION	Version des Vorsystems. Wird derzeit nicht ausgewertet.	2	2		Systemparameter	1	0	CO-Basisdaten
COSTAGE_start_st_sem	Startsemester Studierende Ab welchem Semester sollen Studierende entladen werden? z.B. 20011 für SS 2001	19911	SEMESTER	0.3	Systemparameter	1	0	CO-Basisdaten
COSTAGE_start_leistungen_sem	Startsemester Prüfungen Ab welchem Semester sollen Prüfungen entladen werden? z.B. 20021 für SS 2002	19911	SEMESTER	0.3	Systemparameter	1	0	CO-Basisdaten
COSTAGE_start_bw_sem	Startsemester Bewerbungen Ab welchem Semester sollen Bewerbungen entladen werden? z.B. 20021 für SS 2002	19911	SEMESTER	0.3	Systemparameter	1	0	CO-Basisdaten

Konstanten

Teilstudiengänge generieren

Mit der Konstante "COSTAGE_TSG_GENERATE" können Sie geschlossene Teilstudiengänge für einzelne Semester generieren und den Status aus dem MSG übernehmen. Dies betrifft wahrscheinlich nur Hochschulen in Deutschland, die in CO sog. "Mehrfachstudiengänge" (MSG) nutzen, z.B. im Lehramt. Wir wollen das an einem Beispiel illustrieren. Wenn ein/e Studierende/r z.B. Lehramt Sonderpädagogik mit 5 Fächern studiert:

• Sprachliche Grundbildung
• Kath. Religion (bis SoSe 2021)
• Emotionale / soziale Entwicklung
• Lernen FSP
• Bildungswissenschaften
• Ästhetische Erziehung (ab WiSe 2021/2022)

Dabei werden die einzelnen Teilstudiengänge (TSG) ggf. zu unterschiedlichen Semestern beendet. Am längsten läuft der TSG, in dem dann auch die Abschlussarbeit geschrieben wird. Hier ein Screenshot:

Die rot umrandeten Zellen sind Semester, in denen in CO kein Datensatz mehr vorhanden ist. Nehmen wir das WiSe 2022/2023: Nur im rechten Fach "Bildungswissenschaft" sowie "Ästhetische Erziehung" (jeweils grün umrandet) zählt das Semester bzw. Fachsemester noch hoch. Wenn wir die Datensätze für eine Fallstatistik zählen würden, dann wären die Studierenden in den rot umrandeten Semester gar nicht mehr vorhanden, obwohl die Studierenden im MSG noch eingeschrieben sind. Für Statistiken auf Fallebene wäre es aber korrekter, wenn die Studierenden im rot umrandeten Semester mit dem jeweiligen Status des MSG und dem letzten Fachsemester des TSG gezählt würden. Um dies zu erreichen, kann SuperX die rot umrandeten Datensätze künstlich generieren. Im Datenblatt wären solche Datensätze auch als "Automatisch generiert" erkennbar. Hier ein Screenshot aus SuperX, wenn die Konstante "COSTAGE_TSG_GENERATE"=1 gesetzt ist:

Es gibt neben dem Rückmeldestatus (amtlich)=3 (-> Rückgemeldet) auch einen Studienstatus im TSG, der separat betrachtet werden kann.

Nach einer Änderung der Konstante COSTAGE_TSG_GENERATE müssen Sie die Hauptladeroutine neu ausführen.

Hochschul-Repository

Es werden folgende Repository-Variablen vorgegeben:

Repository Variable COSTAGE_STUDENT_FILTER

Welche Studierenden sollen ausgewertet werden

Im folgenden eine Erläuterung. Am Anfang der Inbetriebnahme ist es nützlich, auf einzelne Studierenden/Gruppen einzuschränken. Sie müssen dabei Matrikelnummern oder andere Personmerkmale mit dem Alias "S." für die Tabelle Studierendenstammdaten verwenden. Beispiele für COSTAGE_STUDENT_FILTER:

• Einzelne Studierende:

S.matrikelnummer in ('1234567','7654321')

• Ohne Personentyp "Test":

S.personentyp_kb != "TEST'

Die Voreinstellung ist "1=1", d.h. kein Filter.

Nach einer Änderung müssen Sie die Hauptladeroutine neu ausführen.

Start der Laderoutine

Wenn die Rohdaten im Ordner

$SUPERX_DIR/db/module/costage/rohdaten/unl/

vorhanden sind, können Sie den Konnektor starten mit

cd $SUPERX_DIR/db/module/costage/
module_etl.x costage .

Die Logausgabe ist Superx-typisch in mehrere Abschnitte eingeteilt, Details siehe Kernmodul-Handbuch.

Weiterverarbeitung im Studierenden Modul SuperX

Wenn die Daten in COSTAGE geladen sind, können sie als Datenquelle für das Studierenden Modul in SuperX genutzt werden. Dazu gehen Sie wie folgt vor:

Setzen Sie in Ihrer SQL_ENV den Wert von SOS_LOAD_PFAD auf COSTAGE:

SOS_LOAD_PFAD=$COSTAGE_PFAD/rohdaten_sos
export SOS_LOAD_PFAD

Im Unterverzeichnis "costage/rohdaten_sos" führen Sie dann das Entladescript

sos_costage_unload.x

aus. Es werden Rohdaten im Unterordner "unl" erzeugt. Diese dienen als Datenquelle für das Studierenden Modul:

cd $SOS_PFAD
sos_update.x

Damit das funktioniert müssen die Versionen zueinander passen. Derzeit ist das COSTAGE-Modul 0.3 passgenau mit dem Studierenden Modul 1.3. Ältere Versionen vom Studierenden Modul lassen sich nicht anbinden.