Abfallkalender: Unterschied zwischen den Versionen

Aus Wiki GeoCMS
Wechseln zu: Navigation, Suche
K
K
Zeile 51: Zeile 51:
 
folgenden Zeilen über nicht exakt genau so viele Spalten, wird die Zeile beim
 
folgenden Zeilen über nicht exakt genau so viele Spalten, wird die Zeile beim
 
Import ignoriert. Zeilennummern von auftretenden Fehlern werden zurückgegeben.
 
Import ignoriert. Zeilennummern von auftretenden Fehlern werden zurückgegeben.
 +
Innerhalb der Tabellenzellen dürfen keine Zeilenumbrüche auftreten.
  
Die Tabelleninhalte der verschiedenen Kalender sind wiefolgt definiert:
+
Die Tabelleninhalte der verschiedenen Kalender sind wie folgt definiert:
  
 
==== Abfallkalender ====
 
==== Abfallkalender ====
Zeile 102: Zeile 103:
 
Die erste Spalte einer Tourendatei '''muss''' ein eindeutiger Schlüssel in Form
 
Die erste Spalte einer Tourendatei '''muss''' ein eindeutiger Schlüssel in Form
 
von Zahlen oder Text sein. Dieser wird von der Abfallkalendertabelle referenziert.
 
von Zahlen oder Text sein. Dieser wird von der Abfallkalendertabelle referenziert.
 +
 +
Die auf die ID-Spalte folgenden Spalten werden wie folgt interpretiert:
  
 
{| class="wikitable"
 
{| class="wikitable"
Zeile 115: Zeile 118:
 
|-
 
|-
 
|}
 
|}
 +
 
Beispiel für eine Tourentabelle in Excel:
 
Beispiel für eine Tourentabelle in Excel:
  
Zeile 124: Zeile 128:
 
gelassender Ortsteil wird zu "Ortskern", eine frei gelassene Abfuhrstelle wird
 
gelassender Ortsteil wird zu "Ortskern", eine frei gelassene Abfuhrstelle wird
 
zu "Namenlos". Aus den drei Spalten wird die Ortsauswahl automatisch generiert.
 
zu "Namenlos". Aus den drei Spalten wird die Ortsauswahl automatisch generiert.
 +
 +
Die auf die drei Ortsspalten folgenden Spalten werden wie folgt interpretiert:
  
 
{| class="wikitable"
 
{| class="wikitable"

Version vom 3. Juli 2014, 14:50 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. 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](http://wiki.geocms.com)

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: