Zuletzt bearbeitet vor einem Jahr
von Daniel Quathamer

Datenabzüge (Datenblätter einfrieren): Unterschied zwischen den Versionen

Keine Bearbeitungszusammenfassung
 
(20 dazwischenliegende Versionen von einem anderen Benutzer werden nicht angezeigt)
Zeile 1: Zeile 1:
=Installation=
<!--Pendant im HIS-WIki https://wiki.his.de/mediawiki/index.php/Datenmanagement_-_HISinOne-BI#Daten_archivieren -->


1) Bei Bedarf Anpassen der Tabellennamen im Installationsskript und den XUpdates<br>
<!-- =Installation=
2) Felder/Spalten der existierenden Datenblätter mit den, durch das Installationsskript neu zu installierenden, Archiv-Datenblättern abgleichen<br>
3) Elternteil des Thembaumeintrages im Installationsskript festlegen<br>


{{ImagePara |imgsrc= Elternteil_Themenbaum.png|width=400|caption=Elternteil des Themenbaumeintrages festlegen}}<br>
Zur Installation müssen die XUpdates install.xml und 71860.xml eingespielt werden. Diese enthalten
# die create tables für arch_datum und arch_table
# die Masken "Datenblatt archivieren" und "Übersicht Datenblatt-Archiv"
# Einträge in arch_table für "sos_stg_aggr", "sos_lab_pord", "sos_lab_stg", "zul_antr_aggr", "lm_konto_pro_fs" -->


4) Installationsskript ausführen<br>
=Anwendung=
5) XUpdates einspielen<br>
<blockquote>
6) Webanwendundung Manager Cache leeren und neu einloggen
Die Berichte ermöglichen es, diverse Datenblätter an beliebigen Tagen zu archivieren. Um dies durchzuführen wird der Bericht "Datenblatt archivieren" genutzt. Der Bericht "Übersicht Datenblatt-Archiv" liefert eine Übersicht über bereits archivierte Datenblätter.
 
{{ImagePara |imgsrc=Datenblatt_Archivierung_1.png|width=800|caption=Auswahl des einzufrierenden Datenblattes}}<br>
</blockquote>
 
==Die Anwendungslogik==
Die Funktionalität wird als generische Funktion im Kernmodul bereitgestellt, d.h. neben dem Beispiel unten zur Studierendenstatistik lassen sich damit beliebige Faktentabellen in der BI archivieren.


=Anwendung=
Archiviert werden die Daten im ausgewählten Bezugszeitraum. Bei jeder Archivierung wird anhand der neuen Spalte 'Archivierungsdatum' und des gewählten Bezugszeitraumes geprüft, ob am jeweiligen Tag bereits archiviert wurde. Falls dies zutrifft, wird nicht erneut archiviert. Für den Fall, dass vom gewählten Bezugszeitraum bereits ein Teilzeitraum zum Archivierungsdatum archiviert wurde, wird ausschließlich der noch nicht archivierte Teilzeitraum archiviert.


Die Berichte ermöglichen es, diverse Datenblätter an beliebigen Tagen einzufrieren/zu archivieren. Um dies durchzuführen wird der Bericht "Datenblätter einfrieren" genutzt. Es wird das gewünschte Datenblatt ausgewählt und der Bericht abgeschickt.
Neben den Tabelleninhalten werden ebenso die Metadaten zur Tabelle und den zugehörigen Feldern kopiert (Tabellen sx_tables und sx_fields), damit Datenblatt-Masken damit arbeiten können.


{{ImagePara |imgsrc= Datenblaetter_einfrieren.png|width=800|caption=Auswahl des einzufrierenden Datenblattes}}<br>
==Ein Datenblatt archivieren==


Jedes der Archivdatenblätter erhält jeweils eine neue Spalte 'Archivierungsdatum'. Dort wird am Tag des Einfrierens/der Archivierung das aktuelle Datum erfasst. Die Archivdatenblätter werden über eigene Berichte abgerufen.
<blockquote>
In der Maske des Berichtes "Datenblatt archivieren" wird zunächst das gewünschte Datenblatt ausgewählt. Des Weiteren wird das 'Archivierungsdatum' und die 'Bezugszeit' angegeben. Optional wird ein Kommentar hinterlegt. Danach wird der Bericht abgeschickt.


==Die Anwendungslogik==
{{ImagePara |imgsrc=Datenblatt_Archivierung_2.png|width=700|caption=Auswahl des einzufrierenden Datenblattes}}<br>
Die Funktionalität wird als generische Funktion im Kernmodul bereitgestellt, d.h. neben dem Beispiel unten zur Studierenden- oder Prüfungsstatistik lassen sich damit beliebige Faktentabellen in der BI archivieren.


Generell werden nur Datensätze des jeweils aktuellen Semesters archiviert. Mit Ausnahme der ersten Archivierung. Bei dieser wird der gesamte Inhalt des Datenblattes (bzw. der zugrunde liegenden Faktentabelle) in die Archivtabelle übertragen. Bei jeder weiteren Archivierung wird anhand der neuen Spalte 'Archivierungsdatum' geprüft, ob am jeweiligen Tag bereits archiviert wurde. Falls dies zutrifft werden zunächst alle Datensätze mit tagesaktuellem Archivierungsdatum gelöscht und anschließend alle Datensätze des aktuellen Semesters archivert. Ansonsten werden lediglich die Datensätze des aktuellen Semesters der Archivtabelle hinzugefügt.
{{Achtung | Die Auswahl eines abweichenden Archivierungsdatums ändert nicht den archivierten Datenbestand. Es wird unabhängig vom gewählten Archivierungsdatum derselbe Datenbestand archiviert. Der Stand der Daten ist abhängig vom letzten Lauf der Hauptladeroutine.}}
Neben den Tabelleninhalten werden auch bei der Erst-Installation die Metadaten zur Tabelle und den zugehötigen Feldern kopiert (Tabellen sx_tables und sx_fields), damit Datenblatt-Masken damit arbeiten können.
</blockquote>


{{Achtung|Die Anwendungslogik hat zur Folge, dass am Tag der Erstarchivierung eines Datenblattes keine weitere Archivierung erfolgen darf. Ansonsten würden alle Datensätze gelöscht und nur die des aktuellen Semesters hinzugefügt werden. Daten aus früheren Semestern können über die "Datenblätter einfrieren"-Maske erst nach kompletter Leerung der Archivtabelle wieder in diese geschrieben werden.}}
<blockquote>
Als Ergebnistabelle erscheint ein Hinweistext, dass die Archivtabelle angelegt wurde inklusive der archivierten Zeiträume. Zudem wird sowohl die Gesamtzahl der eingefügten Datensätze, als auch die Anzahl der eingefügten Datensätze pro Zeitraum ausgegeben.


Es leiten sich zusamenfassend 3 Szenarien ab:
{{ImagePara |imgsrc=Datenblatt_Archivierung_3.png|width=700|caption=Auswahl des einzufrierenden Datenblattes}}<br>
#Erstarchivierung: Wurde ein Datenblatt noch nie archivert, werden alle Datensätze archivert.
</blockquote>
#Mehrere Archiverungen am selben Tag: Bei jeder weiteren Archivierung wird die vorherige Archiverung rückgängig gemacht und nur noch das aktuelle Semester archiviert.
#Einzelne Archivierung mindestens einen Tag nach der Erstarchivierung: Es wird nur das aktuelle Semester archiviert.


==Die archivierten Datenblätter abrufen==
<blockquote>
Falls am selben Tag erneut archiviert wird, sind verschiedene Szenarien denkbar:
# Der gewählte Bezugszeitraum entspricht exakt dem bereits archivierten Bezugszeitraum.
# Der gewählte Bezugszeitraum weicht vollständig vom bereits archivierten Bezugszeitraum ab.
# Der gewählte Bezugszeitraum überschneidet sich teilweise mit dem bereits archivierten Bezugszeitraum.
Im Falle des Szenario 1 wird nichts archiviert. Bei Szenario 2 wird der gewählte Bezugszeitraum vollständig archiviert. Bei Szenario 3 wird nur archiviert, was noch nicht archiviert wurde. Es erscheinen in der Ergebnistabelle Hinweistexte zu bereits archivierten und noch nicht archivierten Bezugszeiträumen. Im folgenden Screenshot ein Beispiel zu Szenario 3:


Die Archivdatenblätter finden sich unter dem selben Themenbaumeintrag wie "Datenblätter einfrieren".
{{ImagePara |imgsrc=Datenblatt_Archivierung_4.png|width=700|caption=Auswahl des einzufrierenden Datenblattes}}<br>
</blockquote>


{{ImagePara |imgsrc= Datenblaetter_historisch.png|width=800|caption=Auswahl der archivierten Datenblätter}}<br>
==Übersicht über archivierte Datenblätter abrufen==


Die Auswahlmasken Der Archivdatenblätter gleichen denen der bekannten, üblichen Datenblätter.
<blockquote>
In der Maske des Übersichtsberichtes wird ein Datenblatt gewählt. Weiterhin wird optional ein Archivierungsdatum und Bezugszeitraum selektiert. Im folgenden Beispiel, wird ein Archivierungsdatum gewählt, sodass alle Archivierungen des gewählten Tages, unabhängig von der Bezugszeit, ausgegeben werden.


{{ImagePara |imgsrc= Studierende_Datenblatt_historisch.png|width=800|caption=Auswahlmaske des Studierende Datenblatt historisch}}<br>
{{ImagePara |imgsrc=Datenblatt_Archivierung_5.png|width=800|caption=Auswahl des einzufrierenden Datenblattes}}<br>
</blockquote>


Die Ergebnistabellen enthalten dieselben Spalten, abgesehen von der zusätzlichen Spalte 'Archivierungsdatum' bei den Archivdatenblättern.
<blockquote>
Zum gewählten Datum wurde dreimal archiviert (jeweils rot markiert). Um 09:37 wurde der Bezugszeitraum 20172 bis 20192 archiviert. Um 09:38 nur 20161. Um 09:40 von 20142 bis 20171. Die Besonderheit bei der letzten Archivierung ist, dass das Semester 20161 zum zweiten Mal an diesem Tag archiviert wurde. Da dies am selben Tag nicht mehrfach möglich ist, findet sich für 09:40 und Semester 20161 eine 0 bei der Anzahl archivierter Datensätze.


{{ImagePara |imgsrc= Studierende_Datenblatt_historisch_Ergebnistabelle.png|width=800|caption=Ergebnistabelle des Studierende Datenblatt historisch}}<br>
{{ImagePara |imgsrc=Datenblatt_Archivierung_6.png|width=800|caption=Auswahl des einzufrierenden Datenblattes}}<br>
</blockquote>

Aktuelle Version vom 3. März 2024, 20:22 Uhr


Anwendung

Die Berichte ermöglichen es, diverse Datenblätter an beliebigen Tagen zu archivieren. Um dies durchzuführen wird der Bericht "Datenblatt archivieren" genutzt. Der Bericht "Übersicht Datenblatt-Archiv" liefert eine Übersicht über bereits archivierte Datenblätter.

Auswahl des einzufrierenden Datenblattes

Die Anwendungslogik

Die Funktionalität wird als generische Funktion im Kernmodul bereitgestellt, d.h. neben dem Beispiel unten zur Studierendenstatistik lassen sich damit beliebige Faktentabellen in der BI archivieren.

Archiviert werden die Daten im ausgewählten Bezugszeitraum. Bei jeder Archivierung wird anhand der neuen Spalte 'Archivierungsdatum' und des gewählten Bezugszeitraumes geprüft, ob am jeweiligen Tag bereits archiviert wurde. Falls dies zutrifft, wird nicht erneut archiviert. Für den Fall, dass vom gewählten Bezugszeitraum bereits ein Teilzeitraum zum Archivierungsdatum archiviert wurde, wird ausschließlich der noch nicht archivierte Teilzeitraum archiviert.

Neben den Tabelleninhalten werden ebenso die Metadaten zur Tabelle und den zugehörigen Feldern kopiert (Tabellen sx_tables und sx_fields), damit Datenblatt-Masken damit arbeiten können.

Ein Datenblatt archivieren

In der Maske des Berichtes "Datenblatt archivieren" wird zunächst das gewünschte Datenblatt ausgewählt. Des Weiteren wird das 'Archivierungsdatum' und die 'Bezugszeit' angegeben. Optional wird ein Kommentar hinterlegt. Danach wird der Bericht abgeschickt.

Auswahl des einzufrierenden Datenblattes

attention.svg Die Auswahl eines abweichenden Archivierungsdatums ändert nicht den archivierten Datenbestand. Es wird unabhängig vom gewählten Archivierungsdatum derselbe Datenbestand archiviert. Der Stand der Daten ist abhängig vom letzten Lauf der Hauptladeroutine.

Als Ergebnistabelle erscheint ein Hinweistext, dass die Archivtabelle angelegt wurde inklusive der archivierten Zeiträume. Zudem wird sowohl die Gesamtzahl der eingefügten Datensätze, als auch die Anzahl der eingefügten Datensätze pro Zeitraum ausgegeben.

Auswahl des einzufrierenden Datenblattes

Falls am selben Tag erneut archiviert wird, sind verschiedene Szenarien denkbar:

  1. Der gewählte Bezugszeitraum entspricht exakt dem bereits archivierten Bezugszeitraum.
  2. Der gewählte Bezugszeitraum weicht vollständig vom bereits archivierten Bezugszeitraum ab.
  3. Der gewählte Bezugszeitraum überschneidet sich teilweise mit dem bereits archivierten Bezugszeitraum.

Im Falle des Szenario 1 wird nichts archiviert. Bei Szenario 2 wird der gewählte Bezugszeitraum vollständig archiviert. Bei Szenario 3 wird nur archiviert, was noch nicht archiviert wurde. Es erscheinen in der Ergebnistabelle Hinweistexte zu bereits archivierten und noch nicht archivierten Bezugszeiträumen. Im folgenden Screenshot ein Beispiel zu Szenario 3:

Auswahl des einzufrierenden Datenblattes

Übersicht über archivierte Datenblätter abrufen

In der Maske des Übersichtsberichtes wird ein Datenblatt gewählt. Weiterhin wird optional ein Archivierungsdatum und Bezugszeitraum selektiert. Im folgenden Beispiel, wird ein Archivierungsdatum gewählt, sodass alle Archivierungen des gewählten Tages, unabhängig von der Bezugszeit, ausgegeben werden.

Auswahl des einzufrierenden Datenblattes

Zum gewählten Datum wurde dreimal archiviert (jeweils rot markiert). Um 09:37 wurde der Bezugszeitraum 20172 bis 20192 archiviert. Um 09:38 nur 20161. Um 09:40 von 20142 bis 20171. Die Besonderheit bei der letzten Archivierung ist, dass das Semester 20161 zum zweiten Mal an diesem Tag archiviert wurde. Da dies am selben Tag nicht mehrfach möglich ist, findet sich für 09:40 und Semester 20161 eine 0 bei der Anzahl archivierter Datensätze.

Auswahl des einzufrierenden Datenblattes