XLSX-Dateien importieren und exportieren
Allgemeine Voraussetzungen
- Sie haben eine Bibliothek ausgewählt.
- Sie haben ein Projekt ausgewählt.
- Sie haben einen Konfigurator ausgewählt.
- Sie haben den Auswahlbereich Konfigurieren und erzeugen geöffnet.
Strukturelle Voraussetzungen
Die XLSX-Datei muss bestimmte Strukturelemente beinhalten, damit sie im Project Builder verwendet werden kann.
Um die Inhalte einer XLSX-Datei den im Project Builder vorhandenen Konfigurationsvariablen, Makro-Typicals und Typical-Gruppen zuordnen zu können, muss der interne Name des entsprechenden Elements in der XLSX-Datei vorhanden sein. Wenn ein übersetzter Anzeigename vorhanden ist, wird er daher um den technisch notwendigen, modell-internen Namen ergänzt. Der modell-interne Name wird von geschweiften Klammern { } umfasst. Wenn keine übersetzten Anzeigenamen für ein Element vorhanden sind, entfällt die Verwendung dieser Klammern.
Beispiel: Interner Name und übersetzter Anzeigename einer Konfigurationsvariable
- Konfigurationsvariable mit internem Namen
Var01 - Anzeigename der Konfigurationsvariable
Hier sehen Sie die Darstellung des internen Namens und des übersetzten Anzeigenamens der Konfigurationsvariable in einer XLSX-Datei:
| A | B | |
|---|---|---|
|
1 |
* |
|
|
2 |
|
|
|
3 |
* Die Zelle A1 einer XLSX-Datei ist für die Angabe des Konfiguratorelements reserviert.
Hinweis
- Bei einem Datenaustausch über eine XLSX-Datei wird nur das erste Arbeitsblatt der XLSX-Arbeitsmappe berücksichtigt.
- Bei einem Datenaustausch über eine XLSX-Datei sollte auf den Einsatz von geschweiften Klammern in den Anzeigenamen sowie auf Einträge in Auswahllisten von Konfigurationsvariablen verzichtet werden, da andernfalls die erforderliche Eindeutigkeit beim Import nicht gewährleistet ist.
Beispiel: Konfiguratoren und Elemente
- Darstellung eines Konfigurators mit Namen
Configurator im Designer - Darstellung der Konfigurationselemente
Element 1 undElement 2 im Designer
- Darstellung eines Konfigurators mit Namen
Configurator im Project Builder - Darstellung der Konfigurationselemente
Element 1 undElement 2 im Project Builder
Hier sehen Sie das Exportergebnis einer XLSX-Datei des Konfiguratorelements
| A | B | |
|---|---|---|
|
1 |
|
|
|
2 |
|
|
|
3 |
|
|
|
4 |
|
|
Ab Zeile 2 der XLSX-Datei folgen die Angaben zu den übergeordneten Konfigurationsvariablen. Die Spalte A enthält den Namen, und Spalte B den Wert für eine bestimmte Konfigurationsvariable. Als Name muss die exakte Bezeichnung der Konfigurationsvariable eingetragen werden. Der zu definierende Wert muss in der Variable zur Auswahl stehen und zum Datentyp passen. Die Reihenfolge der Variablen ist irrelevant.
Hinweis
Ein Konfiguratorelement muss nur während der Verwendung des Ruhemodus angegeben werden. Bei einem manuellen Import einer XLSX-Datei im Project Builder ist dies irrelevant. Der Inhalt der Zelle A1 in der XLSX-Datei wird in diesem Verwendungsfall nicht geprüft.
Beispiel: Grundlegende Struktur einer XLSX-Datei (ohne übersetzte Anzeigenamen)
| A | B | |
|---|---|---|
|
1 |
||
|
2 |
|
|
|
3 |
|
|
|
4 |
|
|
|
5 |
|
|
|
6 |
|
|
|
7 |
|
|
|
8 |
|
|
|
9 |
|
|
|
10 |
|
|
|
11 |
|
|
Beispiel: Grundlegende Struktur einer XLSX-Datei (mit übersetzten Anzeigenamen)
| A | B | |
|---|---|---|
|
1 |
||
|
2 |
|
|
|
3 |
|
|
|
4 |
|
|
|
5 |
|
|
|
6 |
|
|
|
7 |
|
|
|
8 |
|
|
|
9 |
|
|
|
10 |
|
|
|
11 |
|
|
Instanzen und ihre Konfigurationsvariablen
Instanzen werden mit einem Header eingeleitet. In Spalte A steht der Name des instanziierbaren Typicals, gefolgt von den Konfigurationsvariablen in den nachfolgenden Spalten. Die instanziierbaren Elemente samt ihrer Werte für die Konfigurationsvariablen stehen in den Zeilen unter dem Header. Der Abschluss eines Blocks von instanziierbaren Elementen muss durch eine Leerzeile erfolgen.
| A | B | C | |
|---|---|---|---|
|
1 |
|||
|
2 |
|||
|
3 |
|
|
|
|
4 |
|
|
|
|
5 |
|
|
|
|
6 |
|||
|
7 |
|
|
|
|
8 |
|
|
|
|
9 |
Hinweis
Der einleitende Header wird in der Tabelle lediglich zur Verdeutlichung fett dargestellt. Im Allgemeinen haben Formatierungen keinen Einfluss auf die Verarbeitung einer XLSX-Datei durch den Project Builder.
Beispiel: Struktur einer XLSX-Datei zur Konfiguration von Instanzen (ohne übersetzte Anzeigenamen)
| A | B | C | |
|---|---|---|---|
|
1 |
|||
|
2 |
|||
|
3 |
|
|
|
|
4 |
|
|
|
|
5 |
|
|
|
|
6 |
|
|
|
|
7 |
|||
|
8 |
|
||
|
9 |
|
||
|
10 |
Konfiguration als XLSX-Datei exportieren
- Klicken Sie auf Als XLSX exportieren.
- Geben Sie den Namen und einen Speicherort an.
- Klicken Sie auf Speichern.
- Die Konfiguration wird exportiert.
Ihre Auswahl wird für den nächsten Export gespeichert.
Konfiguration als XLSX-Datei importieren
- Klicken Sie auf XLSX-Datei importieren.
- Wählen Sie eine Datei aus.
- Klicken Sie auf Öffnen.
- Die Konfiguration wird importiert.
Hinweis
- Die Angaben in der XLSX-Datei zu Bezeichnung, Typ und Wert einer Konfigurationsvariable müssen zu den Elementen im Konfigurator passen. Wenn die Angaben nicht übereinstimmen, erhalten Sie eine entsprechende Fehlermeldung. Der Import wird nach Möglichkeit fortgesetzt.
- Die Angaben, die im Konfigurator bereits getätigt wurden und in der importierten Datei nicht enthalten sind, werden nicht überschrieben.
- Bei einem Datenaustausch über eine XLSX-Datei wird nur das erste Arbeitsblatt der XLSX-Arbeitsmappe berücksichtigt.