Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- tools:stud2flex_hio [2021/03/15 14:58] – angelegt sschmitz
+++ tools:stud2flex_hio [2021/03/17 09:04] – [Studienverläufe übernehmen (inkl. Stammdaten)] sschmitz
@@ Zeile 1: / Zeile 1: @@
 ===== Import aus HISinOne=====
-==== Schlüsselabgleich mit Fremdsystem ====
+Grundsätzliche Einstellungen speziell für HISinOne:
-<WRAP justify> Der Schlüsselabgleich mit dem SOS-System wird automatisch einmal pro Tag aktiviert. [Ausnahme: Die Schlüsseltabellen sollen manuell gepflegt werden und dies ist im Setup entsprechend eingestellt.] Bei Bedarf kann die Funktion in der Oberfläche manuell aktiviert werden.
+**Caching für Webservice aktivieren**: Die Daten der Studierenden bleiben zumindest teilweise im Speicher. Das beschleunigt weitere Funktionsaufrufe mit den selben Matrikelnummern, kann aber bei entsprechend vielen Personen den Speicher komplett auslasten, bis hin zum Programmabsturz. Daher zum Testen ok, für den Produktivbetrieb eher ungeeignet
-Beim Abgleich werden die folgenden Tabellen übernommen: k_abint, k_kzfa, k_pvers, k_stg und k_abstgv
+**Gaststudierende übernehmen**: Auch Studierende mit der Rolle "gast_student" werden beim Ausführen der Funktionen berücksichtigt.
-Ein Abgleich dieser Tabellen ist nicht nur für die Übernahme der Studierendendaten sondern auch für das Modulhandbuch wichtig.
+**Externes System für Accounts**: Sofern hier ein Wert eingetragen ist, werden bei der Übernahme der Accounts/Usernamen nur solche Datensätze berücksichtigt, die in account.externalsystem den entsprechenden Wert aufweisen.
-</WRAP>
+==== Schlüsselabgleich mit Fremdsystem ====
-==== Exmatrikulationen aus Fremdsystem übernehmen (aufgrund von Status) ====
+<WRAP justify> Der Schlüsselabgleich mit dem HISinOne-System wird automatisch einmal pro Tag aktiviert. [Ausnahme: Die Schlüsseltabellen sollen manuell gepflegt werden und dies ist im Setup entsprechend eingestellt.] Bei Bedarf kann die Funktion in der Oberfläche manuell aktiviert werden.
-<WRAP justify> In dieser Funktion werden Exmatrikulationen aufgrund des Status X im SOS-System übernommen. Dieser Status gilt für die gesamte Person mit all ihren Studiengängen.
+Beim Abgleich werden die folgenden Daten übernommen: Studienfächer (Subject), Abschlüsse (Degree), Kennzeichen Fach (SubjectIndicatorValue), Schwerpunkt (CourseSpecialization), PO-Version (ExaminationversionValue), Vertiefung (MajorFieldOfStudy).
-Die Funktion läuft einmal für das eingestellte Semester, und einmal für das vorangegangene Semester. In der Oberfläche wird dies durch getrennte Fortschrittsbalken und Zähler dargestellt.
-</WRAP>
-Konfigurationsmöglichkeiten:
-  * nur geänderte Sätze übernehmen (Abgleich mit dem Feld SOS.datlae)
-  * Datum für den Vergleich mit SOS.datlae
-  * Semester, in dem die Exmatrikulation liegen soll
-  * Matrikelnummerbereich von - bis
-Einstellungen, die sich hier auswirken:
-  * Anzahl Stellen der Matrikelnummer
-  * Zeichen zum Auffüllen der Matrikelnummer
-  * STG.lepsem für Semester verwenden (sonst stgsem)
+Darüber hinaus werden die Verknüpfungen von Studienfach zu Abschluss bzw. Studienfach zu Abschluss und Vertiefung übernommen. Diese werden aus den Eintragen in "CourseOfStudy" entnommen.
-==== Exmatrikulationen aus Fremdsystem übernehmen (aufgrund von Endedatum) ====
+Es werden nur Datensätze berücksichtigt, bei denen hiskeyId = 1 ist.
-<WRAP justify> In dieser Funktion werden Exmatrikulationen einzelner Studienfächer, erkennbar an einem im STG-Satz gesetzten Endedatum, übernommen. Das klassische Beispiel für das Vorliegen eines solchen Endedatums ist ein Studienfachwechsel. Das Feld wird allerdings nicht an allen Hochschulen gepflegt.
+Die Aufrufe erfolgen alle über den KeyvalueService.
-Die Funktion läuft einmal für das eingestellte Semester, und einmal für das vorangegangene Semester. In der Oberfläche wird dies durch getrennte Fortschrittsbalken und Zähler dargestellt.
+Ein Abgleich dieser Daten ist nicht nur für die Übernahme der Studierendendaten sondern auch für das Modulhandbuch wichtig.
 </WRAP>
-Konfigurationsmöglichkeiten:
-  * nur geänderte Sätze übernehmen (Abgleich mit dem Feld SOS.datlae)
-  * Datum für den Vergleich mit SOS.datlae
-  * Semester, in dem die Exmatrikulation liegen soll
-  * Einschränkung auf einen bestimmtes Studienfach
-  * Einschränkung auf einen bestimmten Abschluss
-  * Matrikelnummerbereich von - bis
-Einstellungen, die sich hier auswirken:
-  * Anzahl Stellen der Matrikelnummer
-  * Zeichen zum Auffüllen der Matrikelnummer
-  * STG.lepsem für Semester verwenden (sonst stgsem)
-==== Exmatrikulationen aufgrund fehlender Rückmeldung vornehmen ====
-<WRAP justify> Diese Funktion überprüft aktive Studiengänge von Studierenden daraufhin, ob weiterhin der Status aktiv gesetzt bleiben kann, oder ob exmatrikuliert werden muss. Dies läuft folgendermaßen ab:
-- Es werden alle Studiengänge von Studierenden ausgewählt, die den Status immatrikuliert oder beurlaubt haben  (und den eingestellten Kriterien entsprechen). \\
-- Für jeden Eintrag wird nun im Fremdsystem angefragt, ob es für das gewählte Semester in SOS einen Eintrag für das Studienfach gibt.\\
-- Sofern kein passender Eintrag gefunden werden kann (also bei fehlender Rückmeldung) wird der Studiengang in FlexNow auf den Status exmatrikuliert gesetzt.
-ACHTUNG: Wird das Semester für diese Funktion auf ein zukünftiges Semester gesetzt können natürlich keine Rückmeldungen gefunden werden. Es kommt dann zu Massen-Exmatrikulationen. Dies kann auch dann der Fall sein, wenn die Funktion ganz zu Beginn der Rückmeldephase mit dem aktuellen Semester aktiviert wird, und in SOS noch keine Rückmeldungen erfasst wurden. Der Einsatz dieser Funktion ist also jeweils mit den Abläufen an der Hochschule zu koordinieren.
-</WRAP>
-Konfigurationsmöglichkeiten:
-  * zu betrachtendes Semester
-  * Einschränkung auf einen bestimmten Studiengang
-  * Matrikelnummerbereich von - bis
-==== Stammdaten von Exmatrikulierten übernehmen ====
+==== Nur Stammdaten übernehmen (ohne Verläufe) ====
 <WRAP justify>
-Mit Hilfe dieser Funktion können die Stammdaten (Namen- und Geburtsinformationen, Adressdaten) von bereits exmatrikulierten Studierenden übernommen und auf den aktuellen Stand gebracht werden. Dies ist nützlich, wenn auch nach der Exmatrikulation noch Schreiben an die entsprechenden Personen verschickt werden sollen.
+Mit Hilfe dieser Funktionen können die Stammdaten (Namen- und Geburtsinformationen, Adressdaten) übernommen und auf den aktuellen Stand gebracht werden.
-Auch Auslandsaufenthalte können dabei mit übertragen werden, wenn diese Funktionalität aktiviert ist.
+Es kann eingestellt werden, ob dieser Vorgang für exmatrikulierte und/oder immatrikulierte Personen ausgeführt werden soll.
-Es werden keine Studiengangsinformationen übernommen!
+Es werden keine Studiengangsinformationen/Semesterverläufe übernommen!
+Eine Aktualisierung der Studierendendaten in FN2META findet jedoch statt, sofern diese Option in der Schnittstelle aktiviert ist.
 </WRAP>
 Konfigurationsmöglichkeiten:
-  * Datum für den Vergleich mit SOS.datlae
+  * Datum für den Vergleich mit dem Datum der letzten Änderung
   * zeitliche Einschränkung: über Semester (ab dem Beginndatum des gewählten Semesters)
   * Matrikelnummerbereich von - bis
@@ Zeile 89: / Zeile 48: @@
   * Nur die erste Adresse wird aktualisiert
   * Nutzername wird auf 8 Zeichen gekürzt
-  * Auslandsaufenthalte übertragen
+  * Einschränkung auf ein bestimmtes Studienfach (nur für Immatrikulierte)
-  * dabei: geänderte Aufenthalte nicht überschreiben/löschen
+  * Einschränkung auf einen bestimmten Abschluss (nur für Immatrikulierte)
-  * Einschreibung/HZB für Hochschulstatistik übertragen
-==== Stammdaten von Immatrikulierten übernehmen ====
+==== Studienverläufe übernehmen (inkl. Stammdaten) ====
-<WRAP justify>
+Die Übernahme von Studienverläufen kann in zwei Modi stattfinden, die im Folgenden beschrieben werden. Unabhängig vom Modus werden in jedem Fall die Stammdaten übernommen, so dass eine separate Stammdatenübernahme auch für die Exmatrikulierten nicht mehr nötig ist.
-Mit Hilfe dieser Funktion können die Stammdaten (Namen- und Geburtsinformationen, Adressdaten) von immatrikulierten Studierenden übernommen und auf den aktuellen Stand gebracht werden. Es werden keine Studiengangsinformationen übernommen!
-Auslandsaufenthalte können dabei mit übertragen werden, wenn diese Funktionalität aktiviert ist.
+=== Alle Verlaufs-Funktionen, Auswahl nur nach Änderungsdatum ===
-</WRAP>
+Die Auswahl der Studierenden, die in der Funktion berücksichtigt werden sollen, erfolgt ausschließlich über das Änderungsdatum (updatedAt). Die Funktion dient dazu, Änderungen in HISinOne zeitnah nach FlexNow zu übernehmen.
-Konfigurationsmöglichkeiten:
+Bei dem verwendeten Webservice handelt es sich um SearchStudentIds im StudentSearchService.
-  * Datum für den Vergleich mit SOS.datlae
-  * Einschränkung auf ein bestimmtes Semester, d.h. es muss in dem Semester mindestens ein aktives Studienfach vorliegen (STG-Satz)
-  * Einschränkung auf ein bestimmtes Studienfach
-  * Einschränkung auf einen bestimmten Abschluss
-  * Matrikelnummerbereich von - bis
-Einstellungen, die sich hier auswirken:
+Für jede StudentId, die der Webservice liefert, wird überprüft, ob die Person mindestens einen Studiengang studiert bzw. studiert hat, der für die Übernahme nach FlexNow relevant ist (Matching über studfachsos). Falls ja, werden die Stammdaten übernommen.
-  * Anzahl Stellen der Matrikelnummer
-  * Zeichen zum Auffüllen der Matrikelnummer
-  * Geburtsland = Nationalität setzen
-  * Nur die erste Adresse wird aktualisiert
-  * Nutzername wird auf 8 Zeichen gekürzt
-  * Auslandsaufenthalte übertragen
-  * dabei: geänderte Aufenthalte nicht überschreiben/löschen
-  * Einschreibung/HZB für Hochschulstatistik übertragen
-==== Immatrikulation und Rückmeldung ====
-<WRAP justify>
+Als nächstes wird überprüft, ob der Status gleich "exmatrikuliert" ist. Ist dies der Fall, werden alle noch aktiven Studiengänge der Person exmatrikuliert, danach wird mit der nächsten Person fortgefahren.
-Mit Hilfe dieser Funktion können die Stammdaten sowie die Studiengangsinformationen von immatrikulierten Studierenden übernommen werden. Je nach Konfiguration im PO-Modul können dabei pro STG-Satz im SOS-System ein oder mehrere Studiengänge in FlexNow angelegt bzw. aktualisiert werden.
-Auslandsaufenthalte können dabei mit übertragen werden, wenn diese Funktionalität aktiviert ist.
+Ist der Status gleich "immatrikuliert", finden drei Überprüfungen statt:
+  - Gibt es Studiengänge, die in HISinOne beendet wurden: Dann wird für diese in FlexNow exmatrikuliert.
-</WRAP>
+  - Gibt es Studiengänge, für die in HISinOne die Rückmeldung fehlt: Dann wird für diese in FlexNow exmatrikuliert.
+  - Gibt es in HISinOne Studiengänge, die neu hinzukommen oder rückgemeldet wurden: Dann werden diese auch in FlexNow hinzugefügt bzw. aktualisiert.
 Konfigurationsmöglichkeiten:
-  * Datum für den Vergleich mit SOS.datlae
+  * Datum für den Vergleich mit dem Datum der letzten Änderung
-  * Einschränkung auf ein bestimmtes Semester, d.h. es muss in dem Semester mindestens ein aktives Studienfach vorliegen (STG-Satz)
-  * Einschränkung auf ein bestimmtes Studienfach
-  * Einschränkung auf einen bestimmten Abschluss
   * Matrikelnummerbereich von - bis
@@ Zeile 137: / Zeile 77: @@
   * Anzahl Stellen der Matrikelnummer
   * Zeichen zum Auffüllen der Matrikelnummer
-  * Geburtsland = Nationalität setzen
+  * Gaststudierende übernehmen
-  * Nur die erste Adresse wird aktualisiert
-  * Nutzername wird auf 8 Zeichen gekürzt
-  * Auslandsaufenthalte übertragen
-  * dabei: geänderte Aufenthalte nicht überschreiben/löschen
-  * Einschreibung/HZB für Hochschulstatistik übertragen