1.6.2. Édition de fichiers de configuration au niveau du fichier

[Important]Important

Les réglages des fichiers de configuration (CFG, DEF, etc.) doivent de préférence être effectués dans PARTadmin.

L'édition au niveau du fichier ne doit être effectuée que par CADENAS (développement, conseil).

Cela peut être utile par exemple lors de la création de nouveaux fichiers ou de la mise en place de marquages spéciaux pour la commande de l'affichage dans PARTadmin.

Dans ce cas, nous recommandons d'utiliser le Bloc-notes de Windows ou, si vous êtes plus exigeant, l'éditeur Notepad++. N'utilisez en aucun cas PSPad, car des erreurs apparaissent lors de l'encodage avec UTF8, ce qui rend les fichiers illisibles pour PARTsolutions.

Syntaxe générale des balises

Il existe différents types d'étiquettes pour les clés, comme les informations brèves, les définitions de type de valeur, l'activation/désactivation et les éléments de contrôle pour l'interface utilisateur. La description courte et les éléments de contrôle de l'interface utilisateur peuvent également être utilisés pour les blocs.

Toutes les balises commencent par "# :", suivi du mot-clé de la balise et se terminent par un point-virgule.

[Remarque]Remarque

Les TAG devraient certes être utilisés pour améliorer l'utilisabilité, mais ils ne sont pas obligatoires d'un point de vue technique.

La liste suivante décrit les TAG pour le placement des textes d'aide

  • HELP - Brève information sur les clés et les blocs

    #:HELP;

    Dans la zone de dialogue Informations brèves [Short description], des informations sur les clés ou les blocs sont affichées (si elles ont été enregistrées).

    exemple :

    #:HELP;Skizzen werden fixiert erzeugt und können nicht geändert werden.

    La description courte [Short description] est créée à cet endroit uniquement pour la langue par défaut.

    [Remarque]Remarque
    • Avec la V11, la gestion des traductions des fichiers de configuration a maintenant été alignée en permanence sur le standard habituel. Les traductions pour toutes les langues supportées par PARTsolutions peuvent être déposées dans des fichiers def. Vous trouverez des détails à ce sujet sur Section 1.6.2.1, « Traduction de la "Brève information  ».

      L'affichage dans PARTadmin se fait en fonction du $CADENAS_LANGUAGE réglé.

    • Pour des raisons de compatibilité, la possibilité de saisie en fonction de la langue a été conservée dans le fichier de configuration. Ces indications ne sont toutefois pas évaluées par V11 ConfigEditor.

      #:HELP;default;Hello
      #:HELP;german;Hallo
      #:HELP;english;Hello
      #:HELP;spanish;Ola

    Pour insérer une brève information sur plusieurs lignes, placez le symbole dièse (#) au début des lignes suivantes.

    exemple :

    #:HELP;This is the text of the first line.
    # This is the next line,
    # another line
    # etc.

    [Remarque]Remarque

    Les lignes qui commencent par exemple par un point-virgule ou qui n'ont pas de balise de contrôle valide ne sont pas affichées dans PARTadmin.

  • CFGHELP - Informations succinctes sur le fichier de configuration

    #:CFGHELP;

    [Remarque]Remarque

    Placez cette balise à la fin du fichier de configuration (ainsi que #:VISFGUICFG si elle existe).

    Laquelle des deux balises est placée en premier n'a pas d'importance. Ce qui est important, c'est que ces balises ne soient pas suivies de blocs ou de clés.

    exemple :

    #:CFGHELP;Hello

    Pour insérer des textes descriptifs sur plusieurs lignes, placez le symbole dièse (#) au début des lignes suivantes.

    exemple :

    #:CFGHELP;This is the text of the first line.
    #This is the next line,
    #another line,
    #etc.

    [Remarque]Remarque

    Les lignes qui commencent par exemple par un point-virgule ou qui n'ont pas de balise de contrôle valide ne sont pas affichées dans PARTadmin.

    [Remarque]Remarque
    • La gestion des traductions s'effectue de la même manière que celle décrite ci-dessus sous CFGHELP.

La liste suivante explique les TAG permettant de spécifier des plages de valeurs

[Remarque]Remarque

Si les domaines de valeurs ne sont pas spécifiés plus précisément (c'est-à-dire qu'aucun "VALS_" n'a été défini), "VALS_S" est supposé en interne.

  • VALS_S - Valeur de clé alphanumérique

    • Pas d'indication de valeurs

      #:VALS_S;

      Si aucune valeur n'est indiquée, la saisie libre est possible.

    • Valeur unique

      #:VALS_S;<String>

    • Liste de valeurs

      #:VALS_S;<String list> 

      Si vous utilisez plusieurs valeurs, indiquez-les séparément avec une virgule.

      exemple :

      #:VALS_S;"YES","NO"
      TOP_SEARCHPATH_SELECTION_CURRENT=YES

      Si des valeurs sont prédéfinies, une zone de liste s'affiche alors dans l'interface utilisateur sous PARTadmin -> Catégorie Fichiers de configuration [Configuration files].

  • VALS_SE - Valeur clé alphanumérique avec valeur par défaut + entrée libre

    #:VALS_SE;

    Utilisez cette balise si vous souhaitez prédéfinir des valeurs sous PARTadmin -> Catégorie Fichiers de configuration [Configuration files] et autoriser en plus la saisie libre de valeurs.

    exemple :

    VALS_SE;„eins“,“zwei“,“drei“

    L'utilisateur peut désormais saisir "quatre", par exemple. Avec la balise "VALS_S", cela ne serait pas possible.

  • VALS_N - Valeur numérique de la clé

    • Pas d'indication de valeurs

      #:VALS_N;<numeric value>

      Si aucune valeur n'est indiquée, une saisie libre est possible sous PARTadmin -> Catégorie Fichiers de configuration [Configuration files].

    • Valeur unique

      #:VALS_N;<String>

    • Liste de valeurs

      #:VALS_N;<list of numeric values>

      Si vous utilisez plusieurs valeurs, indiquez-les séparément avec une virgule.

      exemple :

      #:VALS_N;0,1,2

      Si des valeurs sont prédéfinies, une zone de liste s'affiche sous PARTadmin -> Catégorie Fichiers de configuration [Configuration files].

  • VALS_NE - Valeur numérique de la clé avec valeur par défaut + saisie libre

    #:VALS_NE;

    Utilisez cette balise si vous souhaitez prédéfinir des valeurs sous PARTadmin -> Catégorie Fichiers de configuration [Configuration files] et autoriser en plus la saisie libre de valeurs.

    exemple :

    VALS_NE;1,2,3

    L'utilisateur peut désormais saisir "4", par exemple. Cela n'est pas possible avec la balise "VALS_N".

  • VALS_L - Sélection de champs de liste avec case à cocher

    #:VALS_L;

    Utilisez cette balise si vous souhaitez afficher une sélection de zones de liste avec des cases à cocher sous PARTadmin -> Catégorie Fichiers de configuration [Configuration files].

    exemple :

    #:VALS_L;1,2,3,4

    ou

    #:VALS_L;a,b,c,d

  • VALS_LE - sélection de champs de liste avec case à cocher + saisie libre

    #:VALS_LE;

    Utilisez cette balise si vous souhaitez afficher sous PARTadmin -> Catégorie Fichiers de configuration [Configuration files] une sélection de champs de liste avec des cases à cocher et permettre en plus une saisie libre.

    exemple :

    #:VALS_LE;a,b,c
    Key=a,b,c, extra_value

    L'utilisateur peut cliquer avec le curseur dans le champ de saisie et y placer sa propre entrée.

    L'utilisateur peut cliquer avec le curseur dans le champ de saisie et y placer sa propre entrée.

  • VALS_M - Valeurs clés cartographiées

    Cette balise permet de mapper une valeur ou un ensemble de valeurs sur une autre valeur ou un autre ensemble de valeurs.

    Sous PARTadmin -> Catégorie Fichiers de configuration [Configuration files], la valeur mappée est affichée. L'utilisateur voit ainsi par exemple une valeur "parlante", en interne on travaille avec des valeurs numériques.

    • Valeur unique mappée

      #:VALS_M;<value>;<mapped value>

    • Ensemble de valeurs mappé

      #:VALS_M;<value>,<value>;<mapped value>,<mapped value>

    Les partenaires de mapping sont séparés par un point-virgule, les valeurs individuelles par une virgule.

    exemple :

    #:VALS_M;"0","1";"Load as part","Load as geometry" 
    keyname2=0

    Sous PARTadmin -> Catégorie Fichiers de configuration [Configuration files], une sélection de zones de liste apparaît.

  • VALS_R - Spécification du domaine de valeurs

    #:VALS_R;<from value> - <up to value>

    Les limites des domaines de valeurs sont séparées par un tiret "-".

    Pour ce type, il n'est pas possible d'établir une liste de valeurs individuelles.

    exemple :

    #:VALS_R; 0-10
    DEBUGMODE=

    Lors de la saisie dans PARTadmin -> Catégorie Fichiers de configuration [Configuration files], un contrôle est effectué. Les saisies de valeurs en dehors du domaine de définition ne sont pas autorisées.

  • VALS_C - Affichage correct des phrases de code

    #:VALS_C;<code phrase>

    A l'aide de ce TAG, vous pouvez afficher des phrases de code comme proposition dans PARTadmin.

    Pour les autres lignes à partir de la première, faites-les précéder de "#".

    Les propositions s'affichent dans une zone de liste.

    exemple :

    #:VALS_C;0
    #1
    #any_vb_expression
    CADOPTION=

La liste suivante explique les TAG pour le contrôle général

  • INACTIVE - Désactiver la clé

    #:INACTIVE;<name of key>

    Si une clé ne doit actuellement pas être évaluée par des applications, utilisez ce marquage.

    Faites précéder la clé de la chaîne #:INACTIVE ;.

    exemple :

    #:INACTIVE;ShowInTable =no

    Est une touche est marquée de cette manière, puis elle est PARTadmin -> les fichiers de configuration [Configuration files] de catégorie comme « inactifs » affiché. De plus, la touche de commande activer ou désactiver la touche dans le Menu contextuel disponible, de sorte que le statut peut être changé à tout moment pouvoir.

  • VISFGUI - Contrôler la visibilité des clés et des blocs

    #:VISFGUI;<bool>

    Cette balise permet de contrôler la visibilité des clés ou des blocs dans l'interface utilisateur de PARTadmin:

    Placez le TAG sur une ligne devant le bloc ou la clé souhaitée.

    • Visible(par défaut)

      #:VISFGUI;1

      [Remarque]Remarque

      Si la valeur par défaut doit être utilisée, il n'est pas nécessaire d'activer explicitement ce marquage.

    • Non visible

      #:VISFGUI;0

  • VISFGUICFG - Contrôler la visibilité des fichiers de configuration

    #:VISFGUICFG;<bool>

    Cette balise permet de contrôler la visibilité d'un fichier de configuration dans PARTadmin:

    [Remarque]Remarque

    Placez cette balise à la fin du fichier de configuration (tout comme #:CFGHELP s'il existe).

    Laquelle des deux balises est placée en premier n'a pas d'importance. Ce qui est important, c'est que ces balises ne soient pas suivies de blocs ou de clés.

    • Visible(par défaut)

      #:VISFGUICFG;1

      [Remarque]Remarque

      Si la valeur par défaut doit être utilisée, ce marquage ne doit pas être explicitement activé.

    • Non visible

      #:VISFGUICFG;0

  • SIMPLE - Marquer les clés importantes pour les filtrer

    #:SIMPLE;<bool>

    Cette balise devrait permettre de distinguer les clés qui doivent être adaptées dans tous les cas pour un bon déroulement dans PARTsolutions.

    Dans PARTadmin, il est ainsi possible de filtrer d'excellentes clés.

    exemple :

    #:SIMPLE;1
    poolpath(isCreaOptNotSet)=?_FORMAT_0("$CADENAS_DATA/pool/solidedge/<PREFIXLIST(/)>")....

    Placez le TAG sur une ligne devant la clé souhaitée.

    • Triage standard dans PARTadmin (par défaut)

      #:SIMPLE;0

      [Remarque]Remarque

      Si la valeur par défaut doit être utilisée, ce marquage ne doit pas être explicitement activé.

    • Filtrer avec l'option Seulement les clés importantes [Only important keys] possible dans PARTadmin

      #:SIMPLE;1

Quelques exemples

#:VALS_S 
#:HELP;CheckOut Folder for Native Parts 
#:SIMPLE;1 
NativeCheckoutTargetFolder=?Application.ResolveEnv("%CADENAS_DATA%\\pool\\catia")

#:VALS_S 
#:HELP;Submenu - Tools - Activate the command that should be loaded at startup 
 and set the value on "Yes". 
If a key is disabled the code and command will not be available in CATIA. See manual.
#:INACTIVE;COMMAND_SHOW_PSOLNCScan=no

#:VALS_S 
#:VISFGUI;0 
#:INACTIVE;MetaObjectVersion=""

Anciens tags

Il existe encore d'anciennes balises dans les fichiers de configuration. Pour des raisons de gestion des versions, ces balises restent. Veuillez toutefois ne plus les utiliser pour les nouvelles balises.

Les distinctions plus anciennes sont

  • #:NAME ;

  • #:LNAME ;

  • #:DESC ;

  • #:TOOLTIP ;

  • #:SAMPLE ;

Balises spéciales sous $CADENAS_DEFAULTUSER

TAG Description

#!

  • La balise correspond à la commande du menu contextuel Toujours écraser [Overwrite always] sous PARTadmin -> Fichiers de configuration [Configuration files] au niveau de la clé: couleur de fond jaune

    La valeur de la clé dans $CADENAS_USER est à nouveau écrasée à chaque chargement de l'application.

  • La balise correspond à la commande de menu contextuel Écraser [Overwrite] sous PARTadmin -> Fichiers de configuration [Configuration files] au niveau du bloc.

    Les blocs identiques de $CADENAS_DEFAULTUSER et $CADENAS_USER sont complètement écrasés.

#-

  • La balise correspond à la commande de menu contextuel Supprimer [Delete] sous PARTadmin -> Fichiers de configuration [Configuration files] au niveau de la clé: couleur de fond rouge

#~

  • La balise correspond à la commande de menu contextuel Ne pas fusionner [Do not merge] sous PARTadmin -> Fichiers de configuration [Configuration files] au niveau du bloc.

    Les blocs identiques de $CADENAS_DEFAULTUSER et $CADENAS_USER ne sont pas maintenus.