Technische Voraussetzungen/Informationen

Upload-Schnittstelle - Verarbeitung beim Upload

Folgende Schritte werden im Rahmen des Dokumentenuploads bei KURSNET durchgeführt, nachdem Sie Ihren open-Qcat-Katalog übertragen haben:

1. Der Katalog wird gegen das open-Qcat-Schema des Fraunhofer-Instituts validiert. Entspricht er nicht dem Schema, wird dies (zusammen mit der Fehlermeldung) angezeigt.
2. Parallel zu obiger Validierung gegen das Schema werden zusätzliche BA-spezifische Kriterien, die innerhalb des Katalogs zur Veröffentlichung in KURSNET gegeben sein müssen, überprüft (siehe hierzu Zusätzliche BA-Validierungen des Open-Qcat-Katalogs). Ergeben sich an diesem Punkt Probleme, werden diese (zusammen mit der Fehlermeldung) angezeigt.
3. Nach erfolgreicher Validierung wird der XML-Katalog über ein XSLT-Sheet in ein internes XML-Format umgewandelt.
4. Der Katalog im neuen XML-Format wird in die KURSNET-Datenbank importiert. Nach erfolgreichem Import wird eine Importstatistik angezeigt.
5. Ihre Daten werden in "KURSNET - Bildung einfach anbieten" nach erfolgter Qualitätssicherung durch die KURSNET-Redaktion veröffentlicht. Dies beansprucht ca. 2 bis 3 Werktage.

Zusätzliche BA-Validierungen des Open-Qcat-Katalogs

Im Rahmen des Uploads eines Open-Qcat-XML-Katalogs werden neben der eigentlichen Validierung der Datei hinsichtlich des veröffentlichten Open-Qcat-Schemas diverse BA-Validierungen vorgenommen.

Dies liegt in der Tatsache begründet, dass spezielle für die KURSNET-Anwendung bzw. den Datenbestand notwenige Informationen in geeigneter Form übertragen werden müssen, um die Kataloginhalte veröffentlichen zu können. Diese Informationen sind innerhalb des Open-Qcat-Schemas jedoch nicht als verbindlich vorgeschrieben.

Zusätzlich zur Validität des Open-Qcat-Katalogs bzgl. des Schemas werden folgende BA-relevanten Kriterien überprüft:

• Die in SUPPLIER_ID angegebene ID muss mit der von KURSNET vergebenen übereinstimmen.
  Fehlermeldung: "Ungültige SUPPLIER_ID im Katalog eingetragen. Ihre SUPPLIER_ID ist xxx."
• (min 1) SUPPLIER/CONTACT muss vorhanden sein.
  Fehlermeldung: "In Ihrem Katalog befinden sich keine Ansprechpartner für den Bildungsanbieter."
• Jede Adresse muss das Element NAME beinhalten.
  Fehlermeldung: "In Ihrem Katalog befindet sich eine Adresse ohne Namen."
• Das Element ADDRESS/BOXNO darf nich länger als 10 Zeichen sein.
  Fehlermeldung: "cvc-maxLength-valid: Value YYY with length = '13' is not facet-valid with respect to maxLength 10."
• SERVICE_MODULE/EDUCATION/MODULE_COURSE/LOCATION muss in jedem SERVICE_MODULE-Unterbaum enthalten sein und das Element NAME beinhalten.
  Fehlermeldung: "In Ihrem Katalog befindet sich eine Veranstaltung ohne zugehörigen Ort." bzw.
  Fehlermeldung: "In Ihrem Katalog befindet sich ein Veranstaltungsort ohne Namen."
• Jeglicher CONTACT muss das Element LAST_NAME beinhalten.
  Fehlermeldung: "In Ihrem Katalog befindet sich ein Ansprechpartner ohne Nachnamen."
• Jede SERVICE_MODULE/EDUCATION/MODULE_COURSE/LOCATION muss als Straßenort angegeben sein, d.h. ZIP und CITY müssen gefüllt sein.
  Fehlermeldung: "In Ihrem Katalog existiert ein Veranstaltungsort der kein Straßenort ist." bzw.
  Fehlermeldung: "In Ihrem Katalog existiert ein Veranstaltungsort ohne Ortsangabe."
• (min 1) SERVICE/SERVICE_CLASSIFICATION muss in jedem SERVICE-Baum vorhanden sein. Innerhalb von diesem muss darüber hinaus das Element REFERENCE_CLASSIFICATION_SYSTEM_NAME genau einmal und das Element FEATURE mindestens einmal und maximal fünfmal enthalten sein.
  Fehlermeldung: "In Ihrem Katalog besitzt ein Bildungsangebot keine Systematik." bzw.
  Fehlermeldung: "In Ihrem Katalog besitzt ein Bildungsangebot keine oder mehr als fünf Systematikzuordnungen."
  (vorübergehend ausgesetzt - auch möglich ohne Systematikzuordnung !!)
• Jegliche im Katalog verwendete SERVICE/SERVICE_DETAILS/SERVICE_MODULE/COURSE_ID (sei es als "Vater-"Dienstleistung oder als Verweis auf eine andere Dienstleistung) muss sich genau einmal in einem SERVICE-Unterbaum befinden, für welchen gilt: SERVICE/SERVICE_DETAILS/SERVICE_MODULE/EDUCATION/@type = true
  Fehlermeldung: "In Ihrem Katalog verweisen Sie mit einer Course_id auf eine andere Dienstleistung, die kein Vater ist (kein education_type = true)."
• SERVICE/SERVICE_DETAILS/DESCRIPTION_LONG muss vorhanden sein (insbesondere wenn gilt SERVICE/SERVICE_DETAILS/SERVICE_MODULE/EDUCATION/@type = true)
  Fehlermeldung: "In Ihrem Katalog befindet sich ein Bildungsangebot ohne Beschreibung."
• Innerhalb von SERVICE/SERVICE_REFERENCE darf im Element PRODUCT_ID_REF nur auf andere Dienstleistungen verwiesen werden, für die gilt: SERVICE/SERVICE_DETAILS/SERVICE_MODULE/EDUCATION/@type = true
  Fehlermeldung: "In Ihrem Katalog verweisen Sie in SERVICE_REFERENCE auf eine andere Dienstleistung, die kein Vater ist (kein education_type = true)."
• Bildungsangebote werden intern in KURSNET durch SERVICE/SERVICE_DETAILS/SERVICE_MODULE/EDUCATION/@type = true identifiziert.
  Sollten Sie nun einige der folgenden Elemente, welche innerhalb der KURSNET-Anwendung als Eigenschaften eines Bildungsangebots verstanden werden, nur in Service-Bäumen, in denen SERVICE/SERVICE_DETAILS/SERVICE_MODULE/EDUCATION/@type = false gilt, verwenden und nicht in der zugehörigen "Vater-"Dienstleistung (EDUCATION/@type=true), werden diese überlesen und nicht eingearbeitet.
  Sollten Sie daher eines der folgenden Elemente in einem "false"-Service-Baum angeben, erscheint folgende Warnung: "In Ihrem Katalog haben Sie das Element xy in einer Dienstleistung, welche kein Vater ist, angegeben. Es wird daher überlesen."
  • SERVICE/SERVICE_DETAILS/SERVICE_MODULE/EDUCATION/DEGREE
  • SERVICE/SERVICE_DETAILS/SERVICE_MODULE/EDUCATION/CREDITS
  • SERVICE/SERVICE_DETAILS/SERVICE_MODULE/EDUCATION/HANDICAP
  • SERVICE/SERVICE_DETAILS/SERVICE_MODULE/EDUCATION/SUBSIDY
  • SERVICE/SERVICE_DETAILS/SERVICE_MODULE/EDUCATION/CERTIFICATE
• Das Element OPENQCAT muss das Attribut version beinhalten, welches ab Dezember 2007 die Werte "1.0.0" oder "1.1" haben darf.
• Innerhalb von SERVICE_MODULE/EDUCATION wird nur das Element MODULE_COURSE ausgewertet. Die Verwendung von MODULE_CBT oder MODULE_WBT wird nicht zugelassen.
  Fehlermeldung: "Sie verwenden innerhalb Ihres openQ-CAT-Kataloges folgende Elemente, die von KURSNET nicht zugelassen werden. "
• Das Element SERVICE_MODULE/EDUCATION/EXTENDED_INFO muss die Elemente INSTITUTION, INSTRUCTION_FORM und EDUCATION_TYPE mit dem zugehörigen Attribut "type" beinhalten.
• Bei den Katalogen ab der open-Qcat-Version 1.1 werden die Werte der Attribute "type" der folgender Elemente geprüft: CONTACT_ROLE, ORGANIZATIONAL_FORM, DEGREE, INSTITUTION, INSTRUCTION_FORM, EDUCATION_TYPE und SEGMENT_TYPE. Die gültigen Wertebereiche finden Sie "hier".
  Fehlermeldung: "Der Wert 'x' ist beim Element NAME nicht zugelassen. "
• Das Format der E-Mails muss dem folgenden regulären Ausdruckt genügen: [0-9a-zA-Z\-_\.]+@{1}[0-9a-zA-Z\-_\.]+\.{1}[a-zA-Z]{2,}
  Fehlermeldung: "Die folgenden E-Mails entsprechen nicht dem geforderten Format. "
• Bei den Katalogen ab der open-Qcat-Version 1.1 ist neben NEW_CATALOG auch die angabe von UPDATE_CATALOG innerhalb von OPENQCAT möglich. Bei den Katalogen für KURSNET kann nur eines der Elemente gleichzeitig verwendet werden.
  Fehlermeldung: "Gleichzeitige Verwendung von UPDATE_CATALOG und NEW_CATALOG ist nicht zugelassen. "