Bagikan melalui

Mengimpor, memperbarui, dan mengekspor item kerja massal dengan file CSV di Azure DevOps

  • Artikel

Layanan Azure DevOps | Azure DevOps Server 2022 - Azure DevOps Server 2019

Impor dan ekspor item kerja secara massal menggunakan file berformat CSV di Azure DevOps. Meskipun bisa terus menggunakan Excel untuk impor dan pembaruan massal, Anda bisa menggunakan fitur impor/ekspor asli yang tidak memerlukan Excel. Untuk informasi selengkapnya, lihat Menambahkan atau mengubah item kerja secara massal dengan Excel.

Anda dapat mengekspor item kerja secara massal menggunakan file berformat CSV. Saat Anda terus menggunakan Excel untuk impor dan pembaruan massal, Anda bisa menggunakan fitur ekspor asli dari Kueri yang tidak memerlukan Excel. Untuk informasi selengkapnya, lihat Menambahkan atau mengubah item kerja secara massal dengan Excel.

Mengimpor item kerja baru

Lakukan langkah-langkah berikut untuk mengimpor item kerja baru.

Catatan

Anda dapat mengimpor hingga 1.000 item kerja pada satu waktu. Jika Anda memiliki lebih dari 1.000 item kerja untuk diimpor, pecahkan menjadi beberapa file dan impor secara terpisah.

  1. Buat file import.csv lokal dan buka di Visual Studio Code atau Excel.

  2. File harus berisi Tipe Item Kerja dan bidang Judul . Anda dapat menyertakan bidang lain sesuai kebutuhan. Untuk daftar bidang default, lihat Indeks bidang item kerja.

    Dalam contoh berikut, kami menyertakan bidang Prioritas .

    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. Dari portal web untuk proyek Anda, buka Kueri Papan>, lalu pilih Impor item kerja.

    Cuplikan layar memperlihatkan Papan - Kueri, Impor Item Kerja.

  4. Pilih Pilih file, pilih file Anda, lalu pilih Impor.

    Cuplikan layar memperlihatkan Gambar Tombol Impor Item Kerja.

    Proses impor memuat item kerja yang diimpor ke dalam tampilan kueri dalam status tidak disimpan . Tidak ada ID yang ditetapkan.

  5. Verifikasi hasilnya lalu pilih Simpan item untuk menyimpan item kerja.

    Cuplikan layar memperlihatkan tombol Simpan untuk item kerja yang diimpor.

    Tip

    Hindari menetapkan ID ke item kerja baru yang Anda tambahkan; melakukannya menghasilkan pesan kesalahan.

  6. Sistem menyoroti item kerja tersebut dengan masalah data. Atasi masalah data sebelum Anda menyimpan item kerja. Dalam contoh ini, nilai yang tidak valid ada di bidang Prioritas. Perbaiki data dengan membuka item kerja secara langsung. Sebagai gantinya, gunakan pengeditan massal untuk memperbaiki beberapa item kerja dengan masalah yang sama.

    Cuplikan layar memperlihatkan memperbaiki item kerja dengan masalah data.

Tips

  • Tautan induk-turunan: Anda bisa menambahkan tautan induk-turunan di antara item kerja yang Anda impor dengan mengindentasi kolom judul, seperti yang ditunjukkan dalam Bisakah saya mengimpor file CSV yang memiliki tautan induk-turunan?. Namun, Anda tidak dapat menentukan jenis tautan lain saat mengimpor atau memperbarui item kerja.
  • Bidang Status Default: Saat Anda mengimpor item kerja baru, bidang "Status" selalu diatur ke "Baru" secara default. Anda tidak dapat menentukan status yang berbeda selama proses impor. Jika Anda perlu mengubah status item kerja yang diimpor, Anda bisa menggunakan solusi berikut:
    1. Impor item kerja dengan status "Baru" default.
    2. Ekspor item kerja yang diimpor ke file CSV.
    3. Perbarui nilai bidang "Status" dalam file CSV yang diekspor.
    4. Impor ulang file CSV yang diperbarui untuk mengatur status yang diinginkan.
  • Bidang Area dan Perulangan Default: Bidang "Area" dan "Iterasi" default ke simpul tingkat atas. Perilaku ini terjadi karena proses impor tidak memiliki konteks untuk bidang ini kecuali ditentukan secara eksplisit dalam file CSV. Untuk mengatur jalur "Area" dan "Iterasi" tertentu selama impor, pastikan bidang ini disertakan dalam file CSV Anda dengan nilai yang benar. Misalnya: 
    Title,Description,Area Path,Iteration Path
"Sample Work Item","This is a sample description.","Project\Team","Project\Sprint 1"

Memperbarui item kerja yang sudah ada

  1. Untuk memperbarui item kerja, buat kueri yang berisi semua kolom yang ingin Anda ekspor dan mungkin diedit. Simpan kueri Anda dan pilih Ekspor ke CSV untuk menyimpan file data.csv ke komputer lokal Anda.

    Cuplikan layar memperlihatkan item kerja ekspor, CSV.

    File yang diekspor akan terlihat mirip dengan sintaks berikut:

     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. Lakukan pengeditan pada item kerja Anda. File CSV Anda harus berisi bidang ID, Tipe Item Kerja, dan Judul . Bidang lain yang ingin Anda sertakan bersifat opsional.

    Catatan

    Saat Anda mengimpor bidang identitas, masukkan nama dan email dalam format "Display Name <email>"berikut . Misalnya, untuk menetapkan pekerjaan ke Jamal Hartnett, tentukan "Jamal Hartnett <fabrikamfiber4@hotmail.com>". Jika Anda menentukan nilai yang tidak dikenali sebagai pengguna yang valid ke sistem, Anda mungkin mengalami masalah dengan impor.

    Dalam contoh berikut, kami mengubah beberapa nilai pada item kerja yang ada.

    "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. Simpan file dan impor (lihat langkah 4-6 dari bagian impor sebelumnya.)

  4. Daftar hasil dengan item kerja yang berisi perubahan nilai muncul disorot dalam huruf tebal. Pilih Simpan Item untuk menerapkan perubahan.

    Cuplikan layar memperlihatkan Impor Item Kerja, Simpan Item.

  5. Item kerja dengan masalah data disorot dengan warna merah dan harus diselesaikan sebelum Anda bisa menyimpannya. Dalam contoh ini, nilai yang tidak valid muncul di bidang Ditetapkan Ke. Perbaiki data dengan membuka item kerja secara langsung. Anda dapat menggunakan pengeditan massal jika Anda memiliki banyak item kerja dengan masalah yang sama.

    Cuplikan layar memperlihatkan nilai Tidak Valid muncul di bidang Ditetapkan Ke.

Ekspor daftar sebagai file CSV

Dari kueri apa pun, Anda bisa mengekspor daftar item kerja sebagai daftar yang dibatasi koma. Buka kueri, pilih ikon tindakan, lalu pilih Ekspor ke CSV.

Catatan

Memerlukan Azure DevOps Server 2019 Update 1 atau versi yang lebih baru.

Cuplikan layar memperlihatkan Ekspor kueri sebagai CSV.

Mengekspor dan mengimpor item kerja ke proyek lain

Anda dapat menggunakan fitur ini untuk mengekspor item kerja dari satu proyek dan mengimpornya ke proyek lain. Namun, sebelum mengimpornya ke proyek lain, Anda harus menghapus ID item kerja. Anda mendapatkan kesalahan jika Anda mencoba mengimpor item kerja baru ke proyek dengan ID yang ditentukan.

Mengimpor bidang HTML

Bidang HTML, seperti deskripsi dan kriteria penerimaan, menyertakan pemformatan teks kaya. Untuk memastikan pemformatan ini dipertahankan, lakukan tugas berikut:

  1. Pastikan file CSV Anda menyertakan tag HTML dalam bidang yang relevan.
  2. Impor file CSV ke Excel.

Excel mungkin menangani bidang teks multibaris secara berbeda, jadi penting untuk memeriksa pemformatan setelah impor. Ganti baris yang berakhiran dengan kalimat di CRLF sekitarnya dengan <p>... </p>.

Misalnya, Anda dapat mengimpor item kerja berikut, yang menyertakan tiga baris teks di bidang Deskripsi.

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

Mengonversi bidang multibaris menjadi teks biasa

Untuk menonaktifkan HTML di bidang multibaris untuk memastikannya teks biasa, Anda dapat menggunakan witadmin changefield perintah . Untuk langkah-langkah mendetail, lihat Mengelola Bidang Item Kerja.

Contoh perintah:

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

Menangani inkonsistensi pemformatan

Saat bekerja dengan bidang HTML di berbagai produk Microsoft, Anda mungkin mengalami inkonsistensi pemformatan. Berikut adalah beberapa tips untuk menangani masalah ini:

  • Tinjau pemformatan pasca-impor untuk memastikannya memenuhi kebutuhan Anda.
  • Gunakan tag dan struktur HTML yang sesuai untuk meminimalkan perbedaan. Anda dapat menambahkan beberapa tag yang dipisahkan oleh titik koma. Untuk informasi selengkapnya, lihat Tugas yang bisa dan tidak bisa Anda lakukan dengan Excel.

Untuk informasi selengkapnya tentang mengelola konten HTML dan memastikan kompatibilitas, lihat dokumentasi resmi tentang konten HTML di Azure DevOps.

Tanya Jawab Umum

T: Bisakah saya mengimpor item baru dan memperbarui item yang sudah ada dalam file CSV yang sama?

A: Tentu saja! Biarkan bidang ID kosong untuk item kerja baru apa pun. Dalam contoh berikut, entri terakhir untuk Epik tidak menentukan 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",

A: Ya, Anda dapat menambahkan item kerja anak dengan mengindentasi kolom judul. Contoh berikut menambahkan tiga masalah anak di bawah Epik yang sudah ditentukan.

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

Cuplikan layar memperlihatkan tampilan Excel.

T: Bagaimana cara mengetahui apakah file yang diimpor memiliki kesalahan?

A: Anda dapat menguji dengan menambahkan tag dengan spasi dan tanda hubung, misalnya, dan menyertakannya dalam ekspor. Impor harus cocok dengan format yang sama. Masalah dengan pemformatan file CSV Anda muncul di halaman Hasil tampilan impor. Anda tidak dapat mengimpor item kerja hingga pemformatan dan sintaksisnya benar.

Cuplikan layar Kesalahan CSV.

Hasil item kerja selalu mencantumkan kesalahan data yang ditemukan untuk item kerja individual. Perbaiki setiap kesalahan baik dari portal web, atau di file CSV dan impor lagi.

T: Mengapa saya mendapatkan kesalahan untuk beberapa nilai identitas?

J: Saat Anda menggunakan UI Web, pemilih identitas akan melalui langkah-langkah tambahan untuk memvalidasi pengguna. Pertama memeriksa untuk melihat apakah orang tersebut adalah pengguna yang valid di org. Jika tidak, ia mencari identitas di ID Microsoft Entra. Jika pengguna berada di ID Microsoft Entra tetapi tidak di organisasi, pengguna tersebut akan ditambahkan ke identitas yang valid. Saat Anda mengimpor melalui CSV, karena alasan performa, pemilih identitas tidak melalui langkah-langkah tambahan ini. Ini hanya memeriksa untuk melihat apakah ada Nama Prinsipal Pengguna (UPN) yang cocok yang sudah ada di organisasi. Jika tidak menemukan UPN yang cocok, maka akan melaporkan bahwa identitas tersebut tidak diketahui.

T: Apakah impor CSV mendukung semua jenis item kerja?

A: Tidak, impor CSV tidak mendukung jenis item kerja berikut:

  • Permintaan Peninjauan Kode
  • Respons Peninjauan Kode
  • Permintaan Umpan Balik
  • Respons Umpan Balik
  • Kasus pengujian
  • Rencana Tes
  • Rangkaian Pengujian
  • Parameter Bersama

Untuk informasi selengkapnya, lihat Kasus pengujian impor atau ekspor massal.