FlexWiki

Diese Seite ist nicht editierbar. Sie können den Quelltext sehen, jedoch nicht verändern. Kontaktieren Sie den Administrator, wenn Sie glauben, dass hier ein Fehler vorliegt.
====== stud2flex - Import von Studierendendaten und Studienverläufen ======

<WRAP justify>Das Schnittstellenprogram stud2flex dient zur Übertragung von Studierenden-Stammdaten sowie Studienverläufen. Immatrikulationen, Rückmeldungen sowie Exmatrikulationen können hier übernommen bzw. angestoßen werden.
Zum aktuellen Stand (2021/03) ist eine Übertragung aus den HIS-Systemen SOS sowie HISinOne möglich, sowie eine Übertragung aus SLCM der Firma SAP. Außerdem lassen sich Daten aus einer CSV-Datei importieren.
</WRAP>

===== Funktionen =====

<WRAP justify> Sämtliche Funktionen können nach Belieben an- oder ausgeschaltet werden. Die Reihenfolge des Ablaufs entspricht der Reihenfolge in der Anzeige von oben nach unten. 

Falls eine entsprechende Protokollierung aktiviert ist, werden die Aktionen aller Funktionen in einer gemeinsamen Datei protokolliert. Dabei wird pro Lauf (pro Klicken auf "Start") eine neue Datei angelegt. 

==== Spezifische Funktionen für verschiedene Quellsysteme ====
Die spezifischen Funktionen werden auf den folgenden Unterseiten genauer beschrieben:
</WRAP>

  * [[tools:stud2flex_sos|Import aus SOS]]
  * [[tools:stud2flex_slcm|Import aus SLCM]]
  * [[tools:stud2flex_hio|Import aus HISinOne]]
  * [[tools:stud2flex_csv|Import per CSV-Datei]]

==== Gemeinsame Funktionen für alle Quellsysteme ====

=== Authentifizierungsdaten von Exmatrikulierten löschen ===

<WRAP justify> Die Funktion dient dazu, die Authentifizierungsdaten von bereits exmatrikulierten Studierenden zu löschen, so dass deren Zugang zum FlexNow-System entzogen wird. Bedingung hierfür ist, dass es keinen aktiven Studiengang mehr für die Person gibt.

Authentifizierungsdaten meint Nutzernamen, NDS-Kennung sowie die Einträge in FN2META. 

Die Einschränkung erfolgt über das Semester. In der Oberfläche kann angegeben werden, bis zu welchem Semester **einschließlich** die Daten gelöscht werden. Der Vergleich erfolgt mit dem spätesten Exmatrikulationssemester der jeweiligen Person, über alle ihre Studiengänge betrachtet. 
</WRAP>

Konfigurationsmöglichkeiten:
  * Semester, bis zu dem (einschließlich) Authentifizierungdaten gelöscht werden sollen
  * Matrikelnummerbereich von - bis


=== Datensätze mit zeitgleicher Imma- und Exmatrikulation löschen ===

<WRAP justify> 
Mit Hilfe dieser Funktion können Studiengänge gelöscht werden, bei denen das Datum der Immatrikulation dem Datum der Exmatrikulation entspricht und in denen keine Aktivität stattgefunden hat. Gibt es für eine:n Studierende:n nach dem Löschen eines solchen Studiengangs// überhaupt keine// Studiengänge mehr, wird die komplette Studierendenakte gelöscht.
</WRAP>

Konfigurationsmöglichkeiten:
   * Matrikelnummerbereich von - bis


===== Verarbeitung von FN2META-Daten für Studierende =====

<WRAP justify> 
Die Schnittstelle kann die Einträge, die für die Authentifizierung der Studierenden später nötig sind, in FN2META anlegen und aktualisieren. Dies geschieht mit Hilfe eines WebService. Informationen über den Erfolg der jeweiligen Aktion gibt es in der Protokolldatei. Dort werden ggf. auch Fehler protokolliert. 

Beim Löschen von Authentifizierungsinformationen wird ebenfalls ein WebService genutzt, um die FN2META-Daten für die entsprechenden Personen zu löschen. 
</WRAP>

==== Aktivierung und Einrichtung ====


Die Konfiguration erfolgt über die Tabelle SETUP_. 

''insert  into  setup_  (param_,  value_)  values  ('SCHNITTSTELLE_FN2METADATEN', 'TRUE'); ''
 
Zusätzlich sind zwei Angaben zu machen. Fehlt eine dieser Angaben, wird ein entsprechender 
Hinweis ausgegeben. Bitte tragen Sie jeweils die für Sie relevante Zahl ein. 
 
1) Welche AuthTyp-ID wird bei Ihnen verwendet?  \\
''insert into setup_ (param_, value_) values ('SCHNITTSTELLE_FN2META_AUTHTYPID', '7'); ''
 
3) Wie wird die Nutzerkennung für FN2META erzeugt?  \\
0 = die Kennung entspricht der Matrikelnummer \\
1= die Kennung entspricht dem Nutzernamen der/des Studierenden \\
2 = die Kennung entspricht dem Feld NDSKennung der/des Studierenden \\
''insert into setup_ (param_, value_) values ('SCHNITTSTELLE_FN2META_KENNUNGNUTZER', '0'); ''

==== Arbeitsweise ====
  *  Das  Passwort  wird  bei  AuthTyp-ID  1  oder  7  übernommen,  andernfalls  werden Passwörter  außerhalb  von  FlexNow  verwaltet  und  sie  sind  für  die  Übernahme  nicht relevant. 
  *  Die  Kennung  wird  je  nach  Einstellung  aus  der  Matrikelnummer  oder  aus  dem Nutzernamen erzeugt. 
  *  Falls die/der Studierende bereits in FN2META existiert, erfolgt ein Update auf Kennung und ggf. Kennwort.  
  *  Falls die/der Studierende noch nicht in FN2META existiert, wird die Person angelegt. 

===== Administration =====

==== Installation und Rechte ====

<WRAP justify>stud2flex wird mit den fn2Modulen zusammen ausgeliefert und benötigt die gleiche Laufzeitumgebung. Eine Version benötigt die jeweils dazu passende Datei common.dll. </WRAP>

<WRAP justify>Zur Benutzung sind FlexNow-seitig mindestens PA-Rechte nötig. 

Der Zugriff auf Seiten von SOS erfolgt ausschließlich lesend. Leserechte werden benötigt für die Tabellen:
anschri, k_akfz, email, identroll, k_abint, k_abstgv, k_pvers, k_stg, k_kzfa, sos, stg, sos_acc, telefon und (optional) stay_abroad.

{{ :tools:sos_felder_stand_2022_03.xlsx |Genaue Feldangaben für den Import aus SOS (Excel-Datei)}}

Für HISinOne erfolgt die Übertragung über WebServices.
</WRAP>

==== Steuerung des Programms mittels Parameter-Sets ====

<WRAP justify>Zur flexibleren Steuerung des Programms flexExport wurden Parameter-Sets eingeführt. Diese ermöglichen eine Speicherung sämtlicher Einstellungsmöglichkeiten unter einem selbst gewählten Namen. 

Auf diese Weise können Sets für allgemeine Läufe, bestimmte Spezialläufe, oder Testszenarien definiert werden. Die Sets können je nach Bedarf geladen und ggf. editiert werden. 

Ein Set kann als Default-Set gesetzt werden. Falls ein Default-Set existiert, wird es beim Programmstart automatisch geladen. 
</WRAP>


==== Batch/Aufgabenplanung ====

<WRAP justify>Das Programm lässt sich im Batch oder mit Hilfe der Windows-Aufgabenplanung starten. Dabei müssen die Anmeldedaten für beide Datenbanken wie folgt angegeben werden:
</WRAP>

  * FSY: Art des Quellsystems: "SOS" für SOS/POS, "HIO" für HISinOne

  * DB: FlexNow-Datenbank
  * N: Nutzer für die FlexNow-Datenbank
  * P: Passwort für die FlexNow-Datenbank

  * FDB: Fremddatenbank
  * FN: Nutzer für die Fremddatenbank
  * FP: Passwort für die Fremddatenbank

optional: 
  * PS: Parameterset, das aufgerufen werden soll

Beispiel:\\
''FlexNow_stud2flex.exe FSY=SOS DB=FLEXNOW N=flexnow P=geheim FDB=SOS FN=SOSUSER FP=supergeheim PS=2''

<WRAP justify>Wird kein Parameterset angegeben, wird das Default-Parameterset geladen, falls vorhanden. Wenn kein Parameterset gefunden werden kann, wird das Programm abgebrochen. 
</WRAP>