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

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.

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.

Attribut	Description
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.

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

Tâches

Comment : vérifier les modifications du contrôle de version

Concepts

Plug-in de modèle de processus Windows SharePoint Services

Plug-in de modèle de processus Rapports

Plug-in de modèle de processus Groupes et Autorisations

Paramètres d'extraction de Team Foundation

Autres ressources

Plug-in de modèle de processus Suivi des éléments de travail