Trennzeichen

Ein Trennzeichen trennt verschiedene Felder in derselben Zeile voneinander. Sie können Felder mit beliebigen ASCII-Zeichen trennen, die nicht in den Namen oder Werten der zu importierenden Attribute vorkommen. Sie können mehrere alternative Trennzeichen in derselben Eingabedatei verwenden. Als Trennzeichen werden häufig das Komma, der Tabulatorschritt, das Semikolon und das Leerzeichen verwendet.

Feld- und Wertdefinitionen

Die erste Zeile der Eingabedatei ist die Kopfzeile (auch Header genannt). Sie enthält die in der Eingabedatei verwendeten Felder. Alle anderen Zeilen in der Eingabedatei enthalten die Werte für diese Felder.

Die erste Zeile muss mindestens ein Schlüsselfeld enthalten, das die Modellobjekte oder Zeichnungen identifiziert, und mindestens einen benutzerdefinierten Attributnamen, der ein benutzerdefiniertes Attributfeld identifiziert, in das Sie neue Werte importieren möchten. Beachten Sie, dass die Namen vieler Felder von den Feldbezeichnungen abweichen, die in der Benutzeroberfläche angezeigt werden. Die benutzerdefinierten Attributnamen werden in Dateien namens objects.inp definiert, die für das Modell gelten (siehe Referenz der Dateiinhalte).

Die Konfigurationsdatei import_macro_data_types.dat (die weiter oben erläutert wird) definiert, welche Felder Sie im Attributimport verwenden können und welcher Datentyp für jeden Attributtyp verwendet werden kann. Es ist nicht möglich, Schlüsselfelder hinzuzufügen oder zu ändern. Aber Sie können den Satz der benutzerdefinierten Attribute bearbeiten. Werte werden als Zeichenfolgen (Text) importiert, es sei denn, ein anderer Datentyp wird für das Attribut in der Datei import_macro_data_types.dat definiert.

Verfügbare Schlüsselfelder

Es gibt die folgenden Schlüsselfelder für Modellobjekte:

Es gibt die folgenden Schlüsselfelder für Zeichnungsobjekte:

Leere Werte

Es ist möglich, dass einige Zeilen in der Eingabedatei keinen Wert für alle Attributfelder enthalten (es gibt möglicherweise zwei oder mehr aufeinanderfolgende Trennzeichen zwischen den Werten). Diese leeren Werte können entweder während des Imports übersprungen werden, ohne Änderungen an benutzerdefinierten Attributen vorzunehmen, oder Sie können diese leeren Werte verwenden, um vorhandene benutzerdefinierte Attributwerte in Ihrem Modell zu löschen. Standardmäßig werden leere Werte übersprungen. Um stattdessen vorhandene Werte zu löschen, stellen Sie die erweiterte Option XS_ERASE_UDA_VALUE_WITH_ATTRIBUTE_IMPORT_NULL_AND_BLANK in einer INI-Datei auf TRUE ein.

Einlese-Reihenfolge

Tekla Structures liest die Eingabedatei zeilenweise ab der ersten Zeile ein. Wenn es in späteren Zeilen doppelte Schlüsselfelder gibt, wird nur das erste Vorkommen importiert.

Dateipfad

Die Standarddatei befindet sich im Unterordner system des Umgebungsordners, z. B. C:\ProgramData\Trimble\Tekla Structures\<version>\environments\common\system. Es gibt möglicherweise eine lokalisierte Version der Datei in der Umgebung, die Sie verwenden.

Nehmen Sie keine Änderungen an den Standarddateien vor. Erstellen Sie stattdessen eine Kopie der Datei, und speichern Sie diese an einem anderen Speicherort, z. B. im Firmenordner oder im Unterordner attributes im Modellordner. Auf diese Weise werden Ihre Änderungen nicht überschrieben, wenn Sie Tekla Structures neu installieren oder aktualisieren. Wenn die Datei an mehreren Speicherorten vorliegt, wird die Standardsuchreihenfolge für Ordner befolgt und nur die erste gelesene Datei wird verwendet.

Dateiinhalt

Die Datei import_macro_data_types.dat ist eine reine Textdatei. Sie können die Datei mit einem beliebigen Standard-Texteditor wie Microsoft Notepad bearbeiten.

Jede Zeile in der Datei enthält eine Felddefinition, die die folgenden Attribute in dieser Reihenfolge enthalten kann:

User-defined attribute name,Data type,Conversion factor,Comments

1. User-defined attribute name. Geben Sie den Namen des internen Felds wie in einer objects.inp-Datei definiert an.

   Für die objects.inp-Definition attribute("USER_FIELD_1", "j_user_field_1", string, "%s", no, none, "0.0", "0.0") lautet der Name des benutzerdefinierten Attributs zum Beispiel USER_FIELD_1.

2. Data type.

   Möglichkeiten für den Wert: INT (Ganzzahl), STRING (Text), FLOAT (Dezimalzahl) oder DATE (Datumsfelder mit einem Kalender-Widget). Wenn der Wert fehlt oder falsch ist, wird der Standardwert STRING verwendet.

   Ein Werttypkonflikt verhindert den Datenimport zwar nicht, aber die Ergebnisse sind je nach Daten und Feld möglicherweise nicht immer korrekt. Beispielsweise können Datumsfelder falsch eingestellt werden, wenn der Datentyp nicht DATE ist. Andererseits können Sie eine Zahl mit dem Datentyp Ganzzahl ohne Probleme in ein Textfeld importieren.

   Felder mit Optionslisten werden als Zahlenfelder mit dem Werttyp INT definiert. Beispielsweise können Objektsperren auf Nein, Ja und Organisation eingestellt werden, indem in der Eingabedatei die zugehörigen Ziffern 0, 1 und 2 verwendet werden.

3. Conversion factor (optional, nur FLOAT). Zur Konvertierung von imperialen Werten in metrische Werte in imperialen Umgebungen.

   Anmerkung:

   Wir empfehlen eine Überprüfung der FLOAT-Werte zur Vermeidung von Umrechnungsfehlern.

4. Comment (optional). Alle Zeichen, die den oben genannten Definitionen folgen, werden ignoriert und können für Kommentare verwendet werden. Kommentieren Sie nicht zu viel, da die Datei einfacher lesbar ist, wenn Kommentare in einer separaten Zeile stehen (siehe unten).

Tekla Structures behandelt Zeilen, die mit einem doppelten Schrägstrich (//) beginnen, als Kommentarzeilen und ignoriert diese beim Lesen der Datei.

Beispiele:

//Regular attributes

R1_ISSUED_FOR_APPRL, STRING
R1_DATE_APPROVED, DATE

//Attribute with conversion factor and comment

shear1, FLOAT, 4448.2222, For kips

Beispiel: Importdatei für Teile

In dieser Eingabedatei werden Tabulatoren als Trennzeichen verwendet.

ASSEMBLY_POS und PHASE sind die Schlüsselfelder. Tekla Structures fügt Baugruppen mit Werten, die in den Spalten ASSEMBLY_POS und PHASE enthalten sind, verschiedene benutzerdefinierte Attribute hinzu.

Eine Baugruppe mit der Baugruppennummer (ASSEMBLY_POS) B5 in Phase 1 erhält beispielsweise folgende benutzerdefinierte Attribute:

STATUS: 3

USER_PHASE: 6

USER_ISSUE: 3/25/2019

ASSEMBLY_POS  PHASE  STATUS  USER_PHASE  USER_ISSUE
B1  1  7  3  3/25/2019
B2  1  7  3  3/25/2019
B3  1  7  3  3/25/2019
B4  1  7  3  3/25/2019
B5  1  3  6  3/25/2019
B1  1  3  5  3/26/2019
B2  2  3  4  3/26/2019

Die Eingabedatei enthält zwei Einträge für B1. In diesem Fall schreibt Tekla Structures die Meldung „>Doppelte Eingabe in Eingabedatei“ in die Logdatei und importiert nur den ersten Eintrag in der Datei. Somit weist B1 nach dem Attributimport in diesem Beispiel folgende benutzerdefinierte Attribute auf:

STATUS: 7

USER_PHASE: 3

USER_ISSUE: 3/25/2019

Beispiel einer Eingabedatei für Zeichnungen

In dieser Eingabedatei werden Tabulatoren als Trennzeichen verwendet.

TYPE und NAME sind die Schlüsselfelder. Tekla Structures fügt einen Wert für das benutzerdefinierte Attribut User field 4 zu Zeichnungen mit Werten hinzu, die in den Spalten TYPE und NAME enthalten sind.

Eine Zeichnung mit TYPE A (Baugruppenzeichnung) und NAME B.2 erhält den Wert 4 in User field 4.

TYPE  NAME  DRAWING_USERFIELD_4
A  B.1  3
A  B.2  4
A  C.1  1
A  C.2  2