Abfall.IO

IP-Symcon Modul für die Visualisierung von Entsorgungsterminen.

Inhaltverzeichnis

Funktionsumfang
Voraussetzungen
Installation
Einrichten der Instanzen in IP-Symcon
Statusvariablen und Profile
WebFront
PHP-Befehlsreferenz
Versionshistorie

1. Funktionsumfang

Das Modul nutzt die von Abfall+ (www.abfallplus.de) bereitgestellten Daten zur Berechnung der bevorstehenden Entsorgungstermine (Abfallentsorgung).

Derzeit unterstützt das Modul über 60 verschiedene Landkreise und Großstädte. Wenn jemand noch weitere kennt, bitte einfach bei mir melden!

2. Voraussetzungen

IP-Symcon ab Version 6.4

3. Installation

Über den Modul Store das Modul Abfallwirtschaft (ehem. Awido) installieren.
Alternativ Über das Modul-Control folgende URL hinzufügen.
https://github.com/Wilkware/WasteManagement oder git://github.com/Wilkware/WasteManagement.git

4. Einrichten der Instanzen in IP-Symcon

Unter "Instanz hinzufügen" ist das 'Abfall_IO'-Modul (Alias: 'Abfallwirtschaft (Abfall_IO)' oder 'Entsorgungskalender (Abfall_IO)') unter dem Hersteller '(Geräte)' aufgeführt.

Konfigurationsseite:

Entsprechend der gewählten Auswahl verändert sich das Formular dynamisch. Eine komplette Neuauswahl erreicht man durch Auswahl "Bitte wählen ..." an der gewünschten Stelle.

VORSTICHT: eine Änderung der Auswahl bedingt ein Update bzw. ein Neuanlegen der Statusvariablen!!! Alte Variablen, welche es im anderen Landkreis gab werden nicht gelöscht! Hat man diese in einem WF verlinkt muss man danach selber aufräumen. Ich denke aber mal das ein Umzug nicht so häufig vorkommt 😉

Einstellungsbereich:

Online Dienste ...

Name	Beschreibung
Anbieter	'Abfall.IO (abfallplus.de)'

Abfallwirtschaft ...

Name	Beschreibung
Entsorgungsgebiet	Liste der verfügbaren Gebiete (siehe oben)
Stadt/Gemeinde	Ort im Entsorgungsgebiet (kann identisch zum Gebiet sein)
Stadt-/Ortsteil	In einigen Gegend zusätzliche Gebietseinschränkung
Straße/Abfuhrbezirk	Strasse bzw. Abfuhrbezirk im gewählten Ort
Hausnummer	Hausnummer von-bis, oder Alle = gesamte Strasse
Entsorgungen	Entsorgungsarten, d.h. was wird im Gebiet an Entsorgung angeboten

Visualisierung ...

Name	Beschreibung
Unterstützung für Tile Visu aktivieren?	Aktivierung, ob HTML für Kacheldarstellung erstellt werden soll
Abfallgruppen	Farbliche Zuordnung der Abfallarten

Erweiterte Einstellungen ...

Name	Beschreibung
Tägliche Aktualisierung aktivieren?	Status, ob das tägliche Update aktiv oder inaktiv ist
Variablen für nicht ausgewählte Entsorgungen erstellen?	Status, ob für nicht genutzte Entsorgungen auch Variablen angelegt werden sollen, standardmäßig nein
Skript	Skript, welches nach dem Update der Termine ausgeführt wird, z.B. für Sortierung usw.

Aktionsbereich:

Aktion	Beschreibung
AKTUALISEREN	Werte werden neu ermittelt und geschrieben

5. Statusvariablen und Profile

Die Statusvariablen/Timer werden automatisch angelegt. Das Löschen einzelner kann zu Fehlfunktionen führen.

Name	Typ	Beschreibung
Entsorgungsart(en)	String	Abhängig vom Entsorgungsgebiet und den angebotenem Service mehrere Variablen, z.B.: Restmüll, Biotonne usw.

Es werden keine zusätzlichen Profile benötigt.

6. WebFront

Man kann die Statusvariablen(Strings) direkt im WF verlinken.
Aber wie bei der Konfiguration beschrieben, muss man aufpassen wenn die Konfiguration geändert wird. Dann müssen gegebenenfalls die Links neu eingerichtet werden.

7. PHP-Befehlsreferenz

void ABPIO_Update(int $InstanzID);

Holt die nächsten anstehenden Entsorgungstermine für die gewählten Entsorgungsarten.
Die Funktion liefert keinerlei Rückgabewert.

Beispiel: ABPIO_Update(12345);

void ABPIO_FixWasteName(int $InstanzID, string $from, string $to);

Ändert den in der Konfiguration definierten Namen für eine Abfallart. Die Änderung ist nicht persitent und muss nach Konfigurationsänderungen neu ausgeführt werden. Die Funktion liefert keinerlei Rückgabewert.

Beispiel: ABPIO_FixWasteName(12345, 'Hausmüll', 'Hausmüll (2 wöchentlich)');

8. Versionshistorie

v2.2.20240317

NEU: Support für (manuelle) Strassensuche

v2.1.20240304

FIX: User-Agent für Datenabruf korrigiert
FIX: Support für v7 Visualisierung verbessert
FIX: Update für nicht aktivierte Abfallarten korrigiert
FIX: Einige interne Vereinheitlichungen und Anpassungen
FIX: Dokumentation korrigiert

v2.0.20231119

NEU: Kompatibilität auf IPS 6.4 hoch gesetzt
NEU: Support für v7 Visualisierung
FIX: Übersetzungsfehler korrigiert
FIX: PHP Syle Check korrigiert

v1.5.20221020

FIX: Code bereinigt (ungenutzte Funktionen entfernt)

v1.4.20220309

NEU: Konfigurationsformular angepasst

v1.3.20211228

NEU: Kompatibilität auf IPS 6.0 hoch gesetzt
NEU: Konfigurationsformular an die neuen Möglichkeiten der 6.0 angepasst
NEU: Funktion 'FixWasteName' zur Korrektur von Dateninkonsistenzen eines Anbieters
NEU: Erweiterte Einstellung zur Auswahl des Formates bei der Datenabholung (ICS oder CSV)
NEU: Schalter zum automatischen Match der Namen von Abfallarten (experimentell)
FIX: Daten werden jetzt auch über die Jahresgrenze hinaus aktualisiert

v1.2.20210620

NEU: Umstellung auf maximal 30 vewrschiedene Abfallarten
NEU: Bei Änderung des Standortes werden alle Abfallarten deaktiviert
FIX: IPS_SetProperty nicht mehr notwendig
FIX: Status wird jetzt bei nicht aktivierter Aktualisierung auf 'Inaktiv' gesetzt
FIX: Unter Umständen konnte die Erzeugung der Statusvariablen fehlschlagen

v1.1.20210423

FIX: HotFix für doppelte Abfallarten (fehlerhafte Datenlieferung)

v1.0.20210406

NEU: Initialversion

Entwickler

Seit nunmehr über 10 Jahren fasziniert mich das Thema Haussteuerung. In den letzten Jahren betätige ich mich auch intensiv in der IP-Symcon Community und steuere dort verschiedenste Skript und Module bei. Ihr findet mich dort unter dem Namen @pitti 😉

Spenden

Die Software ist für die nicht kommerzielle Nutzung kostenlos, über eine Spende bei Gefallen des Moduls würde ich mich freuen.

Lizenz

Namensnennung - Nicht-kommerziell - Weitergabe unter gleichen Bedingungen 4.0 International

Abfall+ ist die Lösung für elektronische Bürgerdienste in der Abfallwirtschaft.