İş öğelerini toplu olarak CSV dosyalarıyla dışa aktarma, güncelleştirme ve içe aktarma

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

Azure Boards, Microsoft Excel gerek kalmadan iş öğelerini toplu olarak yönetmek için kullanabileceğiniz yerel bir CSV içeri ve dışarı aktarma özelliği sağlar. Bu özellik çeşitli senaryolar için kullanışlıdır:

• Toplu düzenleme: İş öğelerini dışarı aktarın, Excel'de veya herhangi bir elektronik tablo uygulamasında değişiklik yapın ve bunları yeniden içeri aktarın.
• Veri geçişi: İş öğelerini projeler veya kuruluşlar arasında taşıma.
• Çevrimdışı çalışma: İş öğelerini indirin, internet bağlantısı olmadan düzenleyin ve değişiklikleri daha sonra eşitleyin.
• Reporting and analysis: Excel, Power BI veya diğer araçlarda özel raporlama için iş öğesi verilerini dışarı aktarın.
• Yedekleme: İş öğelerinizin belirli bir noktaya anlık görüntülerini oluşturun.

CSV yaklaşımı, doğrudan web düzenlemeye göre çeşitli avantajlar sunar:

• Tanıdık araçlar: Excel'in bulma/değiştirme, formüller ve filtreleme gibi güçlü özelliklerini kullanın.
• Hız: Aynı anda yüzlerce iş öğesinde değişiklik yapın.
• Esneklik: Çevrimdışı çalışın ve hazır olduğunuzda değişiklikleri içeri aktarabilirsiniz.
• Excel eklentisi gerekmez: Excel tümleştirmesinin aksine, CSV özelliği herhangi bir elektronik tablo uygulamasıyla çalışır.

Tip

Bu makalenin devamında AI kullanarak bu göreve yardımcı olabilirsiniz veya başlamak için Azure DevOps MCP Server ile yapay zeka yardımı sağlama konusuna bakın.

Prerequisites

Kategori	Gereksinimler
İzinler	- İş öğelerini dışarı aktarma: Proje Yöneticileri grubunun üyesi veya Proje düzeyinde bilgileri görüntüle izni İzin Ver olarak ayarlanır. - İş öğelerini içeri aktarma: Proje Yöneticileri veya Team Foundation Yöneticileri güvenlik grubunun üyesi.

İş öğelerini CSV dosyasına aktarma

İş öğelerini dışarı aktarmak, toplu düzenleme iş akışının ilk adımıdır. Dışarı aktarmak istediğiniz iş öğelerini ve sütunları içeren bir sorgu oluşturarak başlayın.

1. Dışarı aktarmak istediğiniz iş öğelerini döndüren bir sorgu açın veya oluşturun. Sorgunun düzenlemeyi planladığınız tüm sütunları içerdiğinden emin olun.

2. Eylemler simgesini ve ardından CSV'ye aktar'ı seçin.

   

3. data.csv dosyasını yerel makinenize kaydedin.

   Dışarı aktarılan dosya aşağıdaki örneğe benzer:

   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

İçeri aktarma dosyası oluşturmadan önce var olan birkaç iş öğesini dışarı aktarın. Bu yaklaşım, Azure DevOps örneğiniz ve işlem şablonunuz için doğru alan adlarını ve biçimini belirlemenize yardımcı olur.

Mevcut iş öğelerini güncelleştirme

İş öğelerini dışarı aktardıktan sonra, bunları Excel'de veya herhangi bir elektronik tablo uygulamasında düzenleyebilir ve sonra değişiklikleri yeniden içeri aktarabilirsiniz.

1. Dışarı aktarılan CSV dosyasını Excel'de veya tercih ettiğiniz elektronik tablo uygulamasında açın.

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.

   Note

   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>". Sistemin geçerli bir kullanıcı olarak tanımadığı bir değer belirtirseniz, içeri aktarma işlemiyle ilgili sorunlarla karşılaşabilirsiniz.

   Aşağıdaki örnekte, var olan çalışma öğelerindeki değerleri değiştirirsiniz.

   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. Dosyayı kaydedin ve içeri aktarın. Web portalında Panolar>Sorgular>İş öğelerini içeri aktar seçin.

   

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

   

5. 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.

   

6. Veri sorunları olan iş öğeleri kırmızı renkle vurgulanır ve kaydedebilmeniz için önce bunları çözmeniz 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.

   

Yeni iş öğelerini içeri aktarma

Yeni iş öğelerini içeri aktarmak için gerekli alanlara sahip bir CSV dosyası oluşturun. Mevcut öğeleri güncelleştirmenin aksine, yeni iş öğelerinin Kimlik alanını eklemeyin.

İş öğelerini toplu olarak içeri aktarmak için CSV dosyanızda İş Öğesi Türü ve Başlık alanları bulunmalıdır. Gerektiğinde daha fazla alan ekleyebilirsiniz. CSV dosyasını içeri aktarmak için şu yönergeleri izleyin:

• Kimlik alanını dışla: CSV dosyanıza Kimliği alanını eklemeyin.
• Projeye özgü alanları kaldırma: CSV dosyası farklı bir projeden dışarı aktarıldıysa, Alan Yolu ve Etiketlerigibi kaynak projeye özgü alanları kaldırın. Varsayılan alanların listesi için bkz. İş Öğesi Alan Dizini .
• Test Adımları alanını ekleyin: Test çalışmalarını içeri aktarırken Test Adımları alanını ekleyin. Daha fazla bilgi için bkz. Toplu İçeri veya Dışarı Aktarma Test Çalışmaları.
• Atanan, Değiştirme Tarihi, Oluşturanveya Durum alanlarını eklemeyin.
• Gerekli alanları doğrula:
  • CSV dosyasında İş Öğesi Türü ve Başlık alanlarının bulunduğundan emin olun.
  • İş Öğesi Türü hedef projede geçerli bir türe karşılık geldiğini onaylayın.
  • CSV dosyasındaki tüm alanların hedef projedeki iş öğesi türlerinin alanlarıyla eşleştiğinden emin olun.
• Geçersiz değerleri işleme: İçeri aktarılan CSV dosyası geçersiz değerlere sahip iş öğeleri içeriyorsa, içeri aktarma işleminden sonra bu iş öğelerini kaydedebilmeniz için önce düzenlemeniz ve düzeltmeniz gerekir.

Tip

İş öğesi alanları farklı işlem şablonları (Çevik, Scrum, CMMI) ve Azure DevOps sürümleri arasında farklılık gösterir. İçeri aktarmadan önce, iş öğesi türleriniz için kullanılabilir alanları şu şekilde doğrulayın:

1. Projenizde istenen türde bir örnek iş öğesi oluşturma
2. İş öğesi formundaki kullanılabilir alanları görüntüleme
3. Geçerli alan yapısını görmek için mevcut iş öğelerini dışarı aktarma

Alan adları ve kullanılabilirlik, işlem şablonunuz ve Azure DevOps sürümünüz temelinde bu makalede gösterilen örneklerden farklı olabilir.

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

Note

Aynı anda en fazla 1.000 iş öğesini içeri aktarabilirsiniz. İçeri aktarabileceğiniz 1.000'den fazla iş öğeniz varsa, bunları birden çok dosyaya bölün ve ayrı olarak içeri aktarın.

1. Yerel bir import.csv dosyası oluşturun ve 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.

   Tip

   Azure DevOps örneğinizin doğru alan adlarını belirlemek için:

   • Tam alan adlarını görüntülemek için var olan birkaç iş öğesini projenizden dışarı aktarın
   • Yeni bir iş öğesi oluşturma ve kullanılabilir alanları gözden geçirme
   • Standart alan başvuruları için İş öğesi alan dizinini kontrol edin

   Aşağıdaki örnek Öncelik alanını içerir. Kullanılabilir alanlarınız işlem şablonunuz temelinde farklılık gösterebilir:

   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ından Panolar>Sorgular'ı seçin>İş öğeleriniiçeri aktarın.

   

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 sorgular görünümünde kaydedilmemiş bir durumda yükler. Kimlikler atanmaz.

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

   

   Tip

   Yeni eklediğiniz iş öğelerine kimlik atamayın. Kimlikleri atamak hata iletisiyle sonuçlanır.

6. Sistem, veri sorunları olan iş öğelerini 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.

   

Tips

• Field compatibility: Farklı Azure DevOps sürümleri ve işlem şablonları (Çevik, Scrum, CMMI veya özel) farklı alanlar sunar. Yenilerini içeri aktarmadan önce projenizdeki mevcut iş öğelerini dışarı aktararak alan adlarını her zaman doğrulayın.

• İşlem şablonu farklılıkları: İşlem şablonları arasındaki farklar hakkında ayrıntılı bilgi için bkz. İşlem seçme.

  • Çevik işlem: Kullanıcı Hikayesi, Görev, Hata, Epic, Özellik, Test Çalışması kullanır
  • Scrum süreci: Ürün Kapsam Öğesi, Görev, Hata, Epic, Özellik, Test Senaryosu kullanır
  • CMMI işlemi: Gereksinim, Görev, Hata, Epic, Özellik, Test Çalışması kullanır
  • Alan adlarınız ve kullanılabilir seçenekleriniz, projenizin kullandığı işleme göre farklılık gösterebilir.

• Ü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 varsayılan durum, CSV dosyasında açıkça belirtmediğiniz sürece içeri aktarma işleminin bu alanlar için bağlamı olmamasından oluşur. İçeri aktarma sırasında belirli Alan ve Yineleme yollarını ayarlamak için, bu alanları doğru değerlerle CSV dosyanıza ekleyin. Örneğin:

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

HTML alanlarını içeri aktarma

Açıklamalar ve kabul ölçütleri gibi HTML alanları zengin metin biçimlendirmesi içerir. Bu biçimlendirmenin korunmasını sağlamak için aşağıdaki adımları tamamlayın:

1. CSV dosyanızın ilgili alanlarda HTML etiketleri içerdiğinden emin olun.
2. CSV dosyasını Excel'e aktarın.

Excel çok satırlı metin alanlarını farklı şekilde işleyebilir, bu nedenle içeri aktarma işleminden sonra biçimlendirmeyi denetlemek önemlidir. Çizgilerin sonundaki CRLF etiketlerini, tümceleri <p>... </p> ile çevreleyerek değiştirin.

Örneğin, Açıklama alanında üç satır metin içeren aşağıdaki iş öğesini içeri aktarabilirsiniz.

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

Çok satırlı alanları düz metne dönüştürme

Çok satırlı alanlarda HTML'yi devre dışı bırakmak ve düz metin olduklarından emin olmak için komutunu kullanın witadmin changefield . Daha fazla bilgi için bkz . İş Öğesi Alanlarını Yönetme.

Örnek komut:

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

Biçimlendirme tutarsızlıklarını işleme

Farklı Microsoft ürünlerinde HTML alanlarıyla çalışırken biçimlendirme tutarsızlıklarıyla karşılaşabilirsiniz. Bu sorunları gidermeye yönelik bazı ipuçları şunlardır:

• İçeri aktardıktan sonra biçimlendirmeyi gözden geçirerek gereksinimlerinizi karşıladığından emin olun.
• Tutarsızlıkları en aza indirmek için uygun HTML etiketlerini ve yapılarını kullanın. Noktalı virgülle ayrılmış birden çok etiket ekleyebilirsiniz. Daha fazla bilgi için bkz . Excel ile yapabileceğiniz ve yapılamaz görevler.

HTML içeriğini yönetme ve uyumluluğu sağlama hakkında daha fazla bilgi için bkz İş öğesi formunda yardım metni, köprüler veya web içeriği sağlama.

Desteklenmeyen iş öğesi türleri

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ı

• Geri Bildirim İsteği

• Geri Bildirim Yanıtı

• Test Çalışması

• Test Planı

• Test Paketi

• Paylaşılan Parametre

• Paylaşılan Adım

Daha fazla bilgi için bkz Test senaryolarını toplu içe veya dışa aktarma.

FAQs

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

Y: Evet! Yeni iş öğeleri için kimlik alanını boş bırakın. Aşağıdaki örnekte, bir Epik için son giriş 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?

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

Q: İthal ettiğim dosyada hata olup olmadığını nasıl anlarım?

Y: Örneğin boşluk ve kısa çizgi içeren etiketler ekleyerek test edebilir ve bunları dışarı aktarmaya ekleyebilirsiniz. İçe aktarma aynı formatta olmalıdır. 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 kimliği arar. Eğer kullanıcı Microsoft Entra ID'de var olup da kuruluşta değilse, o kullanıcı geçerli kimlikler listesine 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.

İş öğelerini toplu olarak yönetmek için yapay zeka kullanma

Aracı modunda yapay zeka aracınıza bağlı Azure Boards MCP Server varsa, CSV'ye aktarmadan birden çok iş öğesi oluşturmak ve güncelleştirmek için doğal dil istemlerini kullanabilirsiniz.

Görev	Örnek komut
Öğeleri toplu olarak oluşturma	Create 5 user stories for the <Contoso> project with titles for a new login feature
Alanları toplu güncelleştirme	Set the iteration path to Sprint 5 for all active tasks assigned to <Jamal>
Dışarı aktaracak öğeleri bulma	List all work items modified in the last 7 days in the <Contoso> area path
İçeri aktarılan öğeleri güncelleştirme	Update the state to Closed for bugs 1234, 1235, and 1236

Note

Aracı modu ve MCP Sunucusu doğal dil kullandığından, bu istemleri ayarlayabilir veya sonuçları iyileştirmek için takip soruları sorabilirsiniz. Büyük ölçekli veri geçişi veya çevrimdışı düzenleme için bu makalede açıklanan CSV içeri/dışarı aktarma özelliğini kullanın.

İlgili içerik

• İş Öğesi Alan Dizinine Eriş
• Excel ile İş Öğelerini Toplu Ekleme veya Değiştirme
• SSS'ye Başvurun: Azure Boards ile Bağlantılı Excel ile Çalışma