Comment utiliser les alias et scripts de l'assistant

Les noms ETS sont souvent énigmatiques - LI_EG_KÜ_Decke_1 - et certaines demandes que vous faites chaque jour. Alias apprend à l'assistant SharKNX vos propres mots pour les adresses et les requêtes, et les Scripts enregistrent les séquences de commandes que vous pouvez exécuter par leur nom.

Types d'alias

Une phrase passe par l'assistant comme toute autre demande, avec la même précision et confirmation. Écrire à un groupe nécessite toujours une forte confirmation, car il écrit à plusieurs adresses à la fois.

Créer un alias dans l'application

1. Chargez le projet ETS auquel l'alias est destiné - voir Comment charger un projet ETS.
2. Dans l'assistant, ouvrez ☰ → Réglages → Créer.
3. Entrez un Nom - les mots que vous utiliserez dans le chat.
4. Choisissez le Type :
   • Phrase - saisissez la requête qu'il exécute, par ex. turn off all kitchen lights.
   • Adresse - appuyez sur Choisir l'adresse et choisissez une adresse de groupe dans le projet.
   • Groupe - appuyez sur Choisir les adresses et choisissez-en plusieurs. Ils doivent tous avoir le même type de point de données, car un groupe leur écrit tous une valeur.
5. Appuyez sur Enregistrer.

Utilisez-le immédiatement : pour un groupe nommé Floor one temperature, set Floor one temperature to 22 écrit 22 à chaque adresse qu'il contient, après confirmation.

Un nom ne peut pas être utilisé deux fois. S'il correspond à un nom dans votre projet ETS, l'assistant vous demande de quel nom vous parlez - un alias importé peut être prioritaire avec override: true.

Importer des alias et des scripts à partir d'un fichier

Un fichier YAML contient plusieurs alias et scripts à la fois - pratique pour un grand projet, pour les salles et les scripts, ou pour partager avec des collègues.

1. Obtenez un fichier de démarrage : dans l'assistant, ouvrez ☰ → Aide → Alias et scripts et appuyez sur Télécharger le modèle. Il contient un exemple de tout, avec chaque champ expliqué.
2. Modifiez-le : remplacez les exemples de noms et d'adresses par les vôtres et supprimez ce dont vous n'avez pas besoin. Chaque champ est décrit dans Format de fichier des alias et scripts.
3. Chargez le projet ETS auquel les alias sont destinés. Un fichier avec des alias ne peut pas être importé sans un ; un fichier de scripts uniquement le peut.
4. Ouvrez ☰ → Réglages → Importer et appuyez sur Importer un fichier YAML.
5. Consultez le rapport Vérifier l'import :
   • Il indique à quel projet les alias seront liés.
   • À corriger avant l'import : répertorie les erreurs, avec la ligne si possible. Corrigez le fichier et importez-le à nouveau.
   • À noter : répertorie les avertissements, par exemple une adresse qui ne figure pas dans le projet chargé. Vous pouvez toujours importer.
   • Absents de ce fichier répertorie les alias que vous possédez actuellement et que le fichier ne contient pas. Activez Les conserver pour les ajouter aux alias importés ; sinon, ils sont supprimés.
6. Appuyez sur Importer.

L'importation d'alias remplace le jeu d'alias du projet. Les scripts sont ajoutés à vos scripts ; un script portant le même nom qu'un script existant le remplace. Importer à nouveau le même fichier ne change rien.

Les fichiers importés sont répertoriés sous Historique avec leur nombre d'alias et de scripts - appuyez sur un pour l'importer à nouveau, par exemple après avoir changé de projet.

Exécuter un script

Tapez sharknx et le nom du script, par exemple sharknx secure house - ou sharknx run secure house. Le script s'exécute comme un plan : SharKNX affiche ses étapes et demande une confirmation lorsqu'une étape en a besoin. Ajoutez -y pour ignorer les confirmations ordinaires ; les étapes qui nécessitent une confirmation forte sont toujours confirmées ensemble avant le démarrage du script.

Les lignes de script sont des commandes exactes avec des adresses littérales - voir Commandes de l'assistant.

Gérer les alias et les scripts

Ouvrez ☰ → Réglages → Gérer. (La carte en haut de Paramètres de l’assistant montre déjà combien d'alias et de scripts sont actifs et de quel fichier ils proviennent.)

Onglet Alias - les alias du projet chargé :

• Le Commuter active ou désactive un alias sans le supprimer. Un alias désactivé dans le fichier lui-même affiche Désactivé dans le fichier.
• Modifier, Dupliquer et Supprimer modifient un alias. Les pièces ne peuvent être modifiées que dans le fichier.
• Supprimer l'ensemble supprime tous les alias du projet chargé. Vous pouvez réimporter le fichier depuis l'historique.
• Réexporter enregistre les alias du projet, y compris ceux que vous avez créés dans l'application, sous forme de fichier YAML.

Onglet Scripts - chaque script, avec ses lignes de commande :

• Le Commuter active ou désactive un script.
• Supprimer le script supprime un script ; le bouton à côté d'un nom de fichier supprime tous les scripts de ce fichier.

Les alias que vous créez dans l'application sont ajoutés au fichier d'alias du projet. Si un fichier importé ne peut pas être modifié sans être reformaté, SharKNX vous demande d'apporter la modification au fichier et de l'importer à nouveau.

Dépannage