Version vom 16. Juli 2023, 11:28 Uhr

Installation

Voraussetzungen

Sie benötigen
- in SuperX das Kernmodul 5.0 oder höher (noch nicht veröffentlicht)
- in HISinOne-BI die Version 2022.06 oder höher
- in beiden Fällen ist nur die Zeichencodierung UTF-8 mit DBMS Postgres nutzbar (also kein ISO, und somit kein Informix)
- Fürs Deployment aus dem git Repository die Software ANT, Anleitung zur Installation siehe hier.
  - Nutzer_innen von Eclipse haben ANT bereits integriert unter "Run" -> "External tools".

Vorgehen bei Neuinstallation - kurz und knapp

Download

Sie können das Modul aus dem SuperX-Downloadbereich herunterladen, oder direkt das git-Repository laden (s.u.).

Zum Download eines fertigen Pakets:
- Laden Sie das zu Ihrer Platform (SuperX / HISinOne-BI) und DBMS (Postgres / Informix) passende Modul herunter und speichern Sie es
  - Bei SuperX in $SUPERX_DIR
  - Bei HISinOne-BI in dem Ordner .../webapps/superx
- Entpacken Sie das Modul mit

 tar -xzvf Dateiname

Zur Installation direkt aus dem git Repository:

git clone https://git.campussource.de/git/SuperX/viz.git
cd viz
ant  -DMODULE_PATH=$VIZ_PFAD -DBASE_DIR=. -DWEBAPP=$WEBAPP -DMODULE=viz all

wobei VIZ_PFAD den Zielordner unter ...db/module/viz enthält, und WEBAPP den Ordner .../webapps/superx

Installation unter SuperX

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:

cat $SUPERX_DIR/db/bin/SQL_ENV_viz.sam >> $SUPERX_DIR/db/bin/SQL_ENV
. $SUPERX_DIR/db/bin/SQL_ENV
cd $VIZ_PFAD
module_install viz .

Eine Hauptladeroutine wird derzeit noch nicht genutzt. Danach bitte Tomcat neu starten, und dann ist das Modul einsatzbereit.

Installation unter HISinOne-BI

Installieren Sie das modul wie gewohnt über die Komponentenverwaltung. Eine Hauptladeroutine wird derzeit noch nicht genutzt. Danach bitte Tomcat neu starten, und dann ist das Modul einsatzbereit.

Weitere Installationsschritte

Repository und XML-Ordner

Damit die Funktionen in den Standardberichten nutzbar sind muss sie Repository-Variable CUSTOMXMLADD aus dem Inhalt der Datei .../db/module/viz/schluesseltabellen/customxmladd.sql befüllt werden.

Nur für SuperX Kern 4.9 bzw. HISinOne-BI bis Version 2023.06: Damit das Visualisierungs-Icon in der Buttonleiste über der Ergebnistabelle erscheint, müssen Sie den Inhalt des Template

.../webapps/superx/xml/pageComponents_html_final_viz.xsl.sam

in Ihre Datei .../webapps/superx/git/viz/superx/xml/pageComponents_html_final.xsl einfügen.

Danach muss man im Webanwendung Manager den Cache leeren. Ein Tomcat Neustart ist nicht nötig.

Konfiguration und Beispiel

Parameterpflege

Über die Auswahlschritte Administration Visualisierungen > Visualisierungen verwalten können Sie die Visualisierungsparameter konfigurieren.

Parameterbereich

Sobald Sie den Mauszeiger über das Dialogelement Weitere Einstellungen bewegen, wird das oben sichtbare PullDown-Menü eingeblendet.

Parameterliste

Die Liste bereits definierter Eigenschaften, Eigenschaftsgruppen oder Diagrammtypen wird gemäß der gewählten Menüoption dargestellt.

Merkmalsdetails eines Listenelementes können Sie im Editiermodus, erreichbar über das Stift-Icon, bearbeiten.
Je Listenelement können Sie die in der Tabelle sichtbaren Spaltenparameter anpassen und über das Disketten-Icon speichern.
Ungewünschte Listenelemente können Sie über das Mülleimer-Icon löschen.

Parameterdetails

Der Bearbeitungsdialog für Merkmalsdetails (hier: Bsp. Diagrammeigenschaften) öffnet sich nach Wahl des Editiermodus und umfasst die in der Abbildung sichtbaren und in der Tabelle erläuterten Felder.

Feldname	Bedeutung für Grafikelemente systemintern	Bedeutung für Grafikelemente im VIZ-Dialog	Auswahlmöglichkeit für Grafikelemente
tid	Identifikator		nein
Bezeichnung		Merkmalsname	beliebig
Schlüssel	Merkmalsname		nein
Defaultwert		Standardwert	leer oder numerisch
Einheit		Maßeinheit	px, em
Datentyp	Datentyp		integer, string, boolean, date
Generische Eigenschaft	Gilt für alle Grafiktypen		0=nein; 1=ja
Pflichteingabe		Eingabezwang	0=nein; 1=ja
Eingabedialog		Eingabeart	Schieberegler, Texteingabe, Select-Liste, großes Textfeld, Farbauswahl
Wertebereich (statisch)	Gilt nur für Select-Liste
Minimalwert		Wertgrenzen-Minimum	leer oder numerisch
Maximalwert		Wertgrenzen-Maximum	leer oder numerisch
Art der Eigenschaft		Merkmalsgruppen-Zuordnung	eine Eigenschaftsgruppe
Erläuterung		Tooltip-Erläuterungstext	beliebig
Sortiernummer		Merkmalsposition	numerisch
Renderer	Renderername		Observable Plot, D3JS
	Variablenname		wie "Schlüssel" (sh. oben)

Beispiel-Dashboard

Im VIZ Modul wird ein Beispiel-Dashboard auf der Basis vom Studierenden-Datenblatt mitgeliefert. Dies ist nur nutzbar wenn Sie auch das Studierenden-Modul 1.3 oder höher installiert haben. Wenn nicht, sollten Sie die beiden Masken

Studierenden-Entwicklung
Studierende Datenblatt (Teiltabelle)

im Themenbaum unsichtbar machen.

Upgrade

Upgrade unter SuperX

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

Führen Sie den Patch in der Shell im Verzeichnis $SUPERX_DIR/db/module/viz/upgrade mit

viz_upgrade.x

aus. Danach bitte Tomcat neu starten.

Upgrade unter HISinOne-BI

Upgraden Sie das Modul wie gewohnt über die Komponentenverwaltung. Danach bitte Tomcat neu starten.

@@ Zeile 71: / Zeile 71: @@
 Der Bearbeitungsdialog für Merkmalsdetails (hier: Bsp. Diagrammeigenschaften) öffnet sich nach Wahl des Editiermodus und umfasst die in der Abbildung sichtbaren und in der Tabelle erläuterten Felder.
 {| class="wikitable sortable"
 |-
-!
+!<span style="color: rgb(0, 0, 255);" data-mce-style="color: #0000ff;"> '''Feldname '''</span><br />
-! Bedeutung für Grafikelemente
+!<span style="color: rgb(0, 0, 255);" data-mce-style="color: #0000ff;"> Bedeutung für Grafikelemente</span>
-!
-!
-!
-! Bedeutung für Diagrammtypen
-|-
-! '''Feldname '''<br />
+<span style="color: rgb(0, 0, 255);" data-mce-style="color: #0000ff;">systemintern</span>
-! systemintern
-! im VIZ-Dialog
-! Auswahlmöglichkeit
+!<span style="color: rgb(0, 0, 255);" data-mce-style="color: #0000ff;">Bedeutung für Grafikelemente</span>
-! Beispiel
-! Diagrammtypen
+<span style="color: rgb(0, 0, 255);" data-mce-style="color: #0000ff;"> im VIZ-Dialog</span>
+!<span style="color: rgb(0, 0, 255);" data-mce-style="color: #0000ff;"> Auswahlmöglichkeit</span>
+<span style="color: rgb(0, 0, 255);" data-mce-style="color: #0000ff;">für Grafikelemente</span>
+!<span style="color: rgb(0, 0, 255);" data-mce-style="color: #0000ff;"> Bedeutung für Diagrammtypen</span>
 |-
@@ Zeile 94: / Zeile 99: @@
 |
 |  nein
-| 16
 |
 |-
@@ Zeile 101: / Zeile 105: @@
 | Merkmalsname
 | beliebig
-| Außenrand links
 |
 |-
@@ Zeile 108: / Zeile 111: @@
 |
 |  nein
-| marginLeft
 |
 |-
@@ Zeile 115: / Zeile 117: @@
 |  Standardwert
 | leer oder numerisch
-| 100
 |
 |-
@@ Zeile 122: / Zeile 123: @@
 | Maßeinheit
 | px, em
-|
 |
 |-
@@ Zeile 129: / Zeile 129: @@
 |
 | integer, string, boolean, date
-| integer
 |
 |-
@@ Zeile 136: / Zeile 135: @@
 |  <br />
 | 0=nein; 1=ja<br />
-| 0
 |
 |-
@@ Zeile 143: / Zeile 141: @@
 | Eingabezwang
 | 0=nein; 1=ja
-| 0
 |
 |-
@@ Zeile 150: / Zeile 147: @@
 | Eingabeart
 | Schieberegler, Texteingabe, Select-Liste, großes Textfeld, Farbauswahl
-|
 |
 |-
@@ Zeile 157: / Zeile 153: @@
 |
 |  <br />
-| <br />
 |
 |-
@@ Zeile 164: / Zeile 159: @@
 | Wertgrenzen-Minimum
 | leer oder numerisch
-| leer
 |
 |-
@@ Zeile 171: / Zeile 165: @@
 | Wertgrenzen-Maximum
 | leer oder numerisch
-| leer
 |
 |-
@@ Zeile 178: / Zeile 171: @@
 | Merkmalsgruppen-Zuordnung
 | eine Eigenschaftsgruppe
-| Größe und Ränder
 |
 |-
@@ Zeile 185: / Zeile 177: @@
 | Tooltip-Erläuterungstext
 | beliebig
-| Abstand zwischen Grafik und linkem Hintergrundrand
 |
 |-
@@ Zeile 192: / Zeile 183: @@
 | Merkmalsposition
 | numerisch
-| 103
 |
 |-
@@ Zeile 199: / Zeile 189: @@
 |
 | Observable Plot, D3JS
-| Observable Plot
 |
 |-
@@ Zeile 206: / Zeile 195: @@
 |
 | wie "Schlüssel" (sh. oben)
-| marginLeft
 |
 |}

Modul Visualisierung Konfigurationshandbuch: Unterschied zwischen den Versionen