Importowanie i aktualizowanie zbiorczych elementów roboczych za pomocą plików CSV

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

Zbiorcze importowanie i eksportowanie elementów roboczych przy użyciu pliku CSV sformatowanego w usłudze Azure DevOps. Chociaż można nadal używać programu Excel do importowania zbiorczego i aktualizacji, można skorzystać z natywnej funkcji importowania/eksportowania, która nie wymaga programu Excel. Aby uzyskać więcej informacji, zobacz Zbiorcze dodawanie lub modyfikowanie elementów roboczych za pomocą programu Excel.

Uwaga

Funkcja eksportu jest dostępna w usłudze Azure DevOps Server 2019 Update 1 i nowszych wersjach. Funkcja importu jest dostępna w usługach Azure DevOps Server 2020 i Azure DevOps Services.

Importowanie nowych elementów roboczych

Wykonaj następujące kroki, aby zaimportować nowe elementy robocze.

Uwaga

Jednocześnie można zaimportować maksymalnie 1000 elementów roboczych. Jeśli masz więcej niż 1000 elementów roboczych do zaimportowania, podziel je na wiele plików i zaimportuj je oddzielnie.

1. Utwórz lokalny plik import.csv i otwórz go w programie Visual Studio Code lub Excel.

2. Plik musi zawierać pola Typ elementu roboczego i Tytuł. W razie potrzeby możesz uwzględnić inne pola. Aby uzyskać listę pól domyślnych, zobacz Indeks pól elementu roboczego.

   W poniższym przykładzie uwzględnimy pole Priorytet .

   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. W portalu internetowym projektu otwórz pozycję Zapytania tablic>, a następnie wybierz pozycję Importuj elementy robocze.

   

4. Wybierz pozycję Wybierz plik, wybierz plik, a następnie wybierz pozycję Importuj.

   

   Proces importowania ładuje zaimportowane elementy robocze do widoku zapytań w stanie niezapisanym . Nie przypisano identyfikatorów.

5. Sprawdź wyniki, a następnie wybierz pozycję Zapisz elementy , aby zapisać elementy robocze.

   

   Napiwek

   Unikaj przypisywania identyfikatorów do nowych elementów roboczych, które dodajesz; spowoduje to wyświetlenie komunikatu o błędzie.

6. System wyróżnia te elementy robocze z problemami z danymi. Rozwiąż problemy z danymi przed zapisaniem elementów roboczych. W tym przykładzie nieprawidłowa wartość znajduje się w polu Priorytet. Napraw dane, otwierając element roboczy bezpośrednio. Zamiast tego użyj edycji zbiorczej, aby rozwiązać kilka elementów roboczych z tym samym problemem.

   

Wskazówki

• Łącza nadrzędno-podrzędne: można dodać łącza nadrzędno-podrzędne między zaimportowanymi elementami roboczymi przez wcięcie kolumn tytułu, jak pokazano w temacie Czy mogę zaimportować plik CSV, który ma łącza nadrzędno-podrzędne?. Nie można jednak określić żadnych innych typów łączy podczas importowania lub aktualizowania elementów roboczych.
• Domyślne pole Stan: podczas importowania nowych elementów roboczych pole "State" jest zawsze ustawione na wartość "New" domyślnie. Podczas procesu importowania nie można określić innego stanu. Jeśli musisz zmienić stan zaimportowanych elementów roboczych, możesz użyć następującego obejścia:
  1. Zaimportuj elementy robocze z domyślnym stanem "Nowy".
  2. Wyeksportuj zaimportowane elementy robocze do pliku CSV.
  3. Zaktualizuj wartości pól "State" w wyeksportowanym pliku CSV.
  4. Ponownie zaimportuj zaktualizowany plik CSV, aby ustawić żądane stany.
• Pola obszaru domyślnego i iteracji: pola "Obszar" i "Iteracja" są domyślne dla węzła najwyższego poziomu. To zachowanie występuje, ponieważ proces importowania nie ma kontekstu dla tych pól, chyba że jawnie określony w pliku CSV. Aby ustawić określone ścieżki "Area" i "Iteration" podczas importowania, upewnij się, że te pola znajdują się w pliku CSV z poprawnymi wartościami. Na przykład: .

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

Aktualizowanie istniejących elementów roboczych

1. Aby zaktualizować elementy robocze, utwórz zapytanie zawierające wszystkie kolumny, które chcesz wyeksportować i ewentualnie edytować. Zapisz zapytanie i wybierz pozycję Eksportuj do pliku CSV , aby zapisać plik data.csv na komputerze lokalnym.

   

   Wyeksportowany plik powinien wyglądać podobnie do następującej składni:

    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. Wprowadź zmiany w elementach roboczych. Plik CSV musi zawierać pola IDENTYFIKATOR, Typ elementu roboczego i Tytuł . Wszystkie inne pola, które chcesz uwzględnić, są opcjonalne.

   Uwaga

   Podczas importowania pól tożsamości wprowadź nazwę i adres e-mail w następującym formacie "Display Name <email>". Aby na przykład przypisać pracę do narzędzia Jamal Hartnett, określ wartość "Jamal Hartnett <fabrikamfiber4@hotmail.com>". Jeśli określisz wartość, która nie jest rozpoznawana jako prawidłowy użytkownik systemu, mogą wystąpić problemy z importowaniem.

   W poniższym przykładzie zmieniamy kilka wartości istniejących elementów roboczych.

   "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. Zapisz plik i zaimportuj (zobacz kroki 4–6 z poprzedniej sekcji importowania).

4. Lista wyników z elementami roboczymi, które zawierają zmiany wartości, jest wyróżniona pogrubioną czcionką. Wybierz pozycję Zapisz elementy , aby zastosować zmiany.

   

5. Elementy robocze z problemami z danymi są wyróżnione na czerwono i należy je rozwiązać, zanim będzie można je zapisać. W tym przykładzie w polu Przypisano do zostanie wyświetlona nieprawidłowa wartość. Napraw dane, otwierając element roboczy bezpośrednio. Możesz użyć edycji zbiorczej, jeśli masz wiele elementów roboczych z tym samym problemem.

   

Eksportowanie listy jako pliku CSV

Z dowolnego zapytania można wyeksportować listę elementów roboczych jako listę rozdzielaną przecinkami. Otwórz zapytanie, wybierz ikonę akcji, a następnie wybierz pozycję Eksportuj do pliku CSV.

Eksportowanie i importowanie elementów roboczych do innego projektu

Za pomocą tej funkcji można wyeksportować elementy robocze z jednego projektu i zaimportować je do innego projektu. Jednak przed zaimportowaniem ich do innego projektu należy usunąć identyfikator elementu roboczego. Jeśli próbujesz zaimportować nowe elementy robocze do projektu z określonym identyfikatorem, wystąpi błąd.

Importowanie pól HTML

Pola HTML, takie jak opisy i kryteria akceptacji, obejmują formatowanie tekstu sformatowanego. Aby zapewnić zachowanie tego formatowania, wykonaj następujące zadania:

1. Upewnij się, że plik CSV zawiera tagi HTML w odpowiednich polach.
2. Zaimportuj plik CSV do programu Excel.

Program Excel może obsługiwać pola tekstowe wielowierszowe inaczej, dlatego ważne jest, aby sprawdzić formatowanie po zaimportowaniu. Zastąp wiersze kończące się CRLF wokół zdania elementem <p>... </p>.

Można na przykład zaimportować następujący element roboczy, który zawiera trzy wiersze tekstu w polu Opis.

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

Konwertowanie pól wielowierszowych na zwykły tekst

Aby wyłączyć kod HTML w polach wielowierszowych, aby upewnić się, że są one zwykły tekst, możesz użyć witadmin changefield polecenia . Aby uzyskać szczegółowe instrukcje, zobacz Zarządzanie polami elementów roboczych.

Przykładowe polecenie:

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

Obsługa niespójności formatowania

Podczas pracy z polami HTML w różnych produktach firmy Microsoft mogą wystąpić niespójności formatowania. Poniżej przedstawiono kilka wskazówek dotyczących obsługi tych problemów:

• Przejrzyj formatowanie po zaimportowaniu, aby upewnić się, że spełnia twoje wymagania.
• Użyj odpowiednich tagów i struktur HTML, aby zminimalizować rozbieżności. Możesz dodać wiele tagów rozdzielonych średnikami. Aby uzyskać więcej informacji, zobacz Zadania, które można i których nie można wykonać w programie Excel.

Aby uzyskać więcej informacji na temat zarządzania zawartością HTML i zapewnienia zgodności, zobacz oficjalną dokumentację dotyczącą zawartości HTML w usłudze Azure DevOps.

Często zadawane pytania

.: Czy mogę zaimportować nowe elementy i zaktualizować istniejące elementy w tym samym pliku CSV?

Ach: Absolutnie! Pozostaw puste pole Identyfikator dla wszystkich nowych elementów roboczych. W poniższym przykładzie ostatni wpis epika nie określa identyfikatora.

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

.: Czy mogę zaimportować plik CSV zawierający łącza nadrzędno-podrzędne?

1: Tak, można dodać podrzędne elementy robocze przez wcięcie kolumn tytułu. W poniższym przykładzie dodano trzy problemy podrzędne w już zdefiniowanym epikiem.

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

.: Jak mogę wiedzieć, czy mój zaimportowany plik zawiera błędy?

1: Możesz przetestować, dodając tagi ze spacjami i łącznikami, na przykład i dołączając je do eksportu. Importowanie powinno być zgodne z tym samym formatem. Wszelkie problemy z formatowaniem pliku CSV są wyświetlane na stronie Wyniki widoku importu. Nie można zaimportować elementów roboczych, dopóki formatowanie i składnia nie będą poprawne.

Wyniki elementu roboczego zawsze zawierają listę błędów danych znalezionych dla poszczególnych elementów roboczych. Napraw każdy błąd z portalu internetowego lub w pliku CSV i zaimportuj ponownie.

.: Dlaczego występują błędy dotyczące niektórych wartości tożsamości?

1: W przypadku korzystania z internetowego interfejsu użytkownika selektor tożsamości przeprowadza dodatkowe kroki w celu zweryfikowania użytkownika. Najpierw sprawdza, czy dana osoba jest prawidłowym użytkownikiem w organizacji. Jeśli nie, wyszukuje tożsamość w identyfikatorze Entra firmy Microsoft. Jeśli użytkownik znajduje się w identyfikatorze Entra firmy Microsoft, ale nie w organizacji, ten użytkownik zostanie dodany do prawidłowych tożsamości. W przypadku importowania za pośrednictwem pliku CSV ze względu na wydajność selektor tożsamości nie przechodzi przez te dodatkowe kroki. Sprawdza tylko, czy w organizacji istnieje pasujący numer UPN. Jeśli nie znajdzie pasującej nazwy UPN, zgłasza, że tożsamość jest nieznana.

.: Czy import CSV obsługuje wszystkie typy elementów roboczych?

1: Nie, importowanie woluminów CSV nie obsługuje następujących typów elementów roboczych:

• Żądanie typu Przegląd kodu
• Odpowiedź Przejrzyj kod
• Żądanie opinii
• Odpowiedź na opinię
• Przypadek testowy
• Planu testu
• Zestaw testów
• Parametr udostępniony

Aby uzyskać więcej informacji, zobacz Zbiorcze importowanie lub eksportowanie przypadków testowych.

Powiązane artykuły

• Indeks pola elementu roboczego
• Zbiorcze dodawanie lub modyfikowanie elementów roboczych w programie Excel
• Często zadawane pytania: Praca w programie Excel połączona z usługą Azure Boards