Archive généralités
Sommaire
Le HS/FS peut enregistrer et archiver les valeurs d'objets de communication (internes et EIB).
L'enregistrement peut être exécuté de manière cyclique et sur instruction.
Toutes les données peuvent être appelées dans différents formats (csv, html, xml), ce qui en permet l'exploitation, p. ex. pour la représentation graphique ou dans un tableur.
Il existe aussi une page de menu qui présente les données directement sous la forme d'un diagramme.
Une archive peut être envoyée par courrier électronique, consultée via http, voire transférée via ftp.
Les informations peuvent être appelées à l'intérieur du réseau, par entrée en communication directe via RNIS ou internet.
Attention
Seules des valeurs numériques peuvent être enregistrées dans les archives !
Remarque
Les textes peuvent être enregistrés dans les archives de messages.

1.Archive

L'archive (plus précisément : l'archive de données) contient les états des objets de communication.
L'archivage peut être exécuté via une instruction. En outre, l'enregistrement des données peut être réalisé de manière cyclique.
Les questions à ce sujet sont traitées dans la rubrique FAQ.
Pour créer une archive de données, passer à la fenêtre « Archives ». Amenez le pointeur de la souris sur le nœud « Archives » de l'arborescence. Effectuez un clic droit de la souris. Un menu déroulant s'ouvre. Cliquez sur « Créer archive ». Une nouvelle archive est ajoutée à l'arborescence.
Dans la rubrique « Colonnes », définissez les données devant être mémorisées dans un enregistrement de données.

1.1.Registre

1.1.1.Données

La définition fondamentale de l'archive est réalisée ici.
Désignation
Ce terme désigne l'archive dans l'Expert HS/FS.
L'interface de point final permet de chercher des archives dont la désignation comprend un mot qui commence par le mot de recherche utilisé.
Mémoire circulaire
Nombre maximum des enregistrements de données pouvant être compris dans la mémoire circulaire. Lorsque ce nombre est atteint, l'enregistrement de données le plus ancien est remplacé par le prochain enregistrement créé. Voir aussi Valeurs limite.
Cycle
Si cette option est sélectionnée, les données sont enregistrées de manière cyclique.
OuiL'enregistrement est cyclique. La durée de cycle est indiquée dans le champ adjacent, en minutes. Indépendamment de cette option, un enregistrement de données peut être mémorisé à tout instant via une instruction.
NonL'enregistrement doit être déclenché par une instruction.
Temps mort
Cette durée empêche que les données soient enregistrées à des intervalles trop courts.
Cette période est surtout importante en liaison avec des instructions d'enregistrement des données.

Exemple :
Si le temps mort est de 60 secondes, les instructions d'enregistrement des données seront exécutées après l'expiration de ce temps. (FAQ à ce sujet)
Colonnes
Il est possible d'enregistrer simultanément jusqu'à 128 objets de communication (1 Kb par colonne) dans une ligne. Ceci facilite l'exploitation ultérieure. Chaque archive contient toujours la date et l'heure dans la première colonne.
Les boutons de commande jouxtant la liste à droite permettent de créer, de modifier ou de supprimer les colonnes. Un masque apparaît à cet effet.
Attention
En cas de modification d'une archive (des colonnes sont ajoutées, supprimées ou le type de données est modifié), la nouvelle transmission consécutive du projet sur le HS/FS provoque la perte de toutes les données de cette archive déjà mémorisées !

1.1.2.Point final

L'interface de point final du HS/FS permet d'accéder aux archives.
Une description des paramètres d'appel se trouve ici.
Remarque
Au lieu de l'archive utilisée sans tous les exemples d'appel du tableau suivant, vous pouvez aussi utiliser n'importe quelle archive.

Les jokers sont indiqués en MAJUSCULES.
1.1.2.1.Méthodes
MéthodeDescription/Appel
metaAppel des métadonnées de l'archive.
https://HS_IP/endpoints/call?key=DA@my_archive&method=meta&user=USER&pw=PWD
getAppel de certaines colonnes d'une archive en une période donnée.
https://HS_IP/endpoints/call?key=DA@my_archive&method=get&startat=1702261500&cnt=12&size=5&cols=MYCOL1+MYCOL5&user=USER&pw=PWD
1.1.2.2.Champs
ID
La valeur entrée ici compose, avec le préfixe prescrit « DA » avec lequel l'ID est relié via un signe '@', la clé d'objet univoque du point final.
Les caractères autorisés sont : A-Z, a-z, 0-9, trait d'union ('-') et tiret bas ('_').
Description
Une description parlante de l'archive.
L'interface de point final permet de chercher des archives dont la désignation comprend un mot qui débute par le mot de recherche utilisé.
Balises
Une liste de termes séparés par des virgules (',').
L'interface de point final permet de chercher des archives dont la désignation comprend une balise qui correspond parfaitement au mot de recherche utilisé.
Les caractères autorisés sont : A-Z, a-z, 0-9, trait d'union ('-') et tiret bas ('_').
Groupes d'utilisateurs
Attention
Ce point est disponible uniquement lorsque des groupes d'utilisateurs ont été activés.
Il est possible d'autoriser des groupes d'utilisateurs à accéder à cette archive (en lecture) via l'interface de point final.

1.1.3.E-mail

Remarque
Cette option est disponible seulement si l'envoi par e-mail a été activé en amont, dans Données de base\Projet\Réseau\E-mail.
Envoi par e-mail
Cette liste affiche toutes les versions d'archive pouvant être envoyées par courrier électronique.
Actionnez les boutons de commande « Créer/Modifier/Supprimer » situés à droite de la liste. Un masque destiné à l'édition apparaît.

1.1.4.Consultation HTTP

Consultation HTTP
Cette liste contient toutes les versions qu'il est possible d'appeler via une interrogation http.
Actionnez les boutons de commande « Créer/Modifier/Supprimer » situés à droite de la liste. Un masque destiné à l'édition apparaît.

1.1.5.FTP

Remarque
Cette option est disponible uniquement si le support a été activé en amont, dans Données de base\Projet\Réseau\FTP.
Envoi par FTP
Cette liste indique toutes les versions d'archives pouvant être transférées par FTP.
Actionnez les boutons de commande « Créer/Modifier/Supprimer » situés à droite de la liste. Un masque destiné à l'édition apparaît.

1.2.Valeurs limite

Les données sont enregistrées de manière durable (permanente) dans une mémoire circulaire. La mémoire est similaire à un tableau constitué de lignes et de colonnes. La mémoire peut être configurée pour chaque archive.
Attention
La première colonne contient toujours la date et l'heure de l'enregistrement et elle n'est pas prise en compte dans le calcul des valeurs limites destiné aux HomeServer et FacilityServer.
Les valeurs maximum indiquées dans les tableaux suivants constituent des limitations extrêmes. Ces indications ne constituent pas des caractéristiques relatives à la capacité de stockage. Il est impossible d'utiliser des valeurs supérieures à celles-ci dans HS/FS et l'Expert HS/FS. Dès lors, la capacité de stockage peut être sensiblement inférieure, en fonction des données à mémoriser et des procédés de compression utilisés.

Les limitations sont les suivantes et la première qui intervient s'applique. Les limitations sont différentes pour le HomeServer et le FacilityServer.

1.2.1.HomeServer

Colonnes max.Lignes max.Colonnes*lignes max.
1 archive128100.000200.000
TOUTES les archives--2.000.000

1.2.2.FacilityServer

Colonnes max.Lignes max.Colonnes*lignes max.
1 archive128200.000400.000
TOUTES les archives--4.000.000