Skip to content

Releases: OpenKNX/OFM-ConfigTransfer

v0.4 Kanal-Tausch + Verbesserungen der Usability und Kompatiblität

03 Jul 21:23

Choose a tag to compare

Achtung: Das Versions-Schema von OpenKNX-Modulen ist an die Versionierung von ETS-Applikationen angelehnt und weicht daher vom Konzept der semantischen Versionierung (SemVer) ab!

  • Wichtig: Der OpenKNXProducer muss auf Version 3.8.0 aktualisiert werden!

    Achtung: Es erfolgt keine Warnung oder Hinweis beim Einsatz einer veralteten Producer-Version!

    Folgende Änderungen/Verbesserungen ergeben sich durch Updates des OpenKNXproducer seit Erscheinen von ConfigTransfer v0.2.0 und sind ggf. auch schon in einzelnen OpenKNX-Applikationen mit ConfigTransfer v0.2 verfügbar:

    • Fix: Ausschluss von Parametern die nicht direkt durch den Nutzer geändert werden können.
      (Diese hatten teilweise für Probleme beim Transfer gesorgt und werden i.d.R. aus den anderen Parametern abgeleitet. Durch den Ausschluss haben sich in der Praxis bisher keine Nachteile gezeigt.)
    • Fix: Standard-Parameter-Werte können nun das Zeichen % enthalten
    • Detail-Verbesserung: Darstellung der Modul-Auswahl
    • Erweiterung: Explizite Beeinflussung ob Parameter-Werte in den Transfer eingeschlossen/ausgeschlossen werden, oder immer exportiert werden.
      Diese Möglichkeit ist erforderlich zur Verbesserung der Kompatiblität beim Transfer mit veränderten Standardwerten und wird im neuen OpenKNX Common 1.4 benötigt.
  • Feature #36: Tausch von Kanälen

    • Eigener Parameterblock analog zu Kanalkopie
    • Bereitstellung Funktion zur Nutzung in Modulen, siehe Entwicklerdokumentation
  • Verbesserungen/Anpassungen, basierend auf Nutzererfahrungen:

    • Geänderte Reihenfolge der Parameter-Blöcke (Seiten): Kanalkopie, Kanaltausch, Standardwerte, Import, Export.
      Operationen innerhalb der Applikation werden in der Praxis häufiger verwendet als Import und Export.
    • Import
      • Konfiguration der Kompatibilitätsprüfung aus der Benutzeroberfläche entfernt.
        Das Verhalten entspricht nun dem Kompatibilitätslevel lockerer.
        Der bisherige Standard-Level streng verhinderte in der Praxis sehr häufig den Import,
        was bei Nutzern teilweise für Verwirrung sorgte.
        In der Praxis führte die deutlich höhere Toleranz von lockerer zu keinen gravierenden Problemen.
      • Tolerieren/Trimmen von Whitespaces vor und nach Transfer-String
      • Direkte Integration von Hinweis zur erforderlichen Nachbereitung
    • Beschriftung für Auswahl von Export-Format.
      "Menschenlesbar" wurde häufig fälschlicherweise für Support-Zwecke ausgewählt.
    • Anzeige von Applikations- und Modul-Versionsnummern in lesbarer einheitlicher Form
  • Vorbereitung auf Multi-Channel-Transfer: Hinweis bei Erkennung von geplanter Format-Version

  • Bereinigung XML, Dokumentation, Kommentare

v0.2 Migration Hotfix + Import Check

29 Jul 19:16

Choose a tag to compare

Achtung: Das Versions-Schema von OpenKNX-Modulen ist an die Versionierung von ETS-Applikationen angelehnt und weicht daher vom Konzept der semantischen Versionierung (SemVer) ab!

  • Hotfix #14 für OAM-PresenceModule/OFM-PresenceModule:
    Exporte aus älteren Versionen von PM konnten nicht importiert werden, weil Parameter entfallen sind.
    Mit Kompatibilität lockerer wird der Import nun nicht mehr abgebrochen, wenn unbekannte Parameter-Namen auftreten,
    sondern nur noch Warn-Meldungen im Import-Resultat ausgegeben.
    Dies betraf vor allem den Migrationspfad zum Wechsel auf eine andere Applikations-Variante.
  • Import - Verbesserungen bei der Fehlerbehandlung und Rückmeldung:
    • Fix #9:
      Der Versuch eine Basiskonfiguration in einen anderen Zielkanal zu importieren (oder umgekehrt) wurde nicht explizit abgefangen
      und resultierte in einer unpassenden Fehlermeldung.
      Ein Import bei exakt übereinstimmenden Parameternamen (kein bekanntes Auftreten in Releases) wurde nicht verhindert.
    • Fix/Improvement:
      Import-Resultat unterscheidet sich im Text nun
      zwischen Importen ohne Auffälligkeiten, mit Warnungen oder Fehlern.
      Dazu wurde die Erzeugung des Meldungstextes umgestellt.
    • Fix: Verbesserte Prüfung von Kanal-Definition in Transfer-String beim Import
    • Fix/Rework: Auswertung der Modul-Version in Prüfung vor Import, speziell Fälle ohne Versionsangabe am Modul
    • Improvement: Genauere Fehleranzeige für Spezial-Einträge
    • Improvement: Fehleranzeige für Unbekannte Einträge
  • Quality: Integration automatisierter Testfälle für JS in ETS-Applikation

v0.1 App Releases 2024-07

17 Jul 20:47

Choose a tag to compare

Erste PROD-Release zur Integration in OpenKNX-Applikationen ab 2024-07.

Nutzung der stabilen Transfer-Format-Version cv1.

Nutzung in mindestens folgenden OpenKNX-Applikationen: