Spezifikation: Kurs Markup Language (KursML)

Abstrakt

KursML definiert ein XML-Schema zur Beschreibung von Kursdaten. Die Spezifikation hat insbesondere das Ziel, die Zusammenarbeit verschiedener Systeme und Datenbanken für Kursdaten zu ermöglichen. Ein zugehöriger Rubriken-Katalog dient hierbei der Klassifikation von Kursen.

Update 23.01.2024

Es wurde ein neues Element <fachkursEsf> definiert. Dieses steht für <kurs> und <onlinekurs> zur Verfügung und markiert Kurse die förderfähig nach dem Fachkursprogramm des Europäischen Sozial Fonds (ESF) sind.

Update 20.01.2023

Es wurde ein neues Element <onlinekurs> definiert. Das bisherige Element <kurs> wird weiterhin als Präsenzkurs interpretiert.

Ressourcen

Aktuelles (spec-20240123) XML-Schema von KursML

Rubriken-Katalog für KursML
Die Hauptrubriken (1.0.0.0.0, 2.0.0.0.0, 3.0.0.0.0 …) dürfen nicht gewählt werden. Es muss mindestens die erste Unterrubrik genommen werden.

Auch wenn WebFIFO-Online die Rubriken von Katalog-Version 1.9.2005 automatisch auf jene vom 15.11.2015 zuordnet, empfehlen wir zum frühest möglichen Zeitpunkt auf den neuen, verbesserten Katalog zu wechseln.

Beispiel einer gültigen XML-Datei gemäß KursML:

Tools: XML-Validator online

Beschreibung KursML

KursML ist eine XML-Beschreibung für Weiterbildungskurse und dient in erster Linie als Austauschformat zwischen Kursdatenbanken. Da in den meisten Datenbanken die Veranstaltungen in einem Katalog festen Rubriken zugeordnet sind, bringt KursML einen eigenen Rubriken-Katalog zur semantischen Klassifikation der Kurse mit, sodass bei einer Datenübernahme oder -übergabe eine Abbildung zwischen den KursML-Rubriken und spezifischen Rubriken stattfinden und somit eine automatisierte übernahme in Kataloge erfolgen kann.

Die Struktur einer KursML-Datei ist:

<?xml version="1.0" encoding="UTF-8"?>
<kurse
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:noNamespaceSchemaLocation="https://www.fortbildung-bw.de/kurserfassung/KursML/spec-20130913/kursml.xsd"
>

	<kurs>
	 … Hier alle Angaben zu einer Veranstaltung
	</kurs>

	<kurs>
	 … Hier alle Angaben zu einer Veranstaltung
	</kurs>

	… weitere Kurse …
</kurse>

Pflichtangaben

Bei den Angaben zu einer Veranstaltung innerhalb von <kurs> und <onlinekurs> sind nur einige Angaben/Tags zwingend erforderlich. Diese unterscheidet sich für <kurs> und <onlinekurs> und werden im Folgendem erläutert.

Beschreibung <onlinekurs>

Ein <onlinekurs> beschreibt einen Kurs ohne Vor-Ort-Veranstaltungen mit meistens ständig möglichem Einstieg. Im Gegensatz zum <kurs> definiert er deshalb keine Starttermine, zu denen jeweils ein Kurs anfängt (Mit Folgeterminen für die nächsten Kurse), sondern einen Veröffentlichungszeitraum <publizierenAb> bis <publizierenBis>. Er setzt zudem einen ständig erreichbaren Ansprechpartner voraus. Hierfür wurde die neue Angabe <ansprechpartner> definiert. Des Weiteren bietet er die Möglichkeit, mittels des neuen Elements <workload>, den zu erwartenden Zeitaufwand zu beschreiben.

Pflichtangaben bei <onlinekurs>

<ansprechpartner anrede="Frau|Herr|k.A." >
	<titel>Dr. Med.</titel>
	<vorname>Marta</vorname>
	<nachname>Muster</nachname>
</ansprechpartner>

Sonstige Angaben bei <onlinekurs>

Andere Angaben sind optional und sollten nach Möglichkeit belegt werden:

Der Onlinekurs bietet die Möglichkeit den zu erwartenden Aufwand für einen Onlinekurs zu definieren. Hierzu steht das Element <workload> zur Verfügung. Es bietet an die Art der Blockeinheit ("workloadIntervalType" in Tagen, Wochen oder Monaten) die Anzahl Einheiten ("workloadIntervalCount") und die Menge der Stunden Pro Einheit ("workloadIntervalHours") zu beschreiben. 

<workload workloadIntervalType="day|week|month" >
	<workloadIntervalCount>5</workloadIntervalCount>
	<workloadIntervalHours>4</workloadIntervalHours>
</workload>

Beschreibung <kurs>

Ein Präsenzkurs

Pflichtangaben bei <kurs> (Präsenzkurs)

Seit dem 19.09.2017 sind die folgenden Felder nicht mehr zwingend erforderlich, aber empfohlen. Sie müssen aber, wenn angeben sind, den Kriterien wie definiert genügen.

Sonstige Angaben bei <kurs> (Präsenzkurs)

Andere Angaben sind optional und sollten nach Möglichkeit belegt werden:

Veraltete XML-Schema von KursML zur Recherche

Impressum

Die Spezifikation wurde erstellt von der krumedia GmbH im Auftrag des Ministeriums für Wirtschaft, Arbeit und Tourismus Baden-Württemberg für die Kurserfassung des Portals Weiterbildung in Baden-Württemberg (Impressum).

Spezifikation, Rubriken-Katalog und Beispiele sind frei von Rechten, öffentlich zugänglich und von jedermann nutzbar.

Betreiber dieser Website ist das Ministerium für Wirtschaft, Arbeit und Tourismus Baden-Württemberg.