Abfallkalender: Unterschied zwischen den Versionen

Version vom 3. Juli 2014, 13:55 Uhr

Typ: Frontend- und Backend-Modul

Beschreibung

Mit dem Abfallkalender können Müllabfuhrtermine per Ortsangabe gesucht werden. Die Suche kann dabei nach Ortsteil und/oder Straßennamen verfeinert werden.

Es gibt zwei Arten von Kalendern:

1. Abfallkalender
2. Schadstoffkalender

Beide Kalender ähneln sich stark vom Aufbau her: eine Ortssuchmaske und eine Termintabelle.

Bedienung

Allgemeiner Workflow

Zunächst muss das Backend-Modul mit Daten gefüttert werden. Dazu werden Tabellen mit vorgegebenen Tabellenköpfen im CSV-Format hochgeladen. Optional kann ein Gültigkeitszeitraum für die Kalender im Bereich `Metadaten` angegeben werden.

Anschließend kann das Frontend-Modul auf einer Seite eingesetzt werden. Dabei muss ausgewählt werden, ob der Abfallkalender oder der Schadstoffkalender angezeigt werden soll. Existieren keine Daten für den ausgewählten Kalender, erscheint eine Fehlermeldung im Frontend.

Hinweis: Abfallkalender und Schadstoffkalender dürfen nicht auf ein- und derselben Seite eingebunden werden.

Datenformat

Sämtliche Dateien müssen im CSV-Format (*.csv|*.txt) vorliegen. Excel-Tabellen können aus MS Excel heraus mit Speichern unter... und dem Dateityp CSV (Trennzeichen-getrennt) in dieses Format konvertiert werden. Der Aufbau der Tabellen muss dabei wie folgt aussehen:

+==============+==============+==============+=====+
| Kopfspalte 1 | Kopfspalte 2 | Kopfspalte 3 | ... |
+==============+==============+==============+=====+
| Zelle 1,1    | Zelle 2,1    | Zelle 3,1    | ... |
+--------------+--------------+--------------+-----+
| Zelle 1,2    | ...          | ...          | ... |
+--------------+--------------+--------------+-----+
| ...          | ...          | ...          | ... |
+--------------+--------------+--------------+-----+

Die erste Zeile in einer Datei wird als Kopfspalte gelesen. Verfügt eine der folgenden Zeilen über nicht exakt genau so viele Spalten, wird die Zeile beim Import ignoriert. Zeilennummern von auftretenden Fehlern werden zurückgegeben.

Die Tabelleninhalte der verschiedenen Kalender sind wiefolgt definiert:

Abfallkalender

Die ersten drei Spalten des normalen Abfallkalenders müssen in der Form 1) Ort, 2) Ortsteil, 3) Straße vorliegen. Dabei muss mindestens der Ort definiert sein - alle anderen Felder können freigelassen werden. Ein frei gelassender Ortsteil wird zu "Ortskern", eine frei gelassene Straße wird zu "Namenlos". Aus den drei Spalten wird die Ortsauswahl automatisch generiert.

Die auf die drei Ortsspalten folgenden Spalten werden wie folgt interpretiert:

*) Eine leere Zelle oder ein Minus-Zeichen werden als fehlender Eintrag

gewertet. In der Ausgabe fehlt dann das entsprechende Feld.

**) Eine Tour-ID kann aus beliebigen Zeichen bestehen (z.B. Zahlen). Existiert

die entsprechende Tour in der Datenbank, so wird der Inhalt einer

Tourspalte als Schlüssel für die erste Spalte einer Zeile in der Touren-

Tabelle interpretiert. Der Inhalt der Zeile aus der Tourentabelle wird in

der Ausgabe des Moduls in mehreren Spalten angezeigt. Existiert die ID

nicht, so wird sie selbst in einer einzigen Spalte angezeigt (Freitext).


Touren

Die erste Spalte einer Tourendatei muss ein eindeutiger Schlüssel in Form von Zahlen oder Text sein. Dieser wird von der Abfallkalendertabelle referenziert.

Beispiel für eine Tourentabelle in Excel:

Schadstoffkalender

Die ersten drei Spalten des Schadstoffkalenders müssen in der Form 1) Ort, 2) Ortsteil, 3) Abfuhrstelle vorliegen. Dabei muss mindestens der Ort definiert sein - alle anderen Felder können freigelassen werden. Ein frei gelassender Ortsteil wird zu "Ortskern", eine frei gelassene Abfuhrstelle wird zu "Namenlos". Aus den drei Spalten wird die Ortsauswahl automatisch generiert.

Beispiel für eine Schadstoffkalendertabelle in Excel: