Importera och uppdatera massarbetsobjekt med CSV-filer

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

Importera och exportera arbetsobjekt i bulk med en CSV-formaterad fil i Azure DevOps. Även om du kan fortsätta använda Excel för massimport och uppdateringar, kan du använda den inbyggda import/export-funktionen som inte kräver Excel. Mer information finns i Masstillägg eller ändring av arbetsobjekt med Excel.

Kommentar

Exportfunktionen är tillgänglig med Azure DevOps Server 2019 Update 1 och senare versioner. Importfunktionen är tillgänglig med Azure DevOps Server 2020 och Azure DevOps Services.

Importera nya arbetsobjekt

Alla arbetsobjekt som du importerar skapas i ett nytt tillstånd. Den här regeln innebär att du inte kan ange fältvärden som inte uppfyller fältreglerna för det nya tillståndet. När du till exempel skapar en ny användarberättelse med agilprocessen, State = New och Reason = New. Du kan inte ange några andra värden.

1. Skapa en lokal import.csv-fil och öppna den i Visual Studio Code eller Excel.

2. Filen måste innehålla fälten Arbetsobjekttyp och Rubrik . Du kan inkludera andra fält efter behov. En lista över standardfält finns i Fältindex för arbetsobjekt.

   I följande exempel inkluderar vi fältet Prioritet .

   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. Öppna Boards - Queries från webbportalen för projektet och välj sedan alternativet Importera arbetsobjekt.

   

4. Välj csv-filen och välj sedan Importera.

   

   Importprocessen läser in de importerade arbetsobjekten i frågevyn i ett tillstånd som inte har sparats . Inga ID:n tilldelas.

5. Kontrollera resultatet och välj sedan Spara objekt för att spara arbetsobjekten.

   

   Dricks

   Tilldela inte ID:n till nya arbetsobjekt som du lägger till, annars får du ett felmeddelande.

   TFS401232: Arbetsobjektet 1794 finns inte eller så har du inte behörighet att läsa det.

6. Systemet markerar dessa arbetsobjekt med dataproblem. Lös dataproblemen innan du sparar arbetsobjekten. I det här exemplet har ett ogiltigt värde angetts i fältet Prioritet. Åtgärda data genom att öppna arbetsobjektet direkt. Använd i stället massredigering för att åtgärda flera arbetsobjekt med samma problem.

   

Dricks

Du kan lägga till överordnade och underordnade länkar mellan arbetsobjekt som du importerar genom att dra in rubrikkolumnerna som visas i exemplet senare i den här artikeln, Kan jag importera en CSV-fil som har länkar mellan överordnad och underordnad? Du kan emellertid inte ange några andra länktyper när du importerar eller uppdaterar arbetsuppgifter.

Kommentar

Du kan importera upp till 1 000 arbetsobjekt åt gången. Om du har fler än 1 000 arbetsobjekt att importera kan du dela upp dem i flera filer och importera dem separat.

Uppdatera befintliga arbetsobjekt

1. Om du vill uppdatera arbetsobjekt skapar du en fråga som innehåller alla kolumner som du vill exportera och eventuellt redigera. Spara frågan och välj Exportera till CSV för att spara filen data.csv på den lokala datorn.

   

   Den exporterade filen bör se ut ungefär så här:

    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. Gör ändringarna i dina arbetsobjekt. CSV-filen måste innehålla fälten ID, Arbetsobjekttyp, Rubrik och Tillstånd. Alla andra fält som du vill inkludera är valfria.

   Kommentar

   När du importerar identitetsfält anger du namnet och e-postmeddelandet i följande format "Display Name <email>". Om du till exempel vill tilldela arbete till Jamal Hartnett anger du "Jamal Hartnett <fabrikamfiber4@hotmail.com>". Om du anger ett värde som inte känns igen som en giltig användare i systemet kan det uppstå problem med importen.

   I följande exempel ändrar vi flera värden för befintliga arbetsobjekt.

   "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. Spara filen och importera (se steg 4–6 från föregående importavsnitt.)

4. Resultatlistan med arbetsobjekt som innehåller värdeändringar visas markerad i fetstil. Välj Spara objekt för att tillämpa ändringarna.

   

5. Arbetsobjekt med dataproblem markeras i rött och måste lösas innan du kan spara dem. I det här exemplet visas ett ogiltigt värde i fältet Tilldelad till. Åtgärda data genom att öppna arbetsobjektet direkt. Du kan använda massredigering om du har många arbetsobjekt med samma problem.

   

Exportera listan som en CSV-fil

Från valfri fråga kan du exportera en lista över arbetsobjekt som en kommaavgränsad lista. Öppna frågan, välj åtgärdsikonen och välj sedan Exportera till CSV.

Exportera och importera arbetsobjekt till ett annat projekt

Du kan använda den här funktionen för att exportera arbetsobjekt från ett projekt och importera dem till ett annat projekt. Innan du importerar dem till ett annat projekt måste du dock ta bort arbetsobjektets ID. Du får ett felmeddelande om du försöker importera nya arbetsobjekt till ett projekt med ett angivet ID.

Importera eller uppdatera RTF-fält

Du kan uppdatera eller importera rtf-fält, till exempel fälten Beskrivning eller Godkännandevillkor . RTF-fält är HTML-formaterade fält. Ersätt rader som slutar i CRLF med omgivande meningar med <p>... </p>.

Du kan till exempel importera följande arbetsobjekt, som innehåller tre textrader i fältet Beskrivning.

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>"

Vanliga frågor och svar

F: Kan jag importera nya objekt och uppdatera befintliga objekt i samma CSV-fil?

S: Absolut! Lämna ID-fältet tomt för alla nya arbetsobjekt. I följande exempel anger inte den sista posten för ett epos något 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",

F: Hur gör jag för att lägga till flera taggar?

S: Du kan lägga till flera taggar avgränsade med ett semikolon. Mer information finns i Uppgifter som du kan och inte kan göra med Excel.

F: Kan jag importera en CSV-fil som har överordnade och underordnade länkar?

S: Ja, du kan lägga till underordnade arbetsobjekt genom att dra in rubrikkolumner. I följande exempel läggs tre underordnade problem till under det redan definierade eposet.

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",

F: Hur gör jag för att vet om min importerade fil har fel?

S: Du kan till exempel testa genom att lägga till taggar med blanksteg och bindestreck och inkludera dem i exporten. Importen ska matcha samma format. Eventuella problem med formateringen av CSV-filen visas på sidan Resultat i importvyn. Du kan inte importera arbetsobjekten förrän formateringen och syntaxen är korrekt.

Resultatet av arbetsobjektet visar alltid de datafel som hittades för enskilda arbetsobjekt. Åtgärda varje fel antingen från webbportalen eller i CSV-filen och importera igen.

F: Varför får jag fel för vissa identitetsvärden?

S: När du använder webbgränssnittet går identitetsväljaren igenom extra steg för att verifiera användaren. Först kontrollerar den om personen är en giltig användare i organisationen. Annars söker den efter identiteten i Microsoft Entra-ID. Om användaren är i Microsoft Entra-ID men inte i organisationen läggs den användaren till i de giltiga identiteterna. När du importerar via CSV går identitetsväljaren av prestandaskäl inte igenom de här extra stegen. Den kontrollerar bara om det redan finns ett matchande UPN i organisationen. Om den inte hittar ett matchande UPN rapporterar den att identiteten är okänd.

F: Stöder CSV-import alla typer av arbetsobjekt?

S: Nej, CSV-importen stöder inte följande typer av arbetsobjekt:

• Begäran om kodgranskning
• Svar på kodgranskning
• Feedbackbegäran
• Feedbacksvar
• Testfall
• Testplan
• Testsvit
• Delad parameter

Mer information finns i Testfall för massimport eller export.

Relaterade artiklar

• Index för arbetsuppgiftsfält
• Lägga till eller ändra flera arbetsobjekt samtidigt med Excel
• Vanliga frågor och svar: Arbeta i Excel som är anslutet till Azure Boards