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. |
Das Hochladen von Masken funktioniert analog, gehen Sie dazu ins Menü "Masken-Quellcode importieren". Dort geben Sie die TID der Maske ein, 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:
- Benutzer- und Gruppenrechte (ohne kamerale Rechte)
- Sichten
- Beschriftungen
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
