Export von Anmeldelisten für Platzvergabeverfahren im XML Format

Aus BIS Wiki
Version vom 11. August 2008, 17:11 Uhr von bisinfo>ihbrune


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.

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.

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:

<?xml version="1.0" encoding="ISO-8859-1"?>
<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:art>S</ekvv:art>
    <ekvv:sws>2</ekvv:sws>
    <ekvv:fakultaet>Fakultät für Erziehungswissenschaft</ekvv:fakultaet>
    <ekvv:oeffnung></ekvv:oeffnung>
    <ekvv:wiederholung></ekvv:wiederholung>
    <ekvv:kurzkommentar></ekvv:kurzkommentar>
    <ekvv:ausgefallen>nein</ekvv:ausgefallen>
    <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:anrechenbarkeit></ekvv:anrechenbarkeit>
            <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">
        <ekvv:teilnehmer matrikelnummer="1343013" hatgeoeffneteeinschreibungen="ja">
            <ekvv:anrede>Frau</ekvv:anrede>
            <ekvv:vornamen>Uda</ekvv:vornamen>
            <ekvv:nachname>Peters</ekvv:nachname>
            <ekvv:einschreibungen>
                <ekvv:einschreibung 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 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:veranstaltung>
<?xml version="1.0" encoding="ISO-8859-1"?>
<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:art>S</ekvv:art>
    <ekvv:sws>2</ekvv:sws>
    <ekvv:fakultaet>Fakultät für Erziehungswissenschaft</ekvv:fakultaet>
    <ekvv:oeffnung></ekvv:oeffnung>
    <ekvv:wiederholung></ekvv:wiederholung>
    <ekvv:kurzkommentar></ekvv:kurzkommentar>
    <ekvv:ausgefallen>nein</ekvv:ausgefallen>
    <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:anrechenbarkeit></ekvv:anrechenbarkeit>
            <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">
        <ekvv:teilnehmer matrikelnummer="1343013" hatgeoeffneteeinschreibungen="ja">
            <ekvv:anrede>Frau</ekvv:anrede>
            <ekvv:vornamen>Uda</ekvv:vornamen>
            <ekvv:nachname>Peters</ekvv:nachname>
            <ekvv:einschreibungen>
                <ekvv:einschreibung 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 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:veranstaltung>