Tankerkönig Adapter Komplett umbau

[Issi]

Aktuelle Version	3.1.0 stable
Veröffentlichungsdatum	24.12.2022
Github Link	https://github.com/iobroker-community-adapters/ioBroker.tankerkoenig

Hey, da der Entwickler von tankerkoenig sich zurückgezogen hat und den Adapter in die Community übergeben hat, habe ich mich dem mal angenommen und den Adapter vollständig überarbeitet.
Es wurden einige offene Issues abgearbeitet, die entweder Bug's oder Feature Anfragen enthielten.
Zuallererst der Adapter wurde komplett neu geschrieben, er hat eine neue React UI bekommen, leider ist somit die alte Config vom Adapter nicht mehr, mit der neuen kompatibel, da das Migrieren der Daten viel zu umständlich gewesen wäre.

Wie geht man nun vor, wenn man den Adapter aktualisieren will, ich empfehle den Adapter komplett neu zu installieren, da bei einem normalen Update eventuell seltsame Fehler in der UI auftreten können. Außerdem sind dann alte Datenpunkte vorhanden, die nicht mehr funktionieren.
Wie macht man das am besten:

1. in den alten Adapter gehen und den API Schlüssel, der dort angegeben ist, irgendwo abspeichern.
2. dann unter Adapter den tankerkönig suchen und dort deinstallieren. Achtung alle Objekte werden gelöscht, auch DB logger (Influx, MySQL usw.) diese müsst ihr dann bei den neuen Objekten neu aktivieren.
3. ihr installiert den neuen tankerkoenig über das +.
4. ihr geht dann in die neue Adapter UI und gebt dort euren API-Schlüssel an, dann könnt ihr auch schon auf den Reiter Stationen gehen und dort die Stationen neu anlegen.

Falls man aber das Update normal ohne Neuinstallation machen will, sollte man alle nicht funktionierenden Datenpunkte löschen, am besten ein mal den gesamten tankerkoenig.0.stations Ordner löschen und dann den Adapter starten, es werden alle neune Datenpunkte generiert.

Weitere Informationen wie und was man in der UI angeben kann, findet ihr auf GitHub in der Adapter Dokumentation DE / Dokumentation EN

Was hat der Adapter nun neues bekommen:
bug fixes:

• Tankerkönig Widgets zeitweise leer Forum und GitHub issue #73
  die Funktion cutPrice wurde komplett neu geschrieben. (falls der Fehler weiterhin besteht, bitte ein neues Issue dafür aufmachen)
• issue #79 wurde behoben.

Feature request:

• es wurden eine JsonTable für die vis hinzugefügt issue #24
• eine Möglichkeit Rabatt anzugeben wurde hinzugefügt issue #50
• Es wurde ein Button zu den Objekten hinzugefügt, über den man eine manuelle Aktualisierung starten kann. issue #53
• Eine min / max Preis Datenpunkte wurden hinzugefügt, diese speichern den min / max Preis für den Tag.

---

Vollständiges Changelog [EN]

Spoiler

3.1.0 (2022-11-27)

• (xXBJXx) removed noLog option because the adapter log output was strongly optimized
• (xXBJXx) Optimized sorting of the cheapest gas station issue #96
• (xXBJXx) add new state cheapest_stations for the cheapest gas station issue #93

3.0.6 (2022-11-23)

• (xXBJXx) Added new option to adjust the text in the combined data point issue #95

3.0.5 (2022-11-20)

• (xXBJXx) fixed sort bug for cheapest station

3.0.4 (2022-11-19)

• (xXBJXx) moved misc-data type to vehicle type
• (xXBJXx) fixed messages rules and added new messages for Adapter Update
• (xXBJXx) update dependencies
• (xXBJXx) added lastUpdate_min / lastUpdate_max DP issue #91

3.0.3 (2022-11-18)

• (xXBJXx) Ukrainian translation added
• (xXBJXx) add validation function for ID and Name Input fields
• (xXBJXx) add copy from clipboard function for ID Input field
• (Schmakus) added daily min/max prices to all stations and fuel types
• (xXBJXx) update documentation because of new min/max datapoints

3.0.2 (2022-11-10)

• (xXBJXx) release new version from Tankerkoenig

3.0.1 (2022-07-30)

• (xXBJXx) resetValue function removed and state quality implemented. issue #79
• (xXBJXx) added function => Set values to 0 when the Station is closed.
• (xXBJXx) updated dependencies

3.0.0 (2022-07-02)

• (xXBJXx) BREAKING Adapter code completely revised
• (xXBJXx) Adapter completely switched to TypeScript
• (xXBJXx) BREAKING Adapter configurations page switched to React and redesigned
  (old config not compatible stations must be recreated)
• (xXBJXx) add Dependabot auto merge support
• (xXBJXx) add test and release script
• (xXBJXx) Dependency updated
• (xXBJXx) add feature request: manual update of all stations (one request per minute allowed) issue #53
• (xXBJXx) add a new state => adapterStatus (indicates whether the adapter executes an automatic request or a manual request)
• (xXBJXx) add new cutPrice function issue #73
• (xXBJXx) add the feature request: Include discount in price (euro and percent) issue #50 and adapter code optimized
• (xXBJXx) add the feature request: JsonTable for the vis issue #24
  

[Chaot]

@issi Danke für deine Arbeit.
Werde ich gerne testen.
Bei mir sind manchmal irgendwelche Phantasiepreise in der Datenbank. Beispielsweise irgendwas mit über 3 € kurz vor dem Schließen der betroffenen Tankstelle usw.
Vielleicht ist das jetzt ja auch irgendwie besser geworden.

[Homoran]

@issi wie sieht es mit den DP IDs aus?
ich frage weil ich die Spritpreise mit History logge und die Historie gerne fortführen möchte

@chaot sagte in Tankerkönig Adapter Komplett umbau:

Bei mir sind manchmal irgendwelche Phantasiepreise in der Datenbank. Beispielsweise irgendwas mit über 3 € kurz vor dem Schließen der betroffenen Tankstelle usw.

das habe ich noch nie beobachtet. Bist du sicher dass das nicht der "echte" Preis des Tankstellenbetreibers ist?

[Chaot]

@homoran
Ich habe keine genaue Ahnung wo das herkommt.
Hier habe ich die ganz groben Ausreißer schon weggefiltert, also alles über 2,80 € und alles unter 1,50 € wird nicht dargestellt:

Wobei die DEA Tankstelle die größeren Ausreißer produziert.

[Issi]

@homoran sagte in Tankerkönig Adapter Komplett umbau:

@issi wie sieht es mit den DP IDs aus?
ich frage weil ich die Spritpreise mit History logge und die Historie gerne fortführen möchte

Ich habe die alte DP Struktur nicht mehr genau im Kopf, so schaut die neue aus tankerkoenig.0.stations.0.e5.feed tankerkoenig.0.stations.1.e5.feed usw.

[DJMarc75]

@issi Sieht schonmal gut aus !

Frage zu min/max DPs:
Es aktualisieren sich die Werte bei min und max jeweils mit dem aktuellen Preis obwohl sich die Preise heute schon öfters verändert haben.
Beobachtet bei meinen 3 Tanken und bei allen Spritarten.

[Homoran]

@issi sagte in Tankerkönig Adapter Komplett umbau:

Ich habe die alte DP Struktur nicht mehr genau im Kopf, so schaut die neue aus tankerkoenig.0.stations.0.e5.feed tankerkoenig.0.stations.1.e5.feed usw.

i h auch nicht, könnte aber passen, das wäre top!

[Issi]

@chaot sagte in Tankerkönig Adapter Komplett umbau:

@homoran
Ich habe keine genaue Ahnung wo das herkommt.
Hier habe ich die ganz groben Ausreißer schon weggefiltert, also alles über 2,80 € und alles unter 1,50 € wird nicht dargestellt:

Wobei die DEA Tankstelle die größeren Ausreißer produziert.

Was du mal machen kannst, ist den DP tankerkoenig.0.stations.json irgendwohin zu logen, da steht nämlich, der der Response von der Tankstelle drin also das, was man von der API bekommt.
Am besten machst du dir ein Script, mit dem du den Inhalt dir als log ausgeben oder Telegram usw. zusenden lässt. Das Ganze kann man dann auch so machen, dass wenn der Preis wieder über ein bestimmtes Ziel geht, es dir dann mit dem Inhalt eine Nachricht sendet.

[Issi]

@djmarc75 hast du da bitte ein Screenshot bei mir schaut es so aus

[DJMarc75]

@issi Logo inkl Zeitstempel:

[Issi]

@djmarc75 war der Preis heute schon unter 1.93

[DJMarc75]

@issi sagte in Tankerkönig Adapter Komplett umbau:

unter 1.93

Das weiß ich nicht aber er war schon bei 1.98 also drüber

[Issi]

@djmarc75
hmm, beobachte das mal bitte weiter kannst du da ein history logger drauflegen auf beide min und max und ein wenig Daten sammeln lassen.
Ich habe es bei mir auf zwei Systemen laufen und es läuft, wie es soll, das schon seit Tagen.

[DJMarc75]

@issi sagte in Tankerkönig Adapter Komplett umbau:

Daten sammeln

wird gemacht !

[Chaot]

@issi Danke für den Tip. Das werde ich mal versuchen.

Eine Frage hätte ich noch.
Gibt es die Möglichkeit den Zeitpunkt der Min und max Werte als Datenpunkt zu schreiben?
Oder gibt es eine andere Möglichkeit den über influxdb auszuwerten?

Ich würde mir gerne möglichst einfach eine Grafik erstellen wann es in der Woche potentiell am günstigsten ist zu tanken.

[DJMarc75]

@issi sagte in Tankerkönig Adapter Komplett umbau:

und es läuft

Bei mir nun auch - weiss der Geier warum, aber alles wieder top

[Rene55]

@issi sagte in Tankerkönig Adapter Komplett umbau:

https://github.com/iobroker-community-adapters/ioBroker.tankerkoenig

Ich hab mir den neuen Adapter auf einer separaten Instanz installiert und mit meinen 4 Tanken bestückt. Läuft super und die GUI sieht klasse aus. Top und Danke.

[Chaot]

Läuft schön. Und Danke für die Option mit der billigsten Tanke.

[Issi]

@chaot
hmm, also aktuell ist im Adapter nichts der artige eingebaut. Du kannst glaube den Zeitstempel von DP auslesen in einem Skript und den in einen Dp schreiben.
Aber für die Zukunft kannst du da bitte ein Issue erstellen, issue als featuer request dann schaue ich mal, dass ich es noch mit rein machen, bitte dann auch genau erklären, was du haben willst.

[Issi]

@chaot sagte in Tankerkönig Adapter Komplett umbau:

Läuft schön. Und Danke für die Option mit der billigsten Tanke.

Was genau meinst, du mit der billigsten Tanke? Die min / max Sachen oder die Sachen unter tankerkoenig.0.stations.cheapest