# Exportieren und Importieren von Variablen

In der Bildschirmbearbeitungs-Software können Export- und Importvorgänge über die Symbolleiste des Variableneditors ausgeführt werden. Die Eigenschaften von Alarmen und Protokollieren sind als Teil der Exportelemente eingeschlossen. Das Exportieren und Importieren lokaler Variablen wird nicht unterstützt.

Hinweis:

- Auch wenn Sie Daten, die als CSV- oder TXT-Dateien aus der Bildschirmbearbeitungs-Software Version 3.3 Service Pack 1 oder früher exportiert wurden, in die Bildschirmbearbeitungs-Software Version 3.4 oder später importieren können, können Dateien, die aus Version 3.4 oder später exportiert wurden, nicht in Version 3.3 Service Pack 1 oder früher importiert werden, da die Dateiversion 2.0 ist.
  Überprüfen Sie die Dateiversion der CSV- oder TXT-Ausgaben in der Zeile [FileVersion] der Ausgabedatei.
- Excel-Dateien werden ab Version 4.4 für den Export und Import von Variablen unterstützt.

Für den Im- und Export von Variablen werden folgende Dateiformate unterstützt:

- TXT-Datei (.txt, UTF-8 (ohne BOM))
- CSV-Datei (.csv, UTF-8 (ohne BOM))
- Microsoft Excel-Datei (.xlsx)

Hinweis:

Microsoft Excel-Datei

- Um Variablen aus bzw. in Excel-Dateien zu exportieren bzw. zu importieren, ist Microsoft Excel erforderlich. Die Bildschirmbearbeitungs-Software unterstützt Microsoft Excel 2016, 2019 und 365.
- Wenn Sie Variablen in eine Excel-Datei importieren, können Sie ein Kennwort festlegen, um sie zu verschlüsseln. Es wird empfohlen, ein komplexes Passwort festzulegen. Ein verloren gegangenes Passwort kann nicht wiederhergestellt werden.
- Excel Information Rights Management (IRM) wird von der Bildschirmbearbeitungs-Software nicht unterstützt.

TXT- oder CSV-Datei

- Wählen Sie beim Export von Variablen in eine TXT- oder CSV-Datei das Trennzeichen aus.
- TXT- oder CSV-Dateien, die mit einer anderen Kodierung als UTF-8 (ohne BOM) gespeichert wurden, können nicht importiert werden.
- Informationen zu Dateiformaten erhalten Sie unter:
  Dateieinstellungen Daten speichern (Export)

Die exportierte Datei kann mithilfe eines Softwareprogramms wie Microsoft Excel angezeigt werden.

Hinweis:

Die Datenausgabe ist wie folgt formatiert:

- Zeichenfolgen werden mit doppelten Anführungszeichen (") angegeben.
  Beispiel: "Dies ist eine Zeichenkette"
- Sonderzeichen "=", "+", "-", "@", TAB und EINGABE, die am Anfang eines Eintrags stehen, werden mit einem einfachen Anführungszeichen (') versehen.
  Beispiel: "'=1+2"

## Hinweise zum Importieren von Variablen

- Wenn beim Importieren keine gleichnamige Abtastrate vorhanden ist, wird eine neue Abtastrate mit dem Intervall aus der exportierten Datei erstellt. Wenn die Abtastrate bereits im Projekt vorhanden ist, wird sie aktualisiert.
- Wenn Sie eine Datei importieren, die aus der Bildschirmbearbeitungs-Software Version 3.1 Service Pack 1B oder früher exportiert wurde, wird externen Variablen die Standard-Abtastrate zugewiesen. Informationen zu Abtastraten erhalten Sie unter:
  Einstellen des Intervalls zum Lesen externer Variablenwerte (Abtastrate)
- Variablen, die per Symboldatei-Import importiert wurden, können nicht mit dem Befehl „Variable importieren“ aktualisiert werden. Informationen zur Aktualisierung der Variablen in der Symboldatei erhalten Sie unter:
  Importieren von Symbolen von externen Geräten - Nach dem Importieren der Symboldatei
- Sie können keine Variablen in ein Projekt importieren, das eine Symboldatei enthält. Um Variablen zu importieren, gehen Sie folgendermaßen vor:
  1. Entfernen Sie die Symboldatei aus dem Projekt.
  2. Exportieren Sie die Variablen aus dem Projekt.
  3. Importieren Sie die Variablen in das Projekt.
  4. Importieren Sie die Symboldatei in das Projekt.

- In der Bildschirmbearbeitungs-Software besteht eine Namenskonvention für Variablennamen.
  Wenn ein Variablenname Zeichen enthält, die nicht der Namenskonvention entsprechen, wird die Variable nicht importiert.
  Weitere Informationen erhalten Sie unter:
  Namenskonventionen

### Importieren einer Excel-Datei

- Beim Import einer geschützten Excel-Datei muss das Passwort eingegeben werden.
- Es werden nur Werte aus Excel-Dateien importiert. Makros und Formeln werden beim Import nicht neu berechnet.
- Die FileVersion auf dem Blatt [Summary] wird beim Import überprüft. Die anderen Zählwerte werden ignoriert.
- Die maximale Dateigröße, die importiert werden kann, beträgt 100 MB.

## Variablenformat

### Struktur der exportierten Excel-Datei

In der exportierten Excel-Datei sind die Daten in folgende Blätter, die jeweils spezifische Informationen enthalten, unterteilt:

- Summary: Übersicht über alle exportierten Variablen.
- VariableTypes: Variablentypen wie Feld oder Struktur, falls vorhanden.
- Variables: Variablendaten.
- ScanRates: Abtastraten, falls vorhanden.
- AlarmGroups: Alle Alarmgruppen, auch wenn keine Alarme festgelegt sind.
- Alarms: Alarme, falls vorhanden.
- LoggingGroups: Alle Protokollierungsgruppen, auch wenn sie keine Variablen enthalten.
- LoggingRecords: Variablen, falls vorhanden.

Beispiel: Variables Blatt

Hinweis:

- Lediglich die Daten in blau können bearbeitet werden. Wenn das Format geändert wird, kann die Datei nicht importiert werden. Alle Spalten sind erforderlich.
- Blätter und Spalten können in beliebiger Reihenfolge angeordnet werden.

### Struktur der exportierten CSV-Datei

Wenn Sie die exportierte CSV-Datei in Excel öffnen, ist sie wie unten dargestellt aufgebaut.

Hinweis: Lediglich die Daten in blau können bearbeitet werden. Wenn das Format geändert wird, kann die Datei nicht importiert werden.

###

## Exportelemente

Diese Tabelle zeigt eine Eigenschaft an, die dem Exportelement entspricht.

Elemente, für die keine Eigenschaft eingerichtet wurde, erscheinen leer.

### Elemente der exportierten Excel-Datei

[VariableTypes]

Elemente | Eigenschaft | Position innerhalb der Eigenschaft | Verfügbarer Wert
Name | [Name] | [Alle Benutzerdatentypen] | Entsprechend der Namenskonventionen.
Type | [Datentyp] | [Alle Benutzerdatentypen] | Entsprechend des unterstützten Datentyps.
ElementTypeName | Gibt den Datentyp eines Feldelements oder eines Strukturelements an. | [Alle Benutzerdatentypen] | Entsprechend des unterstützten Datentyps.
Dimensions | [Dimension] | [Alle Benutzerdatentypen] | Entsprechend des unterstützten Eigenschaftsbereiches.

[Variables]

Elemente | Eigenschaft | Position innerhalb der Eigenschaft | Verfügbarer Wert
Name | [Name] | [Alle Variablen] | Entsprechend der Namenskonventionen.
FolderName | [Ordner] | [Alle Variablen] | Entsprechend der Namenskonventionen.
DataType | [Datentyp] | [Alle Variablen] | Entsprechend des unterstützten Datentyps.
Dimension | [Dimension] | [Alle Variablen] | Entsprechend des unterstützten Eigenschaftsbereiches.
Source | [Quelle] | [Alle Variablen] | Keine Bearbeitung
DeviceAddress | [Geräteadresse] | [Alle Variablen] | Entsprechend des unterstützten Eigenschaftsbereiches.
BaseAddress | [Basisadresse] (nur bei Auswahl von Feld oder Struktur) | [Alle Variablen] | TRUE/FALSE
ScanRate | [Abtastrate] | [Alle Variablen] | Entsprechend der Namenskonventionen.
InitialValue | [Initialwert] | [Alle Variablen] | Entsprechend des unterstützten Eigenschaftsbereiches.
InputRange | [Bereich überschreiben] | [Alle Variablen] | TRUE/FALSE
Min | [Minimum] | [Alle Variablen] | Entsprechend des unterstützten Eigenschaftsbereiches.
Max | [Maximum] | [Alle Variablen] | Entsprechend des unterstützten Eigenschaftsbereiches.
EnableVariableLength | [Variablenlänge] | [Alle Variablen] | TRUE/FALSE
NumberOfBytes/NumberOfWords | [Anzahl Bytes] (nur bei Auswahl von STRING) / [Anzahl Wörter] (nur bei Auswahl von WSTRING) | [Alle Variablen] | Entsprechend des unterstützten Eigenschaftsbereiches.
StringEncode | [Zeichenfolgencodierung] (nur bei Auswahl des externen Geräte von [Quelle].) | [Alle Variablen] | Entsprechend der unterstützten Codierung.
Retentive | [Remanent] | [Alle Variablen] | TRUE/FALSE
Value | [Wert] | [Alle Variablen] | Entsprechend der Namenskonventionen.
BindingType | Gibt den Typ zugewiesener Daten an. | Eigenschaftsauswahl-Fenster für Variableneigenschaft. | Nur Objekte, die in einer Eigenschaft festgelegt werden können.
BindingMode | [Richtung] | Eigenschaftsauswahl-Fenster für Variableneigenschaft. | OneWay/TwoWay
BindingConverter | [Konverter] | Eigenschaftsauswahl-Fenster für Variableneigenschaft. | Entsprechend der Namenskonventionen.
DataSharing | [Gemeinsame Datennutzung] | [Alle Variablen] | None/ReadOnly/ReadWrite
Comments | [Kommentare] | [Alle Variablen] | Entsprechend der Namenskonventionen.

[ScanRates]

Elemente | Eigenschaft | Position innerhalb der Eigenschaft | Verfügbarer Wert
Name | [Name] | [Alle Abtastraten] | Entsprechend der Namenskonventionen.
Interval | [Intervall (100 ms)] | [Alle Abtastraten] | 1 - 600

[AlarmGroups]

Elemente | Eigenschaft | Position innerhalb der Eigenschaft | Verfügbarer Wert
Name | [Name] | [AlarmGroup] | Entsprechend der Namenskonventionen.
***LabelType [1] | Zeigt die Einstellung des Beschriftung an. | [AlarmGroup] | Direct/LanguageTable
***Label [1] | Gibt die Namen der Beschriftungen an. | [AlarmGroup] | Entsprechend des unterstützten Eigenschaftsbereiches.
Parameter | [Parameter] | [AlarmGroup] | Entsprechend des unterstützten Eigenschaftsbereiches.
AlarmBehavior | [Alarmverhalten] | [AlarmGroup] | Optional ACK/Mandatory ACK

1. *** bezieht sich auf LoLo, Lo, Hi, HiHi, Active, ACK, RTN, oder UNACK.

[Alarms]

Elemente | Eigenschaft | Position innerhalb der Eigenschaft | Verfügbarer Wert
Variable | [Variablen] | [Bool-Alarm]/[Niveau-Alarm] | Entsprechend der Namenskonventionen.
AlarmGroupName | [Name] | [AlarmGroup] | Entsprechend der Namenskonventionen.
Type | [Alarmtyp] | [Bool-Alarm]/[Niveau-Alarm] | HiHi/Hi/Lo/LoLo
Condition | [Auslösebedingung] (BOOL-Alarm) / [Wert] (Niveau-Alarm) | [Bool-Alarm]/[Niveau-Alarm] | Wenn die Eigenschaft ausgewählt ist, wird TRUE für Bool-Alarm angezeigt. Niveau-Alarm folgt dem unterstützten Bereich der Eigenschaft.
Deadband | [Totband] | [Niveau-Alarm] | Entsprechend des unterstützten Eigenschaftsbereiches.
Severity | [Stufe] | [Bool-Alarm]/[Niveau-Alarm] | Entsprechend des unterstützten Eigenschaftsbereiches.
Parameter | [Parameter] | [Bool-Alarm]/[Niveau-Alarm] | Entsprechend des unterstützten Eigenschaftsbereiches.
MessageType | Gibt eine Meldungseinstellung an. | [Bool-Alarm]/[Niveau-Alarm] | Direct/Language Table
Message | [Meldung] | [Bool-Alarm]/[Niveau-Alarm] | Entsprechend des unterstützten Eigenschaftsbereiches.

[LoggingGroups]

Elemente | Eigenschaft | Position innerhalb der Eigenschaft | Verfügbarer Wert
Name | [Name] | [LoggingGroup] | Entsprechend der Namenskonventionen.
MaxRecord | [Max. Datensatz] | [LoggingGroup] | Entsprechend des unterstützten Eigenschaftsbereiches.
ConditionType | [Bedingungstyp] | [LoggingGroup] | ValueChange/Periodic/Script
Frequency | [Frequenz] (nur bei Auswahl von [Periodisch] unter [Bedingungstyp]) | [LoggingGroup] | Entsprechend des unterstützten Eigenschaftsbereiches.
Units | [Einheiten] (nur bei Auswahl von [Periodisch] unter [Bedingungstyp]) | [LoggingGroup] | Secs/Mins/Hours/100ms
Condition | [Ausführungsbedingung] (nur bei Auswahl von [Wertänderung] unter [Bedingungstyp]) | [LoggingGroup] | ON/OFF/On Change
TriggerVariable | [Auslösevariable] (nur bei Auswahl von [Wertänderung] unter [Bedingungstyp]) | [LoggingGroup] | Entsprechend der Namenskonventionen.
TriggerVariableBindingConverter | [Konverter] | Eigenschaftsauswahl-Fenster für Variableneigenschaft. | Entsprechend der Namenskonventionen.
InterlockType | Zeigt die Einstellung [Verriegelung] an. | [LoggingGroup] | Direct/Variable
Interlock | [Verriegelung] | [LoggingGroup] | TRUE/FALSE
InterlockBindingMode | [Richtung] | Eigenschaftsauswahl-Fenster für Variableneigenschaft. | OneWay/TwoWay
InterlockBindingConverter | [Konverter] | Eigenschaftsauswahl-Fenster für Variableneigenschaft. | Entsprechend der Namenskonventionen.
ExportData | [Aktivieren] | [LoggingGroup] | TRUE/FALSE
WriteDataTo | [Datenspeicherung] | [LoggingGroup] | USB Storage/SD Card/Internal
AppendDateTime | [Datum/Uhrzeit anhängen] | [LoggingGroup] | TRUE/FALSE
DetectModification | [Änderung erkennen] | [LoggingGroup] | TRUE/FALSE
FolderNameType | Zeigt die Einstellung [Ordnername] an. | [LoggingGroup] | Direct/Variable
FolderName | [Ordnername] | [LoggingGroup] | Entsprechend des unterstützten Eigenschaftsbereiches.
FolderNameBindingMode | [Richtung] | Eigenschaftsauswahl-Fenster für Variableneigenschaft. | OneWay/TwoWay
FolderNameBindingConverter | [Konverter] | Eigenschaftsauswahl-Fenster für Variableneigenschaft. | Entsprechend der Namenskonventionen.
FileNameType | Zeigt die Einstellung [Dateiname] an. | [LoggingGroup] | Direct/Variable
FileName | [Dateiname] | [LoggingGroup] | Entsprechend des unterstützten Eigenschaftsbereiches.
FileNameBindingMode | [Richtung] | Eigenschaftsauswahl-Fenster für Variableneigenschaft. | OneWay/TwoWay
FileNameBindingConverter | [Konverter] | Eigenschaftsauswahl-Fenster für Variableneigenschaft. | Entsprechend der Namenskonventionen.
ExportStatus | [Aktivieren] | [LoggingGroup] | TRUE/FALSE
SaveStatus | [Status speichern] | [LoggingGroup] | Entsprechend des unterstützten Eigenschaftsbereiches.
SaveStatusBindingMode | [Richtung] | Eigenschaftsauswahl-Fenster für Variableneigenschaft. | OneWay/TwoWay
SaveStatusBindingConverter | [Konverter] | Eigenschaftsauswahl-Fenster für Variableneigenschaft. | Entsprechend der Namenskonventionen.
ErrorStatus | [Fehlerstatus] | [LoggingGroup] | Entsprechend des unterstützten Eigenschaftsbereiches.
ErrorStatusBindingMode | [Richtung] | Eigenschaftsauswahl-Fenster für Variableneigenschaft. | OneWay/TwoWay
ErrorStatusBindingConverter | [Konverter] | Eigenschaftsauswahl-Fenster für Variableneigenschaft. | Entsprechend der Namenskonventionen.

[LoggingRecords]

Elemente | Eigenschaft | Position innerhalb der Eigenschaft | Verfügbarer Wert
VariableName | [Variablenname] | [Protokollierungsdatensätze] | Entsprechend der Namenskonventionen.
LoggingGroupName | [Name] | [LoggingGroup] | Entsprechend der Namenskonventionen.

### Elemente der exportierten CSV-Datei

Elemente | Eigenschaft | Position innerhalb der Eigenschaft | Verfügbarer Wert
Name | [Name] | [Alle Variablen] | Entsprechend der Namenskonventionen.
Type | [Datentyp] | [Alle Variablen] | Entsprechend des unterstützten Datentyps.
ElementType | Gibt den Datentyp eines Feldelements oder eines Strukturelements an. | [Alle Variablen] | Entsprechend des unterstützten Datentyps.
Dimensions | [Dimension] | [Alle Variablen] | Entsprechend des unterstützten Eigenschaftsbereiches.
InitialValue | [Initialwert] | [Alle Variablen] | Entsprechend des unterstützten Eigenschaftsbereiches.
RetentiveEnabled | [Remanent] | [Alle Variablen] | TRUE/FALSE
FolderName | [Ordner] | [Alle Variablen] | Entsprechend der Namenskonventionen.
BindType | Gibt den Typ zugewiesener Daten an. | Eigenschaftsauswahl-Fenster für Variableneigenschaft. | Nur Objekte, die in einer Eigenschaft festgelegt werden können.
BindObject | Gibt den Namen zugewiesener Daten an. | Eigenschaftsauswahl-Fenster für Variableneigenschaft. | Entsprechend der Namenskonventionen.
BindField | Gibt die Eigenschaft zugewiesener Daten an. | Eigenschaftsauswahl-Fenster für Variableneigenschaft. | Nur die Eigenschaft eines zugewiesenen Objekts.
BindIsArray | Gibt an, ob eine benutzerdefinierte Variable als Wert festgelegt ist. | Eigenschaftsauswahl-Fenster für Variableneigenschaft. | TRUE/FALSE
BindValue | - | - |
BindDirection | [Richtung] | Eigenschaftsauswahl-Fenster für Variableneigenschaft. | OneWay/Both
BindConverter | [Konverter] | Eigenschaftsauswahl-Fenster für Variableneigenschaft. | Entsprechend der Namenskonventionen.
HasInputRange | [Bereich überschreiben] | [Alle Variablen] | TRUE/FALSE
MinValue | [Minimum] | [Alle Variablen] | Entsprechend des unterstützten Eigenschaftsbereiches.
MaxValue | [Maximum] | [Alle Variablen] | Entsprechend des unterstützten Eigenschaftsbereiches.
Target | [Modell] | Systemarchitektur | Keine Bearbeitung
Source | [Quelle] | [Alle Variablen] | Keine Bearbeitung
ScanRate | [Abtastrate] | [Alle Variablen] | Entsprechend der Namenskonventionen.
ScanRateInterval | [Intervall] | [Alle Abtastraten] | 1 - 600
AddressEnabled | [Basisadresse] (nur bei Auswahl von Feld oder Struktur) | [Alle Variablen] | Wenn die Eigenschaft ausgewählt ist, wird TRUEangezeigt.
Address | [Geräteadresse] | [Alle Variablen] | Entsprechend des unterstützten Eigenschaftsbereiches.
HasBinding | Gibt TRUE an, wenn ein Objekt oder eine andere Variable in der Variableneigenschaft verwendet wird. | [Alle Variablen] | TRUE/FALSE
VariableLength | [Variablenlänge] | [Alle Variablen] | TRUE/FALSE
NumberOfBytes | [Anzahl Bytes/Wörter] | [Alle Variablen] | Entsprechend des unterstützten Eigenschaftsbereiches.
StringEncode | [Zeichenfolgencodierung] (nur bei Auswahl des externen Geräte von [Quelle]). | [Alle Variablen] | Entsprechend der unterstützten Codierung.
HasAlarm | Gibt TRUE an bei Verwendung der Variable in einem Alarm. | [Alle Alarme] | TRUE oder leer
AlarmType | Gibt die Begrenzung an, wenn die Variable in einem Niveau-Alarm verwendet wird. | [Niveau-Alarm] | Limit oder leer
***ThresholdState [1] | Gibt die Aktivierung an, wenn die Variable in einem Niveau-Alarm verwendet wird. | [Niveau-Alarm] | Enable oder leer
***Threshold [1] | [Alarmtyp] | [Niveau-Alarm] | HiHi/Hi/Lo/LoLo
***ThresholdValue [1] | [Wert] | [Niveau-Alarm] | Entsprechend des unterstützten Eigenschaftsbereiches.
***ThresholdDeadBand [1] | [Totband] | [Niveau-Alarm] | Entsprechend des unterstützten Eigenschaftsbereiches.
***ThresholdAlarmGroup [1] | Gibt den Alarmgruppennamen einschließlich Variable an. | [Niveau-Alarm] | Entsprechend der Namenskonventionen.
***ThresholdMessageMode [1] | Gibt eine Meldungseinstellung an. | [Niveau-Alarm] | Direct/Language Table
***ThresholdMessage [1] | [Meldung] | [Niveau-Alarm] | Entsprechend des unterstützten Eigenschaftsbereiches.
***ThresholdSeverity [1] | [Stufe] | [Niveau-Alarm] | Entsprechend des unterstützten Eigenschaftsbereiches.
***ThresholdParameter [1] | [Parameter] | [Niveau-Alarm] | Entsprechend des unterstützten Eigenschaftsbereiches.
ThresholdState | [Auslösebedingung] | [Bool-Alarm] | Enabled/Disable
ThresholdType | [Alarmtyp] | [Bool-Alarm] | Hi/Lo
ThresholdCondition | - | - | WhenHigh/WhenLow Keine Bearbeitung
ThresholdAlarmGroup | Gibt den Alarmgruppennamen einschließlich Variable an. | [Bool-Alarm] | Entsprechend der Namenskonventionen.
ThresholdMessageMode | Gibt eine Meldungseinstellung an. | [Bool-Alarm] | Direct/Language Table
ThresholdMessage | [Meldung] | [Bool-Alarm] | Entsprechend des unterstützten Eigenschaftsbereiches.
ThresholdSeverity | [Stufe] | [Bool-Alarm] | Entsprechend des unterstützten Eigenschaftsbereiches.
ThresholdParameter | [Parameter] | [Bool-Alarm] | Entsprechend des unterstützten Eigenschaftsbereiches.
DataSharing | [Gemeinsame Datennutzung] | [Alle Variablen] | None/ReadOnly/ReadWrite
LoggingGroup | Gibt den Gruppennamen an bei Verwendung einer Variable in der Protokollierung. | [Alle Protokollierungen] | Entsprechend der Namenskonventionen.
Comments | [Kommentare] | [Alle Variablen] | Entsprechend der Namenskonventionen.
AlarmGroupId | Gibt den Namen der Alarmgruppe an. | [Alle Variablen] | Entsprechend der Namenskonventionen.

1. *** verweist auf HiHi, Hi, Lo, oder LoLo.