Cette documentation est archivée et n’est pas conservée.

Comment : créer un fichier batch ou un script Visual SourceSafe

Visual Studio 2005

Vous pouvez utiliser la ligne de commande Visual SourceSafe pour exécuter un fichier batch ou un script permettant de mécaniser les tâches de routine. Vous pouvez également inclure des commandes Visual SourceSafe dans les scripts exécutés par d'autres programmes. Tenez compte des idées suivantes lors de la préparation d'un fichier batch ou d'un script :

  • Il est déconseillé d'inclure des commandes exigeant une entrée d'utilisateur. Vous préférerez généralement désactiver l'entrée afin que les fichiers batch puissent s'exécuter sans perturbation. Consultez -I, option (ligne de commande).

  • Utilisez des codes de sortie dans vos fichiers batch pour tester l'achèvement des commandes. Le code 100 est généralement utilisé pour une erreur.

  • Si nécessaire, redirigez la sortie vers un fichier afin de conserver une trace des opérations de traitement par lots à utiliser lors de la maintenance et des tests.

Pour créer un fichier batch ou un script :

  1. Si vous souhaitez rediriger la sortie de votre fichier batch ou de votre script vers un autre fichier, consultez Comment : rediriger la sortie.

  2. Déterminez un jeu précis de commandes à utiliser lors de l'exécution d'une opération qui se reproduit fréquemment (par exemple, la purge des éléments supprimés).

  3. Utilisez un éditeur de texte pour écrire le fichier batch ou le script à l'aide du langage de votre choix.

  4. Commencez par une instruction @echo off pour désactiver la répercussion de la commande.

  5. Entrez une instruction pour votre première commande (par exemple, la commande Status affichée dans l'exemple).

  6. Vérifiez éventuellement les codes de sortie pour cette commande.

  7. Ajoutez des instructions permettant de gérer les codes de sortie.

  8. Répétez les étapes 4 à 6 jusqu'à ce que vous ayez ajouté des instructions pour toutes les commandes à exécuter.

  9. Terminez le fichier par l'instruction :END, ou l'équivalent pour le langage que vous utilisez.

  10. Exécutez votre fichier à partir de la ligne de commande afin de tester son fonctionnement.

Exemple

L'exemple suivant représente un fichier batch qui extrait des fichiers pour le nom d'utilisateur Thomas. Il montre l'utilisation de l'option -O pour désactiver la sortie, de l'option -Y pour spécifier un nom d'utilisateur et de l'option -C pour spécifier un commentaire. Il illustre également l'utilisation du code de sortie de la commande Status pour déterminer si les fichiers sont extraits.

Si vous tapez ss Checkout Help.c Help.H, et si l'un des deux fichiers est déjà extrait, Visual SourceSafe extrait l'autre fichier. L'exemple de fichier batch évite cette situation en vérifiant l'état de tous les fichiers spécifiés et en ne les extrayant que si aucun d'eux n'est extrait.

@echo off
ss status -o- -yThomas %1 %2 %3 %4 %5 %6 %7 %8 %9
if errorlevel 100 goto BAD_FAILURE
if errorlevel 1 goto CHECKED_OUT

rem Exit code 0, no files were checked out
echo No specified files are checked out: checking all out.
ss checkout "-cChecked out automatically" -yThomas %1 %2 %3 %4 %5 %6 %7 %8 %9
goto END

rem Exit code 1, something is checked out
:CHECKED_OUT
echo One or more files is checked out: quitting without checking anything out.
goto END

rem Exit code 100, something went wrong.
:BAD_FAILURE
echo Visual SourceSafe could not run successfully

:END

Voir aussi

Afficher: