Personnaliser les fichiers SS.INI et SRCSAFE.INI

Vous avez deux possibilités pour personnaliser les fichiers SS.INI et SRCSAFE.INI : utiliser les boîtes de dialogues Options ou un éditeur de texte.

Utiliser les boîtes de dialogue Options

Vous pouvez définir la plupart des variables d'initialisation SS.INI directement dans la boîte de dialogue Options du menu Outils de VSS. Seuls les administrateurs doivent définir les variables des fichiers SRCSAFE.INI, dans la boîte de dialogue Options de l'Administrateur VSS. Lorsque vous utilisez la boîte de dialogue Options, VSS sauvegarde vos modifications mais ne les écrit pas dans le fichier tant que vous ne quittez pas VSS ou ouvrez une autre base de données. Ainsi, si vous ouvrez une deuxième session VSS avant de fermer la première, vos modifications ne seront pas encore prises en compte.

Utiliser un Éditeur de texte

Les fichiers d'initialisation peuvent être lus et modifiés à l'aide de n'importe quel éditeur de texte. Les lignes de ces fichiers ne doivent pas dépasser 511 caractères, mais cette longueur maximale peut encore être réduite en fonction des conditions spécifiques applicables à chaque variable (telles que la longueur maximale du chemin d'accès des projets).

Emplacement du fichier SS.INI

Le fichier SS.INI se trouve généralement dans le sous-dossier Users du dossier dans lequel VSS est installé (SS\USERS\USERNAME, par exemple). Vous pouvez toutefois le déplacer, à condition d'informer VSS de ce changement en modifiant le fichier Users.txt (pour ce faire, contactez votre administrateur VSS).

Le fichier SRCSAFE.INI se trouve généralement dans le dossier VSS principal de l'installation du serveur.

Remarque   Les variables d'initialisation définies dans le fichier SS.INI se substituent aux paramètres du fichier SRCSAFE.INI.

Le format

Les fichiers SS.INI et SRCSAFE.INI contiennent trois types de lignes.

• Les variables d'initialisation, qui sont les lignes fonctionnelles, respectent le format suivant :

  Initialization variable = value
  

  Les variables booléennes prennent les valeurs « Yes » ou « No », « True » ou « False ».

• Les commentaires sont précédés d'un point-virgule :

  ; Salut, JP.
  

  VSS ignore tous les commentaires.

• Les en-têtes sont placés entre crochets :

  [$/Word]
  

  La plupart des en-têtes désignent des chemins d'accès à des projets spécifiques. D'autres, tels que [Keyword Comments], sont utilisés à des fins particulières.

L'ordre des variables à l'intérieur d'un fichier d'initialisation est sans importance, mais l'en-tête sous lequel est placée une variable est capital. En effet, lorsqu'une variable est placée sous un en-tête inapproprié — par exemple, une variable générale placée sous l'en-tête [Keyword Comments] — elle est ignorée.

Exécution de SS.INI sur plusieurs plates-formes

Si vous utilisez une installation de VSS sur plusieurs plates-formes, vous pouvez avoir besoin d'affecter à certaines variables une valeur différente selon la plate-forme ou l'ordinateur. Placez alors un nom de plate-forme ou d'ordinateur entre parenthèses à la suite de la variable pour indiquer qu'elle ne s'applique qu'à cette plate-forme ou cet ordinateur. Par exemple :

Use_ReadOnly (WIN) = Yes
Comment_Editor (JOE1)= c:\MSOFFICE\WINWORD\WINWORD.EXE

La valeur du premier exemple ne s'applique qu'à Microsoft Windows. Celle du second exemple, ne s'applique qu'à l'ordinateur JOE1. Les autres paramètres possibles sont :

MAC	Système d'exploitation Macintosh
NT	Système d'exploitation 32 bits
PC	Tous les systèmes d'exploitation Intel, Windows par exemple. Peut être utilisé uniquement avec UI, ne peut pas être utilisé avec CL.
UNIX	Système d'exploitation UNIX
Win	Système d'exploitation Windows
UI	Interface utilisateur Visual SourceSafe
CL	Ligne de commande Visual SourceSafe

Chaque variable du fichier SRCSAFE.INI peut-être suivie d'une spécification de plate-forme entre parenthèses. Cette spécification permet qu'une variable ait des valeurs différentes sur des plates-formes différentes. La plupart des variables reconnaissent différents noms d'ordinateurs. Seuls 10 spécificateurs de plate-forme sont autorisés par utilisateur ou 10 par fichier SS.INI.

Les différentes versions de VSS recherchent des spécificateurs différents. Par exemple, l'interface VSS pour Windows NT recherche les spécificateurs de plate-forme suivants :

JOE1, NT, Win, PC, UI

Elle recherche une variable définie pour l'ordinateur de Joe JOE1 ; si elle ne la trouve pas, elle recherche Windows NT, puis Win, puis PC, puis UI, et enfin, elle recherche une variable sans spécificateur de plate-forme.

Toutefois, vous pouvez remplacer ce paramètre en définissant une valeur pour la variable d'environnement SSINIENV. Par exemple :

Set SSINIENV = Ragiv, MS-DOS, PC, CL

VSS recherche les variables comportant la spécification Ragiv, puis celles qui comportent MS-DOS, PC, CL, et enfin celles qui n'en comportent aucune. À présent, placez les deux lignes suivantes dans le fichier SRCSAFE.INI :

Data_Path (Ragiv) = R:\SS\DATA
Data_Path (Kim) = R:\SS2\DATA

VSS tient compte de la première valeur et ignore la seconde. Si vous entrez Kim pour SSiniENV, VSS tiendrait compte de la seconde ligne et ignorerait la première. Par conséquent, en donnant à SSiniENV la valeur adéquate, vous pouvez déterminer quelle variable Data_Path VSS lira et quel dossier DATA sera utilisé.

Voir aussi

Définir un dossier de travail dans SS.INI | Utilisation d'en-têtes de projet dans les fichiers SS.INI | Aperçu des fichiers SS.ini et SRCSAFE.ini