Los nombres ETS suelen ser crípticos (LI_EG_KÜ_Decke_1) y algunas solicitudes se realizan todos los días. Alias le enseña al asistente SharKNX sus propias palabras para direcciones y solicitudes, y Scripts guarda secuencias de comandos que puede ejecutar por nombre.
| Alias | Guiones | |
|---|---|---|
| Qué | Sus propios nombres para direcciones de grupo, grupos de direcciones y solicitudes | Secuencias con nombre de comandos exactos |
| Usado en | Mensajes en inglés sencillo: turn off exterior lights | Comandos exactos: sharknx secure house |
| Pertenece a | Un proyecto ETS: activo solo mientras está cargado | Sin proyecto - siempre activo |
| Creado | En la aplicación, o importando un archivo YAML | Importando un archivo YAML |
tipos de alias
| Amable | Da | Ejemplo |
|---|---|---|
| Frase | Un atajo para una solicitud más larga | good night ejecuta turn all kitchen lights off |
| Dirección | Un nombre para una dirección de grupo | reading lamp para 1/2/3 - turn on the reading lamp |
| Grupo | Un nombre para varias direcciones de grupo | exterior lights para cada luz exterior - turn off exterior lights las enciende todas |
| Habitación | Una habitación propia, con cada dirección escrita como luz, persiana, temperatura, etc. | set home office temperature to 21 cambia solo las direcciones de temperatura de esa habitación. Las habitaciones solo se pueden importar desde un archivo; consulta Formato de archivo de alias y scripts. |
Una frase pasa por el asistente como cualquier otra petición, con la misma aclaración y confirmación. Escribir a un grupo siempre necesita una confirmación sólida, porque escribe a varias direcciones a la vez.
Crea un alias en la aplicación
- Carga el proyecto ETS para el que es el alias; consulta Cómo cargar un proyecto ETS.
- En el asistente, abre ☰ → Ajustes → Crear.
- Ingresa un Nombre: las palabras que usarás en el chat.
- Elige el Tipo:
- Frase: introduce la solicitud que Se ejecuta, p. turn off all kitchen lights.
- Dirección: toca Elegir dirección y elige una dirección de grupo del proyecto.
- Grupo: toca Elegir direcciones y elige varios. Todos deben tener el mismo tipo de punto de datos, porque un grupo les escribe un valor a todos.
- Pulsa Guardar.
Úselo de inmediato: para un grupo llamado Floor one temperature, set Floor one temperature to 22 escribe 22 en cada dirección que contiene, después de confirmar.
Un nombre no se puede utilizar dos veces. Si coincide con un nombre en tu proyecto ETS, el asistente le preguntará a cuál se refiere: un alias importado puede tener prioridad con
override: true.
Importar alias y scripts desde un archivo
Un archivo YAML contiene muchos alias y scripts a la vez, lo que resulta útil para un proyecto grande, para salas y scripts, o para compartir con colegas.
- Obtén un archivo inicial: en el asistente, abre ☰ → Ayuda → Alias y scripts y toca Descargar plantilla. Contiene un ejemplo de todo, con cada campo explicado.
- Edítelo: reemplace los nombres y direcciones de muestra con los suyos propios y elimine lo que no necesite. Cada campo se describe en Formato de archivo de alias y scripts.
- Carga el proyecto ETS para el que son los alias. Un archivo con alias no se puede importar sin uno; un archivo de solo scripts puede hacerlo.
- Abre ☰ → Ajustes → Importar y toca Importar un archivo YAML.
- Consulta el informe Revisar importación:
- Dice a qué proyecto se vincularán los alias.
- Corrige esto antes de importar: enumera los errores, con la línea donde sea posible. Arregle el archivo e impórtelo nuevamente.
- Ten en cuenta: enumera advertencias, por ejemplo, una dirección que no está en el proyecto cargado. Aún puedes importar.
- No están en este archivo enumera los alias que tiene ahora y que el archivo no contiene. Activa Conservarlos para agregarlos a los alias importados; de lo contrario se eliminan.
- Pulsa Importar.
La importación de alias reemplaza el conjunto de alias del proyecto. Los scripts se agregan a sus scripts; un script con el mismo nombre que uno existente lo reemplaza. Importar el mismo archivo nuevamente no cambia nada.
Los archivos importados se enumeran en Historial con su alias y número de scripts; toca uno para importarlo nuevamente, por ejemplo, después de cambiar de proyecto.
Ejecutar un script
Escribe sharknx y el nombre del script, por ejemplo sharknx secure house - o sharknx run secure house. El script se ejecuta como un plan: SharKNX muestra sus pasos y solicita confirmación cuando un paso lo necesita. Añade -y para omitir las confirmaciones ordinarias; Los pasos que necesitan una fuerte confirmación aún se confirman, juntos, antes de que comience el guión.
Las líneas de script son comandos exactos con direcciones literales; consulta Comandos del asistente.
Administrar alias y scripts
Abre ☰ → Ajustes → Gestionar. (La tarjeta en la parte superior de Ajustes del asistente ya muestra cuántos alias y scripts están activos y de qué archivo provienen).
Pestaña Alias: alias del proyecto cargado:
- El Conmutar activa o desactiva un alias sin eliminarlo. Un alias desactivado en el propio archivo muestra Desactivado en el archivo.
- Editar, Duplicar y Borrar cambian un alias. Las habitaciones sólo se pueden cambiar en el archivo.
- Eliminar conjunto elimina todos los alias del proyecto cargado. Puedes volver a importar el archivo desde Historial.
- Reexportar guarda los alias del proyecto, incluidos los que creó en la aplicación, como un archivo YAML.
Pestaña Scripts: cada script, con sus líneas de comando:
- El Conmutar activa o desactiva un script.
- Eliminar script elimina un script; el botón al lado del nombre de un archivo elimina todos los scripts de ese archivo.
Los alias que crea en la aplicación se agregan al archivo de alias del proyecto. Si un archivo importado no puede aceptar cambios sin reformatearlo, SharKNX le solicita que realice el cambio en el archivo y lo importa nuevamente.
Solución de problemas
| Problema | Que comprobar |
|---|---|
| Crear dice Debe cargarse un proyecto ETS | Los alias pertenecen a un proyecto; cárguelo primero. |
| Los alias no funcionan | Están activos sólo mientras tu proyecto está cargado. La tarjeta de Configuración dice a qué proyecto pertenecen. |
| This project's alias file could not be read | Importa el archivo nuevamente. |
| These addresses don't share one DPT type | Un grupo escribe un valor en todas sus direcciones: elige direcciones de un tipo de punto de datos. |
| Un nombre de alias también coincide con el nombre de un proyecto. | El asistente pregunta a qué te refieres. En un archivo, configura override: true para que el alias gane. |
| Se rechaza un nombre de script | Los nombres de los scripts no pueden ser los mismos que los de un comando integrado como connect o scan. |
