Modul ETL Nutzungshandbuch

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 im Browser

Vorbemerkung:

Fürs Entladen und Hochladen im Browser haben wir einen Lehrfilm vorbereitet. Die verwendete Version ist zwar veraltet, aber das Grundprinzip wird erläutert.

Im Menü Abfragen -> Laderoutinen -> Administration Laderoutinen -> Laderoutinen verwalten können Sie unter "weitere Einstellungen" den ETL-Manager aufrufen. Dort im Reiter "Masken" können Sie Masken exportieren und importieren.

Zunächst geben Sie die Maskennummer an, im Feld "tid". Dann klicken Sie auf

anzeigen: der exportierte XML wird im großen Textfeld darunter angezeigt.
herunterladen: der Button prozuziert ein XML, das unbeeindruckt vom jeweils verwendeten Betriebssystem und Browser exakt dem Format entspricht, das auch die Kommandozeile erzeugt. Die ist für die Differenz-Ansicht von Versionierungstools nützlich, z.B. für den git-Abgleich. Siehe Screenshot:

Im XML-Export werden anders als bei den Shellscripten sx_select_mask / sx_insert_mask auch die verknüpften Daten exportiert, also

das Elternelement im Themenbaum
zugewiesene Stylesheets und deren Metadaten
den zugewiesenen Stylesheets wiederum zugewiesenen Spalten-Vorbelegungen

Die Stylesheets bzw. JasperReports selber werden nicht mit exportiert, weil diese im Dateisystem liegen und in der Regel per git verwaltet werden.

Entladen von Masken im Browser

Das Hochladen von Masken funktioniert analog, gehen Sie dazu ins Menü "Masken-Quellcode importieren". Dort geben Sie die TID der Ziel-Maske ein (im Sinne einer Sicherheitsabfrage), und fügen den XML im großen Textfeld darunter ein, und klicken dann auf "Importieren".

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 via Kommandozeile

Um eine Maske aus einer XML-Datei in die Datenbank zu importieren 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

Entladen und Hochladen von anderen Tabellengruppen

Neben Masken können auch andere Tabellengruppen entladen und auf einer anderen Säule hochgeladen werden:

Sichten
Testfälle (sofern das QA Modul installiert ist)
Spaltenlayouts (sofern das RPTA-Modul installiert ist

Entladen und Hochladen von anderen Tabellengruppen per Kommandozeile

Sie können per Kommandozeile folgende Tabellengruppen entladen und hochladen:

Benutzer- und Gruppenrechte (ohne kamerale Rechte)
Sichten
Beschriftungen

Hier die Syntax am Beispiel von Benutzer- und Gruppenrechten:

etl_execute_unload_job.x  -Jobname-  -Filter-  -Ausgabedatei-

Also z.B.

etl_execute_unload_job.x  unload_users_and_groups  0  users.xml
etl_execute_unload_job.x  unload_sichten  0  sichten.xml
etl_execute_unload_job.x  unload_sx_captions  0  sx_captions.xml

Das Hochladen funktioniert analog:

etl_execute_upload_job.x  -Jobname-  -Filter-  -Eingabedatei-

Hier analog die Beispiele:

etl_execute_upload_job.x  upload_users_and_groups  0  users.xml
etl_execute_upload_job.x  upload_sichten  0  sichten.xml
etl_execute_upload_job.x  upload_sx_captions  0  sx_captions.xml