Plug-in de modèle de processus du contrôle de version

Article
08/22/2008

Mise à jour : novembre 2007

Le plug-in de contrôle de version définit les autorisations de sécurité du contrôle de version initiales d'un projet d'équipe, les notes d'archivage et indique si l'extraction exclusive est requise. Le nom de plug-in est Microsoft.ProjectCreationWizard.VersionControl. Le fichier XML de contrôle de version est nommé VersionControl.xml et figure dans le dossier Contrôle de version de la hiérarchie des dossiers du modèle de processus. Vous pouvez modifier le fichier XML et le nom du dossier si nécessaire.

Dans le fichier XML, spécifiez une ou plusieurs tâches et leurs dépendances. En général, une seule tâche suffit pour configurer les paramètres du contrôle de version. Pour obtenir un exemple d'une tâche spécifiant les paramètres de contrôle de version, consultez le fichier VersionControl.xml dans le modèle de processus MSF for Agile Software Development.

Remarque :
Team Foundation Server n'inclut pas de mécanisme pour le déploiement de plug-ins, de stratégies ou d'autres modifications côté client. Si vous ne voulez pas déployer des plug-ins, des stratégies ou d'autres modifications sur le serveur Team Explorer, vous devez utiliser votre propre programme de distribution et d'installation.

Notes d'archivage

Les notes d'archivage sont fournies par le développeur lorsque le code est archivé pour décrire comment, ou si, les modifications du code sont liées aux processus d'équipe. Par exemple, une note d'archivage peut indiquer si la modification faisait partie d'une révision de la sécurité, et inclure les détails sur les modifications relatives à la révision de la sécurité.

Utilisez l'élément checkin_note pour définir une note d'archivage.

<checkin_note label="" required="" order=""/>

Le tableau suivant décrit les attributs de l'élément checkin_note.

Attribut	Description
label	Étiquette qui décrit la note d'archivage. L'étiquette est affichée pour l'utilisateur dans la boîte de dialogue Archivages en attente lorsqu'il exécute un archivage.
required	Spécifie si la note d'archivage doit avoir une valeur. Si elle a la valeur true, la note d'archivage doit avoir une valeur. Si elle a la valeur false, l'entrée d'une valeur est facultative.
order	Spécifie un nombre ordinal pour indiquer dans quel ordre afficher les notes d'archivage. Cet attribut est facultatif.

L'exemple suivant indique comment personnaliser les notes d'archivage MSF for Agile Software Development pour fournir une note d'archivage supplémentaire nommée "Documentation Impact" qui ne doit pas nécessairement avoir une valeur.

<taskXml>
   <checkin_note label="Code Reviewer" required="false" order="1"/>
   <checkin_note label="Security Reviewer" required="false" order="2"/>
   <checkin_note label="Performance Reviewer" required="false" order="3"/> 
   <checkin_note label="Documentation Impact" required="false"/>
</taskXml>

Extraction exclusive

Vous pouvez contrôler si plusieurs personnes peuvent extraire un fichier en même temps. Utilisez l'élément exclusive_checkout pour spécifier les propriétés d'extraction.

<exclusive_checkout required=""/>

Si l'attribut requis a la valeur true, seule une personne à la fois peut extraire un fichier. S'il a la valeur false, plusieurs personnes peuvent extraire un fichier en même temps, et ils doivent harmoniser les modifications lorsqu'ils archivent le fichier.

L'exemple suivant indique comment spécifier que l'extraction exclusive est requise.

<exclusive_checkout required="true"/>

Obtenir la dernière version lors de l'extraction

Vous pouvez configurer le comportement d'extraction par défaut pour le projet d'équipe. Utilisez l'élément get_latest_on_checkout pour spécifier le comportement d'extraction.

<get_latest_on_checkout required=""/>

Si l'attribut requis a la valeur true, la version la plus récente de l'élément est téléchargée à chaque extraction. Ce comportement est semblable au comportement d'extraction de Visual SourceSafe.

Si l'attribut requis a la valeur false, l'opération extrait la version locale dans votre espace de travail. Il s'agit du comportement par défaut.

L'exemple suivant indique comment spécifier le comportement d'extraction par défaut qui consiste à obtenir la version la plus récente des éléments à l'extraction.

<get_latest_on_checkout required="true"/>

Autorisations

Le contrôle de version a un ensemble spécifique d'autorisations que vous pouvez configurer pour un modèle de processus. La spécification d'autorisations définit les actions que les groupes de sécurité et les individus peuvent exécuter sur les éléments sous le contrôle de version.

Utilisez l'élément permission pour autoriser, refuser ou autoriser et refuser des autorisations pour une identité.

<permission allow="" identity=""/>
<permission deny="" identity=""/>
<permission allow="" deny="" identity=""/>

Le tableau suivant décrit les attributs de l'élément d'autorisation.

allow

Identifie les autorisations accordées. Les autorisations sont constituées par du texte spécifié séparé par des virgules.

deny

Identifie les autorisations révoquées. Les autorisations sont constituées par du texte spécifié séparé par des virgules.

Remarque :
Les autorisations refusées ont la priorité sur les autorisations permises.

identity

Spécifie le groupe de sécurité Team Foundation Server, le groupe Windows ou l' identité Windows auquel cette autorisation est appliquée.

Le tableau suivant décrit les autorisations que vous pouvez spécifier pour le contrôle de version.

Autorisation	Description
Read	Peut lire le contenu d'un fichier ou d'un dossier.
PendChange	Peut extraire, ajouter, supprimer, créer des branches, fusionner, annuler la suppression et exécuter d'autres activités associées à un ensemble de modifications.
Checkin	Peut archiver des modifications.
Label	Peut appliquer une étiquette aux éléments.
Lock	Peut verrouiller un élément pour empêcher que d'autres personnes le mettent à jour.
ReviseOther	Peut modifier le contenu des commentaires de l'ensemble de modifications et les notes d'archivage d'une autre personne.
UnlockOther	Peut supprimer le verrouillage effectué par une autre personne.
UndoOther	Peut annuler les modifications en attente effectuées par une autre personne.
LabelOther	Peut modifier l'étiquette d'une autre personne.
AdminProjectRights	Peut configurer les paramètres de sécurité du contrôle de version.
CheckinOther	Peut effectuer l'archivage en tant qu'utilisateur différent. Cette autorisation est requise pour les utilitaires de conversion.

Remarque :
Au moment de l'exécution, si l'identité d'une autorisation est introuvable, l'autorisation est recherchée dans tous les autres groupes auxquels appartient l'identité. Si l'autorisation est introuvable, l'action par défaut consiste à refuser l'autorisation.

L'exemple suivant indique comment accorder des autorisations pour permettre au groupe Contributors de modifier des fichiers sous le contrôle de version.

<taskXml>
   <permission allow="Read, PendChange, Checkin, Label, Lock"
               identity="[$$PROJECTNAME$$]\Contributors"/>
</taskXml>

Voir aussi

Partager via

Plug-in de modèle de processus du contrôle de version

Notes d'archivage

Extraction exclusive

Obtenir la dernière version lors de l'extraction

Autorisations

Voir aussi

Tâches

Concepts

Autres ressources

Ressources supplémentaires