Archiver votre contribution au code base de l'équipe

Utilisez la page Modifications en attente (raccourci : Ctrl + 0, P) pour archiver votre code dans le code base de l'équipe.

Que voulez-vous faire ?

• Spécifier les fichiers à archiver

• Associer des éléments de travail

• Archiver vos modifications

• Résoudre les avertissements de stratégie d'archivage

• Exécuter un archivage contrôlé

• S'abonner aux alertes

• Travailler depuis l'invite de commandes

• Obtenir des conseils

Spécifier les fichiers à archiver

Vous pouvez spécifier les modifications de fichier que vous souhaitez archiver en les faisant glisser entre les sections Modifications incluses et Modifications exclues de la page Modifications en attente. Vous pouvez également étendre votre archivage à mesure que vous travaillez dans d'autres zones de Visual Studio :

• Dans l'Explorateur de solutions, sélectionnez un des éléments suivants :

  • La solution

  • Un ou plusieurs projets de code

  • Un ou plusieurs fichiers

  Après avoir sélectionné les éléments, ouvrez leur menu contextuel, puis choisissez Archiver.

• Dans l'Explorateur du contrôle de code source, sélectionnez un ou plusieurs éléments avec des modifications en attente ou un ou plusieurs dossiers qui contiennent des éléments avec des modifications en attente. (Les éléments comportant des modifications en attente sont indiqués par le symbole suivant : ). Ouvrez le menu contextuel des éléments sélectionnés, puis choisissez Archiver.

Associer des éléments de travail

Lorsque vous modifiez des fichiers dans votre code base, vous le faites généralement pour terminer une tâche, corriger un bogue ou répondre à la demande d'un autre type d'élément de travail. Lorsque vous archivez les modifications, vous devez associer de tels éléments de travail aux modifications que vous archivez. Les avantages sont les suivants :

• Un membre de l'équipe qui examine l'élément de travail peut établir un lien direct avec l'ensemble de modifications pour voir le travail que vous avez effectué.

• Un membre de l'équipe qui examine l'historique d'un fichier que vous avez modifié peut afficher l'ensemble des modifications et voir les éléments de travail justifiant la modification.

• Si vous générez vos modifications dans votre système de génération automatisé (par exemple avec une Build CI ou une Build d'archivage contrôlé), les membres de l'équipe peuvent voir dans quelle build terminée la tâche a été terminée ou le bogue a été résolu.

Pour associer des éléments de travail à votre archivage :

• Sélectionnez le lien Ajouter un élément de travail par ID dans la section Éléments de travail associés.

• Faites glisser un élément de travail d'une fenêtre de requête dans la section Éléments de travail associés.

En regard de chaque élément de travail, sélectionnez la façon dont il doit être lié à votre archivage : Associer ou Résoudre (disponible uniquement si l'élément de travail n'est pas déjà dans un état qui exclut cette relation, tel que Résolu, Terminé ou Fermé).

Conseil

Vous pouvez ouvrir le menu contextuel d'un élément de travail associé puis sélectionner :

• Ouvrir l'élément de travail pour ouvrir l'élément de travail dans un onglet provisoire.Si vous souhaitez consulter l'élément de travail dans un onglet normal, ouvrez le menu contextuel de l'onglet et sélectionnez Ouvrir l'onglet (raccourci : Ctrl + Alt + Début).

• Supprimer l'élément de travail si vous ne souhaitez pas associer l'élément de travail à votre archivage.

• Nouvel élément de travail lié, Créer une copie de l'élément de travail ou Lier à un élément existant.

Archiver vos modifications

Pour archiver vos modifications

1. Dans Team Explorer, choisissez Accueil, puis choisissez Modifications en attente (raccourci : Ctrl + 0, P).

2. Sur la page Modifications en attente, entrez un commentaire afin que les coéquipiers qui ont besoin ultérieurement d'examiner et de comprendre l'historique de vos fichiers comprennent ce que vous avez fait. Par exemple : Contrôleur de panier d'achat implémenté.

3. Certaines équipes préfèrent que leurs membres fournissent certains genres d'informations sur chaque archivage. Dans certains cas, ils implémentent même une stratégie d'archivage pour l'exiger. Si un administrateur de votre projet d'équipe a activé les notes d'archivage, vous pouvez taper les informations dans chaque champ de la section Remarques.

4. Choisissez le bouton Archiver.

L'un des résultats suivants se produit.

Vos modifications sont archivées

Toutes les modifications de fichier incluses dans votre espace de travail ainsi que le commentaire, les notes d'archivage et les liens vers les éléments de travail associés sont stockés sur le serveur en tant qu'ensemble de modifications unique sur votre serveur.

Les conflits bloquent votre archivage

Le système vous indique les conflits entre vos modifications et la dernière version des fichiers sur le serveur. Consultez Résoudre les conflits du contrôle de version Team Foundation.

Votre archivage est bloqué car il ne respecte pas la stratégie d'archivage.

Les administrateurs de votre projet d'équipe peuvent implémenter des stratégies d'archivage pour encourager votre équipe à suivre les meilleures pratiques. Par exemple, une stratégie d'archivage peut encourager les membres de l'équipe à associer au moins un élément de travail avec leurs modifications. Pour plus d'informations, consultez Set and Enforce Quality Gates.

Dans certains cas, vous pouvez substituer ces stratégies d'archivage. Dans la section Avertissements de stratégie, choisissez Avertissements de substitution.

Dans la zone Raison, expliquez pourquoi vous substituez la stratégie.

Archiver dans un dossier contrôlé par un processus de build d'archivage contrôlé

Si vous archivez des modifications dans des dossiers du contrôle de version contrôlés par un processus de build d'archivage contrôlé, la boîte de dialogue Archivage contrôlé s'affiche. Pour plus d'informations sur l'exécution d'une opération d'archivage, consultez Archiver des modifications en attente contrôlées par une build d'archivage contrôlé.

S'abonner aux alertes

Si vous voulez être averti lorsqu'un utilisateur archive du code dans votre projet d'équipe TFVC, vous pouvez vous abonner pour recevoir des alertes par courrier électronique. Voici comment.

Travailler depuis l'invite de commandes

• Checkin, commande: affichage des modifications en attente et archivage des fichiers

Conseils

• Vous pouvez détacher la page Modifications en attente à partir de Team Explorer et l'ouvrir dans une nouvelle fenêtre.

• Vous pouvez permuter entre la vue Liste et l'arborescence à partir du menu Actions.

• Avant d'archiver le nouveau code, vous devriez envisager de mener une révision du code. Consultez Interrompez le travail, résolvez un bogue, et effectuez une révision du code.

• Vous pouvez gérer et, si nécessaire, annuler vos modifications en attente. Consultez Développer du code et gérer des modifications en attente.

• Si vous devez mettre de côté les modifications, consultez Interrompre votre travail et gérer vos jeux de réservations.

• L'opération d'archivage est exécutée de façon atomique, ce qui signifie qu'elle réussit totalement ou qu'elle échoue totalement (à une exception près). Si l'une des modifications figurant dans la liste des modifications en attente ne peut pas être soumise au serveur Team Foundation, aucune des modifications n'est validée et aucun ensemble de modifications n'est créé. Par exemple, si la connexion réseau s'interrompt au milieu de l'opération d'archivage, toute l'opération échoue.

  L'exception est l'association d'éléments de travail avec l'ensemble de modifications. En cas d'échec de l'association d'éléments de travail mais que tous les autres aspects de l'archivage réussissent, l'ensemble de modifications est créé. Vous pouvez associer manuellement un élément de travail à un ensemble de modifications. Consultez Lier des éléments de travail et des objets pour la prise en charge de la traçabilité.