Zuletzt bearbeitet vor 9 Monaten
von Daniel Quathamer

Modul ETL 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_etl.sam im gleichen Verzeichnis:
cat $SUPERX_DIR/db/bin/SQL_ENV_etl.sam >>$SUPERX_DIR/db/bin/SQL_ENV
  • In der SQL_ENV müssen Sie, sofern noch nicht geschehen, den JDBC_CLASSPATH um die servlet-api.jar des jew. Tomcat erweitern, und (nur bei SuperX standalone) die Variable SUPERX_DIR an die CATALINA_OPTS anhängen:
    • SuperX:
JDBC_CLASSPATH="$SUPERX_DIR/webserver/tomcat/lib/servlet-api.jar:$LIB_PATH/ant.jar" ; for i in `ls $LIB_PATH/*.jar` ; do JDBC_CLASSPATH=$JDBC_CLASSPATH:$i ; done ; XML_CLASSPATH=$JDBC_CLASSPATH
CATALINA_OPTS="$CATALINA_OPTS -DSUPERX_DIR=$SUPERX_DIR"
    • HISinOne unter Ubuntu:
JDBC_CLASSPATH="$WEBAPP/WEB-INF/classes:/usr/share/tomcat8/lib/servlet-api.jar:$LIB_PATH/ant.jar" ; for i in `ls $LIB_PATH/*.jar` ; do JDBC_CLASSPATH=$JDBC_CLASSPATH:$i ; done ; XML_CLASSPATH=$JDBC_CLASSPATH

Danach laden Sie die SQL_ENV neu und starten die Installation:

. $SUPERX_DIR/db/bin/SQL_ENV
cd $ETL_PFAD
module_install.x etl .

Upgrade

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

. $SUPERX_DIR/db/bin/SQL_ENV
cd $ETL_PFAD/upgrade
etl_upgrade.x

Konfiguration

Nutzung

Entladen und Hochladen von Masken

Bisher wurden Masken im sog. "XUPDATE"-Format exportiert nach XML. Dieses Format haben wir weiterentwickelt:

Eine Maske wird definiert aus mehreren Tabellen, d.h.

  • Name und Quellcode der (Erzeugung der) Ergebnistabelle
  • Maskenfelder
  • Sachgebietszuordnung
  • Komponentenzuordung
  • Themenbaum-Zuordnung
  • (Optional) Stylesheets
  • (Optional) Bei Datenblättern auch die Zuordnung von JasperReports-Dateien zu Spalten im Datenblatt

Entladen von Masken

Um Masken in ein "menschenlesbares" Format zu überführen, bietet sich XML als Exportformat an. Um einen Maske nach XML zu exportieren können Sie die Browseroberfläche oder die Kommandozeile nutzen

Entladen von Masken via Browser

Sie gehen ins Modul Laderoutinen -> Administration Laderoutinen -> Laderoutinen verwalten...

Entladen von Masken via Kommandozeile

Mit folgendem Befehl entladen Sie eine Maske in eine Datei:

etl_sx_select_mask.x -Maskennummer- 

Also z.B.

etl_sx_select_mask.x 16000 

Entlädt die erste Maske des Studierenden-Moduls im aktuellen Verzeichnis in die Datei 16000.xml.

Optional können Sie auch einen Namen der Ausgabedatei festlegen

Hochladen von Masken

Um Masken in ein "menschenlesbares" Format zu überführen, bietet sich XML als Exportformat an. Um einen Maske nach XML zu exportieren führen Sie in der Kommandozeile aus

etl_sx_insert_mask.x -Maskennummer- 

Also z.B.

etl_sx_insert_mask.x 16000

lädt die erste Maske des Studierenden-Moduls im aktuellen Verzeichnis in der Datei 16000.xml hoch.

Optional können Sie auch mit weiteren Argumenten

  • Einen Namen der Eingabedatei festlegen
  • Die Sicherheitsabfrage mit "J" ausschalten