XML-Datei-Struktur der Standardaufbereitung Internet

Die Standardaufbereitung Internet erzeugt eine fest definierte XML-Struktur, die Sie in einem eigenen Web-Auftritt oder in CMS-Importern weiterverarbeiten. Dieser Artikel listet die wichtigsten Knoten und Felder, erklärt die Sonderfälle (Barrierefreiheits-Suffix, frei definierbare KURSAUSWAHL-Felder) und nennt die für Anmeldungen relevanten Schalter. Eine konzeptionelle Einordnung der Standardaufbereitung finden Sie in Standardaufbereitung Internet: Überblick und Voraussetzungen.

ℹ️ Hintergrund: Die XML-Struktur ist valide, d. h. sie ist nach international geltenden Regeln konstruiert und besitzt eine Dokument-Type-Definition (DTD). Die Standard-Internet-Datei ist laut Kufer Software die empfohlene Exportmöglichkeit, deren Wartung und Pflege auch für die Zukunft gewährleistet ist.

⚠️ Achtung: Sehen Sie diese Übersicht als Feld-Referenz, nicht als Bedienanleitung. Für die Konfiguration des Exports siehe Standardaufbereitung Internet (XML) einrichten und ausführen.

Allgemeine Regeln

XML-Deklaration: <?xml version="1.0" encoding="windows-1252"?>.
Zeichensatz-Option im Export-Dialog: Mit Umlaute nach XML konvertieren wird die Ausgabedatei so erzeugt, dass Umlaute und Sonderzeichen in HTML-üblichen Steuerzeichen erscheinen. (In Handbüchern findet sich für dieselbe Option auch die Bezeichnung Umlaute nach HTML konvertieren.)
Wurzel-Element: <KURSE> enthält beliebig viele <KURS>-Kinder, sortiert aufsteigend nach Kursnummer.
Leere Felder: Werden als selbstschließendes Element <FELD /> ausgegeben.
Boolean-Werte: W = wahr / Häkchen gesetzt, F = falsch / Häkchen nicht gesetzt.
Suffix _BF: Identischer Inhalt wie das Basisfeld, aufbereitet für Barrierefreiheit (z. B. ausgeschriebene Begriffe statt Abkürzungen). Auch unter dem Präfix TERMIN_ bei Kurstagen verfügbar.

Top-Level-Felder pro Kurs

Identifikation und Titel:

<KNR> — Kursnummer.
<TITELKURZ>, <TITELKURZ_BF> — Titel kurz und barrierefreie Variante.
<TITELLANG>, <TITELLANG_BF> — Titel für Programmheft mit BF-Variante.
<HAUPTTITEL>, <HAUPTUNTERTITEL> — Kurstitel und Untertitel (je eine Zeile).
<INHALT>, <WEB_INFO> — Kursinfo allgemein und Web-spezifische Info.
<VORSPANN>, <NACHSPANN> + BF-Varianten — Vor- und Nachspann-Texte.
<ABGBEMERK> — Abschließende Bemerkung (identisch mit <ABBEMERKUNG> weiter unten).
<INTNOTIZ> — Interne Notiz.

Internet-Status und erlaubte Anmeldearten:

<INTERNETAKTIV> — W = Kurs für Internet freigegeben, F = nicht freigegeben.
<KEINEWEBANMELDUNG> — Steuert, ob eine Anmeldung möglich ist (Logik im PDF: W = nicht freigegeben für Anmeldung, F = freigegeben).
<KEINEWEBANMELDUNGTEXT> — Anmerkungstext.
<ERLAUBTNORMALEANMELDUNG>, <ERLAUBTELTERNKINDANMELDUNG>, <ERLAUBTFIRMENANMELDUNG>, <ERLAUBTMEHRFACHANMELDUNG>, <ERLAUBTPAARANMELDUNG> — W/F je Anmeldeart.

Organisation und Klassifikation:

<IND_TERM> — Individuelle Terminangaben.
<AUSSENSTELLE>, <SEMESTER>.
<AUSFALL> — J = Kursausfall (nur bei Ausfall ausgegeben).
<FACHBBVV> (BVV/DVV-Fachbereich), <FACHBLAND> (Bundesland-Fachbereich), <FACHB> (interner Fachbereich), <FACHBTEXT> (Bezeichnung des Fachbereiches).

Zeitliche Eckdaten:

<BEGINNDAT> / <ENDEDAT> — Beginn-/Enddatum im Format dd.mm.yyyy.
<DAUER>, <DAUERDETAILS>.
<KURSTYP> — Normalkurs / Eltern-Kind-Kurs / Kinderkurs (1. Seite Kursstamm).
<ONLINE_KURSTYP> — Präsenz, Online, Hybrid, Blended Learning, Selbstlernangebot (3. Seite Kursstamm).
<BEGINNUHR>, <ENDEUHR> — Uhrzeiten hh:mm.
<NEUERKURS> — W = Häkchen „Neuer Kurs” gesetzt, F = nicht gesetzt.

Frei definierbare Felder:

<KURSAUSWAHL1> … <KURSAUSWAHL16> — Inhalte der frei definierbaren Eingabefelder der 3. Seite des Kursstamms. Die Bezeichner der Felder werden bewusst nicht übermittelt. Bei Checkboxen wird W / F ausgegeben, bei anderen Typen (Text, Zahl, Komma, Datum) das Feld nur, wenn gefüllt.

Kursort und Adressdaten

<ORT> — Kursort.
<ORTID> — Interne Nummer des Kursortes.
<ORTRAUMNR>, <ORTRAUMNAME>, <ORTRAUMNAME_BF>, <ORTRAUMKURZ> — Raumnummer, Raumbezeichnung mit BF-Variante, Raumkurzbezeichnung.
<ORTGEBAEUDE> — Gebäude (z. B. Schule).
<ORTSTR>, <ORTPLZ>, <ORTNAME> + BF-Varianten — Straße, PLZ, Ortsname mit BF.
<ORTPROGH> — Kursort-Bezeichnung für Programmheft.
<ORTAUSSENSTELLE>, <ORTAUSSENSTELLE_BF> — Außenstelle.

Gebühren

<GEBNORM> — Gesamtbetrag Normalgebühr (Format e,cc).
<GEBERM> — Gesamtbetrag Ermäßigte Gebühr.
<GEBUEHREN> mit Kindern <GEBUEHR> (nur, wenn im Export-Dialog Gebührendetails ausgeben aktiviert ist):
- <TEXT> — Gebührenbezeichnung.
- <BETRAGNORM> — Normalbetrag.
- <BETRAGERM> — Ermäßigter Betrag.
<GEB_SCHW1>, <GEB_SCHW2> — Schwellengebühren 1 und 2.
<GEBUEHRNULLTEXT> — Text, wenn Gebühr 0,00 ist (z. B. „kostenfrei”).
<GEBUEHRERGAENZTEXT> — Ergänzender Text für die Gebührendarstellung.

Teilnehmer und Anmeldungen

<TNMAX>, <TNMIN> — Maximale und minimale Teilnehmerzahl.
<ANMELDEART>, <VORGESCHRIEBENER_STATUS> — Anmeldeart-Kürzel und Status.
<TNANMELDUNGEN> — Anzahl aktueller Anmeldungen.
<TNSCHW1>, <TNSCHW2> — Teilnehmerschwellen.
<TNMINSATZ2> — Teilnehmerminimum für Gebührensatz 2.
<TNWARTELISTE> — Anzahl Teilnehmer auf der Warteliste.
<BISMAXTN> — W = nur bis Maximum belegen, F = darüber hinaus.
<ANMENDE> — Anmelde-Ende.

Termine

Die <TERMINE>-Liste enthält pro Kurstag ein <TERMIN>-Element mit:

<TAG> — Datum des Kurstages.
<ZEITVON>, <ZEITBIS> — Beginn- und Ende-Uhrzeit.
<TERMIN_DOZ>-Block — Dozenten-Daten für den Kurstag (Vorname, Nachname, Titel, Anredetitel + BF-Varianten, Geschlecht, Beruf, Telefon privat/dienstlich, Mobil, Fax, E-Mail, Aktiv-Status).
<TERMIN_ORT>, <TERMIN_ORT_ID>, <TERMIN_ORTRAUMNR>, <TERMIN_ORTRAUMNAME> + BF, <TERMIN_ORTGEBAEUDE>, <TERMIN_ORTSTR>, <TERMIN_ORTPLZ>, <TERMIN_ORTNAME> + BF, <TERMIN_ORTPROGH>, <TERMIN_ORTAUSSENSTELLE> + BF — vollständige Adressdaten je Kurstag.
<TERMIN_STATUS> — Status des Kurstages als Text.
<TERMINTEXT1> — Bemerkung zum Kurstag.

💡 Warum pro Kurstag eigene Dozenten-/Ortsdaten? Bei wechselnden Dozent:innen oder bei mehreren Räumen über die Kurslaufzeit kann jeder Kurstag eigene Felder übermitteln. Das ist die Grundlage für barrierefreie Detail-Darstellungen im Web.

Dozenten (kursübergreifend) und Zusatztexte

<HAUPTDOZENT> referenziert die interne Nummer des Hauptdozenten. Im <DOZENTEN>-Block folgt pro <DOZENT> ein vollständiger Datensatz:

<NUMMER> / <DNR> — Interne Nummer.
<VORNAME>, <NAME> + BF, <TITEL> + BF, <ANREDETITEL> + BF.
<GESCHLECHT>, <BERUF> + BF.
<TELEFON_PRIVAT>, <TELEFON_DIENSTLICH>, <MOBIL>, <FAX>, <EMAIL>.
<AKTIV> — J/N.
<DOZ_INTERNET> — W = Freigabe für Internet gesetzt, F = nicht gesetzt.
<KOMPETENZ>, <DOZ_TYP>.
<QUALIFIKATIONEN> mit <QUALIFIKATION>-Kindern.

Zusatztexte und Statistik-Daten:

<MATERIAL> — Materialien / Mitzubringen.
<WARNTEXT> — Warn-Hinweis.
<VERANART>, <VERANART_BF> — Veranstaltungsart aus Hinterlegung.
<VERANZIEL> — Veranstaltungs-Ziel (Statistikdaten).
<ZIELGRUPPE> — Zielgruppen-Statistikdaten.
<ZEUGNIS>, <ZEUGNIS_BF> — Texte für Zeugnisse und Kursbestätigungen.
<KOOPERATION> — Kooperations-Statistikdaten.
<USTD> — Unterrichtseinheiten (Format x,xx).
<ALLETAGE> — J/N für Druck der Kurstage auf Seite Planung/Progr.
<KEINKURSBEGINNTEXT> — Text, wenn der Kursbeginn undefiniert ist.
<TERMINDARSTWEB> — Sonderfeld für die Termindarstellung im Web.
<KEINEWEBANMELDTEXT> — Text, wenn keine Internet-Anmeldung möglich ist.
<BEARBEITER> — letzter Bearbeiter.
<MITARBEITER_PLANEND>, <MITARBEITER_VERWALTEND> — zuständiger planender bzw. verwaltender Mitarbeiter.

Frei verwendbare Zusatztexte:

<ZT_VORAUSSETZUNGEN>, <ZT_ZIEL>, <ZT_ZIELGRUPPE> + BF, <ZT_METHODE>, <ZT_ANMELDE>, <ZT_ZUSATZTEXT6> … <ZT_ZUSATZTEXT10> — frei nutzbare Felder.

Web-Steuerung:

<WEB_SUCHBEGRIFFE> — Suchbegriffe.
<INTERNETVON>, <INTERNETBIS> — Web-Freigabe-Zeitraum (Format dd.mm.yyyy).

Stichworte, Kennzeichen, Kategorien, Webseite

Stichworte:

<STICHWORTE> mit <STICHWORT>-Kindern, je mit <STICHWORTTEXT> und <STICHWBEMERK>.

Kurskennzeichen:

<KURSKENNZEICHEN> mit <KENNZEICHEN>-Kindern, je mit <NR> und <TEXT>.

Kategorien und Sonderkategorien:

<KATEGORIEN> / <KATEGORIE> und <SONDERKATEGORIEN> / <SONDERKATEGORIE> — je mit <BEZEICHNUNG>, <BEZEICHNUNGSTRUKTUR> (Baum-Struktur), <BESCHREIBUNG>.

Webseite und Dokumente:

<WEBSITE> — wird aus dem zentralen Link zum Kursprogramm und der Kursnummer ({%k_id%}) erstellt.
<DOKUMENTE> mit <DOKUMENT>-Kindern (Stand, Bemerkung, INTERNET/URL, Kosten, Kostenbemerkung).
<BILDER> mit <BILD>-Kindern (<URL> mit Pfad zum Bild, <UNTERTITEL>, <BESCHREIBUNG> — aktuell nur für RCE-Export).

Einsatz im eigenen CMS

Verwenden Sie für den Import einen XML-Parser Ihrer Plattform-Wahl (PHP SimpleXML, Python lxml, .NET XDocument). Die Standard-Internet-Datei ist die von Kufer Software empfohlene Exportmöglichkeit; Kufer Software pflegt und wartet sie auch künftig. Für die Feld-Reihenfolge in künftigen KuferSQL-Versionen gibt es dagegen keine Zusage — parsen Sie daher feldbezogen und nicht positionsabhängig.

💡 Barrierefreie Darstellungen aufbauen: Die Variablen mit der Endung _BF geben die Daten in einer für Barrierefreiheit vollständig ausgeschriebenen Form aus. Wie Sie Basisfeld und BF-Variante in Ihrem Layout kombinieren, ist eine Implementierungs-Entscheidung Ihres Projekts; eine feste Vorrang- oder Fallback-Regel gibt es dafür nicht.

Ergebnis

Sie kennen die wichtigsten Knoten und Felder der XML-Standardaufbereitung, wissen, wo Barrierefreiheits-Varianten zu finden sind, und können CMS-Imports auf die gepflegte Standardschnittstelle aufsetzen.

✅ Geschafft: Die Feld-Referenz steht bereit. Welche Kurse überhaupt im Export landen, steuern Sie über Kurse für den Export freigeben; die zyklische Übertragung erfolgt mit BAS_EWeb für automatische Übertragung einrichten.