Come Usare Alias e Script dell'Assistente

I nomi ETS sono spesso criptici - LI_EG_KÜ_Decke_1 - e alcune richieste si fanno ogni giorno. Alias insegna all'assistente SharKNX le tue parole per indirizzi e richieste e gli Script salvano sequenze di comandi che puoi eseguire per nome.

Tipi di alias

Una frase passa attraverso l'assistente come qualsiasi altra richiesta, con gli stessi chiarimenti e conferme. La scrittura a un gruppo richiede sempre una forte conferma, perché scrive a più indirizzi contemporaneamente.

Crea un alias nell'app

1. Caricare il progetto ETS a cui è destinato l'alias - vedere Come Caricare un Progetto ETS.
2. Nell'assistente, apri ☰ → Impostazioni → Crea.
3. Inserisci Nome: le parole che utilizzerai nella chat.
4. Scegli Tipo:
   • Frase - inserisci la richiesta Esegue, ad es. turn off all kitchen lights.
   • Indirizzo: tocca Scegli indirizzo e scegli un indirizzo di gruppo dal progetto.
   • Gruppo: tocca Scegli indirizzi e scegline diversi. Devono avere tutti lo stesso tipo di punto dati, perché un gruppo scrive un valore su tutti.
5. Tocca Salva.

Usalo subito: per un gruppo denominato Floor one temperature, set Floor one temperature to 22 scrive 22 su ogni indirizzo in esso contenuto, dopo aver confermato.

Un nome non può essere utilizzato due volte. Se corrisponde a un nome nel tuo progetto ETS, l'assistente ti chiede quale intendi: un alias importato può avere la precedenza su override: true.

Importa alias e script da un file

Un file YAML contiene più alias e script contemporaneamente: utile per un progetto di grandi dimensioni, per stanze e script o da condividere con i colleghi.

1. Ottieni un file iniziale: nell'assistente, apri ☰ → Aiuto → Alias e script e tocca Scarica il modello. Contiene un esempio di tutto, con ogni campo spiegato.
2. Modificalo: sostituisci i nomi e gli indirizzi di esempio con i tuoi ed elimina ciò che non ti serve. Ogni campo è descritto in Formato File di Alias e Script.
3. Carica il progetto ETS a cui servono gli alias. Un file con alias non può essere importato senza uno; un file di soli script può.
4. Apri ☰ → Impostazioni → Importa e tocca Importa un file YAML.
5. Controlla il rapporto Rivedi importazione:
   • Dice a quale progetto saranno legati gli alias.
   • Da correggere prima di importare: elenca gli errori, con la riga ove possibile. Correggi il file e importalo di nuovo.
   • Da sapere: elenca gli avvisi, ad esempio un indirizzo che non è presente nel progetto caricato. Puoi ancora importare.
   • Non presenti in questo file elenca gli alias che hai ora e che il file non contiene. Attiva Mantienili per aggiungerli agli alias importati; altrimenti vengono rimossi.
6. Tocca Importa.

L'importazione di alias sostituisce il set di alias del progetto. Gli script vengono aggiunti ai tuoi script; uno script con lo stesso nome di uno esistente lo sostituisce. Importare nuovamente lo stesso file non cambia nulla.

I file importati sono elencati in Cronologia con i relativi alias e conteggi di script: toccane uno per importarlo nuovamente, ad esempio dopo aver cambiato progetto.

Esegui uno script

Digita sharknx e il nome dello script, ad esempio sharknx secure house - o sharknx run secure house. Lo script viene eseguito come un piano: SharKNX mostra i suoi passaggi e chiede conferma dove un passaggio lo richiede. Aggiungi -y per saltare le conferme ordinarie; i passaggi che necessitano di una forte conferma vengono comunque confermati, insieme, prima dell'avvio dello script.

Le righe di script sono comandi esatti con indirizzi letterali: vedere Comandi dell'Assistente.

Gestisci alias e script

Apri ☰ → Impostazioni → Gestisci. (La scheda nella parte superiore di Impostazioni assistente mostra già quanti alias e script sono attivi e da quale file provengono.)

Scheda Alias - alias del progetto caricato:

• L'Commuta attiva o disattiva un alias senza eliminarlo. Un alias disattivato nel file stesso mostra Disabilitato nel file.
• Modifica, Duplica e Elimina cambiano un alias. Le stanze possono essere modificate solo nel file.
• Elimina set rimuove ogni alias del progetto caricato. Puoi importare nuovamente il file dalla Cronologia.
• Riesporta salva gli alias del progetto, inclusi quelli creati nell'app, come file YAML.

Scheda Script - ogni script, con le sue righe di comando:

• L'Commuta attiva o disattiva uno script.
• Elimina script rimuove uno script; il pulsante accanto al nome di un file rimuove tutti gli script da quel file.

Gli alias creati nell'app vengono aggiunti al file alias del progetto. Se un file importato non può apportare modifiche senza essere riformattato, SharKNX ti chiede di apportare la modifica al file e di importarlo nuovamente.

Risoluzione dei problemi