Trennzeichen in Eingabedateien

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 in Eingabedateien

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 über das Auslesen der Datei).

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 für Eingabedateien

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

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

Leere Werte in Eingabedateien

Einige Zeilen in der Eingabedatei enthalten möglicherweise keinen Wert für alle Attributfelder. Beispielsweise kann es zwei oder mehr aufeinanderfolgende Trennzeichen zwischen Werten geben.

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, setzen Sie die erweiterte Option XS_ERASE_UDA_VALUE_WITH_ATTRIBUTE_IMPORT_NULL_AND_BLANK auf TRUE in einer ini.-Datei.

Lesereihenfolge für Eingabedateien

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.

Speicherort der Datendateien

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

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 bei einer erneuten Installation oder Aktualisierung von Tekla Structures nicht überschrieben. Wenn sich dieselbe Datei an mehreren Speicherorten befindet, wird die Standardsuchreihenfolge für Ordner befolgt und nur die erste gelesene Datei wird verwendet.

Inhalt von Datendateien

Die Datei import_macro_data_types.dat ist eine reine Textdatei. Sie können die Datei mit jedem 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 zwar nicht den Datenimport, verursacht jedoch je nach Daten und Feld möglicherweise fehlerhafte Ergebnisse. Datumsfelder können beispielsweise fehlerhaft eingestellt sein, wenn der Datentyp nicht DATE entspricht. In ein Textfeld können hingegen problemlos ganze Zahlen importiert werden.

   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 den vorangegangenen Definitionen entsprechende Zeichen werden ignoriert und können für Kommentare verwendet werden. Es wird jedoch davon abgeraten, Kommentare der Zeile für Definitionen hinzuzufügen. Die Datei ist besser lesbar, wenn die Kommentare gemeinhin in separate Zeilen geschrieben werden.

Tekla Structures behandelt Zeilen mit doppelten Schrägstrichen (//) am Anfang als Kommentare und ignoriert die gesamte Zeile 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-Eingabedatei für Teile

In dieser Eingabedatei werden Tabulatoren als Trennzeichen verwendet.

Bei ASSEMBLY_POS und PHASE handelt es sich um die Schlüsselfelder. Tekla Structures fügt den Baugruppen mehrere benutzerdefinierte Attribute mit Werten hinzu, die mit denen der Spalten ASSEMBLY_POS und PHASE übereinstimmen.

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-Eingabedatei für Zeichnungen

In dieser Eingabedatei werden Tabulatoren als Trennzeichen verwendet.

Bei TYPE und NAME handelt es sich um die Schlüsselfelder. Tekla Structures fügt den Zeichnungen das benutzerdefinierte Attribut User field 4 mit Werten hinzu, die denen der Spalten TYPE und NAME entsprechen.

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

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