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

Wszystkie zaimportowane elementy robocze są tworzone w stanie Nowy . Ta reguła oznacza, że nie można określić wartości pól, które nie spełniają reguł pól dla nowego stanu. Na przykład podczas tworzenia nowej historii użytkownika z procesem Agile stan = nowy i przyczyna = nowa. Nie można określić żadnych innych wartości.

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 opcję Importuj elementy robocze.

   

4. Wybierz plik CSV, 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

   Nie przypisuj identyfikatorów do nowych elementów roboczych, które dodajesz. W przeciwnym razie zostanie wyświetlony komunikat o błędzie.

   TFS401232: Element roboczy 1794 nie istnieje lub nie masz uprawnień do jego odczytania.

6. System wyróżnia te elementy robocze z problemami z danymi. Rozwiąż problemy z danymi przed zapisaniem elementów roboczych. W tym przykładzie wprowadzono nieprawidłową wartość 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.

   

Napiwek

Można dodać łącza nadrzędno-podrzędne między zaimportowanymi elementami roboczymi przez wcięcie kolumn tytułu, jak pokazano w przykładzie w dalszej części tego artykułu: 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.

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.

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, Tytuł i Stan . 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 lub aktualizowanie pól tekstowych sformatowanych

Możesz aktualizować lub importować pola tekstowe sformatowane, takie jak pola Opis lub Kryteria akceptacji. Pola tekstu sformatowanego to pola sformatowane w formacie HTML. Zastąp wiersze kończące się znakiem CRLF przez otaczające zdania znakiem <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>"

Często zadawane pytania

Pyt.: 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",

Pyt.: Jak mogę dodać wiele tagów?

1: 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.

Pyt.: 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",

Pyt.: 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.

Pyt.: 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.

Pyt.: 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