Importazione dei valori degli attributi utente

Tekla Structures
2021
Tekla Structures

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.

Nota:

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

È possibile importare i valori degli attributi utente (UDA) nei modelli Tekla Structures dai file di input, che sono file di testo delimitati.

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

GUID

ID4FEAFC88-0000-0004-3133-​343038303031

Tekla Structures assegna gli attributi utente in questa linea nel file di input all'oggetto del modello con un valore GUID di ID4FEAFC88-0000-0004-3133-343038303031.

ASSEMBLY_POS

oppure

MARK

A3

Tekla Structures assegna gli attributi utente in questa linea nel file di input all'assemblaggio con un valore ASSEMBLY_POS di A3.

Ripetere questa linea per ciascun assemblaggio da includere.

PHASE

2

Tekla Structures assegna gli attributi utente in questa linea nel file di input all'assemblaggio con un valore PHASE di 2.

È inoltre necessario utilizzare ASSEMBLY_POS come campo chiave con questa opzione.

I campi chiave per gli oggetti del disegno sono:

Campo chiave

Esempio

Azione

TYPE NAME

A D4

Tekla Structures assegna gli attributi utente in questa linea nel file di input al disegno che ha un valore TYPE di A e un valore MARK di D4.

Utilizzare entrambi i campi chiave nel file di input.

ID

134

Tekla Structures assegna gli attributi utente in questa linea nel file di input all'oggetto del disegno con un valore ID di 134.

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

  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, 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

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

Nota: Questa operazione sovrascrive tutti i valori degli attributi esistenti per gli oggetti corrispondenti se il file di input contiene un valore per il campo.

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.

  1. Se si desidera importare gli attributi utente in un'area selezionata del modello di Tekla Structures, selezionare un'area nel modello.
  2. Nel menu File cliccare su Importa > Attributi.

    Viene visualizzata la finestra di dialogo Importa Attributi.

  3. Cliccare sul pulsante ... accanto alla casella Input file per selezionare il file di input da importare.
  4. Scegliere le impostazioni corrette per l'importazione.

    Opzione

    Descrizione

    Delimitatori del file di input

    Selezionare un delimitatore o diversi delimitatori alternativi utilizzati nel file di input.

    È possibile delimitare i campi con qualsiasi carattere ASCII che non viene visualizzato nel nome o nel valore degli attributi che si stanno importando.

    Input scope

    • Default, Modello intero

      Tekla Structures assegna i valori degli attributi utente degli oggetti nel file di input agli oggetti corrispondenti nel modello.

    • Solo selezione

      Tekla Structures assegna solo i valori degli attributi utente degli oggetti nel file di input agli oggetti corrispondenti nell'area selezionata del modello.

      Utilizzare questa opzione per importare gli attributi utente nei modelli. Non utilizzarla per i disegni.

    • Modelli di riferimento

      Tekla Structures assegna i valori degli attributi utente degli oggetti nel file di input agli oggetti corrispondenti nei modelli di riferimento.

    Crea file log

    • Crea

      Consente di creare un nuovo file di log denominato attribute_import.log nella cartella del modello corrente ogni volta che si importano gli attributi utente. Qualsiasi file di log di importazione degli attributi precedente viene sovrascritto.

    • Accoda al precedente

      Consente di aggiungere voci al file attribute_import.log nella cartella del modello corrente ogni volta che si importano gli attributi utente. Se il file di log non esiste, Tekla Structures lo crea.

    • No

      Non crea un file di log.

    Visualizza file log

    • No

      Il file di log non viene visualizzato.

    • Nella finestra di dialogo

      Il file di log viene visualizzato al termine dell'importazione.

  5. Cliccare su Crea per importare il file.

    Se è stata selezionata l'opzione per visualizzare il file di log, Tekla Structures visualizza il file di log in una finestra separata ed è possibile cliccare su una voce del log per selezionare l'oggetto corrispondente nel modello.

È stato utile?
Precedente
Successivo