Technische Voraussetzungen/Informationen

Allgemeine Informationen open-Qcat Version 1.1

Die KURSNET Upload-Schnittstelle basiert auf XML im open-Qcat-Standard. Open-Qcat ist ein Datenaustauschformat für Aus- und Weiterbildungsdienstleistungen und wurde vom Fraunhofer Institut Arbeitswirtschaft und Organisation Stuttgart (IAO) entwickelt und an die Bedürfnisse von KURSNET angepasst. Bildungsanbieter können ihre Angebote direkt aus ihrer Datenbank an KURSNET übermitteln, wenn sie die Daten in das open-Qcat-Format transformieren. Hier war mit der Version open-Qcat 1.0 immer nur eine Übermittlung aller Daten (Gesamtkatalog) möglich.

Seit 18.11.2007 haben wir KURSNET auf das erweiterte open-Qcat 1.1 umgestellt. Damit besteht die Möglichkeit, Bildungskataloge als Gesamt- oder Differenzlieferung der Datenbank KURSNET zu übermitteln.

Wir empfehlen allen Anwendern, die die open-Qcat-Schnittstelle nutzen, auf die neue open-Qcat Version 1.1 umzustellen.

Die Verarbeitung der Datenlieferung in der open-Qcat Version 1.0 wird übergangsweise noch einige Zeit unterstützt werden.

Bei erstmaliger Implementierung der XML-Schnittstelle empfehlen wir, den Leitfaden zu lesen.
Wenn Sie zum Erstellen der XML-Datei unser Starterkit in der Version 1.0 benutzen, laden Sie sich bitte die neue Version des Starterkits herunter (Version 1.1). Die neue Version validiert die Feldwerte gegen die aktuellen Wertebereiche und erzeugt ggf. eine XML-Datei im Format open-Qcat 1.1.
Wenn Sie bereits Daten in der KURSNET-Datenbank haben und erstmals auf XML-Upload wechseln, laden Sie auf jeden Fall erst eine Gesamtlieferung hoch, bevor Sie die Differenzlieferung nutzen. Mit der initialen Gesamtlieferung erhalten wir Ihre Veranstaltungs-IDs, mit denen wir die künftigen Differenzlieferungen vergleichen. Dies ist für einen reibungslosen Datenaustausch nötig.

Die Vorteile von open-Qcat Version 1.1

Im Rahmen der Weiterentwicklung des Upload-Verfahrens über die XML- Schnittstelle wurde die Version open-Qcat 1.1 entwickelt. Diese ermöglicht neben der Gesamtlieferung aller Daten die Lieferung von einzelnen Bildungsangeboten.

Durch die Einspielung der Differenzlieferung wird die Übertragung geänderter, neu angelegter oder zu löschender Bildungsangebote möglich.
Wenn Sie zum Beispiel aus Ihrem Gesamtangebot einer Veranstaltung neue Ansprechpartner oder einen neuen Veranstaltungsort zuordnen, können Sie mit open-Qcat 1.1 allein diesen veränderten Datensatz exportieren und nach KURSNET übertragen. Und wenn Sie eine neue Veranstaltung zu einem existierenden Bildungsangebot anlegen, brauchen Sie künftig nur diesen neuen Datensatz für KURSNET bereitzustellen. Bei der Ursprungsversion open-Qcat 1.0 ist nur die Lieferung des gesamten Katalogs möglich gewesen.
Da alle Daten, die Sie nach KURSNET übertragen, in unsere Qualitätssicherung geschickt werden, reduziert sich der zeitliche Prüfungsaufwand vor der Veröffentlichung damit erheblich und Bildungsangebote können schneller in "KURSNET-Bildungsangebote einfach finden" veröffentlicht werden.

In open-Qcat 1.1 wurden die Wertebereiche für mehrere produktspezifische Elemente aus dem Schema entfernt. Die Wertebereiche sind nun in extra Listen definiert, die Sie hier herunterladen können. Das open-Qcat-Schema sollte daher künftig nicht mehr geändert werden müssen.

Technische Neuerungen des open-Qcat Version 1.1

Open-Qcat 1.1 ist abwärts kompatibel. Sie können Ihren XML-Katalog im open-Qcat 1.0-Format einfach als Version 1.1 auszeichnen, und der Import nach KURSNET wird weiterhin funktionieren. Allerdings sind die Wertebereiche für die Felder Schulart und Bildungsart nicht mehr aktuell. Sie werden beim Import bestmöglich auf die neuen Werte umgesetzt. Wir empfehlen daher, die aktuellen Wertebereiche herunterzuladen und in Ihrer Datenbank zu aktualisieren. Neben dem bisherigen XML-Element 'NEW_CATALOG', welches Wurzelelement einer Gesamtlieferung ist, gibt es nun das Element 'UPDATE_CATALOG', in dem Teillieferungen übermittelt werden können.
Eine gleichzeitige Verwendung beider Elemente ist nicht sinnvoll und wird beim Import in KURSNET nicht unterstützt.

Das Element UPDATE_CATALOG kann die Unterelemente 'DELETE' und 'NEW' beinhalten.

• 1. Das Element DELETE beinhaltet eine Aufzählung von ID's der Veranstaltungen, die gelöscht werden sollen. z.B.: <SERVICE><PRODUCT_ID>VG_1297-426</PRODUCT_ID></SERVICE></li>
• 2. Das Element NEW beinhaltet die modifizierten Bildungsangebote.

Folgende KURSNET-spezifische Wertebereiche wurden aus dem open-Qcat-Schema entfernt:

• 1. Die Organisationsart des Bildungsanbieters
• 2. Die Rollen der Ansprechpartner beim Bildungsanbieter und bei der Veranstaltung
• 3. Arten der Behinderungen, für die das Bildungsangebot geeignet oder nicht geeignet ist
• 4. Die Bildungsart (neue Wertetabelle!) des Bildungsangebots
• 5. Die Schulart (neue Wertetabelle!) des Bildungsangebots
• 6. Der Zertifizierungsstatus des Bildungsangebots
• 7. Die Unterrichtsform der Veranstaltung
• 8. Die Art des Veranstaltungsabschnitts

Für Bildungsträger, die die open-Qcat Version 1.1 nutzen wollen, stehen im Downloadbereich die neuen Wertetabellen zur Verfügung.

Was passiert beim Import in KURSNET?

Über die PRODUCT_ID und COURSE_ID wird geprüft, ob Bildungsangebote oder Veranstaltungen bereits im Datenbereich von "KURSNET-Bildung einfach anbieten" vorliegen.
Werden Bildungsangebote oder Veranstaltungen mit diesen ID's gefunden, so erfolgt eine Änderung dieser Datensätze, ansonsten werden sie neu angelegt.

Ein weiterer Abgleich erfolgt bei den ID's von CONTACT/ID_DB (Ansprechpartner) und LOCATION/ID_DB (Veranstaltungsort) im aktuellen Datenbestand des Bildungsanbieters.
Sollte kein Ansprechpartner oder Veranstaltungsort mit einer solchen ID vorliegen, wird dieser angelegt.

Weitere Informationen sind im Downloadbereich hinterlegt.