Importer, mettre à jour et exporter des éléments de travail en bloc avec des fichiers CSV dans Azure Boards

Importez et exportez des éléments de travail en bloc à l’aide de fichiers au format CSV dans Azure Boards. 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.

Vous pouvez exporter des éléments de travail en bloc à l’aide d’un fichier au format CSV. Même si vous continuez à utiliser Excel pour l’importation en bloc et les mises à jour, vous pouvez utiliser la fonctionnalité d’exportation native à partir de requêtes, qui ne nécessite pas Excel. Pour plus d’informations, consultez Ajouter ou modifier les éléments de travail en bloc avec Excel.

Importer de nouveaux éléments de travail

Pour importer des éléments de travail en bloc, le fichier CSV doit contenir les champs Type d’élément de travail et Titre . Vous pouvez inclure d’autres champs si nécessaire. Pour importer un fichier CSV :

• N’incluez pas le champ ID .
• Si le fichier CSV a été exporté à partir d’un autre projet, supprimez les champs qui contiennent une valeur spécifique au projet source. Par exemple, pour supprimer le chemin d’accès à la zone, balises pour obtenir la liste des champs par défaut, consultez l’index du champ Élément de travail.
• Lors de l’importation de cas de test, vous devez inclure le champ Étapes de test. Pour obtenir plus d’informations, consultez Cas de test d’importation ou d’exportation en bloc. N’incluez pas les champs Affecté à, Date modifiée, Créé par ou État .
• Vérifiez que les champs Type d’élément de travail et Titre sont inclus dans le fichier CSV.
• Vérifiez que le type d’élément de travail est un type valide dans le projet cible.
• Vérifiez que les champs du fichier CSV correspondent aux champs fi=ou au type d’élément de travail dans le projet cible.
• Si vous importez un fichier CSV qui contient des éléments de travail qui ont des valeurs non valides, une fois que vous importez le fichier, vous devez modifier les éléments de travail pour corriger les valeurs non valides avant de pouvoir enregistrer les éléments de travail.

Procédez comme suit pour importer de nouveaux éléments de travail.

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.

   L’exemple suivant inclut 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. À partir du portail web de votre projet, ouvrez Tableaux>Requêtes, puis sélectionnez Importer des éléments de travail.

   

4. Sélectionnez Choisir un fichier, choisissez votre fichier, puis sélectionnez 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 pas d’ID aux nouveaux éléments de travail que vous ajoutez. L’affectation d’ID entraîne un message d’erreur.

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 se trouve 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.

   

Les conseils suivants peuvent être utiles.

• Liens parent-enfant : 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 Puis-je importer un fichier CSV contenant des liens parent-enfant ? Toutefois, vous ne pouvez pas spécifier d’autres types de liens lorsque vous importez ou mettez à jour des éléments de travail.

• Champ État par défaut : lorsque vous importez de nouveaux éléments de travail, le champ État est défini sur Nouveau par défaut. Vous ne pouvez pas spécifier un état différent pendant le processus d’importation. Si vous devez modifier l’état des éléments de travail importés, utilisez la solution de contournement suivante :

  1. Importez les éléments de travail avec l’état Nouveau par défaut.
  2. Exportez les éléments de travail importés dans un fichier CSV.
  3. Mettez à jour les valeurs de champ État dans le fichier CSV exporté.
  4. Réimportez le fichier CSV mis à jour pour définir les états souhaités.

• Champs Zone et Itération par défaut : les champs Zone et Itération sont par défaut du nœud de niveau supérieur. Ce comportement se produit parce que le processus d’importation n’a pas le contexte de ces champs, sauf indication explicite dans le fichier CSV. Pour définir des chemins d’accès de zone et d’itération spécifiques lors de l’importation, vérifiez que ces champs sont inclus dans votre fichier CSV avec les valeurs correctes. Par exemple :

  Title,Description,Area Path,Iteration Path
  "Sample Work Item","This is a sample description.","Project\Team","Project\Sprint 1"
  

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é doit ressembler à l’exemple suivant :

   ID,Work Item Type,Title,Assigned To,State,Tags
   "272","Issue","Fix issues with code","Active","",
   "273","Issue","Merge testing modules","Active","",
   "274","Issue","Open private preview for select customers","Active","",
   "275","Issue","Enable feature for customer champs","Active","",
   "276","Issue","Remove old test code","Active","",
   

2. Apportez les modifications à vos éléments de travail. Votre fichier CSV doit contenir les champs ID, Type d’élément de travail, et Titre. 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 les valeurs sur les éléments de travail existants.

   ID,Work Item Type,Title,Assigned To,State,Tags
   "272","Issue","Fix issues with code","Jamal Hartnett <fabrikamfiber4@hotmail.com>","Active",
   "273","Issue","Merge testing modules","Jamal Hartnett <fabrikamfiber4@hotmail.com>","Active",
   "274","Issue","Open private preview for select customers","Raisa Pokrovskaya <fabrikamfiber5@hotmail.com>","Active",
   "275","Issue","Enable feature for customer champs","Raisa Pokrovskaya <fabrikamfiber5@hotmail.com>","Active",
   "276","Issue","Remove old test code","Christie Church <fabrikamfiber1@hotmail.com>","Active",
   

3. Enregistrez le fichier et importez, comme décrit dans la section 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é.

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 : 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 à partir de CSV, pour des raisons de performances, le sélecteur d’identités ne passe pas par ces étapes supplémentaires. Il vérifie simplement s’il existe un UPN (User Principal Name) correspondant déjà dans l’organisation. S’il ne trouve pas d’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.