schule-suchen [Hupfeld-Software]

Diese Seite ist nicht editierbar. Sie können den Quelltext sehen, jedoch nicht verändern. Kontaktieren Sie den Administrator, wenn Sie glauben, dass hier ein Fehler vorliegt.
====== Schule suchen in NRW ======

[[https://schule-suchen.hpadm.de/|{{:bildschirmfoto_2018-02-19_um_21.47.44.png?direct&360|https://schule-suchen.hpadm.de/}}]]

  * https://schule-suchen.hpadm.de

Das [[https://www.schulministerium.nrw.de/docs/bp/Ministerium/Open_MSB/Open_Data/|Ministerium für Schule und Bildung]] in Nordrhein-Westfalen veröffentlicht im Rahmen der Landesinitiative Open NRW Schuldaten unter einer [[https://www.govdata.de/dl-de/by-2-0|Offenen Lizenz]]. Neben einer tagesaktuellen Adressliste werden zusätzliche Bildungsangebote veröffentlicht, z.B. das Kursangebot in der gymnasialen Oberstufe, bilingualer Unterricht und die Schülerzahlen der einzelnen Schulen.

Die Daten werden in Form von CSV- oder XML-Dateien zur Verfügung gestellt, es existiert keine API zum Abruf der Daten.

Die Idee war, diese Daten in einer Webapplikation so zur Verfügung zu stellen, dass sich komfortable nach einzelnen Schulen suchen lässt, aber auch die Schulen einer Gemeinde oder Stadt angezeigt werden können.

Entstanden ist dabei eine [[https://de.wikipedia.org/wiki/Single-Page-Webanwendung|Single-Page-Webanwendung]] (SPA) auf Basis von Angular JS. Die Restschnittstelle wurde mit PHP programmiert.

===== Aufbau der Datenstruktur und Einlesen der Daten =====

Die Schuladressen werden in einer Tabelle geliefert, wobei die einzelnen Attribute mit Schlüsseltabellen erläutert werden. Aus den vorgegebenen Dateien habe ich eine Datenbank abgeleitet, in die dann automatisiert die Dateien importiert.


==== Datenstruktur ==== 

Bei der Datenstruktur wurde bewusst auf Constrains verzichtet, da diese beim Einlesen Probleme bereiteten. Das ist keine ganz saubere Lösung, hat aber noch keine Probleme verursacht.

  * [[create_schuladressen.sql|Datenbankdefinition]]


==== Script zum Einlesen der Daten ====

Die Anwendung zum Einlesen der Daten besteht aus drei Skripten. In der [[refresh/index.php|index.php]] werden die Tabellen ausgewählt, in der [[refresh/config.php|config.php]] stehen die Adressen und Zugangsdaten, in [[refresh/refresh.php|refresh.php]] findet der eigentliche Einlesevorgang statt. Als CSS-Framework kommt Bootstrap3 zum Einsatz, das per CDN eingelesen wird. Die Daten werden jeweils in den Tabellen vor dem Einlesen gelöscht (truncate). Die Spaltenüberschriften entsprechen den Attributen in der Datenbank, nur E-Mail wird in E_Mail konvertiert.

  * [[refresh/index.php|index.php]]
  * [[refresh/config.php|config.php]]
  * [[refresh/refresh.php|refresh.php]]

===== Die REST-Schnittstelle =====

Die [[https://de.wikipedia.org/wiki/Representational_State_Transfer|REST]]-Schnittstelle liefert die Daten per [[https://de.wikipedia.org/wiki/JavaScript_Object_Notation|JSON]]-Records und wurde ebenfalls mit PHP realisiert. Die Datenabfrage wurde auf mehrere Dateien verteilt, was mit der Entstehungsgeschichte des Projekts zusammenhängt. Mann könnte sicherlich die verschieden Datensätze über geeignete Parameter aus einem Skript auslesen.
 
==== Suchfunktionen ====


Es werden für die Applikation zwei Suchfunktionen verwendet, einmal die Suche nach einer Schule. Das Skript [[ajax/search.php|search.php]] liefert eine **Liste mit Schulen**. Gesucht wird in den Felder für die Schulnummer, den Namen, PLZ und Ort der Schule. Der Suchstring kann mit Leerzeichen getrennt werden, wobei die jeweiligen Suchbegriffe dann jeweils per __Und__ verknüpft werden.

Das Skript [[ajax/search_gemeinden.php|search_gemeinden.php]] sucht in der Gemeindetabelle und liefert eine auf 30 begrenzte Liste der Gemeindetreffer.


  * [[ajax/search.php|search.php]]
  * [[ajax/search_gemeinden.php|search_gemeinden.php]]

==== Schuldaten ====
Das Skript [[ajax/get_schule.php|get_schule.php]] liefert alle Daten einer Schule, deren id als Parameter übermittelt wird. Der Aufruf https://bankerheide.de/schule-suchen/ajax/get_schule.php?snr=169560 liefert den Datensatz der Schule mit der Schulnummer 169569 im JSON-Format.

Im Datensatz ist auch eine **Georeferenzierung** der Schule enthalten, leider nicht in Längen- und Breitengraden, sonder in [[https://de.wikipedia.org/wiki/Gau%C3%9F-Kr%C3%BCger-Koordinatensystem|Gauß-Krüger-Koordinatsystem]]. Um die Geodaten benutzen zu können, um die die Lage Schule auf einer Karte darstellen zu können, müssen die Koordinaten aus dem Gauß-Krüger-System in Längen und Breitengrade umgerechnet werden. Da das ziemlich kompliziert ist, habe ich ein Javascript-Programm von http://calc.gknavigation.de/ in PHP adaptiert.

  * [[ajax/get_schule.php|get_schule.php]]
  * [[ajax/geoconvert.php|geoconvert.php]] (Umrechnung von Gauß-Krüger-Koordinaten in Längen- und Breitengrade)

==== Gemeinden ====

Das Skript [[ajax/get_gm_schulen.php|get_gm_schulen.php]] liefert die Schulen einer Gemeinde. Als Parameter dient die Gemeindekennziffer.Das zweite Skript liefert statistische Daten einer jeden Gemeine wie Anzahl der Schulen einer Schulform und die dazugehörigen Schülerzahlen. Auch das Skript [[ajax/get_statistcs.php|get_statistc.php]] wird mit der Gemeindekennziffer aufgerufen.


  * [[ajax/get_gm_schulen.php|get_gm_schulen.php]]
  * [[ajax/get_statistcs.php|get_statistc.php]]

==== Weitere Daten ====
Es gibt zwei weiter Skripte, Das erste liest das Kursangebot in der Gymnasialen Oberstufe aus, das zweite Daten zu Bilingualen Angeboten an Schulen, die ebenfalls vom MSB angeboten werden.

  * [[ajax/get_kurse.php|get_kurse.php]]
  * [[ajax/get_bilingual.php|get_bilingual.php]]

===== Die Applikation =====
Die [[https://bankerheide.de/schule-suchen/|Applikation]] selber ist als Single-Page-Webapplikation im Prinzip eine HTML-Datei. Als Javascript-Framework wurde [[https://de.wikipedia.org/wiki/AngularJS|AngularJS]] 1. verwendet. Für mich war das eine Gelegenheit, das Framework an einem sinnvollen Beispiel auszuprobieren. Ich bin keine Experte für AngularJS, hier geht sicherlich noch mehr. Aber für einen ersten Einblick das Framework war die Programmierung der Anwendung sicherlich nützlich.

Neben AngularJS wurden noch Bootstrap 4 als Javascript-Framwork und [[http://leaflet.org/|Leaflet]] als Modul für die Darstellung der Karten und [[http://tombatossals.github.io/angular-leaflet-directive/#!/|angular-leaflet-directive]] für die Einbindung in AngularJS verwendet. Die Quelltexte sind im Folgenden dokumentiert.

  * [[schulesuchen/index.html|index.html]] [[https://bankerheide.de/schule-suchen/|Web]]
  * [[schulesuchen/app.js|app.js]]

Gerade bei der Zusammenarbeit mit Leaflet gibt es einige Probleme, die ich nicht alle zufriedenstellend lösen konnte. Es gibt auch einen Fehler bei der Aktualisierung der Kursangebote.

===== Download =====


Das Projekt liegt auf Github zum Download bereit: https://github.com/wahu33/schule-suchen