ETS se puede iniciar con argumentos de líneas de comando adicionales. Usando estos argumentos, el usuario puede especificar acciones que se ejecutarán cuando ETS se inicie.
Acciones soportadas
Se pueden ejecutar las siguientes acciones:
¡Los parámetros de la línea de comandos son sensibles a mayúsculas y minúsculas!
- Abrir un proyecto
- Crear un proyecto
- Eliminar un proyecto
- Comprobar un proyecto
- Importar un proyecto
- Instalar una ETS App
- Abrir una ETS App
- Iniciar el Monitor de Grupos
- Iniciar el Monitor del Bus
- Iniciar el asistente de creación de proyectos
- Cerrar ETS
- Ayuda
- versión
Abrir un proyecto
--openProject "nombre del proyecto"
or
-o "nombre del proyecto"
- Abre un proyecto existente justo después de que arranque el ETS.
- El 'nombre del proyecto' debe ser el nombre actual del proyecto
- Si el proyecto requiere una contraseña, entonces se mostrará el 'diálogo para Introducir contraseña'.
- Se puede combinar con el parámetro --password para abrir un proyecto protegido por contraseña. Si la contraseña del proyecto es incorrecta, se mostrará el 'diálogo para Introducir contraseña' para permitir introducir la contraseña correcta.
Ejemplo
--openProject "Mi Hogar" --password "Contraseña123@#"
o
-o "Mi Hogar" --password "Contraseña123@#"
Crear un proyecto
--createProject "nombre del proyecto"
o
-c "nombre del proyecto"
- Crea un proyecto nuevo (misma función que el diálogo estándar de creación de proyectos), con la siguiente configuración por defecto:
- Medio del Backbone: IP
- Topología: Crea la Línea 1.1 con tipo de medio TP
- Estilo de Dirección de Grupo: Tres niveles
- Se puede combinar con el parámetro --password para crear un proyecto protegido por contraseña.
Ejemplo:
--createProject "Mi Hogar" --password "Contraseña123@#"
o
-c "Mi Hogar" --password "Contraseña123@#"
Eliminar un proyecto
--deleteProject "nombre del proyecto"
o
-d "nombre del proyecto"
Elimina un proyecto existente del Almacén de Proyectos. Los valores del código de salida indican lo siguiente:
- Eliminado con éxito: valor devuelto = 0
- Eliminación fallida: valor devuelto = -2
Ejemplo
--deleteProject "Mi Hogar"
o
-d "Mi Hogar"
Comprobar si existe un proyecto
--existsProject "nombre del proyecto"
o
-e "nombre del proyecto"
- Comprueba si existe un proyecto con el nombre especificado en el Almacén de Proyectos.
- Los valores del código de salida indican lo siguiente:
- Proyecto existente: valor mostrado = 1
- Proyecto no existente: valor mostrado = 0
- Después de que este ETS se cierre automáticamente, es decir, no hay necesidad de añadir el argumento --quit .
Ejemplo:
--existsProject "Mi Hogar"
o
-e "Mi Hogar"
Importar un proyecto
--importProject "ruta al archivo del proyecto"
o
-i "ruta al archivo del proyecto"
- Importa un archivo de proyecto específico (ya sea en formato "knxproj" o "pr") en el Almacén de Proyectos.
- Al importar un proyecto protegido por contraseña, entonces se muestra el 'Diálogo Insertar contraseña' para ser introducida manualmente.
Ejemplo:
--importProject "C:\MyProjects\MyHomeproject.knxproj"
o
-i "C:\MyProjects\MyHomeproject.knxproj"
Instalar una ETS App
--installApp "ruta de archivo al archivo App"
o
-a "ruta de archivo al archivo App"
- Instala una App ETS representada por el archivo *.etsapp especificado.
Ejemplo:
--installApp "C:\MyProjects\MyApp.etsapp"
o
-a "C:\MyProjects\MyApp.etsapp"
Abrir una ETS App
--openApp "AppId"
- Abre una App ETS con un Identificador de App específico dentro de un proyecto y por lo tanto también requiere que se especifique un proyecto existente mediante el comando --openProject.
- El entorno de trabajo anterior será descartado y se creará un nuevo entorno de trabajo que sólo contiene una ventana, una pestaña y un panel y el panel contendrá la App solicitada.
- Los valores del código de salida indican lo siguiente:
- "40" cuando el AppId no está establecido
- "41" cuando el AppId dado no es válido
- "42" cuando no se puede encontrar ninguna App ETS con el AppId indicado
- "43" cuando la App ETS solicitada requiere modo nativo, pero ETS se está ejecutando en modo de compatibilidad
- "44" cuando la App ETS solicitada requiere el modo de compatibilidad, pero ETS se está ejecutando en modo nativo
- "45" cuando la App ETS solicitada no se puede iniciar
- "46" cuando la App ETS solicitada no tiene licencia
Ejemplo:
--openProject "nombre del proyecto" --OpenApp "M00FA-A0005"
Iniciar el Monitor de Grupos
--groupmon "nombre del proyecto"
o
-g "nombre del proyecto"
-
Este comando inicia el Monitor de Grupos en un proyecto determinado.
Ejemplo:
--groupmon "Mi Hogar"
o
-g "Mi Hogar"
Iniciar el Monitor del Bus
--busmon "nombre del proyecto"
o
-b "nombre del proyecto"
-
Este comando inicia el Monitor del Bus en un proyecto determinado.
Ejemplo
--busmon "Mi Hogar"
o
-b "Mi Hogar"
Iniciar el asistente de creación de proyectos
--wizard
o
-w
-
Este comando inicia el asistente de creación de proyectos.
Cerrar ETS
--quit o -q
- Cierra ETS después de haber ejecutado el resto de instrucciones de la línea de comandos.
- Sin embargo, ETS no se cerrará a pesar del argumento --quit si al menos uno de los otros argumentos de línea de comandos ha causado un error que de como resultado diálogos de error/mensajes de advertencia de ETS.
Ayuda
--help
-
Este comando muestra la ayuda en la consola.
versión
--version
-
Este comando muestra la versión actual de ETS en la consola.
Combinación de Argumentos de Líneas de Comando
Las únicas combinaciones posibles de los argumentos de línea de comandos son
- --openProject e --import Project
- --password puede combinarse con --openProject y con --createProject
- --quit puede ser usado junto con otro parámetro
- --openApp siempre requiere --openProject (y una --password si es necesario)
Una vez iniciado el proceso de ETS6, los únicos comandos aceptados son: --createProject, --wizard e -importProject - que son necesarios para los comandos de la barra de tareas de ETS en Windows.
OpenProject usará la última ventana de ETS6 activa y abrirá - si es necesario - una nueva pestaña del panel de control. Cualquier otro comando que se ejecute después de que ETS6 ya esté iniciado, no será procesado, sino que solo pondrá ETS6 al frente.
Manejo de errores
En caso de errores o comandos incorrectos, ETS registrará los mensajes en el registro de ETS ubicado en %LOCALAPPDATA%\Knx\ETS6\Log\ETS6.log
Códigos de Retorno
Para algunos argumentos de línea de comandos (por ejemplo, --existsProject), ETS devuelve un código de retorno. Los códigos de retorno no se imprimen en la consola, pero la variable 'errorlevel' recibe el valor del código de retorno.
Para evaluar el código de retorno, un script por lotes puede usar la construcción IF ERRORLEVEL o usar expansión de variables como en echo %errorlevel% . Cuando ETS es invocado directamente desde la línea de comandos (y no desde un script .bat o .cmd), entonces tiene que ser invocado con cmd /c ETS6.exe ... o start /wait ETS6.exe ...
Códigos de retorno comunes
Los códigos de retorno comunes son códigos de retorno que se pueden establecer en cualquier comando:
- -1 si la sintaxis del parámetro/opciones no son correctas
- -2 si la operación ha fallado, por ejemplo no se ha podido abrir, eliminar, importar o crear el proyecto debido a un error (pero los códigos de retorno específicos del comando no aplican)