A propos de la localisation ou de la modification des codes d'élément de profil type

Pour faciliter la localisation, les éléments de profil type standard d'AutoCAD Civil 3D utilisent un fichier de codes externe pour définir les codes de point, de lien et de forme référencés dans les éléments de profil type.

Ce fichier, nommé C3DStockSubassemblyScripts.codes, se trouve dans le même dossier que le fichier C3DStockSubassemblyScripts.dvb et/ou que le fichier C3DStockSubassemblies.dll. Pour les systèmes en anglais, ce fichier se trouve généralement par défaut à l'emplacement suivant : C:\ProgramData\Autodesk\C3D <version>\enu. Pour les systèmes non basés sur l'anglais, l'emplacement "enu" correspond à la langue ou la région appropriée.

Le fichier de codes est associé à chaque élément de profil type avec le module CodesSpecific dans le fichier .dvb. Les sections suivantes présentent la définition du fichier de codes et expliquent comment le modifier ou y ajouter des codes de point, de lien et de forme.

Le module CodesSpecific se trouve dans le fichier CodesSpecific.vb du projet C3DStockSubassemblies VB lorsqu'il s'agit d'éléments de profil type .NET, et dans le fichier .dvb lorsqu'il s'agit d'éléments de profil type VBA.

Présentation du fichier C3DStockSubassemblyScripts.codes

Vous pouvez ouvrir le fichier C3DStockSubassemblyScripts.Codes dans n'importe quel éditeur de texte. Pour ajouter des commentaires, insérez les signes // devant une phrase. Ne laissez pas de lignes vierges dans le fichier. Chaque ligne de code est séparée par un caractère de retour à la ligne. Chaque définition de code comprend les éléments suivants, séparés par des virgules :

• Numéro d'index : valeur entière utilisée (pour un point, un lien ou une forme selon le cas) pour attribuer une étiquette au module d'élément de profil type.
• Code localisé : valeur affichée par AutoCAD Civil 3D dans l'onglet Codes de propriétés Elément de profil type, Profil type et/ou Projet 3D. Elle est utilisée pour définir le style du lien.
• Code d'origine : variable de code utilisée par AutoCAD Civil 3D. Quelle que soit la version localisée de l'élément de profil type utilisée, l'interprétation est identique pour garantir la portabilité des dessins sur des versions de différentes langues.
• Description du code : description localisée permettant d'expliquer la fonctionnalité associée au code. Ce texte s'affiche dans la colonne Description de l'onglet Codes de la boîte de dialogue de propriétés de l'élément de profil type, du profil type ou du projet 3D. Ce texte est facultatif.

Remarque : Les fichiers de codes doivent être enregistrés au format Unicode. Par exemple, si vous utilisez le Bloc-Notes pour mettre à jour le fichier de codes, la boîte de dialogue Enregistrer sous vous permet de choisir la méthode d'encodage lorsque vous enregistrez le fichier. Assurez-vous de bien choisir Unicode.

Un exemple de ligne de définition de code du fichier C3DStockSubassemblyScripts.codes est présenté ci-dessous :

38,BottomCurb,BottomCurb,Bottom of curb for a curb without gutter.

Le numéro d'index est : 38

Le code localisé est : Point de bordure

Le code d'origine est : Point de bordure

La description du code est : Bas d'une bordure pour une bordure sans caniveau.

Modification des codes par défaut des éléments de profil type standard d'AutoCAD Civil 3D

Pour modifier ou localiser les noms d'affichage des codes, ouvrez le fichier C3DStockSubassemblyScripts.codes dans un éditeur de texte et modifiez le code localisé et/ou la description de code correspondante.

Par exemple, il est possible de changer le nom d'affichage de Point de bordure en modifiant comme suit les composants en gras dans le fichier C3DStockSubassemblyScripts.codes :

38,BordureInférieure,BordureInférieure,Bas d'une bordure pour une bordure sans caniveau

Ajout d'un nouveau code aux éléments de profil type standard d'AutoCAD Civil 3D

Pour modifier des éléments de profil type existants en de nouveaux codes ou ajouter un nouveau module d'élément de profil type en utilisant la structure du contenu Autodesk par défaut, vous pouvez procéder comme suit pour les éléments de profil type .NET

1. Ajoutez <New Code> à la fin du fichier C3DStockSubassemblyScripts.Codes avec un nouvel index, un nouveau nom localisé, un nouveau code d'origine et une nouvelle description facultative.
2. Dans le fichier CodesSpecific.vb du projet C3DStockSubassemblies VB, ajoutez les entrées suivantes à la fin de la structure AllCodes : Public <New Code> as CodeType
3. Dans le CodesSpecific.vb du bloc With/End With de la routine FillCodeStructure, ajoutez les entrées suivantes à la fin : GetFromCollection colCodesAndDescriptionHashtable, n, .<NewCode>
4. Au cas ou le fichier de codes serait introuvable, déclarez la valeur par défaut de CodesDefault(<New Code Index>) dans la fonction InitializeDefaults() du module CodesSpecific.
5. Modifiez la taille de réseau CodesDefault dans le module CodesSpecific de l'instruction Dim.

Un nouveau code ajouté à l'aide de ces procédures peut être utilisé pour de nouveaux éléments de profil type ou des éléments de profil type existants .NET aux éléments de profil type standard d'AutoCAD Civil 3D.

Pour les éléments de profil type VBA, vous pouvez procéder comme suit :

1. Ajoutez <New Code> à la fin du fichier C3DStockSubassemblyScripts.Codes avec un nouvel index, un nouveau nom localisé et une nouvelle description facultative.
2. Dans le module CodesSpecific du fichier C3DStockSubassemblyScripts.dvb, ajoutez les entrées suivantes à la fin de la structure AllCodes : g_s<New Code> as CodeType
3. Dans le fichier CodesSpecific du bloc With/End With de la routine FillCodeStructure, ajoutez les entrées suivantes à la fin : GetFromCollection colCodesAndDescriptionHashtable, n, .g_s<NewCode>
4. Au cas où le fichier de codes serait introuvable, déclarez la valeur par défaut de g_arrDefaults(<New Code Index>) dans la fonction InitializeDefaults() du module CodesSpecific.
5. Modifiez la taille de réseau g_arrDefaults dans le module CodesSpecific.

Un nouveau code ajouté à l'aide de ces procédures peut être utilisé pour de nouveaux éléments de profil type ou des éléments de profil type existants VBA aux éléments de profil type standard d'AutoCAD Civil 3D.

Remarque : Le processus d'association de codes de point sert essentiellement à faciliter la localisation du contenu par défaut. Si vous créez des éléments de profil type personnalisés, il n'est pas nécessaire de suivre cette procédure. Vous pouvez créer un module contenant une liste de codes personnalisée à laquelle vos éléments de profil type peuvent faire référence. Vous pouvez également contourner ce processus en codant localement des chaînes en dur au sein de chaque module.

Localisation des catalogues d'éléments de profil type et des palettes d'outils

Les éléments de profil type par défaut sont généralement définis pour un grand nombre de clients et de zones géographiques. Vous souhaiterez peut-être modifier certains noms d'affichage de catalogues, de palettes ou de variables d'outils pour diverses situations et langues. Ces catalogues et palettes d'outils sont créés au format XML, dans des fichiers .atc, et sont modifiables.

Remarque : Pour les systèmes en anglais, les fichiers AutoCAD Civil 3D du catalogue d'outils d'éléments de profil type d'.atc se trouvent par défaut à l'emplacement suivant : C:\ProgramData\Autodesk\C3D <version>\enu\Tool Catalogs\Road Catalog.

La liste suivante identifie les valeurs des éléments de données que vous pouvez modifier dans le fichier .atc du catalogue d'outils d'éléments de profil type à des fins de localisation :

• La valeur <ItemName> est le nom de description du catalogue, de la catégorie, de la palette ou de l'élément de profil type.
• La valeur <Description> décrit le catalogue, la catégorie, la palette ou l'élément de profil type.
• La valeur <Keywords> comporte une chaîne d'aide pour les éléments de profil type.
• Les éléments suivants sont des attributs de l'élément de données <Params> :
  • NomAffichage : nom affiché dans la fenêtre de propriétés AutoCAD pour un élément de profil type sélectionné.
  • Description : texte descriptif affiché dans l'angle inférieur gauche de la fenêtre de propriétés AutoCAD pour un élément de profil type sélectionné.
• Au besoin, vous pouvez modifier les valeurs d'éléments de données suivantes :
  • Les valeurs des paramètres (telles que Largeur dans l'élément de profil type VoieSimple) de tout sous-élément dans <Params>.
  • La valeur <unités> qui prend en charge les unités exprimées en pieds et en mètres dans AutoCAD Civil 3D.
  • <DotNetClass Assembly = ...> (pour les éléments de profil type .NET), qui peut être modifié afin de pointer sur une classe .NET différente.
  • <Macro Module = ...> (pour les éléments de profil type VBA), qui peut être modifié afin de pointer sur une macro différente.

Remarque : Vous pouvez modifier uniquement les valeurs d'un élément de données et non le nom de l'élément lui-même (tel que Largeur dans l'élément de profil type VoieSimple). Ces éléments de données sont des noms de variables globales utilisés dans les scripts des éléments de profil type.

Installation de kits pays, de fichiers de codes personnalisés ou de fichiers de codes spécifiques à l'environnement local

Si vous prévoyez d'installer un kit pays qui contient un fichier de codes spécifique à la région ou si vous prévoyez d'installer (utiliser) un fichier de codes qui comporte du contenu spécifique à la région, vous devez procédez comme suit avant d'installer le kit pays ou le fichier de codes personnalisé.

Effectuez une copie de sauvegarde du fichier de codes spécifique à la région ou personnalisé, renommez-le avec le nom par défaut de votre fichier de codes installé (par exemple, pour les produits de la version anglaise, le fichier de codes par défaut est C3DStockSubassemblyScripts_US.codes) et copiez-le à l'emplacement suivant : C:\ProgramData\Autodesk\C3D <version>\enu. Pour les systèmes non basés sur l'anglais, l'emplacement "enu" doit correspondre à l'environnement local approprié.

Notez que lors de la première installation d'AutoCAD Civil 3D sur un nouvel ordinateur, les deux versions suivantes du fichier de codes sont installées :

• C3DStockSubassemblyScripts.codes
• C3DStockSubassemblyScripts_US.codes

Le fichier de codes C3DStockSubassemblyScripts_<locale>.codes (dans cet exemple, C3DStockSubassemblyScripts_US.codes) est installé pour fournir un mécanisme de sauvegarde permettant de sécuriser le contenu du fichier de codes.

Lors de l'installation d'un kit pays qui contient des fichiers de codes spécifiques à une zone, le fichier de codes localisé remplace le fichier C3DStockSubassemblyScripts.codes existant. Une copie de C3DStockSubassemblyScripts_<locale>.codes est effectuée. Si vous avez modifié votre fichier C3DStockSubassemblyScripts.codes, cela explique pourquoi il est important d'en effectuer une sauvegarde avant l'installation du kit pays ou du fichier de codes spécifique à l'environnement local.

Dépannage des erreurs de fichier de codes

Si les résultats que vous obtenez sont inattendus lorsque vous utilisez des éléments de profil type personnalisés ou lorsque vous effectuez certains didacticiels de conception du projet 3D AutoCAD Civil 3D, il est possible que cela soit dû au fait que le dessin tente de faire référence à des informations de fichier de codes introuvables. Dans certains cas, il est possible de résoudre ces erreurs en mettant à jour votre fichier de codes existant afin qu'il contienne les informations nécessaires.