Mengekspor, memperbarui, dan mengimpor item kerja massal dengan file CSV

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

Azure Boards menyediakan fitur impor dan ekspor CSV asli yang dapat Anda gunakan untuk mengelola item kerja secara massal tanpa memerlukan Microsoft Excel. Kemampuan ini berguna untuk beberapa skenario:

• Pengeditan massal: Ekspor item kerja, buat perubahan di Excel atau aplikasi lembar bentang apa pun, dan impor ulang.
• Migrasi data: Memindahkan item kerja antara proyek atau organisasi.
• Pekerjaan offline: Unduh item kerja, edit tanpa koneksi internet, dan sinkronkan perubahan nanti.
• Laporan dan analisis: Ekspor data item kerja untuk pelaporan kustom di Excel, Power BI, atau alat lainnya.
• Pencadangan: Buat snapshot waktu tertentu dari item kerja Anda.

Pendekatan CSV menawarkan beberapa keuntungan daripada pengeditan web langsung:

• Alat yang familier: Gunakan fitur canggih Excel seperti menemukan/mengganti, rumus, dan pemfilteran.
• Kecepatan: Buat perubahan pada ratusan item kerja secara bersamaan.
• Fleksibilitas: Bekerja offline dan mengimpor perubahan saat siap.
• Tidak diperlukan add-in Excel: Tidak seperti integrasi Excel, fitur CSV berfungsi dengan aplikasi spreadsheet apa pun.

Tip

Anda dapat menggunakan AI untuk membantu tugas ini nanti dalam artikel ini, atau lihat Mengaktifkan bantuan AI dengan Azure DevOps MCP Server untuk memulai.

Prerequisites

Kategori	Persyaratan
Permissions	- Ekspor item kerja: Anggota grup Administrator Proyek atau Lihat izin informasi tingkat proyek yang diatur ke Izinkan. - Impor item kerja: Anggota Grup keamanan Administrator Proyek atau Administrator Team Foundation .

Mengekspor item kerja ke file CSV

Mengekspor item kerja adalah langkah pertama dalam alur kerja pengeditan massal. Mulailah dengan membuat kueri yang berisi item kerja dan kolom yang ingin Anda ekspor.

1. Buka atau buat kueri yang mengembalikan item kerja yang ingin Anda ekspor. Pastikan kueri menyertakan semua kolom yang Anda rencanakan untuk diedit.

2. Pilih ikon tindakan, lalu pilih Ekspor ke CSV.

   

3. Simpan file data.csv ke komputer lokal Anda.

   File yang diekspor terlihat mirip dengan contoh berikut:

   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

Ekspor beberapa item kerja yang sudah ada sebelum membuat file impor. Pendekatan ini membantu Anda mengidentifikasi nama dan format bidang yang benar untuk instans Azure DevOps dan templat proses Anda.

Memperbarui item kerja yang sudah ada

Setelah mengekspor item kerja, Anda bisa mengeditnya di Excel atau aplikasi lembar bentang apa pun, lalu mengimpor kembali perubahan.

1. Buka file CSV yang diekspor di Excel atau aplikasi spreadsheet pilihan Anda.

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.

   Note

   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 sistem sebagai pengguna yang valid, Anda mungkin mengalami masalah dengan impor.

   Dalam contoh berikut, Anda mengubah nilai pada item kerja yang sudah ada.

   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. Simpan file dan impor. Dari portal web, pilih Papan>Kueri>Impor item kerja.

   

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

   

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

   

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

   

Mengimpor item kerja baru

Untuk mengimpor item kerja baru, buat file CSV dengan bidang yang diperlukan. Tidak seperti memperbarui item yang ada, jangan sertakan bidang ID untuk item kerja baru.

Untuk mengimpor item kerja secara massal, file CSV Anda harus menyertakan Tipe Item Kerja dan bidang Judul. Anda dapat menyertakan lebih banyak bidang sesuai kebutuhan. Ikuti panduan ini untuk mengimpor file CSV:

• Mengecualikan bidang ID: Jangan sertakan bidang ID dalam file CSV Anda.
• Hapus bidang khusus proyek: Jika file CSV diekspor dari proyek yang berbeda, hapus bidang khusus untuk proyek sumber, seperti Jalur Area dan Tag . Untuk daftar bidang default, lihat Indeks Bidang Item Kerja.
• Sertakan bidang Langkah Pengujian: Saat mengimpor kasus pengujian, sertakan bidang Langkah Pengujian. Untuk informasi selengkapnya, lihat Kasus Pengujian Impor atau Ekspor Massal.
• Jangan sertakan bidang Ditetapkan Ke, Tanggal Diubah, Dibuat Oleh, atau Status.
• Validasi bidang wajib:
  • Pastikan bidang Tipe Item Kerja dan Judul ada dalam file CSV.
  • Konfirmasikan bahwa Jenis Item Kerja sesuai dengan jenis yang valid dalam proyek target.
  • Verifikasi bahwa semua bidang dalam file CSV cocok dengan bidang untuk jenis item kerja dalam proyek target.
• Menangani nilai yang tidak valid: Jika file CSV yang diimpor berisi item kerja dengan nilai yang tidak valid, Anda harus mengedit dan memperbaiki item kerja ini setelah mengimpor sebelum dapat disimpan.

Tip

Bidang item kerja bervariasi antara templat proses yang berbeda (versi Agile, Scrum, CMMI) dan Azure DevOps. Sebelum mengimpor, verifikasi bidang yang tersedia untuk jenis item kerja Anda dengan:

1. Membuat item kerja sampel dari jenis yang diinginkan dalam proyek Anda
2. Menampilkan bidang yang tersedia dalam formulir item kerja
3. Mengekspor item kerja yang sudah ada untuk melihat struktur bidang saat ini

Nama bidang dan ketersediaan mungkin berbeda dari contoh yang diperlihatkan dalam artikel ini berdasarkan templat proses dan versi Azure DevOps Anda.

Selesaikan langkah-langkah berikut untuk mengimpor item kerja baru.

Note

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.

   Tip

   Untuk menentukan nama bidang yang benar untuk instans Azure DevOps Anda:

   • Ekspor beberapa item kerja yang ada dari proyek Anda untuk melihat nama bidang yang tepat
   • Membuat item kerja baru dan meninjau bidang yang tersedia
   • Periksa indeks bidang Item kerja untuk referensi bidang standar

   Contoh berikut mencakup bidang Prioritas . Bidang yang tersedia mungkin berbeda berdasarkan templat proses Anda:

   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, pilih Papan Tugas>Kueri>Impor item kerja.

   

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

   

   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.

   

   Tip

   Jangan menetapkan ID untuk item kerja baru yang Anda tambahkan. Menetapkan ID menghasilkan pesan kesalahan.

6. Sistem menyoroti item kerja yang memiliki 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.

   

Tips

• Field kompatibilitas: Versi dan templat proses Azure DevOps yang berbeda (Agile, Scrum, CMMI, atau kustom) menawarkan bidang yang berbeda. Selalu verifikasi nama bidang dengan mengekspor item kerja yang ada dari proyek Anda sebelum mengimpor yang baru.

• Perbedaan templat proses: Untuk informasi terperinci tentang perbedaan antara templat proses, lihat Memilih proses.

  • Proses tangkas: Menggunakan Cerita Pengguna, Tugas, Bug, Epik, Fitur, Kasus Pengujian
  • Proses Scrum: Menggunakan Item Backlog Produk, Tugas, Bug, Epic, Fitur, Kasus Uji
  • Proses CMMI: Menggunakan Persyaratan, Tugas, Bug, Epic, Fitur, Kasus Pengujian
  • Nama bidang dan opsi yang tersedia mungkin bervariasi berdasarkan proses mana yang digunakan proyek Anda.

• 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 diatur ke Baru secara default. Anda tidak dapat menentukan status yang berbeda selama proses impor. Jika Anda perlu mengubah status item kerja yang diimpor, gunakan solusi berikut:

  1. Impor item kerja dengan status Baru secara 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 Default Area dan Perulangan: Bidang Area dan Perulangan diatur secara otomatis ke simpul tingkat atas. Default ini terjadi karena proses impor tidak memiliki konteks untuk bidang ini kecuali Anda secara eksplisit menentukannya dalam file CSV. Untuk mengatur jalur Area dan Iterasi tertentu selama impor, sertakan bidang ini dalam file CSV Anda dengan nilai yang benar. Contohnya:

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

Mengimpor kolom HTML

Bidang HTML, seperti deskripsi dan kriteria penerimaan, menyertakan pemformatan teks kaya. Untuk memastikan pemformatan ini dipertahankan, selesaikan langkah-langkah 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 CRLF dengan yang berakhiran <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 dan memastikan bahwa html adalah teks biasa, gunakan witadmin changefield perintah . Untuk informasi selengkapnya, 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 setelah mengimpor 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 Menyediakan teks bantuan, hyperlink, atau konten web pada formulir item kerja.

Tipe item kerja yang tidak didukung

Impor CSV tidak mendukung jenis item kerja berikut:

• Permintaan Tinjauan Kode

• Respons Peninjauan Kode

• Permintaan Umpan Balik

• Respons Umpan Balik

• Kasus uji

• Rencana Pengujian

• Serangkaian Pengujian

• Parameter Bersama

• Langkah Bersama

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

FAQs

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

A: Ya! Biarkan bidang ID kosong untuk setiap item kerja baru. Dalam contoh berikut, entri terakhir untuk Epik tidak menyertakan 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",

T: Bisakah saya mengimpor file CSV yang memiliki tautan induk-turunan?

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

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 sintaksnya benar.

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.

Kenapa saya mendapatkan kesalahan pada 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 organisasi. Jika tidak, sistem akan mencari identitas tersebut di Microsoft Entra ID. Jika pengguna berada di Microsoft Entra ID tetapi tidak di organisasi, pengguna tersebut akan ditambahkan ke identitas yang valid.

Saat Anda mengimpor dari CSV, karena alasan kinerja, pemilih identitas tidak melakukan 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.

Menggunakan AI untuk mengelola item kerja secara massal

Jika Anda memiliki Azure Boards MCP Server tersambung ke agen AI Anda dalam mode agen, Anda dapat menggunakan perintah bahasa alami untuk membuat dan memperbarui beberapa item kerja tanpa mengekspor ke CSV.

Tugas	Contoh perintah
Membuat item secara massal	Create 5 user stories for the <Contoso> project with titles for a new login feature
Bidang pembaruan massal	Set the iteration path to Sprint 5 for all active tasks assigned to <Jamal>
Temukan item yang akan diekspor	List all work items modified in the last 7 days in the <Contoso> area path
Memperbarui item yang diimpor	Update the state to Closed for bugs 1234, 1235, and 1236

Note

Mode agen dan Server MCP menggunakan bahasa alami, sehingga Anda dapat menyesuaikan perintah ini atau mengajukan pertanyaan tindak lanjut untuk memperbaiki hasilnya. Untuk migrasi data skala besar atau pengeditan offline, gunakan fitur impor/ekspor CSV yang dijelaskan dalam artikel ini.

Konten terkait

• Mengakses Indeks Kolom Item Kerja
• Tambahkan atau Ubah Item Kerja Secara Massal dengan Excel
• Baca Tanya Jawab Umum: Bekerja di Excel Tersambung ke Azure Boards