Abfallkalender

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.

Das Frontend z.B. des normalen Abfallkalenders sieht in etwa wie folgt aus:

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. Innerhalb der Tabellenzellen dürfen keine Zeilenumbrüche auftreten.

Die Tabelleninhalte der verschiedenen Kalender sind wie folgt 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:

Spalte	Bedeutung	Inhalt/Format
4	*Hausmüll ungerade Woche	Wochentag (z.B. Do, Donnerstag)
5	*Hausmüll gerade Woche	Wochentag (z.B. Do, Donnerstag)
6	*Bioabfall ungerade Woche	Wochentag (z.B. Do, Donnerstag)
7	*Bioabfall gerade Woche	Wochentag (z.B. Do, Donnerstag)
8	*Baumschnitt 1. Halbjahr	Datum (z.B. 03.07. oder 3. Juli)
9	*Baumschnitt 2. Halbjahr	Datum (z.B. 03.07. oder 3. Juli)
10	Sperrmüll	Freitext
11	Papier, Pappe, Kartonage (Tour)	Freitext oder Tour-ID**
12	Gelbe Tonne (Tour)	Freitext oder Tour-ID**

*) 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).

Beispiel für eine Abfallkalendertabelle in Excel:

Touren

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

Die auf die ID-Spalte folgenden Spalten werden wie folgt interpretiert:

Spalte	Bedeutung	Inhalt/Format
1	Tour-ID	Freitext
2	Datum (Januar)	z.B.: 03.01.
3	Datum (Februar)	z.B.: 03.02.
...	Datum (...)	z.B.: 03.07.

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.

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

Spalte	Bedeutung	Inhalt/Format
4	*Termin im Frühjahr (Datum)	z.B.: 03.07.2014
5	*Termin im Frühjahr (Zeit)	z.B.: 11:30
6	*Termin im Herbst (Datum)	z.B.: 03.07.2014
7	*Termin im Herbst (Zeit)	z.B.: 11:30

Beispiel für eine Schadstoffkalendertabelle in Excel: