# Exportation et importation de variables

Dans le logiciel d'édition d'écran, vous pouvez exécuter l'exportation et l'importation de variables globales à l'aide de la barre d'outils de l'éditeur de variables. Une propriété d'une alarme et d'une journalisation est incluse dans l'élément d'exportation. L'exportation et l'importation de variables locales ne sont pas prises en charge.

Remarque :

- Bien que vous puissiez importer des données exportées sous forme de fichiers CSV ou TXT depuis la version 3.3 Service Pack 1 ou antérieure du logiciel d'édition d'écran vers la version 3.4 ou ultérieure, les fichiers exportés depuis la version 3.4 ou ultérieure ne peuvent pas être importés dans la version 3.3 Service Pack 1 ou antérieure, car la version du fichier est 2.0.
  Vérifiez la version du fichier des sorties CSV ou TXT à la ligne [FileVersion] du fichier de sortie.
- Les fichiers Excel sont pris en charge pour l'exportation et l'importation de variables à partir de la version 4.4.

Les formats de fichier suivants sont pris en charge pour l'importation et l'exportation de variables :

- Fichier TXT (.txt, UTF-8 (sans BOM))
- Fichier CSV (.csv, UTF-8 (sans BOM))
- Fichier Microsoft Excel (.xlsx)

Remarque :

Fichier Microsoft Excel

- Pour exporter et importer des variables dans des fichiers Excel, Microsoft Excel est nécessaire. Le logiciel d'édition d'écran prend en charge Microsoft Excel 2016, 2019 et 365.
- Lorsque vous exportez des variables vers un fichier Excel, vous pouvez définir un mot de passe pour le chiffrer. Il est recommandé de définir un mot de passe complexe. Si vous oubliez le mot de passe, il ne pourra pas être récupéré.
- Le logiciel d'édition d'écran ne prend pas en charge la gestion des droits d'information (IRM) d'Excel.

Fichier TXT ou CSV

- Lorsque vous exportez des variables vers un fichier TXT ou CSV, sélectionnez le délimiteur.
- Les fichiers TXT ou CSV enregistrés avec un encodage autre que UTF-8 (sans BOM) ne peuvent pas être importés.
- Pour plus d'informations sur les formats de fichiers, voir ce qui suit.
  Enregistrement des données (Exportation) Paramètres du fichier

Vous pouvez consulter le fichier exporté à l'aide de logiciels tels que Microsoft Excel.

Remarque :

La sortie des données est formatée comme suit :

- Les chaînes sont encapsulées par des guillemets doubles (").
  Par exemple : "Ceci est une chaîne de caractères"
- Les caractères spéciaux "=", "+", "-", "@", TAB et ENTER qui apparaissent au début d'une entrée sont préfixés par un guillemet simple (').
  Par ex. "'=1+2"

## Notes sur l'importation des variables

- Lors de l'importation, s'il n'existe pas de vitesse de scrutation du même nom, une nouvelle vitesse de scrutation est créée avec l'intervalle du fichier exporté. Si le taux de numérisation existe déjà dans le projet, il est mis à jour.
- Si vous importez un fichier exporté à partir du logiciel d'édition d'écran version 3.1 Service Pack 1B ou antérieur, les variables externes se voient attribuer la vitesse de scrutation par défaut. Pour plus d'informations sur les vitesses de scrutation, voir ci-dessous.
  Définition de l'intervalle de lecture des valeurs de variables externes (Vitesse de scrutation)
- Les variables qui ont été importées à l'aide de l'importation de fichiers de symboles ne peuvent pas être mises à jour avec la commande import variable. Pour mettre à jour les variables dans le fichier de symboles, reportez-vous à ce qui suit.
  Importation de symboles à partir d'équipemets externes - Notes après l'importation du fichier de symboles
- Vous ne pouvez pas importer de variables dans un projet qui contient un fichier de symboles. Pour importer des variables, suivez ces étapes.
  1. Supprimez le fichier de symboles du projet.
  2. Exportez les variables du projet.
  3. Importez les variables dans le projet.
  4. Importez le fichier de symboles dans le projet.

- Il existe une convention de dénomination pour les noms de variables dans le logiciel d'édition d'écran.
  Si le nom d'une variable contient des caractères qui ne respectent pas la convention de dénomination, la variable n'est pas importée.
  Pour en savoir plus, consultez ce qui suit.
  Conventions de dénomination

### Lors de l'importation d'un fichier Excel

- Lorsque vous importez un fichier Excel protégé, vous devez entrer le mot de passe.
- Seules les valeurs sont importées à partir des fichiers Excel. Les macros et les formules ne sont pas recalculées lors de l'importation.
- FileVersion sur [Summary] est vérifié lors de l'importation. Les autres valeurs de comptage sont ignorées.
- La taille maximale du fichier que vous pouvez importer est de 100 Mo.

## Format de la variable

### Structure du fichier Excel exporté

Dans le fichier Excel exporté, les données sont organisées dans les feuilles suivantes, chacune contenant des informations spécifiques :

- Summary : aperçu de toutes les variables exportées.
- VariableTypes : types de variables tels que tableau ou structure, le cas échéant.
- Variables : données variables.
- ScanRates : taux de balayage, le cas échéant.
- AlarmGroups : tous les groupes d'alarmes, même si aucune alarme n'est définie.
- Alarms : alarmes, le cas échéant.
- LoggingGroups : tous les groupes de journalisation, même s'ils ne contiennent aucune variable.
- LoggingRecords : variables, le cas échéant.

Exemple : Feuille Variables

Remarque :

- Vous pouvez modifier uniquement les données sous forme de texte bleu. Si vous modifiez le format, vous ne pouvez pas importer le fichier. Toutes les colonnes sont obligatoires.
- Les feuilles et les colonnes peuvent être dans n'importe quel ordre.

### Structure du fichier CSV exporté

Lorsqu'il est ouvert dans Excel, le fichier CSV exporté est organisé comme indiqué ci-dessous.

Remarque : vous pouvez modifier uniquement les données sous forme de texte bleu. Si vous modifiez le format, vous ne pouvez pas importer le fichier.

###

## Éléments d'exportation

Ce tableau indique une propriété qui correspond à l'élément exporté.

L'élément dont une propriété n'est pas configurée sera vide.

### Éléments du fichier Excel exporté

[VariableTypes]

Éléments | Propriété | Emplacement avec la propriété | Valeur disponible
Name | [Nom] | [Tous les types de données utilisateur] | Selon les conventions de dénomination.
Type | [Type de données] | [Tous les types de données utilisateur] | Selon le type de données pris en charge.
ElementTypeName | Indique le type de données d'un élément de tableau ou un membre de structure. | [Tous les types de données utilisateur] | Selon le type de données pris en charge.
Dimensions | [Dimension] | [Tous les types de données utilisateur] | Selon la plage prise en charge d'une propriété.

[Variables]

Éléments | Propriété | Emplacement avec la propriété | Valeur disponible
Name | [Nom] | [Toutes les variables] | Selon les conventions de dénomination.
FolderName | [Dossier] | [Toutes les variables] | Selon les conventions de dénomination.
DataType | [Type de données] | [Toutes les variables] | Selon le type de données pris en charge.
Dimension | [Dimension] | [Toutes les variables] | Selon la plage prise en charge d'une propriété.
Source | [la source] | [Toutes les variables] | Non modifié
DeviceAddress | [Adresse de l'équipement] | [Toutes les variables] | Selon la plage prise en charge d'une propriété.
BaseAddress | [Adresse de base] (uniquement lorsqu'un tableau ou une structure est sélectionné). | [Toutes les variables] | TRUE/FALSE
ScanRate | [Vitesse de scrutation] | [Toutes les variables] | Selon les conventions de dénomination.
InitialValue | [Valeur initiale] | [Toutes les variables] | Selon la plage prise en charge d'une propriété.
InputRange | [Plage de saisies] | [Toutes les variables] | TRUE/FALSE
Min | [Minimum] | [Toutes les variables] | Selon la plage prise en charge d'une propriété.
Max | [Maximum] | [Toutes les variables] | Selon la plage prise en charge d'une propriété.
EnableVariableLength | [Longueur de la variable] | [Toutes les variables] | TRUE/FALSE
NumberOfBytes/NumberOfWords | [Nombre d'octets] (lorsqu'une chaîne STRING est sélectionnée uniquement). / [Nombre de mots] (lorsqu'une chaîne WSTRING est sélectionnée uniquement). | [Toutes les variables] | Selon la plage prise en charge d'une propriété.
StringEncode | [Encodage de chaîne] (seulement lorsqu'un équipement est sélectionné dans [la source]). | [Toutes les variables] | Selon l'encodage pris en charge.
Retentive | [Persistante] | [Toutes les variables] | TRUE/FALSE
Value | [Valeur] | [Toutes les variables] | Selon les conventions de dénomination.
BindingType | Indique le type de données affecté. | Fenêtre de sélecteur de propriété pour la propriété de variable. | Seul l'objet pouvant être configuré dans une propriété.
BindingMode | [Sens] | Fenêtre de sélecteur de propriété pour la propriété de variable. | OneWay/TwoWay
BindingConverter | [Convertisseur] | Fenêtre de sélecteur de propriété pour la propriété de variable. | Selon les conventions de dénomination.
DataSharing | [Partage de données] | [Toutes les variables] | None/ReadOnly/ReadWrite
Comments | [Commentaires] | [Toutes les variables] | Selon les conventions de dénomination.

[ScanRates]

Éléments | Propriété | Emplacement avec la propriété | Valeur disponible
Name | [Nom] | [Toutes les vitesses de scrutation] | Selon les conventions de dénomination.
Interval | [Intervalle (100 ms)] | [Toutes les vitesses de scrutation] | 1 - 600

[AlarmGroups]

Éléments | Propriété | Emplacement avec la propriété | Valeur disponible
Name | [Nom] | [AlarmGroup] | Selon les conventions de dénomination.
***LabelType [1] | Indique le paramètre d'étiquette. | [AlarmGroup] | Direct/LanguageTable
***Label [1] | ndique les noms d'étiquette. | [AlarmGroup] | Selon la plage prise en charge d'une propriété.
Parameter | [Paramètre] | [AlarmGroup] | Selon la plage prise en charge d'une propriété.
AlarmBehavior | [Comportement de l'alarme] | [AlarmGroup] | Optional ACK/Mandatory ACK

1. *** fait référence à LoLo, Lo, Hi, HiHi, Active, ACK, RTN ou UNACK.

[Alarms]

Éléments | Propriété | Emplacement avec la propriété | Valeur disponible
Variable | [Variable] | [Alarme booléenne]/[Alarme de niveau] | Selon les conventions de dénomination.
AlarmGroupName | [Nom] | [AlarmGroup] | Selon les conventions de dénomination.
Type | [Type d'alarme] | [Alarme booléenne]/[Alarme de niveau] | HiHi/Hi/Lo/LoLo
Condition | [Condition de déclenchement] (Alarme booléenne) / [Valeur] (Alarme de niveau) | [Alarme booléenne]/[Alarme de niveau] | Si la propriété est sélectionnée, affiche TRUE pour l'alarme booléenne. L'alarme de niveau suit la plage prise en charge de la propriété.
Deadband | [Bande morte] | [Alarme de niveau] | Selon la plage prise en charge d'une propriété.
Severity | [Gravité] | [Alarme booléenne]/[Alarme de niveau] | Selon la plage prise en charge d'une propriété.
Parameter | [Paramètre] | [Alarme booléenne]/[Alarme de niveau] | Selon la plage prise en charge d'une propriété.
MessageType | Indique un paramètre de message | [Alarme booléenne]/[Alarme de niveau] | Direct/Language Table
Message | [Message] | [Alarme booléenne]/[Alarme de niveau] | Selon la plage prise en charge d'une propriété.

[LoggingGroups]

Éléments | Propriété | Emplacement avec la propriété | Valeur disponible
Name | [Nom] | [Groupe de journalisation] | Selon les conventions de dénomination.
MaxRecord | [Nombre max. d'enregistrements] | [Groupe de journalisation] | Selon la plage prise en charge d'une propriété.
ConditionType | [Type de condition] | [Groupe de journalisation] | ValueChange/Periodic/Script
Frequency | [Fréquence] (uniquement lorsque [Périodique] est sélectionné dans [Type de condition]). | [Groupe de journalisation] | Selon la plage prise en charge d'une propriété.
Units | [Unités] (uniquement lorsque [Périodique] est sélectionné dans [Type de condition]). | [Groupe de journalisation] | Secs/Mins/Hours/100ms
Condition | [Condition d'exécution] (uniquement lorsque [Changement de valeur] est sélectionné dans [Type de condition]). | [Groupe de journalisation] | ON/OFF/On Change
TriggerVariable | [Variable de déclenchement] (lorsque [Changement de valeur] est sélectionné dans [Type de condition] uniquement). | [Groupe de journalisation] | Selon les conventions de dénomination.
TriggerVariableBindingConverter | [Convertisseur] | Fenêtre de sélecteur de propriété pour la propriété de variable. | Selon les conventions de dénomination.
InterlockType | Indique le paramètre [Verrouillage]. | [Groupe de journalisation] | Direct/Variable
Interlock | [Verrouillage] | [Groupe de journalisation] | TRUE/FALSE
InterlockBindingMode | [Sens] | Fenêtre de sélecteur de propriété pour la propriété de variable. | OneWay/TwoWay
InterlockBindingConverter | [Convertisseur] | Fenêtre de sélecteur de propriété pour la propriété de variable. | Selon les conventions de dénomination.
ExportData | [Activer] | [Groupe de journalisation] | TRUE/FALSE
WriteDataTo | [Stockage des données] | [Groupe de journalisation] | USB Storage/SD Card/Internal
AppendDateTime | [Ajouter la date/l'heure] | [Groupe de journalisation] | TRUE/FALSE
DetectModification | [Détecter les modifications] | [Groupe de journalisation] | TRUE/FALSE
FolderNameType | Indique le paramètre [Nom du dossier]. | [Groupe de journalisation] | Direct/Variable
FolderName | [Nom du dossier] | [Groupe de journalisation] | Selon la plage prise en charge d'une propriété.
FolderNameBindingMode | [Sens] | Fenêtre de sélecteur de propriété pour la propriété de variable. | OneWay/TwoWay
FolderNameBindingConverter | [Convertisseur] | Fenêtre de sélecteur de propriété pour la propriété de variable. | Selon les conventions de dénomination.
FileNameType | Indique le paramètre [Nom du fichier]. | [Groupe de journalisation] | Direct/Variable
FileName | [Nom du fichier] | [Groupe de journalisation] | Selon la plage prise en charge d'une propriété.
FileNameBindingMode | [Sens] | Fenêtre de sélecteur de propriété pour la propriété de variable. | OneWay/TwoWay
FileNameBindingConverter | [Convertisseur] | Fenêtre de sélecteur de propriété pour la propriété de variable. | Selon les conventions de dénomination.
ExportStatus | [Activer] | [Groupe de journalisation] | TRUE/FALSE
SaveStatus | [État de l'enregistrement] | [Groupe de journalisation] | Selon la plage prise en charge d'une propriété.
SaveStatusBindingMode | [Sens] | Fenêtre de sélecteur de propriété pour la propriété de variable. | OneWay/TwoWay
SaveStatusBindingConverter | [Convertisseur] | Fenêtre de sélecteur de propriété pour la propriété de variable. | Selon les conventions de dénomination.
ErrorStatus | [État d'erreur] | [Groupe de journalisation] | Selon la plage prise en charge d'une propriété.
ErrorStatusBindingMode | [Sens] | Fenêtre de sélecteur de propriété pour la propriété de variable. | OneWay/TwoWay
ErrorStatusBindingConverter | [Convertisseur] | Fenêtre de sélecteur de propriété pour la propriété de variable. | Selon les conventions de dénomination.

[LoggingRecords]

Éléments | Propriété | Emplacement avec la propriété | Valeur disponible
VariableName | [Nom de la variable] | [Enregistrement de journalisation] | Selon les conventions de dénomination.
LoggingGroupName | [Nom] | [Groupe de journalisation] | Selon les conventions de dénomination.

### Éléments du fichier CSV exporté

Éléments | Propriété | Emplacement avec la propriété | Valeur disponible
Name | [Nom] | [Toutes les variables] | Selon les conventions de dénomination.
Type | [Type de données] | [Toutes les variables] | Selon le type de données pris en charge.
ElementType | Indique le type de données d'un élément de tableau ou un membre de structure. | [Toutes les variables] | Selon le type de données pris en charge.
Dimensions | [Dimension] | [Toutes les variables] | Selon la plage prise en charge d'une propriété.
InitialValue | [Valeur initiale] | [Toutes les variables] | Selon la plage prise en charge d'une propriété.
RetentiveEnabled | [Persistante] | [Toutes les variables] | TRUE/FALSE
FolderName | [Dossier] | [Toutes les variables] | Selon les conventions de dénomination.
BindType | Indique le type de données affecté. | Fenêtre de sélecteur de propriété pour la propriété de variable. | Seul l'objet pouvant être configuré dans une propriété.
BindObject | Indique le nom des données attribuées. | Fenêtre de sélecteur de propriété pour la propriété de variable. | Selon les conventions de dénomination.
BindField | Indique la propriété des données attribuées. | Fenêtre de sélecteur de propriété pour la propriété de variable. | Seule une propriété d'un objet affecté.
BindIsArray | Indique si une variable définie par l'utilisateur est définie comme valeur. | Fenêtre de sélecteur de propriété pour la propriété de variable. | TRUE/FALSE
BindValue | - | - |
BindDirection | [Sens] | Fenêtre de sélecteur de propriété pour la propriété de variable. | OneWay/Both
BindConverter | [Convertisseur] | Fenêtre de sélecteur de propriété pour la propriété de variable. | Selon les conventions de dénomination.
HasInputRange | [Plage de saisies] | [Toutes les variables] | TRUE/FALSE
MinValue | [Minimum] | [Toutes les variables] | Selon la plage prise en charge d'une propriété.
MaxValue | [Maximum] | [Toutes les variables] | Selon la plage prise en charge d'une propriété.
Target | [Modèle] | Architecture du système | Non modifié
Source | [la source] | [Toutes les variables] | Non modifié
ScanRate | [Vitesse de scrutation] | [Toutes les variables] | Selon les conventions de dénomination.
ScanRateInterval | [Intervalle] | [Toutes les vitesses de scrutation] | 1 - 600
AddressEnabled | [Adresse de base] (uniquement lorsqu'un tableau ou une structure est sélectionné). | [Toutes les variables] | Si la propriété est sélectionnée, affiche TRUE.
Address | [Adresse de l'équipement] | [Toutes les variables] | Selon la plage prise en charge d'une propriété.
HasBinding | Indique TRUE lors de l'utilisation d'un objet ou d'une autre variable dans la propriété de la variable. | [Toutes les variables] | TRUE/FALSE
VariableLength | [Longueur de la variable] | [Toutes les variables] | TRUE/FALSE
NumberOfBytes | [Nombre d'octets ou de mots] | [Toutes les variables] | Selon la plage prise en charge d'une propriété.
StringEncode | [Encodage de chaîne] (seulement lorsqu'un équipement est sélectionné dans [la source]). | [Toutes les variables] | Selon l'encodage pris en charge.
HasAlarm | Indique TRUE lorsqu'une variable est utilisée dans une alarme. | [Toutes les alarmes] | TRUE ou vide
AlarmType | Indique la limite lors de l'utilisation de la variable dans une alarme de niveau. | [Alarme de niveau] | Limit ou vide
***ThresholdState [1] | Indique l'activation lors de l'utilisation de la variable dans une alarme de niveau. | [Alarme de niveau] | Enable ou vide
***Threshold [1] | [Type d'alarme] | [Alarme de niveau] | HiHi/Hi/Lo/LoLo
***ThresholdValue [1] | [Valeur] | [Alarme de niveau] | Selon la plage prise en charge d'une propriété.
***ThresholdDeadBand [1] | [Bande morte] | [Alarme de niveau] | Selon la plage prise en charge d'une propriété.
***ThresholdAlarmGroup [1] | Indique le nom du groupe d'alarmes, y compris une variable. | [Alarme de niveau] | Selon les conventions de dénomination.
***ThresholdMessageMode [1] | Indique un paramètre de message | [Alarme de niveau] | Direct/Language Table
***ThresholdMessage [1] | [Message] | [Alarme de niveau] | Selon la plage prise en charge d'une propriété.
***ThresholdSeverity [1] | [Gravité] | [Alarme de niveau] | Selon la plage prise en charge d'une propriété.
***ThresholdParameter [1] | [Paramètre] | [Alarme de niveau] | Selon la plage prise en charge d'une propriété.
ThresholdState | [Condition de déclenchement] | [Alarme booléenne] | Enabled/Disable
ThresholdType | [Type d'alarme] | [Alarme booléenne] | Hi/Lo
ThresholdCondition | - | - | WhenHigh/WhenLow Non modifié
ThresholdAlarmGroup | Indique le nom du groupe d'alarmes, y compris une variable. | [Alarme booléenne] | Selon les conventions de dénomination.
ThresholdMessageMode | Indique un paramètre de message | [Alarme booléenne] | Direct/Language Table
ThresholdMessage | [Message] | [Alarme booléenne] | Selon la plage prise en charge d'une propriété.
ThresholdSeverity | [Gravité] | [Alarme booléenne] | Selon la plage prise en charge d'une propriété.
ThresholdParameter | [Paramètre] | [Alarme booléenne] | Selon la plage prise en charge d'une propriété.
DataSharing | [Partage de données] | [Toutes les variables] | None/ReadOnly/ReadWrite
LoggingGroup | Indique le nom du groupe lorsqu'une variable est utilisée dans la journalisation. | [Toutes les journalisations] | Selon les conventions de dénomination.
Comments | [Commentaires] | [Toutes les variables] | Selon les conventions de dénomination.
AlarmGroupId | Indique le nom du groupe d'alarme. | [Toutes les variables] | Selon les conventions de dénomination.

1. *** se réfère à HiHi, Hi, Lo ou LoLo.