Megosztás a következőn keresztül:

Tömeges munkaelemek exportálása, frissítése és importálása CSV-fájlokkal

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

Azure Boards natív CSV importálási és exportálási funkciót biztosít, amellyel tömegesen kezelheti a munkaelemeket anélkül, hogy Microsoft Excel kellene. Ez a képesség több forgatókönyv esetén is hasznos:

  • Tömeges szerkesztés: Munkaelemek exportálása, módosítások végrehajtása az Excelben vagy bármely számolótábla-alkalmazásban, és újraimportálásuk.
  • Adatmigrálás: Munkaelemek áthelyezése projektek vagy szervezetek között.
  • Offline munka: Munkaelemek letöltése, szerkesztése internetkapcsolat nélkül, és a módosítások szinkronizálása később.
  • Bejelentés és elemzés: Munkaelem-adatok exportálása egyéni jelentésekhez az Excelben, Power BI vagy más eszközökben.
  • Biztonsági mentés: Időponthoz kötött pillanatképek létrehozása a munkaelemekről.

A CSV-módszer számos előnyt kínál a közvetlen webes szerkesztéssel szemben:

  • Ismerős eszközök: Az Excel olyan hatékony funkcióit használhatja, mint a keresés/csere, a képletek és a szűrés.
  • Sebesség: Egyszerre több száz munkaelem módosítása.
  • Rugalmasság: Dolgozzon offline, és importálhatja a módosításokat, amikor készen áll.
  • Nincs szükség Excel-bővítményre: Az Excel-integrációval ellentétben a CSV-funkció bármilyen számolótábla-alkalmazással működik.

Tip

A jelen cikk későbbi részében használhatja az MI-t a feladat elvégzéséhez, vagy tekintse meg a MI-támogatás engedélyezése az Azure DevOps MCP-kiszolgálóval, hogy elkezdhessen dolgozni rajta.

Prerequisites

Kategória Requirements
Jogosultságok - Munkaelemek exportálása: A Projektgazdák csoport tagja, vagy a Projektszintű információk megtekintése engedély Engedélyezés-re állítva.
- Munkaelemek importálása: A Projektgazdák vagy a Team Foundation rendszergazdák biztonsági csoportjának tagja.

Munkaelemek exportálása CSV-fájlba

A munkaelemek exportálása a tömeges szerkesztési munkafolyamat első lépése. Először hozzon létre egy lekérdezést, amely tartalmazza az exportálni kívánt munkaelemeket és oszlopokat.

  1. Nyisson meg vagy hozzon létre egy lekérdezést , amely visszaadja az exportálni kívánt munkaelemeket. Győződjön meg arról, hogy a lekérdezés tartalmazza a szerkeszteni kívánt összes oszlopot.

  2. Válassza a műveletek ikont, majd válassza az Exportálás CSV-be lehetőséget.

    A lekérdezés exportálása CSV-ként ábrázoló képernyőkép.

  3. Mentse a data.csv fájlt a helyi gépre.

    Az exportált fájl az alábbi példához hasonlóan néz ki:

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

Tip

Importálási fájl létrehozása előtt exportáljon néhány meglévő munkaelemet. Ez a módszer segít azonosítani a Azure DevOps példány és folyamatsablon megfelelő mezőneveit és formátumát.

Meglévő munkaelemek frissítése

A munkaelemek exportálása után szerkesztheti őket az Excelben vagy bármely táblázatkezelő alkalmazásban, majd újraimportálhatja a módosításokat.

  1. Nyissa meg az exportált CSV-fájlt az Excelben vagy az előnyben részesített számolótábla-alkalmazásban.

  2. Végezze el a munkaelemek szerkesztését. A CSV-fájlnak tartalmaznia kell az azonosító, a munkaelem típusa és a Cím mezőket. A felvenni kívánt egyéb mezők nem kötelezőek.

    Note

    Identitásmezők importálásakor adja meg a nevet és az e-mailt a következő formátumban "Display Name <email>". Ha például jamal Hartnetthez szeretne munkát rendelni, adja meg a kívánt "Jamal Hartnett <fabrikamfiber4@hotmail.com>"értéket. Ha olyan értéket ad meg, amelyet a rendszer nem ismer fel érvényes felhasználóként, problémákat tapasztalhat az importálással kapcsolatban.

    Az alábbi példában a meglévő munkaelemek értékeit módosíthatja.

    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. Mentse és importálja a fájlt. A webes portálon válassza a Táblák lekérdezései>>Munkaelemek importálása lehetőséget.

    Képernyőkép a Táblák lapról, ahol először a Lekérdezések, majd a Munkaelemek importálása van kiválasztva.

  4. Válassza a Fájl kiválasztása lehetőséget, válassza ki a fájlt, majd válassza az Importálás lehetőséget.

    Képernyőkép a Munkaelemek importálása párbeszédablakról, az Import gomb kiemelve.

  5. Az értékváltozásokat tartalmazó munkaelemeket tartalmazó találatok listája félkövér színnel jelenik meg. A módosítások alkalmazásához válassza az Elemek mentése lehetőséget.

    Képernyőkép a Munkaelemek importálása és az Elemek mentése lehetőségről.

  6. Az adatproblémákkal rendelkező munkaelemek piros színnel vannak kiemelve, és a mentés előtt meg kell oldania őket. Ebben a példában egy érvénytelen érték jelenik meg a Hozzárendelt mezőben. Javítsa ki az adatokat a munkaelem közvetlen megnyitásával. Tömeges szerkesztést akkor használhat, ha sok azonos problémával rendelkező munkaeleme van.

    A Hozzárendelt érték mezőben megjelenő érvénytelen érték képernyőképe.

Új munkaelemek importálása

Új munkaelemek importálásához hozzon létre egy CSV-fájlt a szükséges mezőkkel. A meglévő elemek frissítésével ellentétben ne tartalmazza az új munkaelemek azonosító mezőjét.

A munkaelemek tömeges importálásához a CSV-fájlnak tartalmaznia kell a Munkaelem típusa és Cím mezőket. Igény szerint további mezőket is felvehet. CSV-fájl importálásához kövesse az alábbi irányelveket:

  • Az azonosító mező kizárása: Ne vegye fel a azonosító mezőt a CSV-fájlba.
  • Projektspecifikus mezők eltávolítása: Ha a CSV-fájlt egy másik projektből exportálták, távolítsa el a forrásprojektre jellemző mezőket, például Terület elérési útja és Címkék. Az alapértelmezett mezők listáját a Munkaelem mezőindexecímű témakörben találja.
  • Adja meg a Tesztelési lépések mezőt: A tesztelési esetek importálásakor adja meg a Tesztelési lépések mezőt. További információ: tömeges importálási vagy exportálási tesztesetek.
  • Ne tartalmazza hozzárendelt, Módosított dátum, Által létrehozottvagy Állapot mezőket.
  • Kötelező mezők ellenőrzése:
    • Győződjön meg arról, hogy a Munkaelem típusa és Cím mezők szerepelnek a CSV-fájlban.
    • Ellenőrizze, hogy a munkaelem-típus megfelel-e a célprojekt érvényes típusának.
    • Ellenőrizze, hogy a CSV-fájl összes mezője megegyezik-e a célprojekt munkaelem-típusainak mezőivel.
  • Érvénytelen értékek kezelése: Ha az importált CSV-fájl érvénytelen értékeket tartalmazó munkaelemeket tartalmaz, az importálás után szerkesztenie és javítania kell ezeket a munkaelemeket, mielőtt mentené őket.

Tip

A munkaelemmezők különböző folyamatsablonok (Agile, Scrum, CMMI) és Azure DevOps verziók között változnak. Importálás előtt ellenőrizze a munkaelem-típusok rendelkezésre álló mezőit az alábbiak szerint:

  1. A projektben a kívánt típusú mintamunkaelem létrehozása
  2. A munkaelem űrlap elérhető mezőinek megtekintése
  3. Meglévő munkaelemek exportálása az aktuális mezőszerkezet megtekintéséhez

A mezőnevek és a rendelkezésre állás eltérhetnek a jelen cikkben szereplő példáktól a folyamatsablon és Azure DevOps verzió alapján.

Az új munkaelemek importálásához hajtsa végre az alábbi lépéseket.

Note

Egyszerre legfeljebb 1000 munkaelemet importálhat. Ha több mint 1000 munkaelemet szeretne importálni, bontsa őket több fájlba, és külön importálja őket.

  1. Hozzon létre egy helyi import.csv fájlt, és nyissa meg Visual Studio Code vagy Excelben.

  2. A fájlnak tartalmaznia kell a Munkaelem típusát és a Cím mezőket. Szükség szerint más mezőket is felvehet.

    Tip

    A Azure DevOps-példány megfelelő mezőneveinek meghatározása:

    • Exportáljon néhány meglévő munkaelemet a projektből a pontos mezőnevek megtekintéséhez
    • Új munkaelem létrehozása és az elérhető mezők áttekintése
    • Normál mezőhivatkozások keresése a Munkaelem mezőindexben

    Az alábbi példa a Prioritás mezőt tartalmazza. A rendelkezésre álló mezők a folyamatsablontól függően eltérhetnek:

    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. A projekt webes portálján válassza Táblák>Lekérdezések>Munkaelemek importálásalehetőséget.

    Képernyőkép a Táblák lapról, ahol először a Lekérdezések, majd a Munkaelemek importálása van kiválasztva.

  4. Válassza a Fájl kiválasztása lehetőséget, válassza ki a fájlt, majd válassza az Importálás lehetőséget.

    Képernyőkép a Munkaelemek importálása párbeszédablakról, az Import gomb kiemelve.

    Az importálási folyamat nem mentett állapotban tölti be az importált munkaelemeket a lekérdezések nézetébe. Nem rendelnek hozzá azonosítókat.

  5. Ellenőrizze az eredményeket, majd válassza az Elemek mentése lehetőséget a munkaelemek mentéséhez.

    Képernyőkép az importált munkaelemekhez tartozó mentési lehetőségekről.

    Tip

    Ne rendeljen azonosítókat a hozzáadott új munkaelemekhez. Az azonosítók hozzárendelése hibaüzenetet eredményez.

  6. A rendszer kiemeli az adatproblémákkal rendelkező munkaelemeket. A munkaelemek mentése előtt oldja meg az adatproblémát. Ebben a példában egy érvénytelen érték szerepel a Prioritás mezőben. Javítsa ki az adatokat a munkaelem közvetlen megnyitásával. Ehelyett használjon tömeges szerkesztést több azonos problémával rendelkező munkaelem kijavításához.

    Képernyőkép a kijavítandó adatproblémákkal rendelkező munkaelemekről.

Tips

  • Mezőkompatibilitás: A különböző Azure DevOps verziók és folyamatsablonok (Agile, Scrum, CMMI vagy egyéni) különböző mezőket kínálnak. Az új elemek importálása előtt mindig ellenőrizze a mezőneveket úgy, hogy exportálja a meglévő munkaelemeket a projektből.

  • Folyamatsablonok eltérései: A folyamatsablonok közötti különbségekről további információt a Folyamat kiválasztása című témakörben talál.

    • Agilis folyamat: Felhasználói történet, feladat, hiba, epikus, funkció, teszteset használata
    • Scrum-folyamat: Termék-visszalépési tétel, feladat, hiba, epikus történet, funkció, teszteset használata
    • CMMI-folyamat: Követelmény, feladat, hiba, eposz, funkció, teszteset
    • A mezőnevek és a rendelkezésre álló lehetőségek a projekt által használt folyamattól függően változhatnak.

  • Szülő-gyermek hivatkozások: Az importált munkaelemekhez szülő-gyermek hivatkozásokat adhat, ha a címsorokat behúzza, ahogyan azt a Szülő-gyermek hivatkozásokat tartalmazó CSV-fájl importálása című témakör mutatja. Munkaelemek importálásakor vagy frissítésekor azonban nem adhat meg más hivatkozástípusokat.

  • Alapértelmezett állapotmező: Új munkaelemek importálásakor az Állapot mező alapértelmezés szerint Új értékre van állítva. Az importálási folyamat során nem adhat meg másik állapotot. Ha módosítania kell az importált munkaelemek állapotát, használja az alábbi átmeneti megoldást:

    1. Importálja az alapértelmezett Új állapotú munkaelemeket.
    2. Exportálja az importált munkaelemeket egy CSV-fájlba.
    3. Frissítse az állapotmező értékeit az exportált CSV-fájlban.
    4. Importálja újra a frissített CSV-fájlt a kívánt állapotok beállításához.

  • Alapértelmezett terület- és iterációs mezők: A Terület és az Iteráció mezők alapértelmezés szerint a legfelső szintű csomópontra. Ez az alapértelmezett beállítás azért történik, mert az importálási folyamat nem rendelkezik a mezők környezetével, kivéve, ha explicit módon adja meg őket a CSV-fájlban. Ha adott terület- és iterációs útvonalakat szeretne beállítani az importálás során, vegye fel ezeket a mezőket a CSV-fájlba a megfelelő értékekkel. Például:

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

HTML-mezők importálása

A HTML-mezők, például a leírások és az elfogadási feltételek rich text formázást tartalmaznak. A formázás megőrzésének érdekében hajtsa végre a következő lépéseket:

  1. Győződjön meg arról, hogy a CSV-fájl HTML-címkéket tartalmaz a megfelelő mezőkben.
  2. Importálja a CSV-fájlt az Excelbe.

Előfordulhat, hogy az Excel másképp kezeli a többsoros szövegmezőket, ezért fontos ellenőrizni a formázást az importálás után. Cserélje le a `CRLF`-val végződő sorokat úgy, hogy azok `<p>... </p>`-vel végződjenek.

Importálhatja például a következő munkaelemet, amely három sornyi szöveget tartalmaz a Leírás mezőben.

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

Többsoros mezők átalakítása egyszerű szöveggé

Ha le szeretné tiltani a HTML-t többsoros mezőkben, és meg szeretné győződni arról, hogy azok egyszerűek, használja a witadmin changefield parancsot. További információ: Munkaelemmezők kezelése.

Példa parancs:

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

Formázási inkonzisztenciák kezelése

Ha HTML-mezőkkel dolgozik különböző Microsoft-termékekben, formázási következetlenségek fordulhatnak elő. Az alábbiakban néhány tippet talál a problémák megoldásához:

  • Az importálás után tekintse át a formázást, hogy biztosan megfeleljen a követelményeknek.
  • Az eltérések minimalizálása érdekében használjon megfelelő HTML-címkéket és struktúrákat. Pontosvesszővel elválasztva több címkét is hozzáadhat. További információ: Az Excellel elvégezhető és nem elvégezhető feladatok.

A HTML-tartalom kezelésével és a kompatibilitás biztosításával kapcsolatos további információkért lásd : Súgószöveg, hivatkozások vagy webes tartalom megadása munkaeleműrlapon.

Nem támogatott munkaelem-típusok

A CSV-importálás nem támogatja a következő munkaelem-típusokat:

  • Kódvizsgálati kérelem

  • Kódvizsgálati kérelemre adott válasz

  • Visszajelzési kérelem

  • Visszajelzési válasz

  • Teszt eset

  • Tesztterv

  • Tesztcsomag

  • Megosztott paraméter

  • Megosztott lépés

További információ: Tömeges importálási vagy exportálási tesztesetek.

FAQs

K: Importálhatok új elemeket, és frissíthetem a meglévő elemeket ugyanabban a CSV-fájlban?

Válasz: Igen! Hagyja üresen az azonosító mezőt az új munkaelemeknél. Az alábbi példában az Epic utolsó bejegyzése nem ad meg azonosítót.

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

Válasz: Igen, gyermekmunkaelemeket adhat hozzá a cím oszlopait behúzva. Az alábbi példa három gyermekproblémát ad hozzá a már definiált Epic alatt.

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

Képernyőkép az Excel nézetről.

K: Hogyan tudja, hogy az importált fájlom hibát jelez-e?

Válasz: Tesztelhet például szóközökkel és kötőjelekkel ellátott címkéket, és belefoglalhatja őket az exportálásba. Az importálásnak ugyanahhoz a formátumhoz kell igazodnia. A CSV-fájl formázásával kapcsolatos problémák az importálási nézet Eredmény lapján jelennek meg. A munkaelemeket csak akkor importálhatja, ha a formázás és a szintaxis helyes.

Képernyőkép egy CSV-hibáról a Munkaelemek importálása lapon.

A munkaelem eredményei mindig felsorolják az egyes munkaelemek adathibáit. Javítsa ki az egyes hibákat a webportálon vagy a CSV-fájlban, és importálja újra.

K: Miért kapok hibaüzenetet bizonyos identitásértékek esetében?

Válasz: Ha a webes felhasználói felületet használja, az identitásválasztó további lépéseken megy keresztül a felhasználó ellenőrzéséhez. Először ellenőrzi, hogy a személy érvényes felhasználó-e a szervezetben. Ha nem, akkor a Microsoft Entra ID-ben keres az identitáson. Ha a felhasználó a Microsoft Entra ID-ben van, de nincs a szervezetben, akkor hozzáadják az érvényes identitásokhoz.

Ha CSV-ből importál, teljesítménybeli okokból az identitásválasztó nem lépi át ezeket a további lépéseket. Csak azt ellenőrzi, hogy van-e már egyező felhasználónév (UPN) a szervezetben. Ha nem talál egyező UPN-t, az azt jelenti, hogy az identitás ismeretlen.

Munkaelemek tömeges kezelése AI használatával

Ha az Azure Boards MCP-kiszolgáló ügynök módban csatlakozik az AI-ügynökhöz, természetes nyelvi kérésekkel létrehozhat és frissíthet több munkaelemet a CSV-be való exportálás nélkül.

Feladatok Példakérés
Elemek tömeges létrehozása Create 5 user stories for the <Contoso> project with titles for a new login feature
Tömeges frissítési mezők Set the iteration path to Sprint 5 for all active tasks assigned to <Jamal>
Exportálandó elemek keresése List all work items modified in the last 7 days in the <Contoso> area path
Importált elemek frissítése Update the state to Closed for bugs 1234, 1235, and 1236

Note

Az ügynök mód és az MCP-kiszolgáló természetes nyelvet használ, így módosíthatja ezeket az utasításokat, vagy további kérdéseket tehet fel az eredmények finomítása érdekében. Nagy léptékű adatmigráláshoz vagy offline szerkesztéshez használja a cikkben ismertetett CSV importálási/exportálási funkciót.

Kapcsolódó tartalom

  • Last updated on