Zum Hauptinhalt springen

Gruppendatensätzen des Quellsystemanbieters

GET 
/gruppen

Dieser Schnittstellenendpunkt gibt ein Array von Gruppendatensätzen zurück, die vom Anfrager ausgelesen werden dürfen.

Ein READ muss mit einer HTTP-GET Anfrage erfolgen. Die Antwort-Nutzdaten (Response Payload) beinhalten ein Array von JSON-Objekten vom Datentyp Gruppendatensatz, sofern Einträge existieren.

Siehe auch die einzelnen Datenmodelle zu Gruppendatensatz.

Die Schnittstelle /gruppen ermöglicht das Verwenden von Filterparametern zur Präzisierung der Anfrage bei HTTP-GET.

Durch das Setzen von Filterparametern (query-parameter) wird mit der HTTP-GET-Anfrage eine Filteroperation mitgeschickt, welche die Ergebnismenge der Antwort-Nutzdaten (Response Payload) beeinflusst, beispielsweise mit den Filterparametern ?referrer=123&faecher=EN.

Bei Filtern vom Typ „String” überprüft der Schulconnex-Server, ob der Wert des Filterparameters ohne Beachtung von Groß- und Kleinschreibung im Filter-Attribut beinhaltet ist (contains). Bei Filtern vom Typ „String (Code)” überprüft der Schulconnex-Server, ob der Wert des Filterparameters ohne Beachtung von Groß- und Kleinschreibung gleich dem Filter-Attribut ist (equals).

Werden mehrere Filter angegeben, so sind sie als mit „und“ verknüpft anzusehen.

Eine mehrfache Nutzung des gleichen Filters in einer Anfrage darf nicht erfolgen. Entsprechen keine Werte den angegebenen Filtern, so wird als Resultat eine leere Liste geliefert.

Bei Attributen, welche eine Liste von Codes enthalten können (deren „Anzahl“ im Datenmodell die Form „0..n“ oder „1..n“ hat), kann als Filterwert eine durch Kommas getrennte Liste von Werten angegeben werden. Es werden dann nur die Gruppen zurück geliefert, in denen alle diese Codes in der Liste vorkommen. Die Parameter sind auch hier als mit „und“ verknüpft anzusehen. Der Filter &faecher=NL,IT,SN liefert alle Gruppen, in denen kumulativ sowohl Niederländisch, Italienisch und Spanisch gelehrt wird.

Ein Sonderfall ist hier bei dem Filter faecher gegeben. Ein Suchparameter bei diesem Filter sucht sowohl bei dem Unterattribut kennung als auch dem Unterattribut text. Wird in einer Gruppe beispielsweise das Standard-Fach Englisch unterrichtet und auch das Thema „Filmschnitt“, das nicht in der Fächer-Codeliste vorhanden ist und daher über das Attribut text hinzugefügt wurde, so kann diese Gruppe mit dem Filter &faecher=EN,Filmschnitt gesucht werden.

Folgende Tabelle listet die zur Verfügung stehenden Filter:

FilterTypBeschreibung
referrerStringMöglichkeit, die Ergebnisliste der Anfrage nach dem Fremdschlüssel referrer zu filtern.
mandantStringMöglichkeit, die Ergebnisliste der Anfrage nach dem Attribut mandant zu filtern. Der Schulconnex-Server überprüft, ob der Wert des Filterparameters unabhängig von Groß- und Kleinschreibung im Filter-Attribut beinhaltet ist (contains).
bezeichnungStringMöglichkeit, die Ergebnisliste der Anfrage nach dem Attribut gruppe.bezeichnung zu filtern.
optionenString (Code)Möglichkeit, die Ergebnisliste der Anfrage nach dem Attribut gruppe.optionen zu filtern.
differenzierungString (Code)Möglichkeit, die Ergebnisliste der Anfrage nach dem Attribut gruppe.differenzierung zu filtern.
bildungszieleString (Code)Möglichkeit, die Ergebnisliste der Anfrage nach dem Attribut gruppe.bildungsziele zu filtern.
jahrgangsstufenString (Code)Möglichkeit, die Ergebnisliste der Anfrage nach dem Attribut gruppe.jahrgangsstufen zu filtern.
faecherString (Code)Möglichkeit, die Ergebnisliste der Anfrage nach dem Attribut gruppe.faecher.kennung und gruppe.faecher.text zu filtern.

Request​

Responses​

OK