Technische Voraussetzungen/Informationen

Leitfaden zur Generierung von open-Qcat-Katalogen zur Einstellung von Bildungsangeboten in KURSNET

Zweck des Dokuments

Dieses Dokument richtet sich an Bildungsträger, welche beabsichtigen, ihre Bildungsangebote mittels XML-Upload in KURSNET einzustellen. Die Übermittlung der Daten vollzieht sich über die von KURSNET zur Verfügung gestellte Upload-Schnittstelle.

Die Kataloge, welche die Bildungsangebote enthalten, müssen in Form von XML-Dateien, welche dem Standard open-Qcat entsprechen, übertragen werden. Da dieses Format jedoch ein bewusst offen gehaltener Standard zur Übermittlung von jeglichen Dienstleistungsinformationen ist, soll dieses Dokument, neben der eigentlichen Dokumentation des Standards, Unterstützung und Hilfestellung bei der Generierung von open-Qcat-Katalogen speziell für die Einstellung in KURSNET bieten.

Leitfaden zur Erstellung eines für KURSNET validen Katalogs

Neben dem wichtigsten Kriterium der Validität der XML-Datei gegenüber dem open-Qcat-Standard müssen speziell im Kontext von KURSNET zusätzlich diverse Punkte beachtet werden, um eine Einarbeitung in KURSNET zu gewährleisten.

1. Mapping open-Qcat - KURSNET- Eingabekomponente und Pflichtfelder

Sämtliche Eingabefelder der KURSNET-Eingabekomponente werden innerhalb von open-Qcat abgebildet, besitzen also ein Äquivalent. Zur Vereinfachung finden Sie eine Gegenüberstellung im Downloadbereich Download.

Dabei ist zu beachten, dass die in jener Liste als "Pflichtfeld" deklarierten Elemente zwingend notwendig in der open-Qcat-Datei auftauchen müssen, d.h. wird z.B. ein CONTACT-Element angelegt, muss dieses verbindlich die Unterelemente SALUTATION, LAST_NAME, PHONE und CONTACT_ROLE besitzen. Auch wenn jene Felder innerhalb des open-Qcat-Schemas optional sind, müssen sie im speziellen Kontext KURSNET gefüllt sein.

Das Mapping deckt nicht alle (möglichen) Elemente von open-Qcat ab, garantiert jedoch eine vollständige und ausreichende Einarbeitung und anschließende Publikation der Bildungsmaßnahmen in KURSNET.

2. Unterscheidung Bildungsangebote und Veranstaltungen in open-Qcat

In KURSNET wird zwischen Bildungsangeboten und Veranstaltungen unterschieden. Einem Bildungsangebot werden eine oder mehrere Veranstaltungen zugewiesen. Publiziert werden Angebote in KURSNET nur dann, wenn ihnen mindestens eine Veranstaltung zugewiesen wurde. Daher wird im open-Qcat-Standard ein SERVICE-Element als eine Veranstaltung angesehen.

Um jedoch obige Hierarchie zu wahren, werden auch Bildungsangebote als ein SERVICE abgebildet, für das insbesondere gilt: EDUCATION/@type = true. Bildungsangebote mit genau einer Veranstaltung werden also als ein einziges SERVICE-Element angelegt, allerdings muss(!) hierbei obiges Flag auf true gesetzt sein und es gilt: PRODUCT_ID = COURSE_ID. Dabei entspricht die PRODUCT_ID Ihrer eigenen im DV-System verwendeten ID der Bildungsmaßnahme. Bei solchen SERVICE Elementen muss das Element SERVICE_DETAILS/TITLE gefühlt sein.

Besitzt ein Bildungsangebot allerdings mehrere Veranstaltungen, muss für jede weitere Veranstaltung ein SERVICE-Baum angelegt werden, in dem auf das zugehörige übergeordnete Bildungsangebot verwiesen wird. Dies geschieht durch EDUCATION/@type = false, SERVICE/@mod = new und COURSE_ID = PRODUCT_ID des zugehörigen Bildungsangebots. In diesem Fall (SERVICE) gilt: PRODUCT_ID != COURSE_ID.

Beziehungen zwischen Bildungsangeboten (Aufbaukurs, Kursserien etc.) können über das Element SERVICE_REFERENCE abgebildet werden. Dabei werden die zur jeweiligen Kursserie gehörenden Einzelkurse in SERVICE_REFERENCE/@type = consists_of gelistet. Die Einzelkurse einer Serie werden als eigener SERVICE geführt.

3. BA-Validierungen des open-Qcat-Katalogs über das open-Qcat-Schema hinaus

Im Rahmen des Uploads eines open-Qcat-Katalogs werden neben der eigentlichen Validierung der Datei hinsichtlich des veröffentlichen open-Qcat-Standards diverse BA-Validierungen vorgenommen.

Eine Aufstellung der zusätzlichen Kriterien, welche beachtet werden müssen, damit die Upload-Schnittstelle in KURSNET den Katalog akzeptiert, finden Sie hier.

4. KURSNET-Konventionen für einzelne open-Qcat-Elemente

Bei der Verwendung bestimmter open-Qcat-Elemente müssen einige Konventionen beachtet werden, so dass die XML-Kataloge valide sind und in den Datenbestand von KURSNET integriert werden können. Diese Konventionen sind nicht in der offiziellen Dokumentation des open-Qcat-Standards vorzufinden, da sie speziell für den Kontext KURSNET gelten.

1. Die Inhalte der Elemente PHONE, FAX und MOBILE müssen immer (!), unabhängig vom Vaterelement, gegenüber dem Pattern \+*[0-9]+\.[0-9]+\.{0,1}[0-9]*) valide sein, wie z.B. +49.911.12345, d.h. Trennung Vor- und Durchwahl nur mit Punkt (keine anderen Zeichen zulässig!).
   Bem.: Der in der offiziellen open-Qcat-Dokumentation angegebene Beispiel-String +49 1234/567890 führt zu einem Parser-Fehler.
2. Die Inhalte des Elements CATALOG und seiner Kindelemente dienen der Identifizierung des Katalogs, werden allerdings nicht in den Datenbestand in KURSNET importiert, d.h. für die Publikation relevante Inhalte sollten z.B. nicht im Element CATALOG_NAME enthalten sein.
3. Das Element HEADER/SUPPLIER/CONTACT muss mindestens einmal mit dem Kindelement CONTACT_ROLE/@type = 2 (=Gesamtansprechpartner) oder CONTACT_ROLE/@type = 3 (= Leiter des Betriebs) vorhanden sein.
4. Es wird das Element HEADER/SUPPLIER/EXTENDED_INFO mit dem Attribut @input_type = 2 erwartet, unabhängig davon, ob weitere Kindelemente vorhanden sind. Ebenso wird das Kindelement ORGANIZATIONAL_FORM/Qtype="'#" erwartet. Diese Attribute sind Pflicht.
5. Das Attribut NEW_CATALOG/@full_catalog darf ausschließlich "true" bzw. "false" als Werte aufweisen.
6. Um eine Kurssystematik zu einem Bildungsangebot zuzuordnen, steht das open-Qcat-Element SERVICE_CLASSIFICATION zur Verfügung. Das Kindelement REFERENCE_CLASSIFICATION_SYSTEM_NAME, welches den Namen des Systematiksystems beinhaltet, kann standardmäßig für alle Bildungsangebote mit dem String "Kurssystematik" gefüllt werden. Die eigentliche Systematik, z.B. HA 602-72 ist im Element FEATURE/FNAME und die ausgeschriebene Bedeutung dieser Systematik, z.B. "Elektrotechnik Automatisierungstechnik" im Element FEATURE/FVALUE zu finden. Jedem Bildungsangebot können bis zu fünf Systematiken zugeordnet werden (d.h. bis zu fünf FEATURE-Elemente). Die komplette Systematik der Bundesagentur für Arbeit finden Sie im Downloadbereich.
   (vorübergehend ausgesetzt - auch möglich ohne Systematikzuordnung!!)
7. Verweise zwischen verschiedenen Bildungsangeboten können über das Element SERVICE_REFERENCE (Kind von SERVICE) realisiert werden. Als Verweisziel (PRODUCT_ID_REF) muss die PRODUCT_ID des zugehörigen SERVICE angegeben werden. In KURSNET werden hauptsächlich Bildungsangebotsserien über dieses Element abgebildet. Dabei besitzt nur die Serie selbst SERVICE_REFERENCE-Elemente mit den Verweisen auf die Serieninhalte, /-module, weswegen in diesem Fall das Attribut type mit dem Wert "consists-of" zu füllen ist.
8. Diverse open-Qcat-Elemente, wie z.B. INSTRUCTION_FORM, CONTACT_ROLE oder INSTITUTION besitzen ein verbindliches Attribut type (integer), dessen Wert aus einer Liste vorgegebener Werte gewählt werden kann (Enumeration in open-Qcat). Um das Element selbst (String) ebenfalls zu füllen, wurde vereinbart, den Klartext zu jenem integer-Wert zu verwenden.
   Bsp.: Leiter des Betriebs
9. Werden unterhalb des open-Qcat-Elements MODULE_COURSE die Elemente DURATION/START_DATE und DURATION/END_DATE (Veranstaltungszeiträume) verwendet, ist für eine Einarbeitung dieser Informationen in KURSNET unabdingbar, dass ebenso die Elemente MODULE_COURSE/MODULE_ORDER und MODULE_COURSE/EXTENDED_INFO/SEGMENT_TYPE gefüllt sind.

10. Sollen Zertifizierungen für Bildungsangebote übermittelt werden, geschieht dies im Element CERTIFICATE. Eines dessen Kindelemente ist CERTIFIER_NUMBER, welches eine Nummer der Zertifizierers abbildet.

    Diese Nummer befindet sich in einer aktuellen Liste der Zertifizierer-Daten, welche im Downloadbereich zu finden ist.

11. Maßnahmenummern für Veranstaltungen werden im Feld MEASURE_NUMBER übermittelt. Diese müssen jedoch immer dem Pattern [0-9]{3}+\-[0-9]{4}+\-[0-9]{2} entsprechen.
    Bsp: 123-4567-89
12. Eine Adresse muss immer die Elemente NAME, CITY und ZIP beinhalten. Zur Übertragung eines leeren Veranstaltungsortes müssen folgende Elemente übertragen werden: <LOCATION><NAME/></LOCATION>
13. Der name eines Ansprechpartners (CONTACT/LAST_NAME) darf nicht leer sein.