Käynnistysvaihtoehdot

ETS voidaan käynnistää lisätyillä komentoriviparametreilla. Niillä käyttäjä voi määritellä toimet, joita suoritetaan kun ETS käynnistetään.

• Tuetut toiminnot
• Komentoriviparametrien yhdistelmät
• Virheidenkäsittely

Tuetut toiminnot

Seuraavat toiminnot on tuettu:

Komentoriviparametrit ovat merkkikokoriippuvaisia!

1. Avaa projekti
2. Luo projekti
3. Poista projekti
4. Tarkasta projekti
5. Tuo projekti
6. Asenna ETS Sovellus
7. Avaa ETS-sovellus
8. Käynnistä ryhmämonitori
9. Käynnistä väylämonitori
10. Käynnistä projektin luontivelho
11. Lopeta ETS
12. Ohje
13. versio

Avaa projekti

  --openProject "projektin nimi"
tai
-o "projektin nimi"

• Avaa olemassa olevan projektin heti kun ETS on käynnistynyt.
• "projektin nimi" on projektin tosiasiallinen nimi
• Jos projekti vaatii salasanan, niin 'syötä salasana -valintaikkuna' näytetään.
• Voidaan yhdistää parametrin --password kanssa avataksesi salasanalla suojatun projektin. Jos projektin salasana on virheellinen, niin 'syötä salasana -valintaikkuna' näytetään, jotta voit syöttää oikean salasanan.

Esimerkki

  --openProject "minun kotiprojekti" --password "Salasana123@#"
tai
 -o "minun kotiprojekti" --password "Salasana123@#"

Luo projekti

  --createProject "projektin nimi"
tai
  -c "projektin nimi"

• Luo uuden projektin (sama toiminto kuin projektin luonnin vakiovalintaikkunassa) seuraavilla oletusasetuksilla:
  • Runkoverkon media: IP
  • Topologia: luodaan linja 1.1 medialla TP
  • Ryhmäosoitteen esitystapa: kolmen tason
• Voidaan yhdistää parametriin --password luodaksesi salasanalla suojatun projektin.

Esimerkki

  --createProject "minun koti" --password "Salasana123@#"
tai
 -c "minun koti" --password "Salasana123@#"

Poista projekti

  --deleteProject "projektin nimi"
tai
  -d "projektin nimi"

Poistaa olemassa olevan projektin projektiluettelosta. Palautusarvo osoittaa seuraavaa:

• Poistaminen onnistui: palautusarvo = 0
• Poistaminen epäonnistui: palautusarvo = -2

Esimerkki

  --deleteProject "minun kotiprojekti"
tai
 -d "minun kotiprojekti"

Tarkista, onko projekti olemassa

  --existsProject "projektin nimi"
tai
  -e "projektin nimi"

• Tarkastaa, onko projekti olemassa määritetyllä nimellä ETS:n projektiluettelossa.
• Palautusarvo osoittaa seuraavaa:
  • Projekti on olemassa: palautusarvo = 1
  • Projektia ei ole olemassa: palautusarvo = 0
• Tämän jälkeen ETS sulkeutuu automaattisesti, ts. ei ole tarpeen lisätä /quit argumenttia.

Esimerkki

  --existsProject "minun kotiprojekti"
or
 -e "minun kotiprojekti"

Tuo projekti

  --importProject "tiedostopolku projektitiedostoon"
tai
  -i "tiedostopolku projektitiedostoon"

• Tuo projektitiedoston (joko "knxproj" tai "pr" muodossa) projektiluetteloon.
• Jos tuodaan salasanalla suojattu projekti, näytetään 'syötä salasana -valintaikkuna' salasanan syöttämiseksi manuaalisesti.

Esimerkki

  --importProject "C:\MyProjects\minunkotiprojekti.knxproj"
tai
 -i "C:\MyProjects\minunkotiprojekti.knxproj"

Asenna ETS Sovellus

  --installApp "tiedostopolku sovelluksen tiedostoon"
tai
  -a "tiedostopolku sovelluksen tiedostoon"

• Asentaa ETS Sovelluksen, jota edustaa määritetty *.etsapp-tiedosto.

Esimerkki

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

Avaa ETS-sovellus

--openApp "AppId"

• Avaa ETS-sovelluksen tietyllä sovellustunnisteella projektin sisällä, ja siksi se edellyttää myös olemassa olevan projektin määrittelyä --openProject komennon avylla.
• Edellinen projektityötila hylätään ja luodaan uusi työtila, joka sisältää vain yhden ikkunan, välilehden ja paneelin. Paneeli sisältävää pyydetyn sovelluksen.
• Palautusarvo osoittaa seuraavaa:
  • "40" kun sovellustunnusta (AppId) ei ole asetettu
  • "41", kun annettu AppId on virheellinen
  • "42", kun kyseiselle AppID:lle ei löydy ETS-sovellusta
  • "43", kun pyydetty ETS-sovellus vaatii natiivitilaa, mutta ETS toimii yhteensopivuustilassa
  • "44", kun haettu ETS-sovellus vaatii yhteensopivuustilaa, mutta ETStoimii natiivitilassa
  • "45", kun pyydettyä ETS-sovellusta ei voida käynnistää
  • "46", kun pyydettyä ETS-sovellusta ei ole lisensoitu

Esimerkki

  --openProject "projektin nimi" --openApp "M00FA-A0005"

Käynnistä ryhmämonitori

  --groupmon "projektin nimi"
tai
  -g "projektin nimi"

• Tämä komento käynnistää ryhmämonitorin määrätyssä projektissa.

Esimerkki

  --groupmon "minun kotiprojekti"
tai
 -g "minun kotiprojekti"

Käynnistä väylämonitori

  --busmon "projektin nimi"
tai
  -b "projektin nimi"

• Tämä komento käynnistää väylämonitorin määrätyssä projektissa.

Esimerkki

  --busmon "minun kotiprojekti"
tai
 -b "minun kotiprojekti"

Käynnistä projektin luontivelho

  --wizard
tai
  -w

• Tämä komento käynnistää projektin luontivelhon.

Lopeta ETS

  --quit
tai
  -q

• Sulkee ETS:n sen jälkeen, kun kaikki muut komentojonoargumentit on suoritettu.
• ETS ei kuitenkaan sulkeudu, huolimatta --quit -argumentista, jos vähintään yksi toisista komentoriviparametreistä aiheutti virheen, jonka tuloksena on näytetty virheilmoitus tai varoitus ETS:ssä.

Ohje

  --help

• Tämä komento näyttää ohjeen konsolissa.

versio

  --version

• Tämä komento näyttää nykyisen ETS-version konsolissa.

Komentoriviparametrien yhdistelmät

Ainoa mahdollinen komentoriviparametrien yhdistelmä on

• --openProject ja --importProject
• --password voidaan yhdistää seuraaviin: --openProject ja --createProject
• --quit voidaan käyttää yhdessä yhden muun parametrin kanssa
• --openApp vaatii aina --openProject (ja tarvittaessa --password)

Kun ETS6-prosessi on käynnistetty, ainoat hyväksytyt komennot ovat: --createProject, --wizard ja -importProject - niitä tarvitaan ETS:n Windows-tehtäväpalkin komennoille.

OpenProject käyttää viimeisintä aktiivista ETS6-ikkunaa ja avaa – tarvittaessa – uuden välilehden työtilaan. Mitään muuta komentoa, joka käynnistetään sen jälkeen, kun ETS6 on jo käynnistetty, ei käsitellä, vaan se vain nostaa ETS6:n eteen.

Virheidenkäsittely

Virheiden tai huonojen komentojen tapauksessa ETSkirjaa viestit ETS:n lokiin osoitteessa %LOCALAPPDATA%\Knx\ETS6\Log\ETS6.log

Palautuskoodit

Joillakin komentoriviparametreilla (esim. --existsProject) ETS antaa palautuskoodin. Palautuskoodeja ei tulosteta konsolille, mutta 'errorlevel'-muuttuja saa palautuskoodin arvon.

Jotta poistumiskoodi voidaan arvioida, komentosarja voi käyttää IF ERRORLEVEL -rakennetta tai käyttää muuttujan laajenemista, kutenecho %errorlevel%. Kun ETS:n vedotaan suoraan komentoriviltä (ja ei .bat tai .cmd -skriptillä), niin on vedottava joko cmd /c ETS6.exe ...taistart /wait ETS6.exe ...

Yleiset palautuskoodit

Yhteiset palautuskoodit ovat palautuskoodeja, jotka voidaan asettaa millä tahansa komennolla:

• -1 jos parametrin syntaksi/asetukset eivät ole oikein
• -2 jos toiminta epäonnistui, esim. projektia ei voitu avata, poistaa, tuoda tai luoda virheen vuoksi (mutta komentokohtaiset palautuskoodit eivät ole käytössä)