Dela via

Importera, uppdatera och exportera massarbetsobjekt med CSV-filer i Azure DevOps

  • Artikel

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

Importera och exportera arbetsobjekt i bulk med CSV-formaterade filer 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.

Du kan exportera arbetsobjekt i bulk med hjälp av en CSV-formaterad fil. Även om du fortsätter att använda Excel för massimport och uppdateringar kan du använda den interna exportfunktionen från frågor som inte kräver Excel. Mer information finns i Masstillägg eller ändring av arbetsobjekt med Excel.

Importera nya arbetsobjekt

Utför följande steg för att importera nya arbetsobjekt.

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.

  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. Från webbportalen för projektet öppnar du Boards-frågor> och väljer sedan Importera arbetsobjekt.

    Skärmbild som visar tavlor – Frågor, Importera arbetsobjekt.

  4. Välj Välj fil, välj din fil och välj sedan Importera.

    Skärmbild som visar knappen Importera arbetsobjekt.

    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.

    Skärmbild som visar knappen Spara för importerade arbetsobjekt.

    Dricks

    Undvik att tilldela ID:n till nya arbetsobjekt som du lägger till. Detta resulterar i ett felmeddelande.

  6. Systemet markerar dessa arbetsobjekt med dataproblem. Lös dataproblemen innan du sparar arbetsobjekten. I det här exemplet finns ett ogiltigt värde 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.

    Skärmbild som visar korrigering av arbetsobjekt med dataproblem.

Tips

  • Länkar mellan överordnad och underordnad: Du kan lägga till överordnade och underordnade länkar mellan arbetsobjekt som du importerar genom att dra in rubrikkolumnerna, som visas i 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.
  • Standardtillståndsfält: När du importerar nya arbetsobjekt är fältet "Tillstånd" alltid inställt på "Nytt" som standard. Du kan inte ange ett annat tillstånd under importprocessen. Om du behöver ändra status för importerade arbetsobjekt kan du använda följande lösning:
    1. Importera arbetsobjekten med standardtillståndet "Nytt".
    2. Exportera de importerade arbetsobjekten till en CSV-fil.
    3. Uppdatera fältvärdena "Tillstånd" i den exporterade CSV-filen.
    4. Importera den uppdaterade CSV-filen igen för att ange önskade tillstånd.
  • Standardfält för område och iteration: Fälten "Area" och "Iteration" är standard för noden på den översta nivån. Det här beteendet beror på att importprocessen inte har kontexten för dessa fält om inte uttryckligen anges i CSV-filen. Om du vill ange specifika sökvägar för "Område" och "Iteration" under importen kontrollerar du att dessa fält ingår i CSV-filen med rätt värden. Till exempel: 
    Title,Description,Area Path,Iteration Path
"Sample Work Item","This is a sample description.","Project\Team","Project\Sprint 1"

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.

    Skärmbild som visar export av arbetsobjekt, CSV.

    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 och Rubrik. 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.

    Skärmbild som visar Importera arbetsobjekt, Spara objekt.

  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.

    Skärmbild som visar ogiltigt värde som visas i fältet Tilldelad till.

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.

Kommentar

Kräver Azure DevOps Server 2019 Update 1 eller senare version.

Skärmbild som visar Exportera en fråga som 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 HTML-fält

HTML-fält, till exempel beskrivningar och godkännandevillkor, innehåller RTF-formatering. Gör följande för att säkerställa att den här formateringen bevaras:

  1. Se till att CSV-filen innehåller HTML-taggar i relevanta fält.
  2. Importera CSV-filen till Excel.

Excel kan hantera textfält med flera rader på olika sätt, så det är viktigt att kontrollera formateringen efter importen. Ersätt rader som slutar med CRLF 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>"

Konvertera flerradsfält till klartext

Om du vill inaktivera HTML i fält med flera rader för att säkerställa att de är klartext kan du använda witadmin changefield kommandot . Detaljerade steg finns i Hantera arbetsobjektfält.

Exempelkommando:

witadmin changefield /collection:CollectionURL /n:FieldName /type:PlainText

Hantera inkonsekvenser i formatering

När du arbetar med HTML-fält i olika Microsoft-produkter kan det uppstå inkonsekvenser i formateringen. Här följer några tips för att hantera dessa problem:

  • Granska formateringen efter importen för att se till att den uppfyller dina krav.
  • Använd lämpliga HTML-taggar och strukturer för att minimera avvikelser. 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.

Mer information om hur du hanterar HTML-innehåll och säkerställer kompatibilitet finns i den officiella dokumentationen om HTML-innehåll i Azure DevOps.

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

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

Skärmbild som visar Excel-vyn.

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.

Skärmbild av CSV-fel.

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 (User Principal Name) 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.