Hochladen von App-Versionen

Nachdem Sie eine ETS-App registriert haben, können Sie Versionen über deren Detailseite hochladen. Das Hochladen einer Version erfolgt in zwei Schritten:

Fügen Sie die Projektdatei hinzu (dadurch wird die Version erstellt und die automatische Validierung gestartet).
Vervollständigen Sie die Versionsangaben: Versionshinweise, Lizenzvereinbarungen, Erklärung zur Datenerhebung und Rechnungsdaten, und beantragen Sie anschließend die manuelle Validierung.

Schritt 1: Fügen Sie die Projektdatei hinzu

Weiter zu „Konto“ > „Hersteller“ > „ETS-Apps“ > „Meine ETS-Apps“.
Klicken Sie auf das Lupensymbol der ETS-App, in die Sie eine Version hochladen möchten.
Scrollen Sie nach unten zum Abschnitt „ETS-App-Versionen “ und klicken Sie auf „ETS-App-Version erstellen“.
Laden Sie auf der Seite „Neue Version für Ihre ETS-App hinzufügen“ die Binärdatei der App (.etsapp) hoch: Ziehen Sie die Datei per Drag & Drop in den Upload-Bereich oder klicken Sie auf den Upload-Bereich und wählen Sie die Datei aus. Der Dateiname wird neben „Name“ angezeigt.
Falls für die App bereits eine Version vorliegt, wählen Sie bitte aus, was diese Version enthält:
- Diese Version enthält neue Funktionen: Es handelt sich um eine Upgrade-Version, die als Upgrade-Validierung validiert wurde, wobei die entsprechende Gebühr anfällt.
- Diese Version enthält Fehlerbehebungen: Wenn Sie ausschließlich diese Option auswählen, handelt es sich um eine Update-Version, die als Update-Validierung validiert wird, wobei die entsprechende Gebühr anfällt.
Wenn Sie beide Optionen auswählen, handelt es sich um eine Upgrade-Version, die auch Fehlerbehebungen enthält. Siehe ETS-Antragstypen & Prüfungsgebühren.
Klicken Sie auf „ETS-App-Version speichern“.

Sie kehren zur Detailseite der App zurück. Die neue Version erscheint während der automatischen Validierung ganz oben in der Liste der ETS-App-Versionen mit dem Status „In Entwicklung “. Dies dauert in der Regel weniger als eine Minute. Sobald der Vorgang abgeschlossen ist, ändert sich der Status wie folgt:

Wir warten auf IHRE Validierungsanfrage: Die App hat die automatische Validierung bestanden. Fahren Sie mit Schritt 2 fort.
Fehler bei der Validierung: Die App hat eine oder mehrere Validierungsregeln nicht erfüllt. Lesen Sie weiter unten den Abschnitt „Was tun, wenn die automatische Validierung fehlschlägt?“.

Falls die automatische Validierung fehlschlägt

Klicken Sie in der Liste der ETS-App-Versionen auf das Lupensymbol der Version, die den Status „Fehler bei der Validierung“ aufweist.
Auf der Seite wird folgende Meldung angezeigt: „Bei der Validierung Ihrer Projektdatei sind Fehler aufgetreten.“ Klicken Sie auf „Details anzeigen“.
Im Fenster „Testdetails“ werden alle Regeln aufgelistet, bei denen ein Fehler aufgetreten ist, zusammen mit dem Grund dafür, beispielsweise eine veraltete oder inoffizielle SDK-Version, die in der Assembly der App gefunden wurde. Nutzen Sie die Option „Testdetails herunterladen“, um das Ergebnis zu speichern, oder wählen Sie „Testergebnisse per E-Mail versenden“, um es per E-Mail zu erhalten.
Korrigieren Sie die App, laden Sie die korrigierte .etsapp -Datei auf derselben Seite hoch und klicken Sie auf „ETS-App-Version speichern“. Die automatische Validierung wird erneut ausgeführt.

Siehe auch den Artikel Regeln zur App-Validierung. Eine Version, deren Validierung fehlgeschlagen ist, kann über das Papierkorbsymbol in der Versionsliste entfernt werden.

Schritt 2: Geben Sie die Versionsangaben ein

Öffnen Sie in der Liste der ETS-App-Versionen die gewünschte Version, indem Sie auf das Lupensymbol klicken. Die Versionsseite enthält die folgenden Abschnitte:

Projektdatei
Datei(en) mit Versionshinweisen hinzufügen
Lizenzvereinbarung(en) auswählen
Erklärung zur Datenerhebung
Rechnungsdaten auswählen
Automatische Validierung und manuelle Validierung

Projektdatei:

In diesem Abschnitt werden der Versionsstatus und der Name der hochgeladenen .etsapp- Datei angezeigt. Klicken Sie auf das Download-Symbol neben dem Dateinamen, um die Datei herunterzuladen. Das Feld „Version“ wird automatisch aus der Binärdatei ausgefüllt und kann nicht bearbeitet werden. ETS verwendet diese Versionsnummer, um nach Updates für die ETS-App zu suchen. Um dies zu ändern, ändern Sie die Version in der App und laden Sie sie erneut hoch.

Datei(en) mit den Versionshinweisen hinzufügen:

Wählen Sie die Sprache der Versionshinweise aus. Eine Versionshinweise in englischer Sprache ist erforderlich (mit * gekennzeichnet).
Laden Sie die Datei hoch, indem Sie sie per Drag & Drop in den Upload-Bereich ziehen oder indem Sie auf den Upload-Bereich klicken und die Datei auswählen.

Sie können für jede Sprache eine Datei hinzufügen: Ändern Sie die Sprache und wählen Sie eine andere Datei aus. Das bevorzugte Format ist PDF; Dateien im Format .txt, .doc, .docx und .odt werden ebenfalls akzeptiert.

Hinweis: In den Versionshinweisen wird die Historie der Änderungen an der ETS-App dokumentiert, einschließlich Fehlerbehebungen und neuer Funktionen. Das KNX-Support-Team nutzt diese ebenfalls, um Probleme zwischen einer bestimmten ETS-Version und einer bestimmten ETS-App-Version zu untersuchen. Bitte halten Sie sich an folgende Struktur:

Version 1.0
Datum 01.01.2026
Fehlerbehebung 1: …
Fehlerbehebung 2: …
Neue Funktion 1: …
Neue Funktion 2: …
Version 1.1
Datum 01.06.2026
Fehlerbehebung 1: …
Neue Funktion 1: …

Bitte wählen Sie die Lizenzvereinbarung(en) aus:

Wählen Sie für jede Sprache (Deutsch, Griechisch, Englisch, Spanisch, Finnisch, Französisch, Italienisch, Niederländisch, Schwedisch, Chinesisch) aus der Dropdown-Liste die für diese Version geltende Lizenzvereinbarung aus. Keine der Sprachen ist als obligatorisch gekennzeichnet; lassen Sie das Feld für eine Sprache leer (--), wenn Sie keine Vereinbarung in dieser Sprache haben.

Die Liste umfasst die Lizenzvereinbarungen, die unter „Konto“ > „Hersteller“ > „ETS-Apps“ > „Meine Lizenzvereinbarungen“ hochgeladen wurden. Sollte eine Vereinbarung nicht aufgeführt sein, laden Sie diese bitte zunächst über „Neue Lizenzvereinbarung hochladen“ hoch. Neue Lizenzvereinbarungen müssen als Markdown-Dateien (.md) hochgeladen werden, da sie von anderen KNX-Tools den Kunden angezeigt werden (PDF- und Word-Dateien können auf diese Weise nicht angezeigt werden). Zuvor als PDF hochgeladene Vereinbarungen werden weiterhin angezeigt; wir bitten Sie jedoch, diese durch eine Markdown-Version zu ersetzen.

Hinweis: Die Lizenzvereinbarung ist der Vertrag zwischen dem App-Entwickler und dem Endnutzer (EULA). Die KNX Association ist keine Vertragspartei dieser Vereinbarung. Kunden, die die App über MyKNX erwerben, können die Lizenzvereinbarung einsehen und müssen diese akzeptieren, um die Bestellung abzuschließen.

Erklärung zur Datenerhebung:

KNX erfasst Informationen über die Daten, die Ihre ETS-App erfasst oder übermittelt. Für alle ETS-Apps muss eine vollständige Erklärung für ihre aktuellste stabile Version vorliegen. ETS-Apps, für die keine Erklärung eingereicht wurde, werden aus dem KNX Online-Shop entfernt; bereits erworbene und installierte Lizenzen sind davon nicht betroffen, und der Eintrag im Shop wird wiederhergestellt, sobald die Erklärung eingereicht wurde. Beantworten Sie bitte die folgenden Fragen:

Erfasst oder liest diese App Daten aus dem ETS-Projekt, der ETS-Installation oder vom Anwender? (Ja/Nein, Pflichtfeld)
Falls Sie mit „Ja“ antworten: Übermittelt diese App irgendwelche dieser Daten an einen externen Server oder einen Online-Dienst? (Ja/Nein, Pflichtfeld)

Wenn Sie beide Fragen mit „Ja“ beantworten, werden die Abschnitte „Kategorien“ und „Datenübertragung“ angezeigt.

Kategorien: Geben Sie für jede Kategorie an, ob die App diese Daten erfasst oder übermittelt (Ja/Nein):

Benutzerdaten: Name, E-Mail-Adresse, MyKNX-Benutzername, Lizenz- oder Seriennummer, Firma, IP-Adresse und Gerätekennung.
Projektdaten: Projektname, Beschreibung, Projekt-ID, Gebäude-/Gewerbeaufbau, Projektmetadaten sowie die Projektdatei in ihrer Gesamtheit.
Gerätedaten: Hersteller, Produkt- und Bestellnummer, Anwendungsprogramm, Seriennummer und Firmware-Version.
Geräteparameter: Parameterwerte der konfigurierten Geräte.
Gruppenadressen: Gruppenadressen, deren Namen und deren Verknüpfungen zu Kommunikationsobjekten.
Topologie: Bereich-/Linienstruktur, physikalische Adressen, Koppler und IP-Topologie.
Sicherheitsrelevante Informationen: Gerätezertifikate, FDSK, Inhalt des Schlüsselbunds, Tool-Schlüssel, Passwörter und Unterlagen zur sicheren Inbetriebnahme.

Datenübermittlung (alle Felder sind Pflichtfelder):

Wann werden Daten übermittelt? Erst nach einer ausdrücklichen Benutzeraktion innerhalb der App / Automatisch / Beides.
Region des empfangenden Servers: EU / EWR (Nicht-EU) / Außerhalb des EWR / Gemischt oder unterschiedlich.
Zweck der Übermittlung
URL der Datenschutzerklärung
Betreiber des empfangenden Servers

Wählen Sie abschließend die Option „Im Namen des App-Entwicklers bestätige ich, dass die Erklärung zur Datenerhebung vollständig und wahrheitsgemäß ist.“

Rechnungsdaten auswählen:

Wählen Sie den Rechnungskontakt für die Validierungsgebühren aus. Die angezeigten Kontakte stammen aus dem Professional-Konto, mit dem Ihr persönliches Konto verknüpft ist. Sie können einen Kontakt über die Stift- und Kreuz-Symbole bearbeiten oder löschen oder auf „Neue Adresse hinzufügen“ klicken, um einen Kontakt hinzuzufügen. Ein Ansprechpartner ohne Umsatzsteuer-Identifikationsnummer wird mit „Keine Umsatzsteuer“ gekennzeichnet.

Speichern

Klicken Sie auf „ETS-App-Version speichern“.

Automatische Validierung und manuelle Validierung:

Am Ende der Versionsseite:

Die automatische Überprüfung zeigt das Testergebnis an (beispielsweise „Bestanden“). Klicken Sie auf „Details anzeigen“, um das Ergebnis der einzelnen Validierungsregeln anzuzeigen.
Manuelle Validierung: Klicken Sie auf „Manuelle Validierung anfordern“, um die Version zur manuellen Validierung an KNX zu senden. Die Schaltfläche ist erst verfügbar, nachdem die Erklärung zur Datenerhebung ausgefüllt wurde.

Suche