L'ETS può essere avviato con ulteriori argomenti nella riga di comando. Utilizzando questi argomenti, l'utente può specificare azioni che verranno eseguite all'avvio di ETS.
Azioni supportate
Le azioni supportate sono le seguenti:
I parametri della riga di comando sono sensibili all'uso di maiuscole e minuscole!
- Aprire un progetto
- Creazione di un progetto
- Cancellare un progetto
- Controllare un progetto
- Importare un progetto
- Installare un'app ETS
- Apri un'App ETS
- Avviare il Controllo in Linea
- Avviare il Controllo bus
- Avviare la procedura guidata per la creazione del progetto
- Chiudere ETS
- Guida
- versione
Aprire un progetto
--openProject "nome del progetto"
or
-o "nome del progetto"
- Apre un progetto esistente subito dopo l'avvio dell'ETS.
- Il nome "del progetto" è il nome effettivo del progetto
- Se il progetto richiede una password, viene visualizzata la finestra di dialogo «Inserisci password».
- Può essere combinato con il parametro --password per aprire un progetto protetto da password. Se la password del progetto non è corretta, viene visualizzata la finestra di dialogo 'Inserisci password' per inserire la password corretta.
Esempio
--openProject "My Home project" --password "Password123@#"
or
-o "My Home project" --password "Password123@#"
Creazione di un progetto
--createProject "nome del progetto project" o -c "nome del progetto"
- Crea un nuovo progetto (stessa funzione della finestra di dialogo di creazione del progetto standard), con le seguenti impostazioni predefinite:
- Supporto backbone: IP
- Topologia: Crea Linea 1.1 con TP di tipo rete
- Stile indirizzo del gruppo: Tre livelli
- Può essere combinato con il parametro --password per creare un progetto protetto da password.
Esempio:
--createProject "My Home project" --password "Password123@#"
or
-c "My Home project" --password "Password123@#"
Cancellare un progetto
--deleteProgetto "nome del progetto" o -d "nome del progetto"
Cancella un progetto esistente da Project Store. I valori dei codici di uscita indicano quanto segue:
- Eliminazione riuscita: valore restituito = 0
- Eliminazione non riuscita: valore restituito = -2
Esempio
--deleteProgetto "Il mio progetto Home"
o
-d "Il mio progetto Home"
Verifica se esiste un progetto
--existsProject "name of the project" or -e "name of the project"
- Controlla se c'è un progetto esistente con il nome specificato nel Project Store.
- I valori dei codici di uscita indicano quanto segue:
- Progetti esistenti: valore di ritorno = 1
- Il progetto non esiste: valore di ritorno = 0
- Dopo questo ETS si chiude automaticamente, cioè non c'è bisogno di aggiungere l'argomento --quit .
Esempio:
--existsProject "My Home project"
or
-e "Il mio progetto Home"
Importare un progetto
--importProject "percorso del file del progetto" o -i "percorso del file del progetto"
- Importa un file di progetto specifico (sia in formato "knxproj" che "pr") nel Project Store.
- Importando un progetto protetto da password, viene visualizzata la finestra di dialogo 'Inserisci password' per poterla inserire manualmente.
Esempio:
--importProject "C:\MyProjects\MyHomeproject.knxproj"
or
-i "C:\MyProjects\MyHomeproject.knxproj"
Installare un'app ETS
--installApp "percorso file del file App" o -un "percorso file del file App"
- Installa un'app ETS rappresentata dal file specifico *.etsapp.
Esempio:
--installApp "C:\MyProjects\MyApp.etsapp"
o
-a "C:\MyProjects\MyApp.etsapp"
Apri un'App ETS
--openApp "AppId"
- Apre un'App ETS con un identificatore specifico dell'App all'interno di un progetto e quindi richiede anche che un progetto esistente sia specificato tramite il comando --openProject.
- Lo spazio di lavoro del progetto precedente verrà scartato e verrà creato un nuovo spazio di lavoro che contiene solo una finestra, scheda e pannello e il pannello conterrà la App richiesta.
- I valori dei codici di uscita indicano quanto segue:
- "40" quando l'AppId non è impostato
- "41" quando l'AppId specificato non è valido
- "42" quando non è possibile trovare alcuna app ETS con l'AppId specificato
- "43" quando l'App ETS richiesta richiede la modalità nativa, ma ETS viene eseguito in modalità compatibilità
- "44" quando l'App ETS richiesta richiede la modalità compatibilità, ma ETS viene eseguito in modalità nativa
- "45" quando l'App ETS richiesta non può essere avviata
- "46" quando l'App ETS richiesta non è licenziata
Esempio:
--openProject "nome del progetto" --openApp "M00FA-A0005".
Avviare il Controllo in Linea
--groupmon "nome del progetto" o -g "nome del progetto"
-
Questo comando avvia il Controllo in linea in un dato progetto.
Esempio:
--groupmon "Il mio progetto Home"
o
-g "Il mio progetto Home"
Avviare il Controllo bus
--busmon "nome del progetto" o -b "nome del progetto"
-
Questo comando avvia il Controllo bus in un dato progetto.
Esempio
--busmon "Il mio progetto Home"
o
-b "Il mio progetto Home"
Avviare la procedura guidata per la creazione del progetto
--wizard o -w
-
Questo comando avvia la procedura guidata Creazione progetto.
Chiudere ETS
--quit o -q
- Chiude ETS dopo l'esecuzione di tutti gli altri argomenti della linea di comando.
- Tuttavia, ETS non si chiuderà nonostante l'argomento --quit se almeno uno degli altri argomenti della riga di comando ha causato un errore nella finestra di dialogo degli errori/messaggi di avvertimento ETS.
Guida
--help
-
Questo comando mostra l'aiuto nella console.
Versione
versione
-
Questo comando mostra la versione ETS corrente nella console.
Combinazione di Comando-Argomenti Linea
Le uniche combinazioni possibili di argomenti a riga di comando sono
- --openProject e --importProject
- --password può essere combinata con --openProject e --createProject
- --quit può essere usato insieme ad un altro parametro
- --openApp richiede sempre --openProject (e una --password se necessario)
Una volta avviato il processo ETS6, gli unici comandi accettati sono: --createProject, --wizard e -importProject - sono necessari per i comandi ETS della barra delle applicazioni Windows.
OpenProject userà l'ultima finestra ETS6 attiva e aprirà - se necessario - una nuova scheda nella dashboard. Qualsiasi altro comando lanciato dopo che ETS6 è già stato avviato, non verrà elaborato, ma porterà solo ETS6 nel frontend.
Gestione degli Errori
In caso di errori o cattivi comandi, ETS registrerà i messaggi nel registro ETS situato a %LOCALAPPDATA%\Knx\ETS6\Log\ETS6.log
Codici di ritorno
Per alcuni argomenti a riga di comando (ad esempio --existsProject), ETS restituisce un codice di uscita. I codici di uscita non vengono stampati sulla console ma la variabile 'errorlevel' riceve il valore del codice di uscita.
Per valutare il codice di uscita, uno script batch può usare il buildIF ERRORLEVELo usare l'espansione variabile come inecho %errorlevel%. Quando l'ETS viene invocato direttamente dalla riga di comando (e non da un .bat o . md script), poi deve essere invocato concmd /c ETS6. xe ...orstart /wait ETS6.exe ...
Codici comuni restituiti
I codici di ritorno comuni sono codici di ritorno che possono essere impostati su qualsiasi comando:
- -1 se la sintassi dei parametri/le opzioni non sono corrette
- -2 se il funzionamento non è riuscito, ad es. il progetto non può essere aperto, eliminato, importato o creato a causa di un errore (ma non si applicano i codici di ritorno specifici per i comandi)