Inhaltsverzeichnis

Datenverbund Client (DVUH Client)

FH Complete stellt einen Client für die Anbindung zum Datenverbund zur Verfügung. DVUH steht für „Datenverbund der Universitäten und Hochschulen“ und ermöglicht das Melden von Studierendendaten. Es ist eine Vorstufe zur Bismeldung. Schnittstellendokumentation: https://stubei-q.portal.at/rws/swagger-ui.html.

DVUH Extension installieren und konfigurieren

Die Schnittstelle zu DVUH wird über die DVUH Extension zur Verfügung gestellt: https://github.com/FH-Complete/FHC-Core-DVUH.git

Zur Installation und Inbetriebnahme der Extension sind folgende Schritte nötig:

Weitere Konfiguration (optional)

DVUHSync.php Konfigurationdatei: 

$config['fhc_dvuh_studiensemester_meldezeitraum'] = array(
  'SS2021' => array(
	  'von' => '2021-01-01', // SS from 01.01
	  'bis' => '2021-05-31' // SS to 31.05
  ),
  'WS2021' => array(
	  'von' => '2021-06-01', // WS from 01.06
	  'bis' => '2022-03-31' // WS to 31.03
  ),
  'SS2022' => array(
	  'von' => '2022-01-01', // SS from 01.01
	  'bis' => '2022-05-31' // SS to 31.05
  )
);

DVUH Jobs starten

Es werden eine Reihe von Jobs unterstützt, die laufend von FH Complete holen und an den DVUH senden, und in manchen Fällen Daten in FH Complete speichern. Zum Starten der Jobs sind 2 Schritte notwendig:

  1. Starten des Schedulers, welcher die an den DVUH zu sendenden Daten bestimmt und die Ids für diese Daten in einer „Jobsqueue“ (Tabelle system.tbl_jobsqueue) ablegt.
  2. Starten des eigentlichen Jobs („Worker“), welcher die vom Scheduler gespeicherten Ids ausliest, für die entsprechenden Daten Aktionen durchführt und mit dem DVUH interagiert.

Pro Job gibt es demnach zwei Aufrufe, den Scheduler- und den Workeraufruf:

requestMatrikelnummer

sendCharge

sendPayment

sendStudyData

requestBpk

sendPruefungsaktivitaeten

Diese Aufrufe sollten von Cronjobs in festgelegten Zeitabständen ausgeführt werden. Die Meldungen erfolgen für ein als Parameter angegebenes Studiensemester (oben SS2021). Wenn der Studiensemester Parameter weggelassen wird, werden die Studiensemester aus der config Datei DVUHSync.php herangezogen (siehe Konfiguration fhc_dvuh_studiensemester_meldezeitraum).

DVUH Jobs Beschreibung

Alle Jobs werden für ein bestimmtes Studiensemester aufgerufen.

requestMatrikelnummer

sendCharge

sendPayment

sendStudyData

requestBpk

sendPruefungsaktivitaeten

Weitere Hinweise:

DVUH Client GUI

FH Complete stellt eine grafische Benutzeroberfläche zur Durchführung einzelner Aktionen im DVUH zur Verfügung. Dies betrifft das Auslesen von Daten im DVUH sowie das Senden bestimmter Daten an den DVUH. So können u.a. Stammdaten, Studiumsdaten ausgelesen und gemeldet werden, Zahlungen durchgeführt sowie Kontostände, Matrikelnummern und Bpks geprüft werden. Aktionen, die sowohl im Rahmen der Jobs als auch mit der GUI ausgeführt werden können, decken sich. So werden z.B. auch bei Stammdaten-, Zahlungsdaten- sowie Studiumsdatenmeldungen über die GUI die Meldungsinformationen im Sync Schema geloggt und die Matrikelnummer aktiviert.

Die GUI stellt Funktionalitäten aus 4 Bereichen zur Verfügung: Matrikelnummermanagement, Stammdatenmanagement, Zahlungsmanagement und Studiumsdatenmanagement.

Bei Klick auf eine Option erscheint eine Eingabemaske für Daten, die an DVUH geschickt werden sollen. Beispiel für die Zahlungseingangseingabemaske, Option „Zahlungseingang melden“:

Bei Senden von mit einer Person verknüpften Daten (z.B. Stammdaten-, Studiumsdatenmeldung) ist nur die Eingabe einer Person Id notwendig, die dazugehörigen weiteren Daten werden automatisch aus FH Complete bezogen. Zur besseren Nachvollziehbarkeit der zu sendenden Daten ist für Speicherzugriffe mit umfangreicheren Daten eine Vorschaufunktion verfügbar, Button „Zu sendende Daten anzeigen“, wie z.B. bei der Stammdatenmeldung:

Die Daten werden im XML-Format angezeigt, so wie sie an den DVUH geschickt werden. Wo möglich, werden Datenprüfungen seitens FH Complete noch vor der DVUH-Anfrage durchgeführt. Dies wird schon bei der Vorschau als Fehler (rot) oder Warnung (gelb) angezeigt:

Nach Klick auf „Absenden“ wird dann der Response so wie er von der DVUH Schnittstelle zurückkommt im XML Format angezeigt. Meldungen (grün), erkannte Fehler (rot) und Warnungen (gelb) werden oberhalb des XML angezeigt:

Lesezugriffe funktionieren ähnlich, nach Eingabe der Daten und Klick auf den „Absenden“ Button wird der XML response mit den angefragten Daten angezeigt, wie z.B. bei Abfrage der Studiendaten: