Skip to content

Klapp Process Layer

Der Klapp Process Layer ermöglicht den Datenverkehr und die Informationsverarbeitung zwischen KLAPP und CMI Schule.

Der Prozess-Layer beinhaltet:

  • /Integration Integration von Schul-, Lernenden- und Personaldaten aus CMI in KLAPP Pro Schuleinheit werden schulklassen, unterrichtseinheiten, fachklassen und lernende geliefert.
    lernende.schuleinschreibung enthält die Lernenden mit einem aktuellen oder zukünftigen Schuleinschreibungsformular - sie sind noch nicht zwingend einer Schulklasse zugeteilt.
  • /Queries Abfragen von Daten der Lernenden (Absenzen, Journal, Bewertungsanlässe)
  • /Surveys Organisation, Manipulation und Ausgabe von Erhebungsanlässen Der Klapp Benutzer (Erziehungsberechtigte, Lernende) wird via X-Klapp- Header Informationen angegeben
  • /OfferRequest Abfragen von Angeboten (Kategorien, Angebotslisten, Angebotsdetails) sowie Anmeldung, Aktualisierung und Löschung von Angebots-Anmeldungen und Abruf der Mutationshistorie
  • /OfferRegistration Abfragen von Anmeldungen (Anmeldungslisten, Anmeldungsdetails für Kurse, Betreuung und Musikschule)
  • /BaseData Auskunft darüber, welche Angebotsmodule auf der Installation lizenziert sind

CMI Server-Voraussetzungen

Bereich Erforderliche CMI Server-Version Verhalten auf älteren Servern
/Queries (Absenzen, Bewertungsanlässe) 24.3 503
/Queries (Journal) 25.0 503
/OfferRequest, /OfferRegistration, /Deregistration, /Participations, /BaseData 26.0.3 503
Kategorie music 26.2 leere Liste bzw. «nicht gefunden»
Kategorie schuleinschreibung 26.2 leere Liste bzw. «nicht gefunden»
/Integration – lernende.schuleinschreibung 26.2 leeres Array

Endpunkte mit einer Mindestversion antworten auf zu alten Servern mit 503 und dem Fehlercode BASE_CON_002.

Die Kategorien music und schuleinschreibung wie auch /Integration den Abfrageblock für lernende.schuleinschreibung werden auf noch nicht unterstützten Releases in den bestehenden Endpunkten leer geliefert. Endpunkte, die mehrere Kategorien bedienen, liefern also auf jedem Release ein Resultat; Guid-adressierte Endpunkte behandeln die Guid dort als unbekannt und antworten mit 404.

Lizenzen

GET BaseData/Licenses meldet Klapp, welche Angebotsarten die Installation überhaupt anbietet. Klapp kann daran entscheiden, welche Bereiche es den Erziehungsberechtigten anzeigt.

Feld Lizenz
courseStaff, courseSignUp M_ANGEBOT_VERWALTUNG
daycareStaff, daycareSignUp M_ANGEBOT_VERWALTUNG
musicStaff, musicSignUp M_MUSIKSCHULE_VERWALTUNG

Einmal- und Serienangebot gehören im Datenmodell zum selben Modul, deshalb sind course und daycare immer gleich gesetzt. CMI unterscheidet nicht zwischen Zugriff für Schulpersonal und Zugriff für die Anmeldung, deshalb tragen …Staff und …SignUp einer Kategorie denselben Wert.