Règles de syntaxe pour les fichiers formats définis par l’utilisateur

Avec des fichiers formats définis pas l’utilisateur, vous pouvez créer votre propre format de fichier d’enregistrement.

Règles et syntaxe dans le fichier de configuration :

Variables :

%DEF_SEPARATOR

Définit un caractère de séparation autre que ";" ou "," pour le fichier CSV.

Exemple : %DEF_SEPARATOR="/"

%DEF_INVALID

Définit une chaîne de caractères (16 caractères max.) pour des valeurs invalides, des erreurs de communication (pas de données reçues) ou l’absence de valeur initiale pour les différences.

Valeur par défaut : "-"; la chaîne de caractères pour des valeurs REAL invalides est toujours "NaN".

Exemple : %DEF_INVALID="invalid"

%DEF_FILENAME

Indique le nom du fichier d’enregistrement. N’importe quel caractère ASCII et les désignations suivantes (y compris les désignations de dates et heures ISO 8601) peuvent être utilisés :

  • %y (année abrégée avec deux caractères)
  • %Y (année complète avec quatre caractères)
  • %m (mois en nombre 01–12)
  • %d (jour en nombre 01–31)
  • %W (semaine)
  • %j (jour de la semaine)
  • %H (heure)
  • %M (minute)
  • %S (seconde)
  • %F (nom du fichier d’enregistrement défini dans Data Logger > Fichiers d’enregistrement
  • %x (numéro de lot avec 5 digits, 0–65535)
  • %X (numéro de lot avec 10 digits, 0–4294967293)

Exemple : %DEF_FILENAME="%F(%Y%m%d_%H%M%S_TRG).csv"

%DEF_DATA_TIMESTAMP

Définit le numéro de point de données (n) qui contient les informations d’horodatage. Entrez n-1, car "0" correspond au premier point de données.

Exemple : %DEF_DATA_TIMESTAMP="0"

%DEF_DATA_FILEEXT

Définit le numéro de point de données (n) qui contient les informations sur le numéro de lot (utilisé avec %x ou %X dans %DEF_FILENAME). Entrez n-1, car "0" correspond au premier point de données.

Exemple : %DEF_DATA_FILEEXT="0"

%DEF_TIME

Indique un format d’heure, défini par l’utilisateur, pour l’horodatage.

  • %H (heure)
  • %M (minute)
  • %S (seconde)

Exemple : %DEF_TIME="%H:%M:%S"

%DEF_DATE

Indique un format de date, défini par l’utilisateur, pour l’horodatage.

  • %y (année abrégée avec deux caractères)
  • %Y (année complète avec quatre caractères)
  • %m (mois en nombre 01–12)
  • %d (jour en nombre 01–31)
  • %W (semaine)
  • %j (jour de la semaine)

Exemple : %DEF_DATE="%Y/%m/%d"

%DEF_DATETIME

Indique un format de date et heure, défini par l’utilisateur, pour l’horodatage (combine %DEF_DATE et %DEF_DATE).

  • %y (année abrégée avec deux caractères)
  • %Y (année complète avec quatre caractères)
  • %m (mois en nombre 01–12)
  • %d (jour en nombre 01–31)
  • %W (semaine)
  • %j (jour de la semaine)
  • %H (heure)
  • %M (minute)
  • %S (seconde)

Exemple : %DEF_DATETIME="%Y-%m-%d %H:%M:%S"

%DEF_SPLIT_MINUTES

Indique une division des fichiers après un nombre de minutes défini. Paramètres valides : 1, 10, 60, 1440 (1 jour), 10080 (1 semaine). Exemple : %DEF_SPLIT_MINUTES="10"

%DEF_INT

Texte à afficher si %DATAFORMATS est utilisé. Exemple : %DEF_INT="S16"

%DEF_UINT

Texte à afficher si %DATAFORMATS est utilisé. Exemple : %DEF_UINT="US16"

%DEF_WORD

Texte à afficher si %DATAFORMATS est utilisé. Exemple : %DEF_WORD="HEX4"

%DEF_BIN

Texte à afficher si %DATAFORMATS est utilisé. Exemple : %DEF_BIN="BITS"

%DEF_DINT

Texte à afficher si %DATAFORMATS est utilisé. Exemple : %DEF_DINT="S32"

%DEF_UDINT

Texte à afficher si %DATAFORMATS est utilisé. Exemple : %DEF_UDINT="US32"

%DEF_DWORD

Texte à afficher si %DATAFORMATS est utilisé. Exemple : %DEF_DWORD="HEX8"

%DEF_REAL

Texte à afficher si %DATAFORMATS est utilisé. Exemple : %DEF_REAL="FLT"

%DEF_REALEXP

Texte à afficher si %DATAFORMATS est utilisé. Exemple : %DEF_REALEXP="FLT"

%DEF_ASCII

Texte à afficher si %DATAFORMATS est utilisé. Exemple : %DEF_ASCII="CHAR2"

%DEF_DT

Texte à afficher si %DATAFORMATS est utilisé. Exemple : %DEF_DT="DATE AND TIME"

%DEF_TITLE

Inclus pour des raisons de compatibilité uniquement. Exemple : %DEF_TITLE="KW Watcher"

Variables d’en-têtes :

Exemple :
  • %HEADER="Date","Time",%NUMBER_DYN
  • %HEADER+=,,%NAMES
  • %HEADER+=,,%COLUMNS
  • %HEADER+=,,%COM
  • %HEADER+=,,%TYPES
  • %HEADER+=,,%DATAFORMATS
  • %HEADER+=,,%REGISTER
  • %HEADER+=,,%UNITS
%HEADER

Utilisez %HEADER pour spécifier un texte et des variables.

Si l’en-tête se compose de plusieurs lignes, chaque ligne doit commencer par %HEADER suivi de "+=" au lieu de "=".

%NUMBER_DYN

Ajoute automatiquement un numéro à toutes les colonnes dans l’ordre croissant.

%NAMES

Écrit le nom de tous les points de données, séparé par le caractère de séparation.

%COMS

Écrit le numéro de station de tous les points de données, séparé par le caractère de séparation.

%REGISTERS

Écrit l’adresse de registre (par ex. DT100) de tous les points de données, séparée par le caractère de séparation.

%TYPES

Écrit le type de registre (MOMENT/DIFFERENCE) de tous les points de données, séparé par le caractère de séparation.

%DATAFORMATS

Écrit le format de données (INT, DINT...) de tous les points de données, séparé par le caractère de séparation.

Le texte de chaque format de données peut être défini avec les variables %DEF_....

%UNITS

Écrit l’unité (m³, °C, kWh...) de tous les points de données, séparée par le caractère de séparation.

%COLUMNS

Écrit le numéro de colonne de chaque point de données, séparé par le caractère de séparation.

Variables d’enregistrement :

Exemple :
  • %LOGDATA=%DATE,%TIME,%VALUES
%LOGDATA

Indique l’ordre des données dans une ligne d’enregistrement (par ex. pour la date, l’heure, un texte supplémentaire et les données).

%DATE

Utilisez le format de la date défini avec %DEF_DATE.

%TIME

Utilisez le format de l’heure défini avec %DEF_TIME.

%UNIXTIME

Utilisez le format de l’heure Unix (secondes depuis 1970-01-01). Exemple : %LOGDATA=%UNIXTIME,%DATE,%TIME,%VALUES

%VALUES

Écrit les valeurs des données enregistrées, séparées par un caractère de séparation.

NOTA

Vérifiez qu’il y a bien un caractère de séparation entre les variables et le texte.