ETS kan startas med ytterligare kommandorads-argument. Med dessa argument kan användaren specificera åtgärder som kommer att utföras när ETS startar.
Åtgärder som stöds
Följande åtgärder stöds:
Kommando-parametrarna är skiftlägeskänsliga!
- Öppna ett projekt
- Skapa ett projekt
- Ta bort ett projekt
- Kontrollera ett projekt
- Importera ett projekt
- Installera en ETS App
- Öppna en ETS-app
- Starta gruppövervakaren
- Starta bussövervakaren
- Starta guiden för att skapa ett projekt
- Stäng ETS
- Hjälp
- version
Öppna ett projekt
--openProject "projektets namn"
eller
-o "projektets namn"
- Öppnar ett befintligt projekt direkt efter ETS startat.
- "Projektets namn" ska vara det faktiska projektnamnet.
- Om projektet kräver ett lösenord visas dialogen 'Ange lösenord'.
- Det kan kombineras med parametern --password för att öppna ett lösenordsskyddat projekt. Om projektlösenordet är felaktigt visas dialogen 'Ange lösenord' för att ange korrekt lösenord.
Exempel
--openProject "Mitt projekt" --password "Lösenord123@#"
eller
-o "Mitt projekt" --password "Lösenord123@#"
Skapa ett projekt
--createProject "projektets namn" eller -c "projektets namn"
- Skapar ett nytt projekt (samma funktioner som i standarddialogen för att skapa projekt) med följande standardinställningar:
- Medium för områdeslinjen: IP
- Topologi: Skapa linje 1.1 med medietyp TP
- Gruppadresstruktur: Tre nivåer
- Det kan kombineras med parametern --password för att skapa ett lösenordsskyddat projekt.
Exempel
--createProject "Mitt projekt" --password "Lösenord123@#"
eller
-c "Mitt projekt" --password "Lösenord123@#"
Ta bort ett projekt
--deleteProject "projektets namn" eller -d "projektets namn"
Raderar ett befintligt projekt från projektlagret. Returkoden indikerar följande:
- Lyckad borttagning: returkod = 0
- Misslyckad borttagning: returkod = -2
Exempel
--deleteProject "Mitt projekt"
eller
-d "Mitt projekt"
Kontrollera om ett projekt finns
--existsProject "projektets namn" eller -e "projektets namn"
- Kontroller om det finns ett befintligt projekt med det angivna namnet i projektlagret.
- Returkoden indikerar följande:
- Projekt finns: returkod = 1
- Projekt finns inte: returkod = 0
- Efter detta stänger ETS automatiskt, dvs. det finns inget behov för att lägga till argumentet --quit.
Exempel
--existsProject "Mitt projekt"
eller
-e "Mitt projekt"
Importera ett projekt
--importProject "sökväg till projektfilen" eller -i "sökväg till projektfilen"
- Importerar en specifik projektfil (antingen i "knxproj"- eller "pr"-format) till projektlagret.
- Vid import av ett lösenordsskyddat projekt visas dialogen 'Ange lösenord' för att anges manuellt.
Exempel
--importProject "C:\MinaProjekt\MittProjekt.knxproj"
eller
-i "C:\MinaProjekt\MittProjekt.knxproj"
Installera en ETS App
--installApp "sökväg till appens installationsfil" eller -a "sökväg till appens installationsfil"
- Installerar en ETS App som representeras av den specificerade *.etsapp-filen.
Exempel
--installApp "C:\MinaProjekt\MinApp.etsapp"
eller
-a "C:\MinaProjekt\MinApp.etsapp"
Öppna en ETS-app
--openApp "AppId"
- Öppnar en ETS-app med en specifik app-identifiering inom ett projekt och kräver därför också att ett befintligt projekt specificeras via kommandot --openProject.
- Den tidigare arbetsytan kommer att ignoreras och en ny arbetsyta kommer att skapas som endast innehåller ett fönster och flik och kommer att innehålla den efterfrågade appen.
- Returkoden indikerar följande:
- "40" när AppId inte är angivet
- "41" när det angivna AppId är ogiltigt
- "42" när ingen ETS-app med det angivna AppId kan hittas
- "43" när den begärda ETS-appen kräver standardläge men ETS körs i kompatibilitetsläge
- "44" när den begärda ETS-appen kräver kompatibilitetsläge men ETS körs i standardläge
- "45" när den begärda ETS-appen inte kan startas
- "46" när den begärda ETS-appen inte är licensierad
Exempel
--openProject "projektets namn" --OpenApp "M00FA-A0005"
Starta gruppövervakaren
--groupmon "projektets namn" eller -g "projektets namn"
-
Detta kommando startar gruppövervakaren i ett givet projekt.
Exempel
--groupmon "Mitt projekt"
eller
-g "Mitt projekt"
Starta bussövervakaren
--busmon "projektets namn" eller -b "projektets namn"
-
Detta kommando startar bussövervakaren i ett givet projekt.
Exempel
--busmon "Mitt projekt"
eller
-b "Mitt projekt"
Starta guiden för att skapa ett projekt
--wizard eller -w
-
Detta kommando startar guiden för att skapa ett projekt.
Stäng ETS
--quit eller -q
- Avslutar ETS efter att alla andra kommandorads-argument har körts.
- ETS kommer dock inte stänga trots argumentet --quit om minst ett av de andra kommandorads-argumenten orsaker ett fel som resulterar i fel/varnings-meddelande i ETS.
Hjälp
--help
-
Detta kommando visar hjälpen i konsolen.
version
--version
-
Detta kommando visar nuvarande ETS-version i konsolen.
Kombination av kommandorads-argument
De enda möjliga kombinationerna av kommandorads-argument är
- --openProject och --importProject
- --password kan kombineras med --openProject och --createProject
- --quit kan användas med en annan parameter
- --openApp kräver alltid --openProject (och --password om nödvändigt)
När ETS-processen har startat är de enda accepterade kommandon: --createProject, --wizard and --importProject, de behövs för ETS-fönstrets kommandon via aktivitetsfältet.
OpenProject kommer använda det senast aktiva ETS6-fönstret och öppna - vid behov - en ny flik. Alla andra kommandon som startas efter att ETS6 redan startat kommer inte bearbetas, men kommer fokusera ETS6 på skärmen.
Felhantering
Vid fel eller ogiltiga kommandon kommer ETS logga meddelandena i ETS-loggen som finns i %LOCALAPPDATA%\Knx\ETS6\Log\ETS6.log.
Returkoder
För vissa kommandorads-argument (t.ex. --existsProject) returnerar ETS en avslutningskod. Avslutningskoder skrivs inte ut till konsolen men variabeln 'errorlevel' tar emot koden.
För att utvärdera avslutningskoden kan ett batch-script använda IF ERRORLEVEL eller använda variabel-expansion som echo %errorlevel%. När ETS startas direkt från kommandoraden (och inte från ett .bat eller .cmd script) så behöver den startas med antingen cmd /c ETS6.exe ... eller start /wait ETS6.exe ...
Vanliga returkoder
Vanliga returkoder returkoder som kan ges vid alla kommandon:
- -1 om parameter-syntax/alternativ inte stämmer
- -2 om åtgärden misslyckades, t.ex. ett projekt kunde inte öppnas, raderas, importeras eller skapas på grund av ett fel (men kommando-specifika returkoder gäller inte)