Abfallkalender: Unterschied zwischen den Versionen
Apopov (Diskussion | Beiträge) (→Allgemeiner Workflow) |
Apopov (Diskussion | Beiträge) K |
||
| Zeile 13: | Zeile 13: | ||
Beide Kalender ähneln sich stark vom Aufbau her: eine Ortssuchmaske und eine | Beide Kalender ähneln sich stark vom Aufbau her: eine Ortssuchmaske und eine | ||
Termintabelle. | Termintabelle. | ||
| + | |||
| + | Das Frontend z.B. des normalen Abfallkalenders sieht in etwa wie folgt aus: | ||
| + | |||
| + | [[Datei:abfallkalender_scr-frontend-default.png]] | ||
== Bedienung == | == Bedienung == | ||
| Zeile 30: | Zeile 34: | ||
'''Hinweis:''' Abfallkalender und Schadstoffkalender dürfen nicht auf ein- und | '''Hinweis:''' Abfallkalender und Schadstoffkalender dürfen nicht auf ein- und | ||
derselben Seite eingebunden werden. | derselben Seite eingebunden werden. | ||
| − | |||
| − | |||
| − | |||
| − | |||
=== Datenformat === | === Datenformat === | ||
Version vom 3. Juli 2014, 15:28 Uhr
Typ: Frontend- und Backend-Modul
Inhaltsverzeichnis
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:
- Abfallkalender
- Schadstoffkalender
Beide Kalender ähneln sich stark vom Aufbau her: eine Ortssuchmaske und eine Termintabelle.
Das Frontend z.B. des normalen Abfallkalenders sieht in etwa wie folgt aus:
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. 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:
