Nadat u een nieuwe ETS App hebt geregistreerd, kunt u versies uploaden via de detailpagina van de App. Het uploaden van een versie bestaat uit twee stappen:
- Het projectbestand toevoegen (Hiermee wordt de versie aangemaakt en de automatische validatie gestart).
- De versiegegevens aanvullen: releaseopmerkingen, licentieovereenkomsten, verklaring over gegevensverzameling en facturatiegegevens. Vervolgens vraagt u de handmatige validatie aan.
Stap 1: Voeg het projectbestand toe
- Ga naar Account > Fabrikant > ETS Apps > Mijn ETS Apps.
- Klik op het vergrootglaspictogram van de ETS App waarvoor u een versie wilt uploaden.
- Scrol naar ETS App-versies en klik op ETS App-versie aanmaken.
- Upload op de pagina Nieuwe versie voor uw ETS App toevoegen het binaire App-bestand (.etsapp). Sleep het bestand naar het uploadgebied of klik op het uploadgebied en selecteer het bestand. De bestandsnaam verschijnt naast Naam.
-
Als er al een versie van de App bestaat, selecteert u wat deze versie bevat:
- Deze versie bevat nieuwe functies: De versie is een Upgrade-versie en wordt als een Upgrade-validatie gevalideerd, waarvoor de bijbehorende kosten worden aangerekend.
- Deze versie bevat bugfixes: Als u alleen deze optie selecteert, is de versie een Update-versie en wordt deze als een Update-validatie gevalideerd, waarvoor de bijbehorende kosten worden aangerekend.
Als u beide opties selecteert, is de versie een Upgrade-versie die ook bugfixes bevat. Zie het artikel ETS App-types & validatiekosten.
- Klik op ETS App-versie opslaan.
U keert terug naar de detailpagina van de App. De nieuwe versie verschijnt bovenaan de lijst met ETS App-versies met de status In ontwikkeling, terwijl de automatische validatie wordt uitgevoerd. Dit duurt doorgaans minder dan een minuut. Zodra het voltooid is, verandert de status in:
- Wachten op UW validatieaanvraag: De App heeft de automatische validatie doorstaan. Ga verder met stap 2.
- Fout bij de validatie: De App voldoet niet aan een of meer validatieregels. Zie Als de automatische validatie mislukt hieronder.
Indien de automatische validatie mislukt
- Klik in de lijst met ETS App-versies op het vergrootglaspictogram van de versie met de status Fout bij validatie.
- Op de pagina verschijnt de melding: Er zijn fouten opgetreden bij de validatie van uw projectbestand. Klik op Details weergeven.
- In het venster Testdetails wordt elke regel weergegeven die niet is geslaagd, samen met de reden daarvoor, bijvoorbeeld omdat er een verouderde of niet-officiële SDK-versie in de assembly van de App is aangetroffen. Gebruik de optie Testgegevens downloaden om het resultaat op te slaan, of Testresultaten per e-mail verzenden om het per e-mail te ontvangen.
- Corrigeer de App, upload het gecorrigeerde .etsapp -bestand op dezelfde pagina en klik op ETS App-versie opslaan. De automatische validatie wordt opnieuw uitgevoerd.
Zie ook het artikel Validatieregels van de App. Een versie die de validatie niet heeft doorstaan, kan via het prullenbakpictogram in de versielijst worden verwijderd.
Stap 2: De versiegegevens aanvullen
Open de versie in de lijst met ETS App-versies door op het vergrootglaspictogram te klikken. De versiepagina bevat de volgende onderdelen:
- Projectbestand
- Releaseopmerkingen toevoegen
- Licentieovereenkomst(en) selecteren
- Verklaring over gegevensverzameling
- Facturatiegegevens selecteren
- Automatische validatie en handmatige validatie
Projectbestand:
In dit gedeelte worden de status van de versie en de naam van het geüploade .etsapp -bestand weergegeven. Klik op het downloadpictogram naast de bestandsnaam om het bestand te downloaden. Het veld Versie wordt automatisch ingevuld op basis van het binaire bestand en kan niet worden bewerkt. ETS gebruikt dit versienummer om te controleren of er updates voor de ETS App beschikbaar zijn. Als u het versienummer wilt wijzigen, moet u dit in de App aanpassen en het bestand opnieuw uploaden.
Releaseopmerkingen toevoegen:
- Selecteer de taal van de release-opmerkingen. Releaseopmerkingen in het Engels zijn verplicht (aangeduid met *).
- Upload het bestand door het naar het uploadgebied te slepen of door op het uploadgebied te klikken en het bestand te selecteren.
U kunt voor elke taal één bestand toevoegen: wijzig de taal en selecteer een ander bestand. PDF is het voorkeursformaat; bestanden in de formaten .txt, .doc, .docx en .odt worden eveneens geaccepteerd.
Opmerking: In de release-opmerkingen wordt de geschiedenis van de wijzigingen in de ETS App beschreven, waaronder bugfixes en nieuwe functies. Het KNX Support Team gebruikt deze ook om problemen tussen een specifieke ETS-versie en een specifieke ETS App-versie te onderzoeken. Gebruik de volgende structuur:
Versie 1.0
Datum 01-01-2026
Bugfix 1: …
Bugfix 2: …
Nieuwe functie 1: …
Nieuwe functie 2: …
Versie 1.1
Datum 01-06-2026
Bugfix 1: …
Nieuwe functie 1: …
Licentieovereenkomst(en) selecteren:
Selecteer voor elke taal (Duits, Grieks, Engels, Spaans, Fins, Frans, Italiaans, Nederlands, Zweeds en Chinees) via de vervolgkeuzelijst de licentieovereenkomst die op deze versie van toepassing is. Geen enkele taal is als verplicht aangeduid; laat de selectie op - - staan als u geen overeenkomst in die taal hebt.
De lijst bevat de licentieovereenkomsten die zijn geüpload onder Account > Fabrikant > ETS Apps > Mijn licentieovereenkomsten. Indien een overeenkomst niet in de lijst staat, dient u deze eerst daar te uploaden via Een nieuwe licentieovereenkomst uploaden. Nieuwe licentieovereenkomsten moeten worden geüpload als Markdown-bestanden (.md), aangezien andere KNX-tools deze aan klanten zullen weergeven (PDF- en Word-bestanden kunnen op deze manier niet worden weergegeven). Overeenkomsten die eerder als PDF zijn geüpload, worden nog steeds weergegeven, maar wij verzoeken u deze te vervangen door een Markdown-versie.
Opmerking: De licentieovereenkomst is de overeenkomst tussen de App-ontwikkelaar en de eindgebruiker (EULA). De KNX Association is geen partij bij deze overeenkomst. Klanten die de App via MyKNX aanschaffen, kunnen de licentieovereenkomst inzien en moeten deze accepteren om de bestelling af te ronden.
Verklaring over gegevensverzameling:
KNX verzamelt informatie over de gegevens die uw ETS App verzamelt of doorstuurt. Voor alle ETS Apps moet een volledig ingevulde verklaring beschikbaar zijn voor de meest recente stabiele versie. ETS Apps waarvoor geen verklaring is ingediend, worden uit de KNX Online Shop verwijderd. Reeds aangekochte en geïnstalleerde licenties blijven onaangetast. Zodra de verklaring is ingediend, wordt de vermelding in de shop hersteld. Beantwoord de volgende vragen:
- Verzamelt of leest deze App gegevens uit het ETS-project, de ETS-installatie of van de gebruiker? (Ja/Nee, verplicht)
- Indien u met „Ja” antwoordt: Stuurt deze App deze gegevens of een deel ervan door naar een externe server of onlinedienst? (Ja/Nee, verplicht)
Als u beide vragen met „Ja” beantwoordt, verschijnen de secties „Categorieën en Gegevensoverdracht.
Categorieën: Geef voor elke categorie aan of de App deze gegevens verzamelt of doorstuurt (Ja/Nee):
- Gebruikersidentiteit: naam, e-mailadres, MyKNX-gebruikersnaam, licentie- of serienummer, bedrijf, IP-adres en apparaatidentificatiecode.
- Projectgegevens: projectnaam, beschrijving, project-ID, gebouw- en vakgebiedstructuur, projectmetadata en het volledige projectbestand.
- Apparaatgegevens: fabrikant, product- en bestelnummer, applicatieprogramma, serienummer en firmwareversie.
- Apparaatparameters: parameterwaarden van geconfigureerde apparaten.
- Groepsadressen: groepsadressen, hun namen en hun koppelingen met groepsobjecten.
- Topologie: gebieds- en lijnstructuur, individuele adressen, koppelaars en IP-topologie.
- Beveiligingsgerelateerde informatie: apparaatcertificaten, FDSK, inhoud van de keyring, tool key, wachtwoorden en gegevens voor secure inbedrijfname.
Gegevensoverdracht (alle velden zijn verplicht):
- Wanneer worden gegevens doorgestuurd? Alleen na een expliciete handeling van de gebruiker binnen de App / Automatisch / Beide.
- Regio van de ontvangende server: EU / EER (buiten de EU) / Buiten de EER / Gemengd of variabel.
- Doel van de transmissie
- URL van het privacybeleid
- Operator van de ontvangende server
Selecteer tot slot Namens de App-ontwikkelaar bevestig ik dat de verklaring over gegevensverzameling volledig en waarheidsgetrouw is.
Facturatiegegevens selecteren:
Selecteer het facturatiecontact voor de validatiekosten. De weergegeven contacten zijn afkomstig uit het professionele account waaraan uw persoonlijke account is gekoppeld. U kunt een contact bewerken of verwijderen met respectievelijk het potloodpictogram en het kruisje. Klik op Nieuw adres toevoegen om een nieuw contact toe te voegen. Bij een contact zonder btw-nummer wordt Geen btw weergegeven.
Opslaan
Klik op ETS App-versie opslaan.
Automatische validatie en handmatige validatie:
Onderaan de versiepagina:
- Automatische validatie: hier wordt het testresultaat weergegeven (bijvoorbeeld Geslaagd). Klik op Details weergeven om het resultaat van elke validatieregel te bekijken.
- Handmatige validatie: klik op Handmatige validatie aanvragen om de versie naar KNX te verzenden voor handmatige validatie. De knop is pas beschikbaar nadat de verklaring over gegevensverzameling is ingevuld.