Export von Anmeldelisten für Platzvergabeverfahren im XML Format

Aus BIS Wiki
(Weitergeleitet von Anmeldelisten XML)

Das hier beschriebene XML Format wurde für Fakultäten entwickelt, die mit eigenen IT Verfahren ihre Seminarplatzvergabe durchführen, das eKVV aber für die Anmeldung zu den jeweiligen Lehrveranstaltungen nutzen. Über diese Funktion ist es möglich verstanstaltungsbezogen Anmeldelisten samt umfangreichen Veranstaltungsdaten zu erhalten, welche dann die Grundlage des Vergabeverfahrens bilden können.

Wichtig: Diese Schnittstelle ist heute nicht allgemein verfügbar. Falls Sie einen Bedarf für diese Schnittstelle sehen sprechen Sie uns rechtzeitig an.

Wie kann das Exportformat aufgerufen werden

Der XML Export kann direkt im Webbrowser über die eKVV Eingabeseiten aufgerufen werden. Um den Export für eine bestimmte Veranstaltung zu finden sollte diese zunächst z. B. über die Schnellsuche gefunden und die Detailseite aufgerufen werden.

Dort findet sich im 'Aktionen' Menü der Punkt TeilnehmerInnen Liste. Auf der folgenden Seite sehen Sie die Anmeldeliste im normalen Format. Klicken Sie nun auf 'Teilnehmerliste im XML Format exportieren' und Sie erhalten das hier beschrieben Exportformat.

Für einen direkten Aufruf dieser Seite können Sie sich die im Browser angezeigte URL genauer ansehen. Hier finden Sie am Ende einen Parameter:


...?id=1234567

Der Parameter identifiziert die Veranstaltung eindeutig und kann z. B. in der Detailseite der Veranstaltung ganz am Ende gefunden werden


...
ID: 1234567

Alternativ gibt es die Option als 'id' die Adresse des automatischen eKVV E-Mailverteilers der Veranstaltung zu verwenden, wobei nur der Teil vor dem '@' relevant ist. Hier ein Beispiel:


...?id=WS2008_259030

Die Verteileradresse kann ebenfalls in der Detailseite der Veranstaltung gefunden werden. Wichtig ist hier aber, dass die Belegnummer, die Teil der Adresse ist, eindeutig im Semester ist. Falls dies nicht der Fall ist kann die gesuchte Veranstaltung nicht eindeutig bestimmt werden. Es ist nicht definiert, welche Veranstaltung in diesem Fall verwendet wird!

Welche Rechte sind notwendig

Der Zugriff auf den XML Export erfolgt wie beschrieben als Webrequest. Hierbei gelten die gleichen Sicherheitsregeln wie beim normalen Zugriff per Webbrowser:

  • Der Zugriff erfolgt immer verschlüsselt per SSL/HTTPS
  • Beim Zugriff wird eine Benutzeranmeldung erzwungen

Der Benutzer muss dabei im eKVV die sogn. Belegmanagerrechte für die Fakultät der Veranstaltung haben. Die entsprechenden Rechte müssen beantragt werden, die notwendigen Antragsunterlagen finden Sie am Ende der Seite 'Zugang zum BIS'.

Wie sieht das Format aus

Das XML Format wurde mit dem Ziel entwickelt alle Informationen zu enthalten, die für Platzvergabeverfahren auch mit den komplexesten Regeln benötigt werden. Ein beispielhafter Export sieht so aus, wobei hier zur Verbesserung der Übersichtlichkeit nur jeweils eine Fachzuordnung und nur eine Teilnehmerin enthalten sind:

<?xml version="1.0" encoding="UTF-8"?>
<ekvv:veranstaltung id="817301">
    <ekvv:semester id="20082">WS 2008/2009</ekvv:semester>
    <ekvv:belegnummer>259030</ekvv:belegnummer>
    <ekvv:thema>Grundlagen der Konfliktforschung</ekvv:thema>
    <ekvv:fakultaet>Fakultät für Erziehungswissenschaft</ekvv:fakultaet>
    <ekvv:art>S</ekvv:art>
    <ekvv:sws>2</ekvv:sws>
    <ekvv:dozenten>
        <ekvv:dozent id="11250">
            <ekvv:anrede>Herr</ekvv:anrede>
            <ekvv:titel>Prof. Dr.</ekvv:titel>
            <ekvv:vorname>Eike</ekvv:vorname>
            <ekvv:nachname>Musterprof</ekvv:nachname>
        </ekvv:dozent>
        <ekvv:dozenten_zusatz></ekvv:dozenten_zusatz>
    </ekvv:dozenten>
    <ekvv:fachzuordnungen>
        <ekvv:fachzuordnung id="8173144_1" ekvvstudiengangid="6993812"
            sosfachcode="273" sosabschlusscode="63" fuerkernhauptfach="ja">
            <ekvv:ekvvstudiengangname>Erziehungswissenschaft (Kernfach) / Bachelor (Kernfach)</ekvv:ekvvstudiengangname>
            <ekvv:abschnitt></ekvv:abschnitt>
            <ekvv:status></ekvv:status>
            <ekvv:fachsemester></ekvv:fachsemester>
            <ekvv:leistung></ekvv:leistung>
            <ekvv:leistungspunkte>3/5</ekvv:leistungspunkte>
            <ekvv:kommentar>AT oder EL b</ekvv:kommentar>
            <ekvv:untergliederungen>
                <ekvv:untergliederung id="8108754">
                    <ekvv:kuerzel>BE 3.1</ekvv:kuerzel>
                    <ekvv:name>Theorien der Erziehungswissenschaft (Bildungs-, Sozialisations-, Erziehungs-, Gesellschafts- und Sozialtheorien)</ekvv:name>
                </ekvv:untergliederung>
            </ekvv:untergliederungen>
        </ekvv:fachzuordnung>
    </ekvv:fachzuordnungen>
    <ekvv:teilnehmerliste teilnehmermanagement="nein"
                    teilnehmerbegrenzung="30">
        <ekvv:teilnehmer matrikelnummer="1343013" prioritaet="-1" 
                         hatgeoeffneteeinschreibungen="ja">
            <ekvv:anrede>Frau</ekvv:anrede>
            <ekvv:vornamen>Uda</ekvv:vornamen>
            <ekvv:nachname>Peters</ekvv:nachname>
            <ekvv:einschreibungen>
                <ekvv:einschreibung semester="20082" sosfachcode="149"
                    sosabschlusscode="63" fuerkernhauptfach="ja" geoeffnet="nein">
                    <ekvv:sosstudiengangname>Soziologie / Bachelor (2-Fach)</ekvv:sosstudiengangname>
                    <ekvv:fachsemester>3</ekvv:fachsemester>
                </ekvv:einschreibung>
                <ekvv:einschreibung semester="20082" sosfachcode="149"
                    sosabschlusscode="63" fuernebenfach="ja" geoeffnet="nein">
                    <ekvv:sosstudiengangname>Soziologie / Bachelor (2-Fach)</ekvv:sosstudiengangname>
                    <ekvv:fachsemester>3</ekvv:fachsemester>
                </ekvv:einschreibung>
            </ekvv:einschreibungen>
        </ekvv:teilnehmer>
    </ekvv:teilnehmerliste>
    <ekvv:termine>
        <ekvv:termin datum="22.07.2009" startUhrzeitMinuten="600"
            endUhrzeitMinuten="720" typ="normal" kettenId="11100327">
            <ekvv:uhrzeit>10-12</ekvv:uhrzeit>
        </ekvv:termin>
        <ekvv:termin datum="27.07.2009" startUhrzeitMinuten="600"
            endUhrzeitMinuten="720" typ="klausur" kettenId="11200568">
            <ekvv:uhrzeit>10-12</ekvv:uhrzeit>
        </ekvv:termin>
    </ekvv:termine>
</ekvv:veranstaltung>

Das oberste Element ist 'ekvv:veranstaltung', alle weiteren Elemente sind Unterelemente. Alle Elemente haben den Namensraum 'ekvv'. Dieser wird in den folgenden Detailerklärungen daher meist weggelassen.

Teil 1: Veranstaltungsgrunddaten

Im Exportformat sind zunächst Grunddaten der Veranstaltung enthalten:

<ekvv:veranstaltung id="817301">

    <ekvv:semester id="20082">WS 2008/2009</ekvv:semester>
    <ekvv:belegnummer>259030</ekvv:belegnummer>
    <ekvv:thema>Grundlagen der Konfliktforschung</ekvv:thema>
    <ekvv:fakultaet>Fakultät für Erziehungswissenschaft</ekvv:fakultaet>

    <ekvv:art>S</ekvv:art>
    <ekvv:sws>2</ekvv:sws>

Im obersten Element 'veranstaltung' gibt es immer das Attribut 'id'. Hier findet sich die Datenbank-Id der Veranstaltung wieder, die bereits zum Aufruf des Exports benötigt wurde. Falls die Veranstaltung ausgefallen ist wird auch das Attribut 'status' eingefügt mit dem Wert 'ausgefallen'.

Danach folgen diese Unterelemente:

semester
Das Semester hat ein Attribut 'id', welches das Semester in einer eindeutigen, numerischen Form kodiert. Diese Format wird auch in der HIS SOS Studierendenverwaltung verwendet und setzt sich aus dem Jahr zusammen, in welchem das Semester stattfindet bzw. beginnt. Bei Sommersemestern wird dann eine '1' angehängt, bei Wintersemestern eine '2'. Als Elementinhalt wird der Semestername in der üblichen eKVV Form geliefert. Siehe auch das semester Element bei den einzelnen Einschreibungen der TeilnehmerInnen
belegnummer, thema und fakultaet
Hier finden sich die Belegnummer und das Thema/der Titel der Veranstaltung sowie die Einrichtung, welche die Veranstaltung durchführt
art und sws
Die Veranstaltungsart und die Semesterwochenstunden haben die Besonderheit, dass 2 Arten und damit auch 2 SWS Angaben möglich sind. Die Elemente 'art' und 'sws' kommen allerdings immer nur einmal vor und enthalten ggf. Einträge der Art 'V+Ü' und '4+2'

Teil 2: Lehrende der Veranstaltung

Das nächste Unterelement von 'veranstaltung' ist 'dozenten'. In diesem Unterelement finden sich die Angaben zu den Lehrenden der Veranstaltung. 'dozenten' hat zwei Arten von Unterelementen: 'dozent' und 'dozenten_zusatz':


    <ekvv:dozenten>

        <ekvv:dozent id="11250">
            <ekvv:anrede>Herr</ekvv:anrede>
            <ekvv:titel>Prof. Dr.</ekvv:titel>
            <ekvv:vorname>Eike</ekvv:vorname>
            <ekvv:nachname>Musterprof</ekvv:nachname>
        </ekvv:dozent>

        <ekvv:dozenten_zusatz></ekvv:dozenten_zusatz>

    </ekvv:dozenten>

'dozent' Elemente können einmal, mehrmals oder überhaupt nicht vorkommen. Jedes dieser Elemente hat ein 'id' Attribut, welches die Datenbank-Id der jeweiligen Lehrenden bezeichnet. Danach folgen diese Unterelemente:

anrede
'Frau' oder 'Herr' oder leer
titel
Der persönliche Titel
vorname und nachname
Der Name

Die 'dozent' Elemente erscheinen in der Reihenfolge, die bei der Veranstaltung festgelegt wurde.

Danach kommt immer das Element 'dozenten_zusatz'. Sein Inhalt besteht aus eventuell vorhandenen Freitextangaben zu den Lehrenden (z. B. 'N.N.').

Teil 3: Die Fachzuordnungen

In diesem Teil werden die u. U. sehr komplexen und zahlreichen Öffnungen der Veranstaltung für die verschiedenen Studiengänge und Studiengangsuntergliederungen (Module) dargestellt. Des Element 'fachzuordnungen' ist ein Unterelement zu 'veranstaltung' und enthält wieder 'fachzuordnung' Unterelemente. Hier wurde im Zuge der eKVV Erweiterung für das Studienstrukturmodell 2011 eine gemeinsame Darstellung von Fachzuordnungen im klassischen und im neuen eKVV Modell eingeführt:

    <ekvv:fachzuordnungen>

        <ekvv:fachzuordnung id="8173144_1" ekvvstudiengangid="6993812"
            sosfachcode="273" sosabschlusscode="63" fuerkernhauptfach="ja">

            <ekvv:ekvvstudiengangname>Erziehungswissenschaft (Kernfach) / Bachelor (Kernfach)</ekvv:ekvvstudiengangname>

            <ekvv:abschnitt></ekvv:abschnitt>
            <ekvv:status></ekvv:status>
            <ekvv:fachsemester></ekvv:fachsemester>
            <ekvv:leistung></ekvv:leistung>
            <ekvv:leistungspunkte>3/5</ekvv:leistungspunkte>
            <ekvv:kommentar>AT oder EL b</ekvv:kommentar>

            <ekvv:untergliederungen>

                <ekvv:untergliederung id="8108754">

                    <ekvv:kuerzel>BE 3.1</ekvv:kuerzel>
                    <ekvv:name>Theorien der Erziehungswissenschaft (Bildungs-, Sozialisations-, Erziehungs-, Gesellschafts- und Sozialtheorien)</ekvv:name>

                </ekvv:untergliederung>

            </ekvv:untergliederungen>

        </ekvv:fachzuordnung>

    </ekvv:fachzuordnungen>

Hier kann eine beliebige Anzahl an Fachzuordnungen geliefert werden. Jedes 'fachzuordnung' Element hat zunächst eine Reihe von Attributen:

Attribut 'id'
Eine interne Datenbank-Id des Fachzuordnungsdatensatz ergänzt um einen Zähler. Ist normalerweise nicht weiter von Bedeutung.
Attribut 'ekvvStudiengangId'
Die eKVV Datenbank-Id des Studiengangs im klassischen Modell oder die Id der Studiengangsvariante im neuen Modell, den diese Öffnung verknüpft
Attribute 'sosFachCode' und 'sosAbschlussCode'
Die Fach- und Abschlussnummer des Studiengangs, wie er in der Studierendenverwaltung HIS SOS verwendet wird. Diese beiden Attribute sind wichtiger als die eKVV Studiengangs-Id, da sie gebraucht werden um die Verknüpfung mit den Einschreibungen der Studierenden herzustellen. Eine Liste der möglichen Abschlusscodes findet man auf dieser Seite. Letztlich werden diese Codes vom Studierendensekretariat festgelegt. Beide Attribute können leer sein, falls es sich bei der Fachzuordnung nicht um einen grundständigen Studiengang handelt (Beispiel: Beruforientierung und Schlüsselkompetenzen)
Attribute 'fuerKernHauptfach' und 'fuerNebenfach'
Diese Attribute sind optional. Sie können alleine oder zusammen auftreten oder auch komplett fehlen. Wenn sie vorhanden sind haben sie immer den Wert 'ja'.
'fuerkernhauptfach' ist vorhanden, wenn bei der Fachzuordnung Kernfach, Hauptfach, Kern-/Nebenfach oder Haupt-/Nebenfach ausgewählt wurde.
'fuernebenfach' ist vorhanden, wenn bei der Fachzuordnung Nebenfach, Kern-/Nebenfach oder Haupt-/Nebenfach ausgewählt wurde.

An Hand dieser Attribute ist es möglich zu prüfen, ob eine Fachzuordnung in Bezug auf die Einschreibungen einer bestimmten Teilnehmerin relevant ist.

Attribut 'modell'
Über dieses Attribut kann eine Unterscheidung zwischen Fachzuordnungen aus dem klassischen eKVV Modell (Wert = 'alt') und dem neuen Studiengangsmodell (Wert = 'neu') erfolgen.

Die 'fachzuordnung' Elemente haben dann folgende Unterelemente:

ekvvstudiengangname
Der komplette, im eKVV verwendete Name des Studiengangs im klassischen Modell bzw. der Name des Profils im neuen Modell.

Die folgenden Attribute 'abschnitt', 'status', 'fachsemester', 'leistung', 'leistungspunkte' und 'kommentar' sind nur bei Fachzuordnungen in der klassischen eKVV Modellierung relevant (altes Studiemodell), und im Studienmodell 2011 immer leer:

abschnitt
Enthält Angaben wie 'GS' für Grundstudium, 'HS' für Hauptstudium, etc.. Ist in den BA/MA Studiengängen normalerweise leer
status
Ist die Veranstaltung 'Pflicht', 'Wahlpflicht' oder 'Wahl'
fachsemester
Die Fachsemesterempfehlung. Falls mehrere Fachsemester ausgewählt wurden erscheinen sie zusammen in diesem Element. Beispiel: '1. 2.'
leistung
Inhalt des entsprechenden Auswahlfeldes in der Fachzuordnungseingabe. Enthält einen Text wie z. B. 'Aktive Teilnahme'
leistungspunkte
Die Anzahl der Leistungspunkte. Wichtig ist hier, dass das eKVV auch Eingaben zulässt, die keine reinen Zahlen sind!
kommentar
Enthält den Text aus dem Kommentarfeld der Fachzuordnung
untergliederungen
Dieses Element enthält beliebig viele 'untergliederung' Unterelemente. Die Untergliederungen eines Studienganges sind im klassischen eKVV Modell die Module, Profile, Schwerpunkte etc., welche die Binnendifferenzierung eines Studiengangs ausmachen. Im neuen Studiengangsmodell sind es immer Module. Alle in der Eingabemaske ausgewählten Untergliederungen/Module werden hier geliefert, es kann allerdings auch keine einzige geliefert werden. Auch kann der gleiche Studiengang noch einmal in einer weiteren Fachzuordnung erscheinen und so noch weitere Modulöffnungen einbringen.
Die 'untergliederung' Elemente haben das Attribut 'id', welches die interne Datenbank-Id im eKVV enthält. Es gibt 2 Unterelemente:
kuerzel
Die Kurzbezeichnung der Untergliederung, z. B. 'Modul 1'
name
Die ausführliche und teilweise sehr lange Bezeichnung

Teil 4: Die TeilnehmerInnen

Danach kommt die eigentliche Liste der TeilnehmerInnen. Sie ist im Element 'teilnehmerliste' enthalten, welches ein Unterelement von 'veranstaltung' ist:


    <ekvv:teilnehmerliste teilnehmermanagement="nein"
                    teilnehmerbegrenzung="30">

        <ekvv:teilnehmer matrikelnummer="1343013" 
                         prioritaet="-1" 
                         eltern="nein" 
                         hatgeoeffneteeinschreibungen="ja">

            <ekvv:anrede>Frau</ekvv:anrede>
            <ekvv:vornamen>Uda</ekvv:vornamen>
            <ekvv:nachname>Peters</ekvv:nachname>

            <ekvv:einschreibungen>

                <ekvv:einschreibung semester="20082" sosfachcode="149"
                    sosabschlusscode="63" fuerkernhauptfach="ja" geoeffnet="nein">

                    <ekvv:sosstudiengangname>Soziologie / Bachelor (2-Fach)</ekvv:sosstudiengangname>
                    <ekvv:fachsemester>3</ekvv:fachsemester>

                </ekvv:einschreibung>

                <ekvv:einschreibung semester="20082" sosfachcode="149"
                    sosabschlusscode="63" fuernebenfach="ja" geoeffnet="nein">

                    <ekvv:sosstudiengangname>Soziologie / Bachelor (2-Fach)</ekvv:sosstudiengangname>
                    <ekvv:fachsemester>3</ekvv:fachsemester>

                </ekvv:einschreibung>

            </ekvv:einschreibungen>

        </ekvv:teilnehmer>

    </ekvv:teilnehmerliste>

Das 'teilnehmerliste' Element hat immer das Attribut 'teilnehmermanagement'. Es kann als Werte 'ja' oder 'nein' enthalten, je nachdem, ob bei der Veranstaltung bereits das Teilnehmermanagement eingeschaltet ist. Ein weiteres optionales Attribut ist 'teilnehmerbegrenzung'. Falls bei der Veranstaltung eine Teilnehmerbegrenzung eingetragen wurde wird in dieses Attribut die Anzahl eingesetzt. Hier gibt es den Sonderfall, dass über die erweiterten Einstellungen des Teilnehmermanagements die Plätze für Platzvergabe separat eingetragen wurden. Ist dieser Wert vorhanden, so wird er an Stelle der öffentlich sichtbaren Teilnehmerbegrenzung verwendet.

Das Element 'teilnehmerliste' enthält wiederum 'teilnehmer' Unterelemente. Für jede angemeldete Person wird ein entsprechender Eintrag gemacht. Die 'teilnehmer' Elemente können mehrere Attribute haben:

Attribute 'matrikelnummer' oder 'gastbenutzer'
Bei Studierenden, die sich im eKVV über ihre Matrikelnummer angemeldet haben, wird das Attribut 'matrikelnummer' verwendet. Bei Studierenden, die nur einen Gastaccount verwenden erscheint das Attribut 'gastbenutzer' mit dem eindeutigen, aber anonymen Gastbenutzernamen.
Attribut 'teilnahmestatus'
Wird nur bei Veranstaltungen mit Teilnehmermanagement gezeigt, dort aber bei jeder Teilnehmerin. Kann dann folgende Werte haben:
'drin' - Teilnehmerin hat Platz erhalten
'nicht drin' - kein Platz erhalten oder Platzvergabe undefiniert
'wartet0001' - Platz auf der Warteliste, die Zahl am Ende gibt die Position an (im Beispiel 1)
Attribut 'hatGeoeffneteEinschreibungen'
Ist immer vorhanden und kann 'ja' oder 'nein' sein. 'ja' bedeutet, dass die Teilnehmerin wenigstens eine Einschreibung hat, die laut den Fachzuordnungen der Veranstaltung geöffnet ist. Dieses Attribut fasst damit die Prüfung der 'geoeffnet' Attribute der folgenden einzelnen Einschreibungsdatensätze zusammen. Kann bei Gastbenutzern nie 'ja' sein. Dieses Attribut soll eine Vorfilterung der Teilnehmerinnen ermöglichen
Attribut 'eltern'
Hier steht 'ja', falls die Person den Elternstatus hat, sonst 'nein'. Um diesen Status zu erhalten müssen sich die Studierenden selbst beim StudSek melden und entsprechend eintragen lassen. Das Verfahren wird in dieser Wiki Seite genauer beschrieben. Wie in dieser Seite dokumentiert sollen Studierende mit Kind Vorrang bei der Platzvergabe erhalten.
Attribut 'prioritaet'
Falls die Teilnehmerin der Veranstaltung über das eKVV eine Priorität gegeben hat, so wird der Wert hier gezeigt. Je kleiner der hier gezeigte Wert desto höher die Priorisierung. Falls keine explizite Priorisierung bei der Veranstaltung vorgenommen wurde kommt '-1'. Eine fehlende Priorisierung muss bei der Vergabe als niedrigste Priorität gewertet werden. Damit eine vollständige Identität mit der Interpretation der Prioritäten im eKVV erreicht wird müssen Veranstaltungen ohne Priorität dann noch aufsteigend nach der Belegnummer sortiert werden.
Wichtig ist bei der Auswertung der Priorisierungen, dass diese sich in Bezug auf eine einzige Veranstaltung nicht direkt miteinander vergleichen lassen. Falls die Prioritäten verwendet werden, so müssen sie über der gesamten Menge von Veranstaltungen, die in einem Platzvergabenverfahren sind, erst für jede Studierende normalisiert werden. Falls in einem Vergabeverfahren Untergruppen von Veranstaltungen gebildet werden, so muss die Normalisierung auf Ebene dieser Gruppen erfolgen. Erst nach einer solchen Normalisierung kann vergleichen werden, ob eine Studierende eine bestimmte Veranstaltung höher priorisiert hat als eine andere Studierende.

Das 'teilnehmer' Element hat dann eine Reihe von Unterelementen:

anrede, vornamen und nachname
Diese Angaben sind bei Gastbenutzern nie vorhanden, können aber auch bei per Matrikelnummer angemeldeten Studierenden u. U. fehlen, falls die Studierende nicht mehr eingeschrieben ist
einschreibungen
Dieses Element enthält wieder eine Anzahl von 'einschreibung' Unterelementen. BA Studierende werden meist 2 solche Unterelemente haben, MA Studierende nur eines. Allerdings kann es durch Mehrfacheinschreibungen auch eine höhere Anzahl geben. Gastbenutzer haben hier nie Einträge. 'einschreibung' Elemente haben zunächst eine Reihe von Attributen, die identisch zu den Attributen des 'fachzuordnung' Elements sind:
Attribut 'semester'
Das Semester, in welches die Einschreibung gehört. In der SOS Notation, siehe das id Attribut der Veranstaltungsdaten. Wird geliefert um Fälle unterscheiden zu können, in denen Einschreibungen aus dem vorherigen Semester angezeigt werden. Dies geschieht dann, wenn der/die Studierende (noch) nicht im Semester der Veranstaltung eingeschrieben sind. Durch einen Vergleich des hier gelieferten Semesters und des Semesters bei der Veranstaltung können solche Fälle erkannt und ggf. besonders behandelt werden. Es wird garantiert, dass die gelieferten Einschreibungen einer/s Studierenden aus dem gleichen Semester kommen
Attribute 'sosFachCode' und 'sosAbschlussCode'
Die Fach- und Abschlussnummer des eingeschriebenen Studiengangs, wie sie in der Studierendenverwaltung HIS SOS verwendet werden.
Attribute 'fuerKernHauptfach' und 'fuerNebenfach'
Es ist immer genau eines dieser Attribute vorhanden. Als Wert haben sie dann immer 'ja'.
'fuerkernhauptfach' ist vorhanden, wenn die Einschreibung im Kernfach oder Hauptfach erfolgt ist
'fuernebenfach' ist vorhanden, die Einschreibung im Nebenfach erfolgt ist
Attribut 'geoeffnet'
Dieses Attribut fasst die Überprüfung zusammen, ob unter den Fachzuordnungen der Veranstaltung wenigstens eine ist, die identische Werte für 'sosFachCode' und 'sosAbschlussCode' hat und bei der auch das entsprechende 'fuerKernHauptfach' oder 'fuerNebenfach' Attribut vorhanden ist. Dieses Attribut soll damit die Prüfung erleichtern, welche der Einschreibungsdaten einer Studierenden überhaupt für das Vergabeverfahren relevant sind. Es ist immer vorhanden und kann als Wert 'ja' oder 'nein' enthalten.
Es ist möglich dass Studierende mehr als eine geöffnete Einschreibung haben. Dies könnte z. B. durch Öffnungen von anderen Fakultäten der Fall sein.
Das 'einschreibung' Element enthält dann noch 2 Unterelemente:
sosStudiengangName
Die Bezeichnung des Studiengangs aus der Studierendenverwaltung HIS SOS
fachsemester
Das Fachsemester, in welchem sich die Studierende in Bezug auf den Studiengang befindet

Teil 5: Die Veranstaltungstermine

Als letztes kommt die Liste der Termindaten, an welchen die Veranstaltung stattfindet. Sie ist im Element 'termine' enthalten, welches ein Unterelement von 'veranstaltung' ist und wiederum 'termin' Unterelemente enthält:

    <ekvv:termine>
        <ekvv:termin datum="22.07.2009" startUhrzeitMinuten="600"
            endUhrzeitMinuten="720" typ="normal" kettenId="11100327">
            <ekvv:uhrzeit>10-12</ekvv:uhrzeit>
        </ekvv:termin>
        <ekvv:termin datum="27.07.2009" startUhrzeitMinuten="600"
            endUhrzeitMinuten="720" typ="klausur" kettenId="11200568">
            <ekvv:uhrzeit>10-12</ekvv:uhrzeit>
        </ekvv:termin>
    </ekvv:termine>

Gezeigt werden die einzelnen Daten, an denen die Veranstaltung stattfindet. Die Termine müssen dazu veröffentlicht sein. Es werden allerdings nur Daten angegeben, die noch stattfinden (also keine vergangenen Termine). Jedes 'termin' Element hat folgende Attribute:

datum
Das Datum im Format 'TT.MM.JJJJ'
startUhrzeitMinuten
Der Beginn des Termines in Minuten nach Mitternacht
endUhrzeitMinuten
Das Ende des Termines in Minuten nach Mitternacht
typ
Hier kann entweder 'normal' oder 'klausur' kommen. Dient zur Unterscheidung von Klausurterminen
kettenId
Die Id des eKVV Termindatensatzes, zu dem das Datum gehört. Kann verwendet werden um zu ermitteln, ob ein Datum ein Einzeltermin ist oder zu einer Kette (wöchentlich, 14-täglich) von Terminen gehört

An Hand dieser Attribute soll es möglich sein bei Platzvergaben sich überschneidende Veranstaltungen zu erkennen.

Das 'termin' Element hat noch ein Unterelement:

uhrzeit
Hier wird die Terminuhrzeit in lesbarer Form dargestellt. Dieses Element bietet damit keine zusätzliche Information zu den schon beschriebenen Attributen

Rückimport von Platzvergabeergebnissen

Auch für den Rückimport gibt es eine Schnittstelle. Eine Beschreibung finden Sie hier.