Austausch über XLSX
Allgemeine Voraussetzungen
- Sie haben den Project Builder aufgerufen.
- Sie haben eine Bibliothek geöffnet.
- Sie haben ein Zielprojekt ausgewählt und den Konfigurator geöffnet.
Voraussetzungen: Aufbau der XLSX-Datei
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. 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.
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.
Hinweis
Bei einem Datenaustausch wird nur das erste Arbeitsblatt einer XLSX-Arbeitsmappe berücksichtigt.
Beispiel: Konfiguratoren und Elemente
Definition eines Konfigurators mit Namen
Darstellung im Project Builder:
Hier sehen Sie das Exportergebnis einer XLSX-Datei des Konfiguratorelements
A | B | |
---|---|---|
1 |
|
|
2 |
|
|
3 |
|
|
4 |
|
|
Tipp
Die strukturell korrekte XLSX-Datei eines Konfiguratorelements lässt sich am einfachsten über die Funktion *.xlsx exportieren aus dem Project Builder erzeugen.
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.
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 |
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 *.xlsx exportieren.
- Geben Sie den Namen und einen Speicherort an.
- Klicken Sie auf Speichern.
- Die im Project Builder vorgenommene Konfiguration wird als XLSX-Datei exportiert.
Tipp
Ihre zuletzt ausgeführte Aktion wird gespeichert. Sie müssen keine erneute Auswahl über das Dropdown-Icon treffen, um die Aktion zu wiederholen.
Konfiguration als XLSX-Datei importieren
- Klicken Sie auf *.xlsx importieren.
- Wählen Sie eine Datei aus.
- Klicken Sie auf Öffnen.
- Der Konfigurator wird mit den Angaben aus der XLSX-Datei angereichert.
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 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.