Gebruikersattribuutwaarden importeren
U kunt gebruikersattribuutwaarden (UDA) vanuit een tekstbestand in een model importeren. U kunt bijvoorbeeld een lijst met gefabriceerde of gecontroleerde merken importeren. U kunt ook bestaande waarden van gebruikersattributen wissen via attribuutimport.
U kunt attribuutwaarden in Tekla Structures-modelobjecten, tekeningen en enkele referentiemodelobjecten importeren (indien geconfigureerd, raadpleeg Gebruikersattributen (UDA´s) in referentiemodellen toevoegen). U definieert overeenkomende criteria voor de attribuutimport in het invoerbestand en u kunt daarnaast ook de importomvang beperken tot objecten die u in het model selecteert of tot referentiemodelobjecten.
Het invoerbestand kan het volgende zijn:
-
Geëxporteerd uit andere software.
-
Handmatig gemaakt met een standaard teksteditor, bijvoorbeeld Microsoft Kladblok.
-
Gemaakt vanuit Microsoft Excel door het bestand met het commando Opslaan als op te slaan naar de indeling Tekst (tab is scheidingsteken) (*.txt).
-
Een eenvoudige Tekla Structures-lijst met de onderdeel-GUID's en gebruikersattributen.
Er zijn alternatieve manieren om gegevens in gebruikersattributen te importeren. Gebruikersattributen kunnen bijvoorbeeld worden gevuld wanneer u IFC-objecten importeert en deze naar oorspronkelijke Tekla Structures-objecten converteert. Er zijn ook verschillende extensies in Tekla Warehouse waarmee u gebruikersattribuutgegevens kunt wijzigen.
Invoerbestandstructuur voor het importeren van waarden in gebruikersattributen
U kunt waarden voor gebruikersattributen (UDA) importeren in Tekla Structures-modellen vanuit invoerbestanden die tekstbestanden met scheidingstekens zijn.
Scheidingstekens in invoerbestanden
Een scheidingsteken is een teken dat verschillende velden scheidt die zich op dezelfde regel bevinden.
U kunt velden afscheiden met elk ASCII-teken dat niet verschijnt in de namen of waarden van de attributen die u importeert. U kunt meerdere alternatieve scheidingstekens in hetzelfde invoerbestand gebruiken. Veelvoorkomende scheidingstekens bevatten de komma, tab, puntkomma en spatie.
Definities van velden en waarden in invoerbestanden
De eerste regel in het invoerbestand is een header die de velden voor de rest van het invoerbestand definieert. Alle andere regels in het invoerbestand bevatten de waarden voor de velden die u op de eerste regel hebt genoemd.
De eerste regel moet ten minste één sleutelveld bevatten dat de modelobjecten of tekeningen identificeert en ten minste één gebruikersattribuutnaam die een gebruikersattribuutveld identificeert waarin u nieuwe waarden wilt importeren. De namen van veel van de velden zijn anders dan de veldlabels die u in de gebruikersinterface ziet. De namen van de gebruikersattributen worden gedefinieerd in de bestanden objects.inp die van toepassing zijn op het model (raadpleeg de referentie over hoe het bestand moet worden gelezen).
Het configuratiebestand import_macro_data_types.dat (dat verderop wordt uitgelegd) definieert welke velden u in de attribuutimport kunt gebruiken en wat elk gegevenstype van het attribuut is. Het is niet mogelijk om de sleutelvelden toe te voegen of te wijzigen, maar u kunt de set met gebruikersattributen bewerken. De waarden worden als strings (tekst) geïmporteerd tenzij er in het bestand import_macro_data_types.dat een ander gegevenstype voor het attribuut wordt gedefinieerd.
Beschikbare sleutelvelden voor invoerbestanden
De sleutelvelden voor modelobjecten zijn:
Sleutelveld |
Voorbeeld |
Actie |
---|---|---|
|
|
Tekla Structures wijst de gebruikersattributen op deze regel in het invoerbestand toe aan het modelobject met een |
of |
|
Tekla Structures wijst de gebruikersattributen op deze regel in het invoerbestand toe aan het merk met een Herhaal deze regel voor elk merk dat u wilt opnemen. |
|
|
Tekla Structures wijst de gebruikersattributen op deze regel in het invoerbestand toe aan het merk met een U moet bij deze optie ook |
De sleutelvelden voor tekeningobjecten zijn:
Sleutelveld |
Voorbeeld |
Actie |
---|---|---|
|
|
Tekla Structures wijst de gebruikersattributen op deze regel in het invoerbestand toe aan de tekening met een Gebruik beide sleutelvelden in het invoerbestand. |
|
|
Tekla Structures wijst de gebruikersattributen op deze regel in het invoerbestand toe aan het tekeningobject met een |
Lege waarden in invoerbestanden
Sommige regels in het invoerbestand hebben mogelijk geen waarde voor alle attribuutvelden. Er kunnen bijvoorbeeld twee of meer opeenvolgende scheidingstekens tussen waarden zijn.
Deze lege waarden kunnen tijdens het importeren worden overgeslagen zonder wijzigingen aan de gebruikersattributen aan te brengen of u kunt deze lege waarden gebruiken om bestaande gebruikersattribuutwaarden in uw model te wissen. Lege waarden worden standaard overgeslagen. Om in plaats daarvan bestaande waarden te wissen, stelt u de variabele XS_ERASE_UDA_VALUE_WITH_ATTRIBUTE_IMPORT_NULL_AND_BLANK in op TRUE
in een ini-bestand.
Leesvolgorde voor invoerbestanden
Tekla Structures leest het invoerbestand in volgorde, beginnend vanaf de eerste regel. Als er dubbele sleutelvelden op de volgende regels staan, wordt alleen het eerste exemplaar geïmporteerd.
Gegevensbestanden (import_macro_data_types.dat) voor het importeren van waarden in gebruikersattributen
Als u in een gebruikersattribuut een waarde wilt importeren, moeten de veldnaam en het gegevenstype in het gegevensbestand import_macro_data_types.dat correct worden gedefinieerd. U kunt gebruikersattribuutvelden waarin de gegevens worden geïmporteerd, toevoegen, bewerken en verwijderen
Bewerk de sleutelvelden-sectie van het bestand niet. Het is niet mogelijk om nieuwe sleutelvelden toe te voegen.
Locatie van gegevensbestanden
Het standaard gegevensbestand bevindt zich in de map system in de omgevingsmap, zoals C:\ProgramData\Trimble\Tekla Structures\<version>\environments\common\system. Mogelijk bevindt zich in de omgeving die u gebruikt ook een gelokaliseerde versie van het bestand.
Breng geen wijzigingen in de standaard bestanden aan. Maak in plaats daarvan een kopie van het bestand en sla deze in een andere locatie op, bijvoorbeeld in de bedrijfsmap of in de map attributes in de modelmap. Zo worden uw wijzigingen niet overschreven wanneer u Tekla Structures opnieuw installeert of bijwerkt. Als het zelfde bestand op meerdere locaties bestaat, wordt de standaard zoekvolgorde voor mappen gevolgd en wordt alleen het eerst gelezen bestand gebruikt.
Inhoud van gegevensbestanden
Het bestand import_macro_data_types.dat is tekst zonder opmaak. U kunt het bestand in elke standaard teksteditor wijzigen, zoals Microsoft Kladblok.
Elke regel in het bestand is een velddefinitie die de volgende attributen in deze volgorde kan bevatten:
User-defined attribute name,Data type,Conversion factor,Comments
-
User-defined attribute name
. Schrijf de interne veldnaam zoals voor het veld in een objects.inp bestand wordt gedefinieerd.In de definitie
attribute("USER_FIELD_1", "j_user_field_1", string, "%s", no, none, "0.0", "0.0")
van objects.inp is de naam van het gebruikersattribuut bijvoorbeeld USER_FIELD_1. Data type
.De waarde kan de volgende zijn:
INT
(geheel getal),STRING
(tekst),FLOAT
(decimaal getal) ofDATE
(datumvelden met een kalenderwidget). Als de waarde ontbreekt of onjuist is, wordt de waarde standaard opSTRING
ingesteld.Een waardetype-discrepantie voorkomt het importeren van gegevens niet, maar de resultaten zijn mogelijk niet altijd correct, afhankelijk van de gegevens en het veld. Datumvelden kunnen bijvoorbeeld mogelijk onjuist worden ingesteld als het gegevenstype niet
DATE
is. Maar in een tekstveld kunt u probleemloos een nummer van het gegevenstype integer importeren.Velden met optielijsten worden als nummervelden van het waardetype
INT
gedefinieerd. Objectvergrendelingen kunnen bijvoorbeeld op Nee, Ja en Organisatie worden ingesteld met in het invoerbestand de corresponderende nummers 0, 1 en 2.-
Conversion factor
(optioneel, alleenFLOAT
). Voor het converteren van Engelse waarden naar metrische waarden in Engelse omgevingen.Opmerking:We raden u aan de
FLOAT
-waarden te controleren om fouten in conversiefactoren te voorkomen. Comment
(optioneel). Tekens die de bovenstaande vorige definities volgen, worden genegeerd en kunnen voor het schrijven van uw opmerkingen worden gebruikt. We raden u echter aan dat u geen opmerkingen op dezelfde lijn als definities plaatst. Het bestand is eenvoudiger te lezen als u de meeste opmerkingen op aparte lijnen zet.
Tekla Structures behandelt lijnen die beginnen met dubbele slashes (//
) als opmerkingen en negeert de hele lijn bij het lezen van het bestand.
Voorbeelden:
//Regular attributes
R1_ISSUED_FOR_APPRL, STRING
R1_DATE_APPROVED, DATE
//Attribute with conversion factor and comment
shear1, FLOAT, 4448.2222, For kips
Voorbeelden van invoerbestanden voor het importeren van waarden in gebruikersattributen
Voorbeeld invoerbestand voor onderdelen
Gegevens in dit invoerbestand worden door tabs gescheiden.
ASSEMBLY_POS
en PHASE
zijn de sleutelvelden. Tekla Structures voegt meerdere gebruikersattributen aan de merken toe met waarden die overeenkomen met de waarden in de ASSEMBLY_POS
en PHASE
-kolommen.
Een merk met het ASSEMBLY_POS
(merknummer) van B5 in fase 1 krijgt bijvoorbeeld de volgende gebruikersattributen:
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
Het invoerbestand bevat twee vermeldingen voor B1. In dit geval schrijft Tekla Structures het bericht ">Dubbele invoer in input bestand." in het logboekbestand en wordt alleen de eerste vermelding in het bestand geïmporteerd. Dus in dit voorbeeld heeft B1 na de attribuutimport de volgende gebruikersattributen:
STATUS
: 7
USER_PHASE
: 3
USER_ISSUE
: 3/25/2019
Voorbeeld invoerbestand voor tekeningen
Gegevens in dit invoerbestand worden door tabs gescheiden.
TYPE
en NAME
zijn de sleutel velden. Tekla Structures voegt een waarde voor het gebruikersattribuut User field 4
aan tekeningen toe met waarden die overeenkomen met de waarden in de TYPE
-kolommen en NAME
.
Voor een tekening met TYPE A
(merktekening) en NAME
B.2 wordt de waarde 4 opgehaald in het veld User field 4
.
TYPE NAME DRAWING_USERFIELD_4
A B.1 3
A B.2 4
A C.1 1
A C.2 2
Een invoerbestand verwerken voor het importeren van waarden in gebruikersattributen
Lege waarden worden standaard overgeslagen. Om in plaats daarvan bestaande waarden te wissen, stelt u de variabele XS_ERASE_UDA_VALUE_WITH_ATTRIBUTE_IMPORT_NULL_AND_BLANK in op TRUE
in een .ini-bestand.