Listes de commutation externes - Processus de commutation via des fichiers externes
Sommaire
Les HS/FS permettent désormais de lire des fichiers se trouvant sur un serveur accessible via le LAN/internet.
Ces fichiers textes comprennent des enregistrements de données (appelés 'points de commutation') constitués de l'adresse de groupe, de la date et de l'heure ainsi que de la valeur. Le HS/FS peut appeler ces fichiers par le biais d'un protocole FTP ou HTTP.
Une fois les fichiers transférés, HS/FS règle les variables, avec les adresses de groupe saisies, à la valeur à la date et à l'heure réglées. Grâce à sa structure simple, cette interface de fichier convient de manière idéale pour connecter des programmes de gestion extérieurs (p. ex. de gestion des horaires) à la technique des systèmes domotiques. Une utilisation corrélée avec une gestion centrale d'immeubles est également imaginable, en utilisant cette interface et un serveur de fichiers commun. Les fichiers de cette source à points de commutation sont consultés via une instruction de manière cyclique et/ou manuelle.

1.Consultation de fichier

Les fichiers suivants sont consultés à chaque opération :
  • Un fichier annuel
  • Un fichier mensuel
  • n fichiers journaliers (en fonction de la valeur Jours max.) (valeur max. : 7 jours).
Tous les points de commutation situés des fichiers sont lus, traités et mémorisés de manière permanente dans le HS/FS. Pourtant, seuls les points de commutation futurs seront utilisés. La constante Points de commutation max. limite ici le nombre à traiter par fichier (valeur max. : 1000 lignes).
Remarque
L'appel et le traitement concernent toujours tous les fichiers de la contrepartie.

2.Nom de fichier

Le HS/FS attend des noms de fichiers ayant la structure suivante :
  • Fichier annuel : préfixeAAAASuffixe (exemple : schaltpunkt2007.dat pour l'année 2007)
  • Fichier mensuel : préfixeAAAAMMSuffixe (exemple : point_de_commutation200706.dat pour juin 2007)
  • Fichier journalier : préfixeAAAAMMJJSuffixe (exemple : point de commutation20070615.dat pour le 15 juin 2007)
AAAA : le millésime a toujours 4 chiffres
MM : le jour du mois a toujours 2 chiffres
JJ : la date du jour a toujours 2 chiffres
Le préfixe et le suffixe sont expliqués dans une section ultérieure.

3.Structure de fichier

Tous les types de fichiers (année/mois/jour) ont la même structure de fichier.
Une ligne est définie comme suit :

DATE_HEURE|CLE|VALEUR

Le caractère '|' sert de séparateur entre les différents champs Remarque : ce caractère correspond à la combinaison de touches (actionnement simultané) [Alt Gr] + [<].
La date doit être au format AAAAMMJJ et compter huit chiffres. L'heure, séparée de la date par un tiret bas, doit avoir quatre chiffres et être au format hhmm. Utilisez comme clé l'adresse de groupe de l'objet de communication souhaité. La notation à 2 ou 3 positions de l'adresse de groupe doit être identique à celle définie dans les réglages de l'Expert HS/FS. La valeur souhaitée est saisie dans 'Valeur'. Il peut s'agir d'une valeur numérique ou alphanumérique. Le séparateur décimal destiné aux valeurs en virgule flottante est le point.
Remarque :AAAA = année, MM = mois, JJ = jour, hh = heure, mm = minute

Exemple :
20061001_1230|100/1|1
20061001_1245|100/1|0

Le fichier contient deux points de commutation. Le premier est le 1.10.2006 à 12:30 heures, moment où l'objet de communication (interne) est défini à la valeur 1, avec l'adresse de groupe 100/1. Le deuxième point de commutation est le 01.10.2006 à 12:45 heures, moment où le même objet de communication est réglé sur 0.

4.Commentaires

Afin d'éviter qu'une ligne puisse être identifiée en tant que ligne de données, elle est ignorée par l'Expert sans que cela ne donne lieu à une erreur. Il est donc possible d'insérer autant des lignes vides que des lignes de texte sans aucun problème. Mais il est interdit d'insérer un texte APRES une ligne de données valide.

5.Exemple de nouvelle liste de commutation externe

Exemples de données (date d'appel 01.10.2006 12:00 h) :
Jours max. : 2
Points de commutation max. : 100
Préfixe : mesdonnées/pointcommutation
Suffixe : '.dat'

Dans cet exemple, les fichiers
- mesdonnées/pointcommutation2006.dat,
- mesdonnées/pointcommutation200610.dat,
- mesdonnées/pointcommutation20061001.dat et
- mesdonnées/point commutation20061002.dat
sont appelées depuis le serveur. Les cent points de commutation suivants (à partir du 01.10.2006 à 12:00 h) sont extraits de ces fichiers pour être traités.

6.Données

Désignation

Désignation des points de commutation extérieurs.

Cycle d'appel (en min)

Les fichiers sont appelés par le serveur selon ce cycle. La valeur minimum du cycle est une minute.

Jours max.

Définit le nombre maximum de jours que le serveur appelle et traite. La valeur minimum est un jour.

Points de commutation max.

Définit le nombre maximum de points de commutation qui doivent être traités et mémorisés. Pour un appel, seuls comptent les points de commutation futurs. Si les fichiers appelés contiennent plus de points de commutation, les points de commutation excédentaires sont ignorés. La valeur minimum est un point de commutation.

Etat (en option)

Ecrit l'état d'un appel dans l'objet de communication numérique indiqué ici ::
  • 1 => Les données ont été appelées avec succès.
  • 2 => L'appel des données n'a pas réussi. Ceci peut être dû au fait qu'aucune connexion au serveur n'a pu être établie ou à une structure de fichier invalide.
L'indication d'un objet de communication est une option.

Consultation manuelle >(en option)

Si l'objet de communication indiqué ici envoie un 1, la consultation des points de commutation est lancée manuellement. L'indication d'un objet de communication est une option.

Accès autorisé aux objets de communication suivants

Seuls les objets de communication indiqués ici peuvent être modifiés par les points de commutation. Les adresses de groupes manquant dans cette liste sont ignorées. L'adresse de groupe fait office de clé.
Attention
Si des objets de communication internes doivent être modifiés, ceux-ci doivent disposer d'une adresse de groupe.

7.Serveur

Type d'accès

Définit le protocole de consultation :
  • FTP (actif) => appelle les données d'un serveur FTP (en mode actif).
  • FTP (passif) => appelle les données d'un serveur FTP (en mode passif).
  • HTTP => appelle les données d'un serveur HTTP.

Hôte/Port IP

L'adresse et le port IP de la contrepartie, d'où les données sont appelées.
Remarque
Le port habituel est 21 pour les interrogations FTP, 22 pour les interrogations SFTP.

Nom d'utilisateur (en option)

Si l'accès aux fichiers est protégé par un mot de passe, il est nécessaire d'entrer ici le nom d'utilisateur correspondant.

Mot de passe (en option)

Si l'accès aux fichiers est protégé par un mot de passe, il est nécessaire d'entrer ici le mot de passe correspondant.

Chemin avec préfixe

Définit le chemin d'accès au fichier avec le préfixe de fichier. Exemple : Pour le fichier 'mesdonnées/point de commutation2006.dat', le préfixe serait 'mesdonnées/point de commutation'.
Remarque
Il est préférable de ne pas utiliser de caractères spéciaux ni de points dans le préfixe !

Suffixe

Définit la partie terminale (suffixe) du nom du fichier.
En règle générale, il s'agit de '.dat' ou de '.txt'. Mais vous pouvez aussi utiliser tout autre suffixe. Si vous désirez utiliser un fichier sans suffixe, entrez uniquement un point ('.') comme suffixe, dans l'Expert.
Remarque
Il n'est pas recommandé d'utiliser de caractères spéciaux ni de points dans le suffixe, sauf comme premier caractère !

8.Quelques exemples

Selon le type de serveur sur lequel les listes sont déposées, il peut être nécessaire de veiller à la casse.
Chemin avec préfixeType de fichierSuffixeNom de fichierCommentaire
ExtList/testAnnée.dattest2016.datLe fichier se trouve dans le sous-dossier 'ExtList'
heatingJour.txtheating20160916.txt
MyCompanyMois.MyCompany201609Lorsqu'un '.' a été saisi comme suffixe dans l'Expert, le fichier n'a pas d'extension !
ExtList/special/lightsJourmycompanylights20161027mycompanyLe fichier se trouve dans le sous-répertoire 'ExtList/special'. Bien qu'il présente un suffixe, il n'a AUCUNE extension de fichier !