CSV2UDA
Zweck und Beschreibung
Das Tool CSV2UDA ermöglicht den automatisierten Import von Massendaten aus externen Quellen (wie z. B. ERP-Systemen, SAP-Exporten oder Excel-Listen) in die benutzerdefinierten Attribute (UDAs) der Bauteile eines Tekla Structures-Modells.
Back to topSystemanforderungen
- Installierte Version von Tekla Structures (kompatibel mit der heruntergeladenen Version aus dem Tekla Warehouse).
- Windows-Betriebssystem.
- Eine sauber formatierte CSV-Datei (Comma-Separated Values) als Datenquelle.
Installation von CSV2UDA
Führen Sie die folgenden Schritte aus, um die Erweiterung zu installieren:
- Laden Sie die Erweiterung (
.tsep-Datei) aus dem Tekla Warehouse herunter. - Doppelklicken Sie auf die heruntergeladene
.tsep-Datei, um den Extension Manager (Erweiterungsmanager) von Tekla Structures zu öffnen. - Wählen Sie die Tekla Structures-Versionen aus, in die Sie das Tool importieren möchten.
- Klicken Sie auf Importieren (Import).
- Starten Sie Tekla Structures neu, damit die Installation abgeschlossen und das Tool im Katalog geladen wird.
Verwendung von CSV2UDA
Im folgenden Beispiel nutzen wir eine SAP-Exportdatei (Example.csv), um den Abstandhaltern im Tekla-Modell eine SAP-Artikelnummer und eine Mengeneinheit zuzuweisen.
So verwenden Sie die Erweiterung:
- Öffnen Sie Ihr Tekla Structures-Modell.
- Öffnen Sie auf der rechten Seite den Katalog Anwendungen und Komponenten (Applications & Components).
- Suchen Sie nach CSV2UDA und starten Sie das Tool per Doppelklick.
- Klicken Sie im Tool auf die Schaltfläche zum Durchsuchen (Browse) und wählen Sie Ihre Datei
Example.csvaus. - Geben Sie unter Delimiter (Trennzeichen) das Semikolon
;ein und laden Sie die Datei. - Schlüssel festlegen (Key): Wählen Sie unter den CSV-Spalten den Eintrag
Bezeichnung(z. B. "Abstandhalter Beton C 20 mm") und weisen Sie ihm das Tekla-GegenstückNAMEoderPROFILEzu. - Mapping durchführen: * Spalte
SAP-NR.-> Tekla-UDA:ARTICLE_NUMBER(oderUSER_FIELD_1) -> Typ:String(Text).- Spalte
BasME-> Tekla-UDA:UNIT(oderUSER_FIELD_2) -> Typ:String.
- Spalte
- Markieren Sie im Modell die Bauteile, die aktualisiert werden sollen (oder drücken Sie
Strg + Afür das gesamte Modell). - Klicken Sie auf Update (Aktualisieren) oder Write (Schreiben), um den Datenimport zu starten.
CSV2UDA Einstellungen
Hier sind die wichtigsten Eigenschaften der Benutzeroberfläche detailliert beschrieben:
| Eigenschaft | Beschreibung |
|---|---|
| File Path / Browse | Der Dateipfad zu Ihrer ausgewählten CSV-Datei. |
| Delimiter | Das Trennzeichen, das in Ihrer CSV-Datei verwendet wird (meistens ; oder ,). Zwingend erforderlich für das korrekte Einlesen der Spalten. |
| Key Column (CSV) | Die Spalte aus der CSV-Datei, die als eindeutiges Identifikationsmerkmal (Schlüssel) dient. |
| Tekla Property | Die entsprechende Eigenschaft im Tekla-Modell, die mit dem Schlüssel aus der CSV-Datei verglichen wird (z. B. GUID, NAME, ASSEMBLY_POS). |
| Mapping Table | Die Tabelle, in der die restlichen CSV-Spalten den internen Tekla-UDA-Namen und Datentypen (String, Integer, Float) zugeordnet werden. |
Back to top
Anpassung von CSV2UDA
Eine direkte Anpassung des Tools ist in der Regel nicht erforderlich. Die wichtigste "Anpassung" findet bei der Vorbereitung Ihrer CSV-Datei statt:
- Datenbereinigung: CSV-Exporte (wie das SAP-Beispiel) enthalten oft doppelte Zeilen. Bereinigen Sie diese vorab in Excel (Daten > Duplikate entfernen), um die Verarbeitungsgeschwindigkeit in Tekla zu erhöhen.
- Leerzeichen: Achten Sie darauf, ob Ihre Werte Leerzeichen enthalten (z. B.
220 5400). Wenn ja, müssen diese alsString(Text) im Tool konfiguriert werden, da es sonst zu Fehlern bei der Umwandlung in reine Zahlenformate kommt.
Zusätzliche Informationen
- Bekannte Probleme & Einschränkungen: * Das Tool erfordert zwingend den internen, englischen Variablennamen eines UDAs (z. B.
commentanstatt "Kommentar"). Sie können diese internen Namen über die Dateiobjects.inpin Ihrer Tekla-Umgebung herausfinden. - Wenn die CSV-Datei während des Imports noch in Microsoft Excel geöffnet ist, kann es zu einer Fehlermeldung kommen, da Excel die Datei blockiert. Schließen Sie die Datei vor dem Import.
- Bauteile, die im Modell markiert sind, aber nicht in der CSV-Datei vorkommen, werden vom Tool ignoriert und nicht verändert.
Diskussionsforum
Im Diskussionsforum finden sie weitere Informationen und auch eine csv-Beispieldatei.
https://forum.tekla.com/index.php?/topic/12663-csv-2-uda/
Back to top