|
|
@@ -2,9 +2,7 @@
|
|
|
|
|
|
[Schild-NRW](http://www.svws.nrw.de/index.php?id=schildnrw) ist die offizielle Schulverwaltungssoftware in NRW, `schild` ein Ruby-Gem, das als API zwischen der Schild-NRW-Datenbank und eigenen Skripten fungieren kann. `schild` ermöglicht es, direkt und ohne die Schild-Oberfläche auf Daten zuzugreifen und für eigene Zwecke weiterzuverarbeiten, z.B. um eigene Dokumente (Reports/Berichte in Schild-Sprech genannt) zu erstellen.
|
|
|
|
|
|
-Mit `schild` kann man eigenen Skripte schreiben und komfortabel auf die Datenbank zugreifen. Lediglich ein paar Kenntnisse in der Programmiersprache Ruby werden erwartet. Mit Hilfe der [Prawn-Bibliothek](http://prawnpdf.org/) lassen sich sehr schöne und v.a. genau beschriebene PDF-Dokumente erstellen, die ganz ohne grafische Oberfläche auskommen und vollständig programmiert werden.
|
|
|
-
|
|
|
-Auch möglich ist die Nutzung von HTML und CSS zur Erzeugung von Dokumenten. Dazu eigenet sich bespielsweise [slim](http://slim-lang.com).
|
|
|
+Mit `schild` kann man eigene Skripte schreiben und komfortabel auf die Datenbank zugreifen. Kenntnisse in der Programmiersprache Ruby sind allerdings notwendig.
|
|
|
|
|
|
Um `schild` nutzen zu können muss es zuerst installiert werden:
|
|
|
|
|
|
@@ -18,12 +16,14 @@ Dazu muss ein Datenbankadapter installiert werden. Da in den meisten Fällen MyS
|
|
|
gem install mysql2
|
|
|
```
|
|
|
|
|
|
+Falls es nicht klappt und Fehlermeldungen auftauchen. liegt es meist daran, dass neben dem Server auch die Entwicklerbibliotheken isntalliert sein müssen. `mysql-dev` oder ähnlich genannt. Das hängt vom jeweils verwendeten Betriebssystem ab.
|
|
|
+
|
|
|
Jetzt kann `schild` in einem Skript aufgerufen werden:
|
|
|
|
|
|
```ruby
|
|
|
require 'schild'
|
|
|
```
|
|
|
-Da `schild` eine Datenbankverbindung zur Schild-Datenbank herstellen muss, werden noch ein paar Angaben gebraucht. `schild`verwendet dafür sog. Environment-Variablen. Unter Linux sehen die so aus:
|
|
|
+Da `schild` eine Datenbankverbindung zur Schild-Datenbank herstellen muss, werden noch ein paar Angaben gebraucht. `schild` verwendet dafür sog. Environment-Variablen. Unter Linux sehen die so aus:
|
|
|
|
|
|
```sh
|
|
|
export S_USER=schild
|
|
|
@@ -52,9 +52,9 @@ require 'schild'
|
|
|
```
|
|
|
|
|
|
Hier ist es wichtig, dass zuerst die Variablen geladen werden und erst im Anschluss daran `schild`, denn `schild` versucht direkt beim ersten Laden die Verbindung zur Datenbank herzustellen.
|
|
|
-
|
|
|
+
|
|
|
Nun sollte noch das `Schild`-Modul geladen werden, das die Verwendung von `schild` vereinfacht:
|
|
|
-
|
|
|
+
|
|
|
```ruby
|
|
|
require 'envyable'
|
|
|
Envyable.load('./config/env.yml', 'testing')
|
|
|
@@ -63,8 +63,7 @@ include Schild
|
|
|
```
|
|
|
|
|
|
Um jedoch alle Hilfsmethoden nutzen zu können, die das `schild`-Gem zur
|
|
|
-Verfügung stellt, noch besser folgenden Befehl verwenden, der seit
|
|
|
-Version 0.4.0 zur Verfügung steht:
|
|
|
+Verfügung stellt, noch besser folgender Befehl verwenden:
|
|
|
|
|
|
```ruby
|
|
|
include SchildErweitert
|
|
|
@@ -88,7 +87,7 @@ oder:
|
|
|
```ruby
|
|
|
s = Schueler.where(:Klasse => 'B13B').first
|
|
|
s.skt_halbjahr.noten.map{ |n| "#{n.fach.Bezeichnung}: #{n.NotenKrz}"}
|
|
|
- => ["Deutsch/ Kommunikation: 3", "Englisch: 3", "Religionslehre: ", "Mathematik: 4-", "Sport/ Gesundheitsförderung: 2", "Wirtschafts- und Betriebslehre: 3", "Datenverarbeitung: ", "Fachpraxis Textil/ Bekleidung: 2", "Gestaltungslehre: 3", "Politik/ Gesellschaftslehre: 2", "Technologie Bekleidung: 5", "Technisches Zeichnen Bekleidung: 4"]
|
|
|
+ => ["Deutsch/ Kommunikation: 3", "Englisch: 3", "Religionslehre: ", "Mathematik: 4-", "Sport/ Gesundheitsförderung: 2", "Wirtschafts- und Betriebslehre: 3", "Datenverarbeitung: ", "Fachpraxis Textil/ Bekleidung: 2", "Gestaltungslehre: 3", "Politik/ Gesellschaftslehre: 2", "Technologie Bekleidung: 5", "Technisches Zeichnen Bekleidung: 4"]
|
|
|
```
|
|
|
|
|
|
In diesem Beispiel wurde der erste Schüler der klasse B13B aus dem Datensatz `Schueler` gewählt und Daten aus verschiedenen Tabellen abgerufen:
|
|
|
@@ -97,7 +96,7 @@ In diesem Beispiel wurde der erste Schüler der klasse B13B aus dem Datensatz `S
|
|
|
* Die Notenliste aus Noten
|
|
|
* Die Fachbezeichnung aus Faecher
|
|
|
|
|
|
-`schild` vereinfacht an dieser Stelle einige Probleme von Schild. So sind z.B. Daten zur Schule unter `Schule` erreichbar, während die Tabelle unter Schild direkt nur über DB[:eigeneschule] anzusteuern wäre. Da viele Namen im Schema der Schild-Datenbank uneinheitlich sind, versucht `schild` soweit es geht, eine einheitliche Form zu verwenden.
|
|
|
+`schild` vereinfacht an dieser Stelle einige Probleme von Schild. So sind z.B. Daten zur Schule unter `Schule` erreichbar, während die Tabelle unter Schild direkt nur über DB[:eigeneschule] anzusteuern wäre. Da viele Namen im Schema der Schild-Datenbank uneinheitlich sind, versucht `schild`, soweit es geht, eine einheitliche Form zu verwenden.
|
|
|
|
|
|
Alle zur Verfügung stehenden Hilfsmethoden werden in den API-Docs erläutert.
|
|
|
|
|
|
@@ -119,15 +118,47 @@ s.bemerkungen
|
|
|
|
|
|
Mit Hilfe dieser zusätzlichen Methoden können Fehlermeldungen in den erstellten Berichten komfortabel umgangen werden. Je nach Bedarf kann auf Typensicherheit gesetzt werden oder etwas mehr Freiheit.
|
|
|
|
|
|
+Zum Abfragen der Tabellen stehen also die Methoden entsprechend der Tabellen zur Verfügung:
|
|
|
+
|
|
|
+```ruby
|
|
|
+s = Schueler.first
|
|
|
+s.Geburtsdatum
|
|
|
+=> nil
|
|
|
+s.Vorname
|
|
|
+=> "Stefan"
|
|
|
+```
|
|
|
+
|
|
|
+Dazu die erweiterte Methode
|
|
|
+```ruby
|
|
|
+s = Schueler.first
|
|
|
+s.geburtsdatum
|
|
|
+=> 1899-01-01 00:00:00 +0100
|
|
|
+s.geburtsland_mutter
|
|
|
+=> ""
|
|
|
+```
|
|
|
+
|
|
|
+Und es gibt noch die Unterstrichmethoden, die beides verbinden: Ruby-style und frei von nil:
|
|
|
+
|
|
|
+```ruby
|
|
|
+s = Schueler.first
|
|
|
+s._geburtsdatum
|
|
|
+=> nil0
|
|
|
+s._geburtsland_mutter
|
|
|
+=> nil
|
|
|
+```
|
|
|
## Das sollte beachtet werden
|
|
|
-`schild` läuft nur unter Ruby. Es ist wahrscheinlich möglich auch über JRuby andere Sprachen zu verwenden, die auf der JVM laufen. Also Java zum Beispiel. Gleiches gilt für Python. Leider nicht getestet.
|
|
|
+`schild` läuft nur unter Ruby. Es läuft auch unter JRuby und kann dementsprechend in alle auf der JVM laufenden Sprachen eingesetzt werden.
|
|
|
|
|
|
Die Schild-Datenbank muss einigermaßen aktuell sein, ältere Datenbanken haben offensichtlich noch Großbuchstaben in den Tabellennamen verwendet. Das bereitet `schild` Schwierigkeiten. Bei neueren Versionen von Schild (2015) werden Kleinbuchstaben verwendet.
|
|
|
|
|
|
-Es kann nicht garantiert werden, dass `schild` mit jeder Version von Schild funktioniert. `schild` hat keinerlei Einfluß auf die Entwicklung von Schild und kann bei jeder Änderung am Schema der Datenbank zu fehlerhaftem Verhalten veranlasst werden.
|
|
|
+Es kann nicht garantiert werden, dass `schild` mit jeder Version von Schild funktioniert. `schild` hat keinerlei Einfluß auf die Entwicklung von Schild und kann bei jeder Änderung am Schema der Datenbank zu fehlerhaftem Verhalten veranlasst werden. Soweit möglich, werden Legacy-Methoden geschrieben, die trotz namensänderung auf alte Werte zugreifen können. Ebenso werden Warnungen geschrieben, wenn `schild` Methoden kennt, die Schild in alten Versionen noch nicht verwendet hat.
|
|
|
|
|
|
`schild` verändert keine Daten an der Schild-Datenbank. Es ist aber möglich, dass mit Hilfe von `schild` auf Daten zugegriffen und verändert wird. `schild` verwendet zum Ansteuern der Datenbank `sequel`, ein weiterer Gem zum komfortablen Bearbeiten von relationalen Datenbanken. Um sicherzugehen, dass keine Schreibzugriffe auf die Schild-Datenbank vorgenommen werden, muss der Datenbankbenutzer auf Lesezugriff beschränkt werden.
|
|
|
|
|
|
+Abschließend sollte noch erwähnt werden, dass `schild` naturgemäß auf nicht besonders vielen Datenbanken getestet werden konnte. Es wir zur Zeit an einem Berufskolleg verwendet und funktioniert einwandfrei. Nicht alle Tabellen werden derzeit verwendet, können aber bei Bedarf relativ schnell eingebunden werden.
|
|
|
+
|
|
|
+`schild` wird zur Zeit als Bibliothek für [Sahib](https://github.com/hmt/sahib) eingesetzt. Sahib ist eine komfortable Oberfläche zum Suchen von Schülern und Klassen und der Erstellung von Dokumenten mit Hilfe von HTML und CSS, die als PDF ausgegben werden. Zeugnisse und andere Dokumente können innerhalb von wenigen Minuten erstellt und ausgegeben werden.
|
|
|
+
|
|
|
## Tests
|
|
|
`schild` verwendet Tests, um sicherzustellen, dass alle Funktionen über den gesamten Entwicklungsprozess reibungslos funktionieren. Dazu wird die Testdatenbank verwendet, die von der ribeka GmbH auf ihrer Dropbox zur Verfügung gestellt wurde. Leider ist dies eine ältere Version, die an die neue Schild-Version angepasst werden musste. Die neue Version steht als [Download](https://www.dropbox.com/s/tyswqh1burf4ijo/schild-test.sql.gz?dl=0) zur Verfügung und kann in MySQL importiert werden.
|
|
|
|
|
|
@@ -138,7 +169,7 @@ git clone git@github.com:hmt/schild.git
|
|
|
cd schild
|
|
|
```
|
|
|
|
|
|
-Um die Tests bei installierter Datenbank durchführen zu können müssen die nötigen Abhängigkeiten installiert sein. Dies wird über `bundler` organisiert:
|
|
|
+Um die Tests bei installierter Datenbank durchführen zu können, müssen die nötigen Abhängigkeiten installiert sein. Dies wird über `bundler` organisiert:
|
|
|
|
|
|
```sh
|
|
|
bundle install
|
|
|
@@ -150,6 +181,8 @@ Die Tests können nun mit `rake` gestartet werden:
|
|
|
rake
|
|
|
```
|
|
|
|
|
|
+`rake` greift automatisch auf die `config/env.yml` zu, um Environment-Variablen einzulesen, die voreingestellt sind. Damit die Tests funktionieren, müssen diese Variablen evtl. an die jeweilige Datenbankanbindung angepasst werden.
|
|
|
+
|
|
|
## Mitmachen
|
|
|
Hilfe bei der Mitarbeit von `schild` wird gerne angenommen. Bitte Pull Requests und Issues bei Github nutzen. Alle Änderungen sollten mit Tests eingereicht werden.
|
|
|
|
|
|
@@ -157,7 +190,25 @@ Hilfe bei der Mitarbeit von `schild` wird gerne angenommen. Bitte Pull Requests
|
|
|
[]("http://creativecommons.org/licenses/by/4.0/")
|
|
|
[schild](https://github.com/hmt/schild) von [HMT](https://github.com/hmt) ist lizenziert unter einer [Creative Commons Namensnennung 4.0 International Lizenz](http://creativecommons.org/licenses/by/4.0/).
|
|
|
|
|
|
+Oder:
|
|
|
+The MIT License (MIT)
|
|
|
|
|
|
+Copyright (c) 2015 HMT
|
|
|
|
|
|
+Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
|
+of this software and associated documentation files (the "Software"), to deal
|
|
|
+in the Software without restriction, including without limitation the rights
|
|
|
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
|
+copies of the Software, and to permit persons to whom the Software is
|
|
|
+furnished to do so, subject to the following conditions:
|
|
|
|
|
|
+The above copyright notice and this permission notice shall be included in all
|
|
|
+copies or substantial portions of the Software.
|
|
|
|
|
|
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
|
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
|
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
|
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
|
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
|
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
|
+SOFTWARE.
|
