Séparateurs

Un séparateur est un caractère qui sépare différents champs d'une même ligne. Vous pouvez séparer les champs avec n’importe quel caractère ASCII qui n’apparaît pas dans les noms ou les valeurs des attributs que vous importez. Vous pouvez utiliser plusieurs séparateurs différents dans le même fichier d’entrées. Les caractères de séparation communs sont notamment la virgule, la tabulation, le point-virgule et l’espace.

Définitions des champs et des valeurs

Dans le fichier d’entrées, la première ligne est un en-tête qui définit les champs du reste du fichier d’entrées. Toutes les autres lignes du fichier d’entrées contiennent les valeurs des champs que vous avez nommés sur la première ligne.

La première ligne doit contenir au moins un Champ clé qui identifie les objets du modèle ou les dessins, et au moins un nom d'attribut utilisateur qui identifie un champ d'attribut utilisateur dans lequel vous souhaitez importer de nouvelles valeurs. Notez que les noms de beaucoup de champs sont différents de ceux des champs que vous voyez dans l’interface utilisateur. Les noms d'attributs utilisateur sont définis dans les fichiers objects.inp qui s’appliquent au modèle (voir la référence sur la façon de lire le fichier).

Le fichier de configuration import_macro_data_types.dat (qui est expliqué plus loin) définit les champs que vous pouvez utiliser dans l’import d’attributs et ce qui correspond au type de données de chaque attribut. Il n’est pas possible d’ajouter ou de modifier les identifiants, mais vous pouvez modifier l’ensemble d’attributs utilisateur. Les valeurs sont importées en tant que chaînes (texte), sauf si un type de données différent est défini pour l’attribut dans le fichier import_macro_data_types.dat.

Identifiants disponibles

Les identifiants pour les objets du modèle sont :

Les identifiants pour les objets de dessin sont :

Valeurs vides

Il est possible que certaines lignes du fichier d’entrées ne possèdent pas de valeur pour tous les champs d’attribut (il peut y avoir plusieurs caractères de séparation consécutifs entre les valeurs). Ces valeurs vides peuvent être ignorées lors de l’import sans apporter aucune modification aux attributs définis par l’utilisateur, ou vous pouvez utiliser ces valeurs vides pour effacer des valeurs d'attributs utilisateur existantes dans votre modèle. Par défaut, les valeurs vides sont ignorées. À la place, pour supprimer des valeurs existantes, définissez l'option avancée XS_ERASE_UDA_VALUE_WITH_ATTRIBUTE_IMPORT_NULL_AND_BLANK sur TRUE dans un fichier ini.

Ordre de lecture

Tekla Structures lit le fichier d’entrées dans l’ordre à partir de la première ligne. S’il existe des identifiants en double sur les lignes suivantes, seule la première occurrence est importée.

Emplacement du fichier

Le fichier de données par défaut se trouve dans le répertoire system dans le répertoire d’environnement, C:\ProgramData\Trimble\Tekla Structures\<version>\environments\common\systempar exemple. Il peut également exister une version traduite du fichier dans l’environnement que vous utilisez.

Ne modifiez pas les fichiers par défaut. Créez plutôt une copie du fichier et enregistrez-la dans un emplacement différent, par exemple, dans le répertoire société ou dans le répertoire attributes du répertoire modèle. De cette façon, vos modifications ne sont pas remplacées lors de la réinstallation ou de la mise à niveau de Tekla Structures. Lorsque le fichier existe dans plusieurs emplacements, l'ordre de recherche des dossiers par défaut est suivi et seul le premier fichier lu est utilisé.

Contenu du fichier

Le fichier import_macro_data_types.dat est un fichier texte brut. Vous pouvez modifier le fichier à l'aide d'un éditeur de texte standard, tel que le Bloc-notes de Microsoft.

Chaque ligne du fichier est une définition de champ qui peut contenir les attributs suivants dans cet ordre :

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

1. User-defined attribute name. Entrez le nom du champ interne tel qu'il est défini pour le champ dans un fichier objects.inp.

   Par exemple, dans la définition objects.inp attribute("USER_FIELD_1", "j_user_field_1", string, "%s", no, none, "0.0", "0.0"), le nom de l'attribut utilisateur est USER_FIELD_1.

2. Data type.

   La valeur peut être : INT (entier), STRING (texte), FLOAT (nombre décimal) ou DATE (champs de date avec un widget de calendrier). Si la valeur est manquante ou incorrecte, la valeur par défaut est STRING.

   Une différence de type de valeur n’empêche pas d’importer des données, mais les résultats ne sont pas toujours corrects en fonction des données et du champ. Par exemple, les champs de date peuvent être définis de manière incorrecte si le type de données n'est pas DATE. D’autre part, vous pouvez importer un nombre avec le type de données entier dans un champ texte sans problème.

   Les champs avec des listes d’options sont définis comme nombre avec valeur de type INT. Par exemple, les verrouillages d’objet peuvent être définis sur Non, Oui et Organisation, avec les chiffres correspondants 0, 1 et 2 dans le fichier d’entrées.

3. Conversion factor (facultatif, FLOAT uniquement). Pour convertir les valeurs impériales en valeurs métriques dans un environnement impérial.

   Remarque :

   Nous vous recommandons de vérifier les valeurs FLOAT afin d'éviter les erreurs de facteurs de conversion.

4. Comment (facultatif). Tous les caractères qui suivent les définitions ci-dessus sont ignorés et peuvent être utilisés pour rédiger vos commentaires. Cependant, ces commentaires doivent être utilisés avec modération car le fichier est plus facile à lire si vous écrivez la plupart des commentaires sur une ligne distincte, comme expliqué ci-dessous.

Tekla Structures traites les lignes commençant par // comme des commentaires et les ignore lors du traitement.

Exemples :

//Regular attributes

R1_ISSUED_FOR_APPRL, STRING
R1_DATE_APPROVED, DATE

//Attribute with conversion factor and comment

shear1, FLOAT, 4448.2222, For kips

Exemple de fichier pour pièces

Ce fichier d'entrées est délimité par des tabulations.

ASSEMBLY_POS et PHASE sont les identifiants. Tekla Structures ajoute plusieurs attributs utilisateur aux assemblages dont les valeurs correspondent à celles des colonnes ASSEMBLY_POS et PHASE.

Par exemple, un assemblage avec une valeur ASSEMBLY_POS (repère d'assemblage) B5 en phase 1 renvoie les attributs utilisateur suivants :

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

Le fichier d'entrées contient deux entrées pour B1. Dans ce cas, Tekla Structures écrit le message « >Entrée dupliquée dans le fichier d'entrées. » dans le fichier historique et importe uniquement la première entrée du fichier. Par conséquent, dans cet exemple, B1 aura les attributs utilisateurs suivants après l'importation d'attribut :

STATUS: 7

USER_PHASE: 3

USER_ISSUE: 3/25/2019

Exemple de fichier pour dessins

Ce fichier d'entrées est délimité par des tabulations.

TYPE et NAME sont les identifiants. Tekla Structures ajoute une valeur pour l'attribut utilisateur User field 4 aux dessins dont les valeurs correspondent aux valeurs des colonnes TYPE et NAME.

Par exemple, un dessin de TYPE A (croquis d'assemblage) portant le NAME B.2 renvoie la valeur 4 dans User field 4.

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