Alle Termine, die im Portal erfasst wurden können sehr einfach auf der Schulhomepage veröffentlicht werden.

Hierzu bietet schultermine einen Webservice, der die Daten im JSON-Format bereitstellt.

Hierzu sind folgende Schritte nötig:

1. Ermittlung des Zugangscodes
2. Bestimmung der Webservice-Url sowie Aufruf und Test
3. Anpassungen auf der Homepage

Ermittlung des Zugangscodes

Der Zugangscode der Schule kann wie folgt ermittelt werden: Melden Sie sich im Portal an und wählen Sie aus der Menüleiste den Menüpunkt "Schule".

Notieren Sie sich den Text im Feld "Zugangscode"

Bestimmung der Webservice-Url

Die Webservice-Url lautet wie folgt:

 https://www.schultermine.de/ServiceV1/RestService/GetSchoolTimes/?school=<Zugangscode>

Ersetzen Sie dabei den Text <Zugangscode> durch ihren ermittelten Zugangscode.

Der Zugangscode für die Demo-Schule lautet: CDU6KA Die Webservice-URL lautet demnach

 https://www.schultermine.de/ServiceV1/RestService/GetSchoolTimes/?school=CDU6KA

Aufbau der Daten

Der Rückgabewert des Webservice ist eine Liste der Termine mit folgenden Attributen:

id: 64Bit langer identifier des Termins

date: Zeitpunkt des Termins im Microsoft JSON Datumsformat

name: Der Name der Versanstaltung

description: Die Beschreibung der Veranstaltung

Beispiel:

[

 {  id: 454790694437380, date: "/Date(1439416800000)/", name: "Einschulungsfeier für unsere neuen Schulanfänger", description: ""},

 {  id: 454790694437381, date: "/Date(1439762400000)/", name: "Klassenpflegschaftssitzung  \nKlassen 1", description: ""}

]

Anpassungen auf der Homepage

Der folgende Codeabschnitt demonstriert, wie die Daten aus dem Portal geladen und dargestellt werden können. Der in diesem Beispiel verwendete Zugangscode ist der der Demo-Schule.

Hierzu wird zunächst ein div-Element benötigt, in das die Daten geladen werden

<div id="termine">Lade Termine...</div>

Als nächstes wird ein JavaScript Baustein erstellt, der die Daten vom Webservice lädt und eine HTML-Tabelle aufbaut. Natürlich kann diese dann individuell gestaltet werden.

<script type="text/javascript">

  $(document).ready(function(){

    //

    // Important: The school access code is required and passed as parameter to the service

    //

    var stdataURL = "https://www.schultermine.de/ServiceV1/RestService/GetSchoolTimes/?school=CDU6KA";

    var returnData = "";

    $.ajax({

        type: "GET",

        dataType: "json",

        async: true,

        url: stdataURL,

        error: function(request, status, error) { alert(request.responseText) },

        success: function(data) {

            $("div#termine").html(" ");

            returnData = "";

                    for (var i = 0; i < data.length; i++) {

                        var re = /-?\d+/;

                        var m = re.exec(data[i]["date"]);

                        var newdate = new Date(parseInt(m[0]));

                        var newdate=newdate.getDate()+'.'+(newdate.getMonth()+1)+'.'+newdate.getFullYear();

                        returnData += "";

                    }

            returnData = returnData + "<table <tr=""><tbody><tr><th>Termin</th><th>Veranstaltung</th><th>Bemerkung</th></tr><tr><td>" + newdate

                                   + "</td><td>" + data[i]["name"] + "</td><td>"

                                   + data[i]["description"] + "</td></tr></tbody></table>";

            $("div#termine").html(returnData);

        }

    });

    return (false);

  });

</script>