Importazione dei valori degli attributi utente
È possibile importare i valori degli attributi utente (UDA) in un modello da un file di testo. Ad esempio, è possibile importare un elenco di assemblaggi lavorati o controllati. È inoltre possibile cancellare i valori degli attributi utente esistenti tramite l'importazione degli attributi.
È possibile importare i valori degli attributi in oggetti del modello, disegni e alcuni oggetti del modello di riferimento di Tekla Structures (se configurati, vedere Aggiunta di UDA nei modelli di riferimento). Definire i criteri di corrispondenza per l'importazione degli attributi nel file di input ed è inoltre possibile limitare l'ambito di importazione agli oggetti selezionati nel modello o agli oggetti del modello di riferimento.
Il file di input può essere:
-
Esportato da altro software.
-
Creato manualmente utilizzando un qualunque editor di testo standard, ad esempio Blocco note di Microsoft.
-
Creato da Microsoft Excel salvando il file con il comando Salva come in formato Testo (delimitato da tabulazioni) (*.txt).
-
Un report semplice di Tekla Structures contenente i GUID parte e gli attributi utente.
Esistono metodi alternativi per importare i dati negli attributi utente. Ad esempio, gli attributi utente possono essere compilati quando si importano gli oggetti IFC e li si converte in oggetti Tekla Structures. Sono inoltre disponibili diverse estensioni in Tekla Warehouse che consentono di modificare i dati degli attributi utente.
Struttura file di input
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:
Campo chiave |
Esempio |
Azione |
---|---|---|
|
|
Tekla Structures assegna gli attributi utente in questa linea nel file di input all'oggetto del modello con un valore |
oppure
|
|
Tekla Structures assegna gli attributi utente in questa linea nel file di input all'assemblaggio con un valore Ripetere questa linea per ciascun assemblaggio da includere. |
|
|
Tekla Structures assegna gli attributi utente in questa linea nel file di input all'assemblaggio con un valore È inoltre necessario utilizzare |
I campi chiave per gli oggetti del disegno sono:
Campo chiave |
Esempio |
Azione |
---|---|---|
|
|
Tekla Structures assegna gli attributi utente in questa linea nel file di input al disegno che ha un valore Utilizzare entrambi i campi chiave nel file di input. |
|
|
Tekla Structures assegna gli attributi utente in questa linea nel file di input all'oggetto del disegno con un valore |
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.
File di dati (import_macro_data_types.dat)
Per importare un valore in una attributo utente, il nome del campo e il tipo di dati devono essere definiti correttamente nel file di dati import_macro_data_types.dat. È possibile aggiungere, modificare e rimuovere i campi attributo utente in cui vengono importati i dati. Non modificare la sezione del file dei campi chiave; non è possibile aggiungere nuovi campi chiave.
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
-
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. Data type
.Il valore può essere:
INT
(numero intero),STRING
(testo),FLOAT
(numero decimale) oDATE
(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.-
Conversion factor
(facoltativo, soloFLOAT
). 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. 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
Esempi di file di input
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
Elaborazione di un file di input
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.