Toplu iş öğelerini CSV dosyalarıyla içeri aktarma ve güncelleştirme

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Azure DevOps'ta CSV biçimli bir dosya 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.

Not

Dışarı aktarma özelliği Azure DevOps Server 2019 Güncelleştirme 1 ve sonraki sürümlerde kullanılabilir. İçeri aktarma özelliği Azure DevOps Server 2020 ve Azure DevOps Services ile kullanılabilir.

Yeni iş öğelerini içeri aktarma

İçeri aktardığınız tüm iş öğeleri Yeni durumda oluşturulur. Bu kural, yeni durum için alan kurallarına uymayen alan değerlerini belirtememenizi sağlar. Örneğin, Çevik işlemiyle yeni bir kullanıcı hikayesi oluşturduğunuzda Durum = Yeni ve Neden = Yeni. Başka değer belirtemezsiniz.

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. Varsayılan alanların listesi için bkz . İş öğesi alan dizini.

   Aşağıdaki örnekte Öncelik alanını ekleyeceğiz.

   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 İçeri Aktar seçeneğini belirleyin.

   

4. CSV dosyanızı 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 atamayın, aksi takdirde bir hata iletisi alırsınız.

   TFS401232: 1794 iş öğesi yok veya okuma izniniz yok.

6. Sistem bu iş öğelerini veri sorunlarıyla vurgular. İş öğelerini kaydetmeden önce veri sorunlarını çözün. Bu örnekte, Öncelik alanına geçersiz bir değer girilmiştir. İş öğ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.

   

İpucu

İçeri aktardığınız iş öğeleri arasına üst-alt bağlantılar eklemek için, bu makalenin devamında yer alan örnekte gösterildiği gibi başlık sütunlarını girintileyebilir, üst-alt bağlantılara sahip bir CSV dosyasını içeri aktarabilir miyim?. Ancak iş ögelerini içeri aktarırken veya güncelleştirirken başka hiçbir bağlantı türü belirtemezsiniz.

Not

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.

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 söz dizimine benzer olmalıdır:

    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. İş öğelerinizde düzenlemeleri yapın. CSV dosyanız Kimlik, İş Öğesi Türü, Başlık ve Durum 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, var olan çalışma öğelerindeki çeşitli değerleri değiştiriyoruz.

   "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. Dosyayı kaydedin ve içeri aktarın (önceki içeri aktarma bölümünde yer alan 4-6 arası adımlara bakı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.

Zengin metin alanlarını içeri aktarma veya güncelleştirme

Açıklama veya Kabul Ölçütleri alanları gibi zengin metin alanlarını güncelleştirebilir veya içeri aktarabilirsiniz. Zengin metin alanları HTML biçimli alanlardır. CRLF ile biten satırları, çevresindeki cümlelerle <p>... </p>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>"

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: Birden çok etiket eklemek Nasıl yaparım??

Y: Noktalı virgülle ayrılmış birden çok etiket ekleyebilirsiniz. Daha fazla bilgi için bkz . Excel ile yapabileceğiniz ve yapılamaz görevler.

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 aracılığıyla 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 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.

İlgili makaleler

• İş öğesi alan dizini
• İş öğelerini Excel ile toplu olarak ekleme veya değiştirme
• SSS: Azure Boards'a bağlı Excel'de çalışma