Die XLSX-Datei muss einen bestimmten Aufbau aufweisen, 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. Sind keine übersetzten Anzeigenamen für ein Element vorhanden, so entfällt die Verwendung dieser Klammern.
Beispiel: Interne Namen und übersetzte Anzeigenamen einer Konfigurationsvariable
Hier sehen Sie die Konfigurationsvariable mit ihrem internen Namen
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.
Hinweise
- Bei einem Datenaustausch wird nur das erste Arbeitsblatt einer XLSX-Arbeitsmappe berücksichtigt.
Tipp:
Bei einem Datenaustausch über XLSX-Dateien 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.
Hier sehen Sie die Definition eines Konfigurators mit Namen
Hier sehen Sie die Darstellung im Project Builder:
Hier sehen Sie das Exportergebnis einer XLSX-Datei des Konfiguratorelements
| A | B | |
|---|---|---|
|
1 |
|
|
|
2 |
|
|
|
3 |
|
|
|
4 |
|
|
Hinweise
- 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.
Tipp:
Eine strukturell korrekte XLSX-Datei eines Konfiguratorelements lässt sich am einfachsten über die Funktion Export *.xlsx aus dem Project Builder erzeugen.
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.
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. Dabei steht in Spalte A 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 |
Hinweise
- 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 das Dropdown.
- Klicken Sie auf XLSX Datei.
- Geben Sie den gewünschten Namen und einen Speicherort für die zu exportierende Datei an.
- Klicken Sie auf Speichern.
- Die im Project Builder vorgenommene Konfiguration wird als XLSX-Datei exportiert.
Konfiguration als XLSX-Datei importieren
- Klicken Sie auf das Dropdown.
- Klicken Sie auf XLSX Datei.
- Wählen Sie die zu importierende Datei in ihrem Dateisystem aus.
- Bestätigen Sie den Dialog mit Öffnen.
- Der Konfigurator wird mit den Angaben aus der XLSX-Datei angereichert.
Hinweise
- Die Angaben in der XLSX-Datei zu Bezeichnung, Typ und Wert einer Konfigurationsvariable müssen zu den Elementen im Konfigurator passen. Stimmen die Angaben nicht überein, erhalten Sie eine entsprechende Fehlermeldung. Der Import wird trotz Fehlermeldung nach Möglichkeit fortgesetzt.
- Die Angaben, die bereits im Konfigurator getätigt wurden und in der zu importierenden Datei nicht enthalten sind, bleiben auch nach dem Import in der Eingabemaske des Project Builders erhalten.
- Bei einem Import wird nur das erste Arbeitsblatt einer XLSX- Arbeitsmappe berücksichtigt.