Importer et mettre à jour des éléments de travail en bloc à l’aide de fichiers CSV

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Importez et exportez des éléments de travail en bloc en tirant parti d’un fichier au format CSV dans Azure DevOps. Bien que vous puissiez continuer à utiliser Excel pour l’importation et les mises à jour en bloc, vous pouvez utiliser la fonctionnalité d’importation/exportation native qui ne nécessite pas Excel. Pour plus d’informations, consultez Ajouter ou modifier les éléments de travail en bloc avec Excel.

Remarque

La fonctionnalité d’exportation est disponible avec Azure DevOps Server 2019 Update 1 et versions ultérieures. La fonctionnalité d’importation est disponible avec Azure DevOps Server 2020 et Azure DevOps Services.

Importer de nouveaux éléments de travail

Tous les éléments de travail que vous importez sont créés dans un état Nouveau. Cette règle signifie que vous ne pouvez pas spécifier de valeurs de champ qui ne répondent pas aux règles de champ pour le nouvel état. Par exemple, lorsque vous créez un récit utilisateur avec le processus Agile, l’État = Nouveau et la Raison = Nouveau. Vous ne pouvez pas spécifier d’autres valeurs.

1. Créez un fichier import.csv local et ouvrez-le dans Visual Studio Code ou Excel.

2. Le fichier doit contenir les champs Type d’élément de travail et Titre. Vous pouvez inclure d’autres champs si nécessaire. Pour obtenir la liste des champs par défaut, consultez Index des champs d’élément de travail.

   Dans l’exemple suivant, nous incluons le champ Priorité.

   Work Item Type,Title,Priority
   Issue,Fix issues with code,1
   Issue,Merge testing modules,3
   Issue,Open private preview for select customers,2
   Issue,Enable feature for customer champs,2
   Issue,Remove old test code,2
   

3. Dans le portail web de votre projet, ouvrez Tableaux - Requêtes, puis sélectionnez l’option Importer des éléments de travail.

   

4. Sélectionnez votre fichier CSV, puis Importer.

   

   Le processus d’importation charge les éléments de travail importés dans la vue Requêtes dans un état non enregistré. Aucun ID n’a été attribué.

5. Vérifiez les résultats, puis sélectionnez Enregistrer les éléments pour enregistrer les éléments de travail.

   

   Conseil

   N’affectez aucun ID aux nouveaux éléments de travail que vous ajoutez. Sinon, vous recevrez un message d’erreur.

   TFS401232 : l’élément de travail 1794 n’existe pas ou vous ne disposez pas des autorisations pour le lire.

6. Le système met en évidence ces éléments de travail avec des problèmes de données. Résolvez les problèmes de données avant d’enregistrer les éléments de travail. Dans cet exemple, une valeur non valide a été entrée dans le champ Priorité. Corrigez les données en ouvrant directement l’élément de travail. Utilisez plutôt la modification en bloc pour résoudre plusieurs éléments de travail avec le même problème.

   

Conseil

Vous pouvez ajouter des liens parent-enfant entre les éléments de travail que vous importez en mettant en retrait les colonnes de titre, comme indiqué dans l’exemple plus loin dans cet article, Puis-je importer un fichier CSV contenant des liens parent-enfant ?. Toutefois, vous ne pouvez pas spécifier d’autres types de liens lors de l’importation ou de la mise à jour d’éléments de travail.

Remarque

Vous pouvez importer jusqu’à 1 000 éléments de travail à la fois. Si vous avez plus de 1 000 éléments de travail à importer, divisez-les en plusieurs fichiers et importez-les séparément.

Mettre à jour des éléments de travail existants

1. Pour mettre à jour des éléments de travail, créez une requête qui contient toutes les colonnes que vous souhaitez exporter et éventuellement modifier. Enregistrez votre requête et sélectionnez Exporter au format CSV pour enregistrer le fichier data.csv sur votre ordinateur local.

   

   Le fichier exporté devrait ressembler à la syntaxe suivante :

    ID,Work Item Type,State,Assigned To,Title,Tags
    "1043","Issue","To Do",,"Fix issues with code",
    "1044","Issue","To Do",,"Merge testing modules",
    "1045","Issue","To Do",,"Open private preview for select customers",
    "1046","Issue","To Do",,"Enable feature for customer champs",
    "1047","Issue","To Do",,"Remove old test code",
   

2. Apportez les modifications à vos éléments de travail. Votre fichier CSV doit contenir les champs ID, Type d’élément de travail, Titre et État. Tous les autres champs que vous souhaitez inclure sont facultatifs.

   Remarque

   Lorsque vous importez des champs d’identité, entrez le nom et l’e-mail au format suivant "Display Name <email>". Par exemple, pour affecter du travail à Jamal Hartnett, spécifiez "Jamal Hartnett <fabrikamfiber4@hotmail.com>". Si vous spécifiez une valeur qui n’est pas reconnue comme un utilisateur valide pour le système, vous pourriez rencontrer des problèmes avec l’importation.

   Dans l’exemple suivant, nous modifions plusieurs valeurs sur des éléments de travail existants.

   "1043","Issue","To Do","Jamal Hartnett <fabrikamfiber4@hotmail.com>","Fix issues with code",architecture
   "1044","Issue","To Do","Jamal Hartnett <fabrikamfiber4@hotmail.com>","Merge testing modules",testing
   "1045","Issue","To Do","Raisa Pokrovskaya <fabrikamfiber5@hotmail.com>","Open private preview for select customers","customer focus"
   "1046","Issue","To Do","Raisa Pokrovskaya <fabrikamfiber5@hotmail.com>","Enable feature for customer champs","customer focus"
   "1047","Issue","To Do","Christie Church <fabrikamfiber1@hotmail.com>","Remove old test code",architecture```
   
   

3. Enregistrez le fichier et importez-le (consultez les étapes 4 à 6 de la section d’importation précédente.)

4. La liste des résultats avec les éléments de travail qui contiennent des modifications de valeur apparaît avec une mise en évidence en gras. Sélectionnez Enregistrer les éléments pour appliquer les modifications.

   

5. Les éléments de travail présentant des problèmes de données sont mis en surbrillance en rouge et doivent être résolus avant de pouvoir les enregistrer. Dans cet exemple, une valeur non valide apparaît dans le champ Affecté à. Corrigez les données en ouvrant directement l’élément de travail. Vous pouvez utiliser la modification en bloc si vous avez de nombreux éléments de travail avec le même problème.

   

Exporter la liste en tant que fichier CSV

À partir de n’importe quelle requête, vous pouvez exporter une liste d’éléments de travail sous la forme d’une liste délimitée par des virgules. Ouvrez la requête, sélectionnez l’icône d’actions , puis Exporter au format CSV.

Exporter et importer des éléments de travail dans un autre projet

Vous pouvez utiliser cette fonctionnalité pour exporter des éléments de travail à partir d’un projet et les importer dans un autre projet. Toutefois, avant de les importer dans un autre projet, vous devez supprimer l’ID d’élément de travail. Vous recevez une erreur si vous tentez d’importer de nouveaux éléments de travail dans un projet avec un ID spécifié.

Importer ou mettre à jour des champs de texte enrichi

Vous pouvez mettre à jour ou importer des champs de texte enrichi, comme les champs Description ou Critères d’acceptation. Les champs de texte enrichi sont des champs au format HTML. Remplacez les lignes se terminant par CRLF en entourant les phrases par <p>... </p>.

Par exemple, vous pouvez importer l’élément de travail suivant, qui comprend trois lignes de texte dans le champ Description.

Work Item Type,Title,Description
"Product Backlog Item","Hello World Web Site - 8","<p><strong>&nbsp;You can include bold text</strong></p><p><em>&nbsp;And italic text</em></p><p><u>&nbsp;Underline text</u></p>"

FAQ

Q : Puis-je importer de nouveaux éléments et mettre à jour des éléments existants dans le même fichier CSV ?

R : Absolument ! Laissez le champ ID vide pour les nouveaux éléments de travail. Dans l’exemple suivant, la dernière entrée d’une épopée ne spécifie pas d’ID.

ID,Work Item Type,Title,Assigned To,State,Priority,Tags
"16504","Issue","Fix issues with code",,"To Do","1",
"16505","Issue","Merge testing modules",,"To Do","3",
"16506","Issue","Open private preview for select customers",,"To Do","2",
"16507","Issue","Enable feature for customer champs",,"To Do","2",
"16508","Issue","Remove old test code",,"To Do","2",
,"Epic","Track Telemetry for data imports",,"To Do","2",

Q : Comment ajouter plusieurs étiquettes ?

R : Vous pouvez ajouter plusieurs étiquettes séparées par point-virgule. Pour plus d’informations, consultez Tâches que vous pouvez et ne pouvez pas effectuer avec Excel.

Q : Puis-je importer un fichier CSV contenant des liens parent-enfant ?

R : Oui, vous pouvez ajouter des éléments de travail enfants en mettant en retrait les colonnes de titre. L’exemple suivant ajoute trois problèmes enfants sous l’épopée déjà définie.

ID,Work Item Type,Title 1,Title 2,Assigned To,State,Priority,Tags
"165","Epic","Track Telemetry for data imports",,,"To Do","2",
,"Issue",,"Fix issues with code",,"To Do","1",
,"Issue",,"Open private preview for select customers",,"To Do","2",
,"Issue",,"Enable feature for customer champs",,"To Do","2",

Q : Comment savoir si mon fichier importé contient des erreurs ?

R : Vous pouvez tester en ajoutant des étiquettes avec des espaces et des traits d’union, par exemple, et les inclure dans l’exportation. L’importation doit correspondre au même format. Tout problème de mise en forme de votre fichier CSV apparaît dans la page Résultats de la vue d’importation. Vous ne pouvez pas importer les éléments de travail tant que la mise en forme et la syntaxe ne sont pas correctes.

Les résultats de l’élément de travail répertorient toujours les erreurs de données détectées pour des éléments de travail individuels. Corrigez chaque erreur à partir du portail web ou dans le fichier CSV et importez à nouveau.

Q : Pourquoi est-ce que je reçois des erreurs pour certaines valeurs d’identité ?

R : Lorsque vous utilisez l’interface utilisateur web, le sélecteur d’identité effectue des étapes supplémentaires pour valider l’utilisateur. Tout d’abord, il vérifie si la personne est un utilisateur valide dans l’organisation. Si ce n’est pas le cas, il recherche l’identité dans Microsoft Entra ID. Si l’utilisateur se trouve dans Microsoft Entra ID, mais pas dans l’organisation, cet utilisateur est ajouté aux identités valides. Lorsque vous importez via CSV, pour des raisons de niveau de performance, le sélecteur d’identité ne passe pas par ces étapes supplémentaires. Il vérifie uniquement qu’un UPN correspondant existe déjà dans l’organisation. S’il ne trouve aucun UPN correspondant, il signale que l’identité est inconnue.

Q : L’importation CSV prend-elle en charge tous les types d’élément de travail ?

R : Non. L’importation CSV ne prend pas en charge les types d’élément de travail suivants :

• Demande de revue du code
• Réponse de revue du code
• Demande de commentaires
• Réponse aux commentaires
• Cas de test
• Plan de test
• Suite de tests
• Paramètre partagé

Pour obtenir plus d’informations, consultez Cas de test d’importation ou d’exportation en bloc.

Articles connexes

• Index des champs d’élément de travail
• Ajouter ou modifier les éléments de travail en bloc avec Excel
• Questions fréquentes (FAQ) : Utilisation d’Excel avec une connexion à Azure Boards