L'ETS peut être démarré en ligne de commande avec des arguments supplémentaires. En utilisant ces arguments, l'utilisateur peut spécifier les actions qui seront exécutées au démarrage de l'ETS.
Actions prises en charge
Les actions suivantes sont prises en charge :
Les paramètres de la ligne de commande sont sensibles à la casse!
- Ouvrir un projet
- Création d'un projet
- Supprimer un projet
- Vérifier un projet
- Importer un projet
- Installer une ETS App
- Ouvrir une application ETS
- Lancer le moniteur de groupe
- Lancer le moniteur de Bus
- Lancer l'assistant de création de projet
- Quitter ETS
- Aide
- version
Ouvrir un projet
--openProject "nom du projet"
ou
-o "nom du projet"
- Ouvre un projet existant dès le démarrage de l'ETS.
- Le "nom du projet" doit être le nom du projet actuel
- Si le projet nécessite un mot de passe, alors la boîte de dialogue 'Entrer le mot de passe' s'affiche.
- Il peut être combiné avec le paramètre --password pour ouvrir un projet protégé par un mot de passe. Si le mot de passe du projet est incorrect, alors la boîte de dialogue « Entrer le mot de passe » est affichée pour entrer le mot de passe correct.
Exemple
--openProject 'Mon projet Home' --password 'Password123@#'
ou
-o 'Mon projet Home' --password 'Password123@#'
Création d'un projet
--createProject "nom du projet" or -c "nom du projet"
- Crée un nouveau projet (même fonction que dans la boîte de dialogue de création d'un projet standard), avec les réglages par défaut suivants :
- Média de zone : IP
- Topologie : Créer la ligne 1.1 avec le type de média TP
- Style d'adresse du groupe : Trois niveaux
- Il peut être combiné avec le paramètre --password pour créer un projet protégé par un mot de passe.
Exemple :
--createProject "Mon projet Home" --password "Password123@#"
ou
-c "Mon projet Home" --password "Password123@#'
Supprimer un projet
--deleteProject "nom du projet" ou -d "nom du projet"
Supprime un projet existant depuis le Project Store. Les valeurs du code de retour indiquent ce qui suit :
- Suppression réussie: valeur de retour = 0
- Suppression échouée: valeur de retour = -2
Exemple
--deleteProject "Mon projet Home"
ou
-d "Mon projet Home"
Vérifier si un projet existe
--existsProject "nom du projet" ou -e "nom du projet"
- Vérifie s'il y a un projet existant avec le nom spécifié dans la bibliothèque du projet.
- Les valeurs du code de retour indiquent ce qui suit :
- Les projets existent: valeur de retour = 1
- Le projet n'existe pas : valeur de retour = 0
- Une fois que cet ETS se termine automatiquement, c'est à dire qu'il n'est pas nécessaire d'ajouter l'argument --quit .
Exemple :
--existsProject "Mon projet Home"
ou
-e "Mon projet Home"
Importer un projet
--importProject "chemin vers le fichier projet" or -i "chemin vers le fichier projet"
- Importe un fichier de projet spécifique (soit au format "knxproj" ou "pr") dans la bibliothèque de projets.
- Importation d'un projet protégé par un mot de passe, puis la boîte de dialogue 'Entrer le mot de passe' est affichée pour être saisi manuellement.
Exemple :
--importProject "C:\MyProjects\MyHomeproject.knxproj"
ou
-i "C:\MyProjects\MyHomeproject.knxproj"
Installer une ETS App
--installApp "chemin d'accès vers le fichier de l'application" ou -un "chemin vers le fichier de l'application"
- Installe une ETS App représentée par le fichier spécifié*.etsapp.
Exemple :
--installApp "C:\MyProjects\MyApp.etsapp"
ou
-a "C:\MyProjects\MyApp.etsapp"
Ouvrir une application ETS
--openApp "AppId"
- Ouvre une application ETS avec un identifiant spécifique d'application dans un projet et nécessite donc également qu'un projet existant soit spécifié via la commande --openProject.
- L'espace de travail précédent du projet sera supprimé et un nouvel espace de travail sera créé qui ne contiendra qu'une seule fenêtre, et le panneau : le panneau contiendra l'application demandée.
- Les valeurs du code de retour indiquent ce qui suit :
- "40" lorsque l'AppId n'est pas défini
- "41" lorsque l'AppId donné est invalide
- "42" quand aucune application ETS avec l'AppId donné ne peut être trouvée
- "43" lorsque l'application ETS demandée nécessite un mode natif, mais ETS fonctionne en mode de compatibilité
- "44" lorsque l'application ETS demandée nécessite un mode de compatibilité, mais ETS fonctionne en mode natif
- "45" lorsque l'application ETS demandée ne peut pas être démarrée
- "46" lorsque l'application ETS demandée n'est pas sous licence
Exemple :
--openProject "nom du projet" --OpenApp "M00FA-A0005"
Lancer le moniteur de groupe
--groupmon "nom du projet" ou -g "nom du projet"
-
Cette commande démarre le Group Monitor dans un projet donné.
Exemple :
--groupmon "Mon projet Home"
ou
-g "Mon projet Home"
Lancer le moniteur de Bus
--busmon "nom du projet" ou -b "nom du projet"
-
Cette commande démarre le Bus Monitor dans un projet donné.
Exemple
--busmon "My Home Project"
ou
-b "My Home Project"
Lancer l'assistant de création de projet
--wizard ou -w
-
Cette commande démarre l'assistant de création de projet.
Quitter ETS
--quit ou -q
- Referme ETS après l'exécution de tous les arguments de ligne de commande.
- L'ETS ne se fermera cependant pas malgré l'argument --quit si au moins l'un des autres arguments de la ligne de commande a causé une erreur qui a conduit à des dialogues de messages d'erreur/avertissement d'ETS .
Aide
--help
-
Cette commande affiche l'aide dans la console.
version
--version
-
Cette commande affiche la version ETS actuelle dans la console.
Combinaison des arguments de ligne de commande
Les seules combinaisons possibles d'arguments en ligne de commande sont
- --openProject et --importProject
- --password peut être combiné avec --openProject et --createProject
- --quit peut être utilisé avec un autre paramètre
- --openApp requiert toujours --openProject (et un --mot de passe si nécessaire)
Une fois le processus ETS6 démarré, les seules commandes acceptées sont : --createProject, --wizard et -importProject : elles sont nécessaires pour les commandes de la barre des tâches ETS Windows.
OpenProject utilisera la dernière fenêtre active ETS6 et ouvrira - si nécessaire - un nouvel onglet du tableau de bord. Toute autre commande qui est lancée après que ETS6 soit déjà démarrée, ne sera pas traitée, mais ne fera que mettre ETS6 en avant plan.
Gestion des erreurs
En cas d'erreurs ou de mauvaises commandes, ETS enregistrera les messages dans le journal ETS situé à %LOCALAPPDATA%\Knx\ETS6\Log\ETS6.log
Codes de retour
Pour certains arguments en ligne de commande (par exemple --existsProject), ETS retourne un code de sortie. Les codes de sortie ne sont pas affichés dans la console mais la variable 'errorlevel' reçoit la valeur du code de sortie.
Pour évaluer le code de sortie, un script batch peut utiliser la constructionIF ERRORLEVELou utiliser l'expansion de variable comme dansecho %errorlevel%. Quand ETS est appelé directement depuis la ligne de commande (et non depuis un .bat ou . md script), puis il doit être appelé aveccmd /c ETS6. xe ...oudémarrer /wait ETS6.exe ...
Codes de retour communs
Les codes de retour courants sont des codes de retour qui peuvent être définis sur n'importe quelle commande :
- -1 si la syntaxe/options du paramètre n'est pas correcte
- -2 si l'opération a échoué, p. ex. le projet n'a pas pu être ouvert, supprimé, importé ou créé à cause d'une erreur (mais les codes de retour spécifiques à la commande ne s'appliquent pas)