Delimitatori

Un delimitatore è un carattere che separa i diversi campi sulla stessa linea. È possibile delimitare i campi con qualsiasi carattere ASCII che non viene visualizzato nei nomi o nei valori degli attributi che si stanno importando. È possibile utilizzare diversi delimitatori alternativi nello stesso file di input. I caratteri di delimitazione comuni includono virgola, tabulazione, punto e virgola e spazio.

Definizioni di campi e valori

Nel file di input, la prima linea è un'intestazione che definisce i campi per il resto del file di input. Tutte le altre linee nel file di input contengono i valori per i campi denominati nella prima linea.

La prima linea deve contenere almeno un campo chiave che identifichi gli oggetti del modello o i disegni e almeno un nome di attributo utente che identifichi un campo attributo utente nel quale importare i nuovi valori. I nomi di molti dei campi sono diversi dalle etichette dei campi visualizzate nell'interfaccia utente. I nomi dei attributo utente sono definiti nei file objects.inp che si applicano al modello ( vedere il riferimento su come leggere il file ).

Il file di configurazione import_macro_data_types.dat (che viene spiegato più avanti) definisce i campi che è possibile utilizzare nell'importazione degli attributi e il tipo di dati di ciascun attributo. Non è possibile aggiungere o modificare i campi chiave, tuttavia è possibile modificare l'insieme di attributi utente. I valori vengono importati come stringhe (testo) a meno che non venga definito un tipo di dati diverso per l'attributo nel file import_macro_data_types.dat.

Campi chiave disponibili

I campi chiave per gli oggetti del modello sono:

I campi chiave per gli oggetti del disegno sono:

Valori vuoti

È possibile che alcune linee nel file di input non abbiano un valore per tutti i campi degli attributi (possono essere presenti due o più caratteri di delimitazione consecutivi tra i valori). Questi valori vuoti possono essere ignorati durante l'importazione senza apportare modifiche agli attributi utente oppure è possibile utilizzare questi valori vuoti per cancellare i valori di attributo utente esistenti nel modello. Di default, i valori vuoti vengono ignorati. Per cancellare i valori esistenti, impostare l'opzione avanzata XS_ERASE_UDA_VALUE_WITH_ATTRIBUTE_IMPORT_NULL_AND_BLANK su TRUE in un file ini.

Ordine di lettura

Tekla Structures legge il file di input in ordine a partire dalla prima linea. Se sono presenti campi chiave duplicati nelle linee successive, viene importata solo la prima occorrenza.

Posizione file

Il file di dati di default si trova nella cartella system della cartella ambiente, ad esempio, C:\ProgramData\Trimble\Tekla Structures\<version>\environments\common\system. Può inoltre essere presente una versione localizzata del file nell'ambiente utilizzato.

Non apportare modifiche ai file di default. Creare invece una copia del file e memorizzarla in una posizione diversa, ad esempio, nella cartella azienda o nella cartella attributes della cartella modello. In questo modo, le modifiche non vengono sovrascritte quando si reinstalla o si aggiorna Tekla Structures. Quando il file è presente in più posizioni, viene seguito l'ordine di ricerca delle cartelle di default e viene utilizzato solo il primo file letto.

Contenuto file

Il file import_macro_data_types.dat è di testo normale. È possibile modificare il file utilizzando un qualunque editor di testo standard, ad esempio, Blocco note di Microsoft.

Ciascuna riga nel file è una definizione di campo che può contenere i seguenti attributi nell'ordine seguente:

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

1. User-defined attribute name. Scrivere il nome del campo interno come definito per il campo in un file objects.inp.

   Ad esempio, nella definizione objects.inp attribute("USER_FIELD_1", "j_user_field_1", string, "%s", no, none, "0.0", "0.0") , il nome dell'attributo utente è USER_FIELD_1.

2. Data type.

   Il valore può essere: INT (numero intero), STRING (testo), FLOAT (numero decimale) o DATE (campi data con un widget calendario). Se il valore è mancante o non corretto, il valore di default è STRING.

   Un tipo di valore non corrispondente non impedisce l'importazione dei dati, tuttavia i risultati potrebbero non essere sempre corretti in base ai dati e al campo. Ad esempio, i campi data possono essere impostati in modo errato se il tipo di dati non è DATE. Tuttavia, è possibile importare senza problemi un numero con il tipo di dato come intero in un campo di testo.

   I campi con le liste di opzioni sono definiti come campi numerici con tipo di valore INT. Ad esempio, i blocchi degli oggetti possono essere impostati su No , Sì e Organizzazione con i numeri corrispondenti 0 , 1 e 2 nel file di input.

3. Conversion factor (facoltativo, solo FLOAT ). Per convertire i valori imperiali in valori metrici in ambienti imperiali.

   Nota:

   Si consiglia di verificare i valori FLOAT per evitare errori dei fattori di conversione.

4. Comment (opzionale). Tutti i caratteri che seguono le definizioni precedenti vengono ignorati e possono essere utilizzati per scrivere i commenti. Tuttavia, questi commenti devono essere utilizzati con parsimonia poiché è più facile leggere il file se si scrivono più commenti su una linea separata, come spiegato di seguito.

Tekla Structures considera le righe che iniziano con caratteri barra rovesciata doppia ( // ) come commenti e le ignora quando legge il file.

Esempi:

//Regular attributes

R1_ISSUED_FOR_APPRL, STRING
R1_DATE_APPROVED, DATE

//Attribute with conversion factor and comment

shear1, FLOAT, 4448.2222, For kips

Esempio di file di input per le parti

Questo file di input è delimitato da tabulazioni.

ASSEMBLY_POS e PHASE sono i campi chiave. Tekla Structures aggiunge diversi attributi utente agli assemblaggi con i valori che corrispondono a quelli elencati nelle colonne ASSEMBLY_POS e PHASE.

Ad esempio, un assemblaggio con ASSEMBLY_POS (marca di assemblaggio) di B5 nella fase 1 ottiene i seguenti attributi utente:

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

Il file di input contiene due voci per B1. In questo caso, Tekla Structures scrive il messaggio " >Oggetto duplicato nel file di input. " nel file di log e importa solo la prima voce nel file. Pertanto in questo esempio, al termine dell'importazione degli attributi, B1 disporrà dei seguenti attributi utente:

STATUS : 7

USER_PHASE : 3

USER_ISSUE : 3/25/2019

Esempio di file di input per i disegni

Questo file di input è delimitato da tabulazioni.

TYPE e NAME sono campi chiave. Tekla Structures aggiunge un valore per l'attributo utente User field 4 ai disegni con valori che corrispondono a quelli elencati nelle colonne TYPE e NAME.

Ad esempio, un disegno con TYPE A (disegno di assemblaggio) e NAME B.2 ottiene un valore di 4 nel User field 4.

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

Di default, i valori vuoti vengono ignorati. Per cancellare i valori esistenti, impostare l'opzione avanzata XS_ERASE_UDA_VALUE_WITH_ATTRIBUTE_IMPORT_NULL_AND_BLANK su TRUE in un file ini.