Azure Boards'ta CSV dosyalarıyla toplu iş öğelerini içeri aktarma, güncelleştirme ve dışarı aktarma

Azure Boards'ta CSV biçimli dosyaları kullanarak iş öğelerini toplu olarak içeri ve dışarı aktarın. Toplu içeri aktarma ve güncelleştirmeler için Excel'i kullanmaya devam edebilirsiniz ancak Excel gerektirmeyen yerel içeri/dışarı aktarma özelliğini kullanabilirsiniz. Daha fazla bilgi için bkz . Excel ile iş öğelerini toplu ekleme veya değiştirme.

CSV biçimli bir dosya kullanarak iş öğelerini toplu olarak dışarı aktarabilirsiniz. Toplu içeri aktarma ve güncelleştirmeler için Excel'i kullanmaya devam ederken, Excel gerektirmeyen Sorgular'dan yerel dışarı aktarma özelliğini kullanabilirsiniz. Daha fazla bilgi için bkz . Excel ile iş öğelerini toplu ekleme veya değiştirme.

Yeni iş öğelerini içeri aktarma

Yeni iş öğelerini içeri aktarmak için aşağıdaki adımları uygulayın.

1. Yerel bir import.csv dosyası oluşturun ve dosyayı Visual Studio Code veya Excel'de açın.

2. Dosya, İş Öğesi Türü ve Başlık alanlarını içermelidir. Gerektiğinde başka alanlar da ekleyebilirsiniz. Varsayılan alanların listesi için bkz . İş öğesi alan dizini.

   Aşağıdaki örnek Öncelik alanını içerir.

   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. Projenizin web portalında Pano>Sorguları'nı açın ve ardından İş öğelerini içeri aktar'ı seçin.

   

4. Dosya seç'i seçin, dosyanızı seçin ve ardından İçeri Aktar'ı seçin.

   

   İçeri aktarma işlemi, içeri aktarılan iş öğelerini kaydedilmemiş durumdaki sorgular görünümüne yükler. Kimlik atanmadı.

5. Sonuçları doğrulayın ve ardından öğeleri kaydet'i seçerek iş öğelerini kaydedin.

   

   İpucu

   Eklediğiniz yeni iş öğelerine kimlik atayın. Kimlikleri atamak hata iletisiyle sonuçlanır.

6. Sistem bu iş öğelerini veri sorunlarıyla vurgular. İş öğelerini kaydetmeden önce veri sorunlarını çözün. Bu örnekte, Öncelik alanında geçersiz bir değer var. İş öğesini doğrudan açarak verileri düzeltin. Bunun yerine, aynı soruna sahip birkaç iş öğesini düzeltmek için toplu düzenlemeyi kullanın.

   

Aşağıdaki ipuçları yararlı olabilir.

• Üst-alt bağlantılar: Üst-alt bağlantıları olan bir CSV dosyasını içeri aktarabilir miyim? bölümünde gösterildiği gibi, başlık sütunlarını girintileyerek içeri aktardığınız iş öğeleri arasına üst-alt bağlantılar ekleyebilirsiniz. Ancak, iş öğelerini içeri aktarırken veya güncelleştirirken başka bağlantı türü belirtemezsiniz.

• Varsayılan Durum alanı: Yeni iş öğelerini içeri aktardığınızda, Durum alanı varsayılan olarak Yeni olarak ayarlanır. İçeri aktarma işlemi sırasında farklı bir durum belirtemezsiniz. İçeri aktarılan iş öğelerinin durumunu değiştirmeniz gerekiyorsa aşağıdaki geçici çözümü kullanın:

  1. İş öğelerini varsayılan Yeni durumuyla içeri aktarın.
  2. İçeri aktarılan iş öğelerini bir CSV dosyasına aktarın.
  3. Dışarı aktarılan CSV dosyasındaki Durum alanı değerlerini güncelleştirin.
  4. İstenen durumları ayarlamak için güncelleştirilmiş CSV dosyasını yeniden içeri aktarın.

• Varsayılan Alan ve Yineleme alanları: Alan ve Yineleme alanları varsayılan olarak en üst düzey düğüm olur. Bu davranış, CSV dosyasında açıkça belirtilmediği sürece içeri aktarma işleminin bu alanlar için bağlamı olmadığından oluşur. İçeri aktarma sırasında belirli Alan ve Yineleme yollarını ayarlamak için bu alanların CSV dosyanıza doğru değerlerle eklendiğinden emin olun. Örneğin:

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

Mevcut iş öğelerini güncelleştirme

1. İş öğelerini güncelleştirmek için dışarı aktarmak ve büyük olasılıkla düzenlemek istediğiniz tüm sütunları içeren bir sorgu oluşturun. data.csv dosyasını yerel makinenize kaydetmek için sorgunuzu kaydedin ve CSV'ye Aktar'ı seçin.

   

   Dışarı aktarılan dosya aşağıdaki örneğe benzer görünmelidir:

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

2. İş öğelerinizde düzenlemeleri yapın. CSV dosyanız Kimlik, İş Öğesi Türü ve Başlık alanlarını içermelidir. Eklemek istediğiniz diğer alanlar isteğe bağlıdır.

   Not

   Kimlik alanlarını içeri aktarırken, adı ve e-postayı aşağıdaki biçimde "Display Name <email>"girin. Örneğin, Jamal Hartnett'e iş atamak için belirtin "Jamal Hartnett <fabrikamfiber4@hotmail.com>". Sistemde geçerli bir kullanıcı olarak tanınmayan bir değer belirtirseniz, içeri aktarma işlemiyle ilgili sorunlarla karşılaşabilirsiniz.

   Aşağıdaki örnekte, mevcut çalışma öğelerindeki değerleri değiştiriyoruz.

   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. Önceki bölümde açıklandığı gibi dosyayı kaydedin ve içeri aktarın.

4. Değer değişiklikleri içeren iş öğelerinin bulunduğu sonuç listesi kalın olarak vurgulanmış olarak görünür. Değişiklikleri uygulamak için Öğeleri Kaydet'i seçin.

   

5. Veri sorunları olan iş öğeleri kırmızı renkle vurgulanır ve kaydedebilmeniz için önce bunların çözülmesi gerekir. Bu örnekte, Atanan alanında geçersiz bir değer görüntülenir. İş öğesini doğrudan açarak verileri düzeltin. Aynı sorunla ilgili birçok iş öğeniz varsa toplu düzenlemeyi kullanabilirsiniz.

   

Listeyi CSV dosyası olarak dışarı aktarma

Herhangi bir sorgudan, iş öğelerinin listesini virgülle ayrılmış liste olarak dışarı aktarabilirsiniz. Sorguyu açın, eylemler simgesini seçin ve ardından CSV'ye Aktar'ı seçin.

İş öğelerini farklı bir projeye aktarma ve içeri aktarma

Bu özelliği, iş öğelerini bir projeden dışarı aktarmak ve başka bir projeye aktarmak için kullanabilirsiniz. Ancak, bunları başka bir projeye aktarmadan önce iş öğesi kimliğini kaldırmanız gerekir. Yeni iş öğelerini belirtilen bir kimlikle projeye aktarmaya çalışırsanız bir hata alırsınız.

SSS

S: Aynı CSV dosyasındaki yeni öğeleri içeri aktarabilir ve mevcut öğeleri güncelleştirebilir miyim?

Y: Kesinlikle! Yeni iş öğeleri için kimlik alanını boş bırakın. Aşağıdaki örnekte, epic için son girdi bir kimlik belirtmez.

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

S: Üst-alt bağlantıları olan bir CSV dosyasını içeri aktarabilir miyim?

Y: Evet, başlık sütunlarını girintileyerek alt iş öğeleri ekleyebilirsiniz. Aşağıdaki örnek, önceden tanımlanmış Epic'in altına üç alt sorun ekler.

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

S: İçeri aktarılan dosyamda hata olup olmadığını Nasıl yaparım? biliyor musunuz?

Y: Örneğin boşluk ve kısa çizgi içeren etiketler ekleyerek test edebilir ve dışarı aktarmaya ekleyebilirsiniz. İçeri aktarma işlemi aynı biçimle eşleşmelidir. CSV dosyanızın biçimlendirmesiyle ilgili sorunlar, içeri aktarma görünümünün Sonuçlar sayfasında görünür. Biçimlendirme ve söz dizimi doğru olana kadar iş öğelerini içeri aktaramazsınız.

İş öğesi sonuçları her zaman tek tek iş öğeleri için bulunan veri hatalarını listeler. Web portalından veya CSV dosyasındaki her hatayı düzeltip yeniden içeri aktarın.

S: Bazı kimlik değerleri için neden hata alıyorum?

Y: Web kullanıcı arabirimini kullandığınızda, kimlik seçici kullanıcıyı doğrulamak için ek adımlardan geçer. İlk olarak kişinin kuruluşta geçerli bir kullanıcı olup olmadığını denetler. Aksi takdirde, Microsoft Entra Id'de kimlikte arama gerçekleştirir. Kullanıcı Microsoft Entra Id'deyse ancak kuruluşta değilse, bu kullanıcı geçerli kimliklere eklenir.

CSV'den içeri aktardığınızda, performans nedeniyle kimlik seçici bu ek adımları gerçekleştirmez. Yalnızca kuruluşta eşleşen bir Kullanıcı Asıl Adı (UPN) olup olmadığını denetler. Eşleşen bir UPN bulamazsa kimliğin bilinmediğini bildirir.

S: CSV içeri aktarma işlemi tüm iş öğesi türlerini destekliyor mu?

Y: Hayır, CSV içeri aktarma işlemi aşağıdaki iş öğesi türlerini desteklemez:

• Kod Gözden Geçirme İsteği
• Kod Gözden Geçirme Yanıtı
• Geribildirim Talebi
• Geri Bildirim Yanıtı
• Test Çalışması
• Test Planı
• Test Paketi
• Paylaşılan Parametre

Daha fazla bilgi için bkz . Test çalışmalarını toplu içeri veya dışarı aktarma.