SVTREND

Icône du lien vers le conceptVoir également Icône du lien vers le conceptExemple

Récupération entre deux dates des valeurs historisées d’un ensemble de variables.

Support WebVue - Oui.

L'utilisation des verbes EXPORT, EXPORT_LOG et EXPORT_TREND est préférée à celle des verbes SVLOG et SVTREND. Ces derniers ne sont conservés que pour compatibilité. Ces derniers ne sont conservés que pour compatibilité.

Les variables doivent être configurées pour être archivées en tendance.

Mode Mnémonique Syntaxe
1 GETTREND 1
2 GETNEXTBUFFER 2

Syntaxe 1

IntVal = SVTREND (Mode, ListVar, Branch, StartDate, EndDate, Period, [DisplayMode, Handle_Result, Parameters]);

Type de retour : INTEGER.

Argument

Définition
ListVar Soit :
Handle contenant la liste des variables (séparée par des virgules) concernées par la recherche. Type LONG.
Ou
Chaîne de caractères contenant une liste séparée par des virgules. Type STR
Branch Branche de la liste des variables. Type STR.
StartDate Date de début d'extraction, en millisecondes depuis1980. Type DOUBLE.
EndDate Date de fin d'extraction, en millisecondes depuis1980. Type DOUBLE.
Period Période d'échantillonnage en secondes. Type DOUBLE.
DisplayMode

Présentation des points.

Mode Display= 1 - Les données sont extraites à l'aide de la liste des variables dans le buffer Handle_Listvar au format défini par Format.
DisplayMode = 2 - Les données échantillonnées pour chaque variable seront contenues sur la même ligne précédée de son estampille date et heure.

Voir l'exemple pour plus de détails.
Handle_Result Handle du buffer résultat. Type de retour : LONG.
Parameters

Soit :
Handle contenant la liste des variables séparées par des virgules concernées par la recherche. Type LONG.
Ou :
Liste des variables séparée par des virgules concernées par la recherche. Type STR.

Voir ci-dessous pour plus d'informations au sujet du formatage de cet argument.

Exécution

Mode Mnémonique Action
1 GETTREND

Récupère les valeurs (historisées) d'un ensemble de variables en tendance entre deux dates.

Retour :

1 OK.
-1 Handle_Listvar est nul ou de longueur nulle.
-2 Str_ListVar n’a pu être lu-3 Le paramètre 1 n’est ni de type LONG ni de type STR.
-4 Le paramètre 2 n’est pas de type STR.
-5 Le paramètre 3 n’est pas de type DOUBLE.
-6 Le paramètre 4 n’est pas de type DOUBLE.
-7 Le paramètre 5 n’est pas de type DOUBLE.
-8 Le paramètre 6 n’est pas de type LONG.
-10 Le paramètre 7 n’est pas de type STR
-11 Le paramètre 8 n’est pas de type STR.
-12 Le paramètre 9 n’est pas de type STR.
-13 StrVar n’existe pas dans la base de données ou n'est pas configuré en tendance.
-14 Une des variables de Handle_ListVar ou Str_ListVar n’est pas une variable.
-15 Une des variables de Handle_ListVar ou Str_ListVar n’existe pas dans la base de données.
-16 Une des variables de Handle_ListVar ou Str_ListVar fait déja l’objet d’une requête SVTREND ou HISTORY.
-17 Handle_ListVar ou Str_ListVar est vide.

Format de l'argument Parameters

L'argument Parameters inclut les éléments suivants séparés par des virgules: Format, Filter, LogVar, NameVar

Il est passé soit sous la forme d'un handle sur un buffer, ou directement sous la forme d'une chaîne de caractères.

Elément

Définition
Format

Formatage des horodates. Type STR.

#D pour le jour
#M pour le mois
#Y pour l'année sur 2 chiffres
###Y pour l'année sur 4 chiffres
#h pour l'heure
#m pour les minutes
#s pour les secondes
##l pour les millisecondes

Tous les autres caractères sont interprétés littéralement.
Filter Filtre appliqué à l'extraction. Voir la rubrique Expressions de Filtre natif. Type STR.
LogVar Nom de la variable état mise à 1 en fin de traitement. Type STR.
NameVar Nom de la variable mesure dont la valeur vaudra l'identifiant numérique de la variable en cours d'extraction. Type STR.

Syntaxe 2

IntVal = SVTREND (Mode, Handle_Result);

Type de retour : INTEGER.

Argument

Définition

Handle_Result

Handle du buffer dans lequel les données sont placées. Type LONG.

Exécution

Mode Mnémonique Action
2 GETNEXTBUFFER Récupère le buffer de points suivants. Ce mode est un mode synchrone, c'est-à-dire que le buffer est disponible dès l'instruction suivante.

Retour :

0 Buffer vide.
1 Paramètres corrects.
-1 Aucune instruction SVTREND précédente.
-2 Paramètre Handle_Result est nul ou non initialisé.

Le buffer Handle_Result est rempli à concurrence de sa taille. Une fois les points récupérés, le mode GETNEXTBUFFER, permet de récupérer à nouveau le prochain buffer de points.

Exemple

Pour un exemple, sélectionnez le lien Exemple ci-dessus.