SVLOG

Icône du lien vers le conceptVoir également Icône du lien vers le conceptExemple Icône du lien vers le conceptInfos complémentaires

Extraction d'enregistrements issus de listes de consignation.

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é.

Mode

Mnémonique

Syntaxe

1

EXTRACT

1

Syntaxe 1

LongVal = SVLOG(Mode, DestHandle, ParamHandle [, EndVarName [, StatusVarName [, LinesVarName [, StartTime [, EndTime]]]]]);

Type de retour : LONG

Argument

Définition

DestHandle

Handle du buffer dans lequel seront stockées les lignes de consignation trouvées. Type LONG.

ParamHandle

Handle du buffer contenant les paramètres de l'extraction. Les paramètres doivent être stockés dans le buffer sous forme d'une chaîne en ASCII délimitée par des virgules. Type LONG.

EndVarName

Variable dans laquelle l'horodate du 1er enregistrement extrait sera stockée. Type STR.

StatusVarName

Nom de la variable mesure qui contient le résultat de l'instruction. Ce paramètre est ignoré si vous utilisez une chaîne vide. Type STR.

-1 - Extraction en cours.
0 - Si toutes les lignes concernées ont été extraites.
2 - Si toutes les lignes concernées n'ont pas pu être extraites suite à la limitation imposée par la taille du buffer de destination. Pour écrire une nouvelle ligne dans le buffer il faut disposer encore d'au moins 300 caractères libres.

 

 

 

LinesVarName

Le nom d'une variable mesure dans laquelle sera écrit le nombre de lignes retournées. Une valeur négative indique une erreur. Ce paramètre est ignoré s'il est égal à une chaîne de caractères vide "". Type STR.

StartTime

Variable dans laquelle l'horodate du dernier enregistrement extrait sera stockée. Type STR.

  • Si une variable de type mesure est utilisée, l'horodate sera représentée sous la forme d'un nombre de millisecondes depuis 1980 (voir instruction DATETIMEVALUE).
  • Si une variable de type texte est utilisée, l'horodate sera représentée avec le format #D/#M/###Y #h:#m:#s:##l.

Ce paramètre est ignoré si une chaîne vide est passée.

EndTime

Variable dans laquelle l'horodate du dernier enregistrement extrait sera stockée. Type STR.

Voir StartTime pour les informations de format.

Exécution

Mode

Mnémonique

Action

1

EXTRACT

Permet d'extraire des lignes d'une liste de consignation et de les stocker dans un buffer défini par le paramètre DestHandle.

Retour : 0 si la syntaxe de l'instruction est incorrecte. La variable de statut doit être utilisée pour les codes de statut opérationnel.

Pour le format du buffer de paramètre, voir les rubriques Format du Buffer de Paramètre et Expressions de filtre natif.

La taille du buffer de destination est limitée à 32 Ko.

Si le nombre de lignes retournées, tel qu'indiqué dans la variable LinesVarName est égal au nombre de lignes maximum demandé (voir MaxLines dans ParamHandle), il se peut qu'il y ait d'autres données à extraire.

Les noms d'attributs utilisés dans les expressions de filtres n'autorisent pas les espaces. Par exemple (#A5==T 5) n'est pas autorisé.

Exemple

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