Opties voor opstarten

ETS kan worden gestart met aanvullende opdrachtargumenten. Met behulp van deze argumenten, kan de gebruiker acties opgeven die worden uitgevoerd wanneer ETS start.

• Ondersteunde acties
• Combinatie van opdrachtregel argumenten
• Foutafhandeling

Ondersteunde acties

De volgende acties worden ondersteund:

De opdrachtregel parameters zijn hoofdlettergevoelig!

1. Een project openen
2. Een project aanmaken
3. Een project verwijderen
4. Een project controleren
5. Een project importeren
6. Een ETS App installeren
7. Een ETS App openen
8. Start de groepsmonitor
9. Start Bus Monitor
10. Start de wizard voor het maken van projecten
11. ETS verlaten
12. Hulp
13. Versie

Een project openen

  --openProject "naam van het project"
of
-o "naam van het project"

• Opent een bestaand project direct na ETS start.
• De "naam van het project" is de eigenlijke projectnaam
• Als het project een wachtwoord vereist, dan wordt het 'Wachtwoord invoeren' dialoogvenster weergegeven.
• Het kan worden gecombineerd met de parameter --password om een met wachtwoord beveiligd project te openen. Als het projectwachtwoord onjuist is, dan wordt het 'Wachtwoord invoeren' venster weergegeven om het juiste wachtwoord in te voeren.

voorbeeld

  --openProject "Mijn Home project" --wachtwoord "Wachtwoord123@#"
of
 -o "Mijn Home project" --wachtwoord "Wachtwoord123@#"

Een project aanmaken

  --createProject "naam van het project"
of
  -c "naam van het project"

• Maakt een nieuw project aan (zelfde functie als bij het standaarddialoogvenster voor het aanmaken van een project) met de volgende standaardinstellingen:
  • Backbone medium: IP
  • Topologie: Creëer Regel 1.1 met medium type TP
  • Weergavestijl groepsadres: drie niveaus
• Het kan worden gecombineerd met de parameter --wachtwoord om een met wachtwoord beveiligd project aan te maken.

voorbeeld

  --createProject "Mijn Home project" --wachtwoord "Wachtwoord123@#"
of
 -c "Mijn Home project" --wachtwoord "Wachtwoord123@#"

Een project verwijderen

  --deleteProject "naam van het project"
of
  -d "naam van het project"

Verwijdert een bestaand project uit de projectopslag. De exitcode waarden geven het volgende aan:

• Succesvolle verwijdering: retourwaarde = 0
• Mislukte verwijdering: retourwaarde = -2

voorbeeld

  --deleteProject "Mijn Home project"
of
 -d "Mijn Home project"

Controleer of een project bestaat

  --existsProject "naam van het project"
of
  -e "naam van het project"

• Controleert of er een bestaand project is met de opgegeven naam in de Project Store.
• De exitcode waarden geven het volgende aan:
  • Project bestaat: retourwaarde = 1
  • Project bestaat niet: retourwaarde = 0
• Hierna sluit ETS automatisch, d.w.z. het is niet nodig om het argument --quit toe te voegen.

voorbeeld

  --existsProject "Mijn Home project"
of
 -e "Mijn Home project"

Een project importeren

  --importProject "bestandspad naar het projectbestand"
of
  -i "bestandspad naar het projectbestand"

• Importeert een specifiek project bestand (in "knxproj" of "pr" formaat) in de Project Store.
• Als een door een wachtwoord beveiligd project geïmporteerd wordt, dan wordt het 'Wachtwoord invoeren' venster getoond om het handmatig in te voeren.

voorbeeld

  --importProject "C:\MyProjects\MyHomeproject.knxproj"
of
 -i "C:\MyProjects\MyHomeproject.knxproj"

Een ETS App installeren

  --installApp "bestandspad naar het App bestand"
of
  -a "bestandspad naar het App bestand"

• Installeert een ETS App die door het gespecificeerde *.etsapp-bestand wordt weergegeven.

voorbeeld

  --installApp "C:\MyProjects\MyApp.etsapp"
of
 -a "C:\MyProjects\MyApp.etsapp"

Een ETS App openen

--openApp "AppId"

• Opent een ETS App met een specifieke App Identifier binnen een project en vereist daarom het ook een bestaand project via de --openProject opdracht.
• De vorige projectwerkruimte zal worden verwijderd en er zal een nieuwe werkruimte worden gemaakt met slechts één venster, tabblad en overzicht en het overzicht zal de gevraagde app bevatten.
• De exitcode waarden geven het volgende aan:
  • "40" wanneer de AppId niet is ingesteld
  • "41" wanneer de opgegeven AppId ongeldig is
  • "42" wanneer er geen ETS App gevonden kan worden met de opgegeven AppId
  • "43" wanneer de gevraagde ETS App native mode vereist, maar ETS werkt in compatibiliteitsmodus
  • "44" wanneer de gevraagde ETS app compatibiliteitsmodus vereist, maar ETS werkt in de native modus
  • "45" wanneer de gevraagde ETS App niet kan worden gestart
  • "46" wanneer de gevraagde ETS app geen licentie heeft

voorbeeld

  --openProject "naam van het project" --openApp M00FA-"A0005"

Start de groepsmonitor

  --groupmon "naam van het project"
of
  -g "naam van het project"

• Dit commando start de Groepsmonitor in een bepaald project.

voorbeeld

  --groupmon "Mijn Home project"
of
 -g "Mijn Home project"

Start Bus Monitor

  --busmon "naam van het project"
of
  -b "naam van het project"

• Dit commando start de Bus Monitor in een bepaald project.

voorbeeld

  --busmon "Mijn Home project"
of
 -b "Mijn Home project"

Start de wizard voor het maken van projecten

  --wizard
of
  -w

• Met deze opdracht wordt de wizard Project maken gestart.

ETS verlaten

  --quit
of
  -q

• Sluit ETS af nadat alle andere argumenten van de commandoregels werden uitgevoerd.
• ETS zal echter niet sluiten ondanks het argument --quit als ten minste een van de andere opdrachtregelargumenten een fout veroorzaakt heeft die resulteerde in ETS fout/waarschuwing berichtendialogen.

Hulp

  --help

• Deze opdracht geeft de help weer in de console.

Versie

  --version

• Dit commando toont de huidige ETS versie in de console.

Combinatie van opdrachtregel argumenten

De enige mogelijke combinaties van command-line argumenten zijn

• --openProject en --importproject
• --password kan gecombineerd worden met --openProject en --createProject
• --quit kan samen met één andere parameter worden gebruikt
• --openApp vereist altijd --openProject (en een --wachtwoord indien nodig)

Zodra het ETS6-proces is gestart, zijn de enige geaccepteerde commando's --createProject, --wizard en -importproject - ze zijn nodig voor de ETS Windows taakbalk commando's.

OpenProject gebruikt het laatste actieve ETS6-venster en opent - indien nodig - een nieuw dashboardtabblad. Elke andere opdracht die wordt gestart nadat ETS6 al is gestart, wordt niet verwerkt, maar brengt ETS6 alleen naar voren.

Foutafhandeling

In geval van fouten of slechte commando's, zal ETS de berichten loggen in het ETS logboek op %LOCALAPPDATA%\Knx\ETS6\Log\ETS6.log

Retour codes

Voor sommige command-line argumenten (bijv. --existsProject), geeft ETS een exit code terug. Exitcodes worden niet naar de console afgedrukt, maar de variabele 'errorlevel' ontvangt de exitcodewaarde.

Om de afsluitcode te evalueren, kan een batchscript de constructie IF ERRORLEVEL gebruiken of variabele uitbreiding gebruiken zoals in echo %errorlevel%. Als ETS rechtstreeks vanaf de opdrachtregel wordt aangeroepen (en niet vanuit een .bat- of .cmd-script), dan moet het worden aangeroepen met cmd /c ETS6.exe ... of start /wait ETS6.exe ...

Veelvoorkomende retourcodes

Veelvoorkomende retourcodes zijn retourcodes die bij elk commando ingesteld kunnen worden:

• -1 als parameter syntax/opties niet correct zijn
• -2 als bewerking mislukt, b.v. project kon niet worden geopend, verwijderd, geïmporteerd of aangemaakt door een fout (maar specifieke retourcodes zijn niet van toepassing)