Partager via


Ajout de champs d'intégration dans des types d'éléments de travail

Mise à jour : novembre 2007

Le système du suivi des éléments de travail Team Foundation s'intègre avec d'autres composants de Team Foundation Server et de Visual Studio Team System. Pour optimiser l'intégration entre composants, vous utilisez certains champs et actions dans les types d'éléments de travail. Cette rubrique décrit comment vous utilisez ces champs et actions obligatoires dans les sections suivantes :

  • Intégration avec Team Build

  • Intégration avec les outils de test Visual Studio

  • Intégration du contrôle de code source Team Foundation

Intégration avec Team Foundation Build

Team Foundation Build est le système de génération automatisé de Team Foundation Server. Vous pouvez configurer votre processus de génération à l'aide de Team Foundation Build. Team Foundation Build peut générer des éléments de travail lorsqu'une génération échoue. Il peut également ajouter des informations de génération aux éléments de travail qui ont été résolus dans une génération particulière. Pour ce faire, Team Foundation Build requiert les deux champs suivants : Found In et Integration Build.

Ajout du champ Trouvé dans

Team Foundation Build crée un élément de travail lorsqu'une génération échoue et attribue le champ Found In au numéro de build de la génération qui vient d'échouer. Le champ Found In doit être présent dans le type d'élément de travail à créer par Team Foundation Build lorsqu'une génération échoue. Si le champ Found In est manquant, Team Foundation Build ne crée pas d'élément de travail pour la génération qui a échoué, mais tout le reste fonctionne comme prévu.

Le tableau suivant récapitule les noms et valeurs des attributs de champ Found In.

Nom d'attribut

Valeur d'attribut

RefName

Microsoft.VSTS.Build.FoundIn

Name

Peut avoir n'importe quelle valeur car le fonctionnement des intégrations est basé sur les noms de références de champs, et non pas sur les noms de champs.

Type

Chaîne

Exemple du champ Trouvé dans

<FIELD name="Found In" refname="Microsoft.VSTS.Build.FoundIn" type="String" reportable="dimension">
    <HELPTEXT>Product build number (revision) in which this item was found</HELPTEXT>
</FIELD>

Ajout du champ Build d'intégration

Team Foundation Build identifie les éléments de travail qui ont été résolus avec chaque génération, puis les met à jour pour définir le numéro de build dans lequel ils ont été résolus. Il définit le numéro de build dans le champ Integration Build Si le champ Integration Build est manquant, Team Foundation Build ne stocke pas le numéro de build dans les éléments de travail mais tout le reste fonctionne comme prévu.

Le tableau suivant récapitule les noms et valeurs des attributs de champ Integration Build.

Nom d'attribut

Valeur d'attribut

RefName

Microsoft.VSTS.Build.IntegrationBuild

Name

Peut avoir n'importe quelle valeur car le fonctionnement des intégrations est basé sur les noms de références de champs, et non pas sur les noms de champs.

Type

Chaîne

Exemple du champ Build d'intégration

<FIELD name="Integration Build" refname="Microsoft.VSTS.Build.IntegrationBuild" type="String" reportable="dimension">
    <HELPTEXT>Product build number this bug was fixed in</HELPTEXT>
</FIELD>

Intégration avec les outils de test Visual Studio

Certaines versions de Visual Studio incluent des outils de test qui sont intégrés dans l'environnement de développement. La capacité à créer de nouveaux éléments de travail lorsqu'un test échoue fait partie des fonctionnalités disponibles dans les outils de test. Pour ce faire, dans la fenêtre Résultats des tests, cliquez avec le bouton droit sur le résultat pour lequel vous souhaitez créer un bogue, pointez sur Créer un élément de travail, puis cliquez sur le type d'élément de travail que vous souhaitez créer, par exemple Bogue. Pour plus d'informations, consultez Comment : créer un élément de travail à partir d'un résultat de test.

Lorsqu'un élément de travail a été créé de cette manière, trois champs peuvent être remplis automatiquement pour fournir des informations sur l'échec du test. Les trois champs sont TestName, TestId et TestPath. Visual Studio Test Edition définit ces trois champs avec des informations spécifiques relatives au test qui a échoué. Si les champs TestName, TestId et TestPath sont absents de l'élément de travail, les champs ne sont pas définis mais tout le reste fonctionne comme prévu.

Le tableau suivant récapitule les noms et les valeurs des attributs de ces trois champs.

Nom d'attribut

Valeur d'attribut

RefName

Microsoft.VSTS.Test.TestName, Microsoft.VSTS.Test.TestId, Microsoft.VSTS.Test.TestPath

Name

Peut avoir n'importe quelle valeur car le fonctionnement des intégrations est basé sur les noms de références de champs, et non pas sur les noms de champs.

Type

Chaîne

Exemple des champs TestName, TestId et TestPath

<FIELD name="Test Name" refname="Microsoft.VSTS.Test.TestName" type="String" reportable="detail">
    <HELPTEXT>The name of the test that found this bug</HELPTEXT>
</FIELD>
<FIELD name="Test Id" refname="Microsoft.VSTS.Test.TestId" type="String" reportable="detail">
    <HELPTEXT>The Id of the test that found this bug</HELPTEXT>
</FIELD>
<FIELD name="Test Path" refname="Microsoft.VSTS.Test.TestPath" type="String" reportable="detail">
    <HELPTEXT>The full pathname of the test that found this bug</HELPTEXT>

Intégration du contrôle de code source Team Foundation

L'une des fonctionnalités du contrôle de version Team Foundation est que vous pouvez associer ou résoudre des éléments de travail tout en archivant le code. Vous avez probablement travaillé sur un élément de travail donné lors de la modification d'un code donné et vous pouvez définir cette association à partir de la fenêtre d'archivage du contrôle de code source lorsque vous avez fini de travailler sur le code.

La capacité du contrôle de version Team Foundation à résoudre un élément de travail requiert que les éléments de travail contiennent une action particulière. Le système de contrôle de code source interroge ensuite le suivi des éléments de travail pour déterminer si l'élément de travail prend en charge cette action et, si tel est le cas, il interroge également la source et les états de destination de la transition. Si l'action est trouvée, le système de contrôle de code source peut effectuer la transition de l'élément de travail en fonction de la transition définie tout en archivant le code.

Remarque :

Lorsque vous utilisez l'action Checkin, vous devez définir les états "de" et "à" pour refléter la transition d'état de votre choix.

Pour plus d'informations sur les actions, consultez Association d'une transition d'état à une action et Détails des actions de transition.

Exemple de l'action Archivage

<TRANSITION from="Active" to="Resolved">
....
    <ACTIONS>
        <ACTION value="Microsoft.VSTS.Actions.Checkin"/>
    </ACTIONS>
....  
</TRANSITION>

Voir aussi

Tâches

Comment : créer un élément de travail à partir d'un résultat de test

Concepts

Association d'une transition d'état à une action

Détails des actions de transition

Autres ressources

Personnalisation des types d'éléments de travail

Définition du flux de travail des éléments de travail