İş öğesi alanlarını yönetme

  • Makale

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

Önemli

Şirket içi XML işlem modeli için witadmin kullanarak proje için bir işlemi listeleyebilir, içeri aktarabilir, dışarı aktarabilir ve değiştirebilirsiniz. Devralınan ve Barındırılan XML işlem modellerinde, yalnızca işlem bilgilerini listelemek ve dışarı aktarmak için witadmin kullanabilirsiniz. İşlem modellerine ve desteklenenlere genel bakış için bkz . İş izleme deneyiminizi özelleştirme.

Aşağıdaki witadmin komutlarını kullanarak bir proje koleksiyonu (Şirket içi XML) için tanımlanan iş öğesi türleri için tanımlanan alanları yönetebilirsiniz. Genel alan eklemek istiyorsanız (Şirket içi XML için geçerlidir) bunu yapmak için genel iş akışı dosyasını değiştirebilir ve koleksiyona aktarabilirsiniz.

  • changefield: Bir alanın bir veya daha fazla özniteliğini değiştirir. Aşağıdaki özniteliklerden birini değiştirdiğinizde, bunu proje koleksiyonundaki tüm iş öğesi türleri ve projeleri için değiştirirsiniz:

    • veya HTML alanları için PlainText veri türü.

      Önemli

      Team Foundation Server'ı önceki bir sürümden geçerli sürüme yükselttiğiniz zaman, Açıklama (System.Description) alanının tür ataması otomatik olarak 'den'e PlainTextHTMLdönüştürülür. komutuyla changefield , düz metin görüntülemek için bu alanın içeriğini geri yükleyebilirsiniz.

    • İş öğesi sorgusunda görüntülenen kolay ad . Bu ad, iş öğesi formunda görüntülenen addan farklı olabilir.

    • Bir raporda görünen alanın adını, başvuru raporu adını ve raporlama türünü içeren raporlama öznitelikleri .

    • Active Directory ile eşitleme - Kişi adı alanlarının eşitlenmesini etkinleştirebilir/devre dışı bırakabilirsiniz.

  • deletefield: Belirtilen alanı siler.
  • listfields: Tüm alanların veya belirtilen alanın özniteliklerini listeler.

Not

witadmin indexfield Komut, Azure DevOps Server 2019 ve sonraki sürümlerle kullanım dışı bırakılmıştır. Dizin oluşturma alanları artık gerekli değildir.

witadmin Komut satırı aracını çalıştırma

Komut satırı aracını çalıştırmak witadmin için Visual Studio'nın yüklü olduğu bir Komut İstemi penceresi açın. Komut witadmin satırı aracı, Visual Studio'nun herhangi bir sürümüyle yüklenir. Visual Studio Community veya Visual Studio Team Explorer'ın ücretsiz sürümünü yükleyerek bu araclara erişebilirsiniz.

Not

Azure DevOps Services'e bağlanmak için Visual Studio'nun veya Visual Studio Community'nin en son sürümünü kullanmanızı öneririz.

Not

Bir şirket içi sunucuya bağlanmak için, Azure DevOps Server'ınız ile aynı veya daha sonraki bir Visual Studio sürümünü kullanmanızı öneririz. Örneğin, Azure DevOps Server 2019'a bağlanıyorsanız visual studio 2019 sürümünden projenize bağlanın.

Visual Studio 2022 için

%programfiles(x86)%\Microsoft Visual Studio\2022\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

veya ProfessionalEnterprise yerine Community, yüklediğiniz sürüme bağlı olarak.

Visual Studio 2019 için

%programfiles(x86)%\Microsoft Visual Studio\2019\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

veya ProfessionalEnterprise yerine Community, yüklediğiniz sürüme bağlı olarak.

Visual Studio 2017 için

%programfiles(x86)%\Microsoft Visual Studio\2017\Enterprise\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

veya TeamExplorerProfessional yerine Enterprise, yüklediğiniz sürüme bağlı olarak.

Windows'un 32 bit sürümünde %programfiles(x86)% öğesini %programfiles% ile değiştirin. Visual Studio Community'yi (Takım Gezgini'ne erişim sağlayan) veya Visual Studio Team Explorer 2017'yi ücretsiz yükleyebilirsiniz.

Varsayılan işlem şablonunda tanımlanan alanlara genel bakış için bkz . İş öğesi alan dizini.

İpucu

witadmin ile tanım dosyalarını içeri ve dışarı aktarabilirsiniz. Kullanabileceğiniz diğer araçlar arasında İşlem Düzenleyicisi bulunur (Visual Studio'nun bir sürümünü yüklemiş olmanız gerekir). Visual Studio Market'ten İşlem Şablonu düzenleyicisini yükleyin.

Önkoşullar

  • Alanları listelemek için, koleksiyonda proje için Proje düzeyinde bilgileri görüntüleme izninizin İzin Ver olarak ayarlanmış olması gerekir.
  • Alanları silmek veya yeniden adlandırmak ya da bir alanın özniteliğini değiştirmek için Team Foundation Yönetici istrators güvenlik grubunun veya Project Collection Yönetici istrators güvenlik grubunun üyesi olmanız gerekir.

Daha fazla bilgi için bkz . Proje koleksiyonu düzeyi izinlerini değiştirme.

Not

Yönetici izinleriyle oturum açsanız bile, bu işlevi Windows Server 2008 çalıştıran bir sunucuda gerçekleştirmek için yükseltilmiş bir Komut İstemi penceresi açmanız gerekir. Yükseltilmiş bir Komut İstemi penceresi açmak için Başlat'ı seçin, Komut İstemi kısayol menüsünü açın ve ardından Yönetici istrator olarak çalıştır'ı seçin. Daha fazla bilgi için bkz. Microsoft Web sitesi: Kullanıcı Erişim Denetimi.

Sözdizimi

witadmin changefield /collection:CollectionURL /n:RefName   [/name:NewName]    [/syncnamechanges:true | false]   [/reportingname:ReportingName]    [/reportingrefname:ReportingRefName]   [/reportingtype:Type]   [/reportingformula:Formula]   [/type:PlainText | HTML]   [/noprompt]  

witadmin deletefield /collection:CollectionURL /n:RefName [/noprompt]  

witadmin listfields /collection:CollectionURL /n:RefName [/unused]

Parametreler

Parametre Açıklama
/collection:CollectionURL Proje koleksiyonunun URI'sini belirtir. Örneğin:

Şirket içi biçim:http://ServerName:Port/VirtualDirectoryName/CollectionName
Sanal dizin kullanılmazsa şu biçimi kullanın: http://ServerName:Port/CollectionName.
/n:RefName
/n:Name		 İş öğesi türü alanının başvuru adı.
/index Belirtilen alan için dizin oluşturmayı etkinleştirmeyi veya devre dışı bırakmayı belirtir. Dizin oluşturmayı etkinleştirmek için açık ve dizin oluşturmayı devre dışı bırakmak için kapalı seçeneğini belirtin.
/name:NewName Alanın yeni adını belirtir.
/syncnamechanges Active Directory'de veya bir çalışma grubunda değişiklikler yapıldıkçe adları depolamak ve güncelleştirmek için iş öğesi alanının kullanılacağını belirtir. Bu seçenek yalnızca için Dize veri türüne sahip bir alan belirtildiğinde typenamegeçerlidir.

true Veri alanı için eşitlemeyi etkinleştirmek için belirtin, veri alanı için eşitlemeyi devre dışı bırakmak için belirtinfalse.
/reportingname:ReportingName Raporlama için kullanılacak veri ambarında alanın adını belirtir.
/reportingrefname:ReportingRefName Raporlama için kullanılacak veri ambarında alanın başvuru adını belirtir.
/reportingtype:Type Alanın raporlama için ambarda nasıl kullanılacağını belirtir. Aşağıdaki değerler geçerlidir:

- dimension: Integer, String veya DateTime alanları için kullanılır.
- detail: Integer, Double, String veya DateTime alanları için kullanılır.
- measure: Tamsayı ve Çift alanları için kullanılır. Varsayılan toplama türü toplamdır. Formül parametresini kullanarak başka bir toplama türü belirtebilirsiniz.
- none: Alanda raporlanabilirliği devre dışı bırakmak için kullanılır.

Daha fazla bilgi için bkz . İş öğesi alanları ve öznitelikleri hakkında.
/reportingformula:Formula Alan olarak measureraporlandığında kullanılacak toplama formülünü belirtir. Desteklenen tek formül: sum.
/type:HTML | PlainText Alanın içeriğinin 'den veya 'den'e PlainTextHTMLHTML dönüştürülmesini PlainTextbelirtir. Bu seçeneği yalnızca tür ataması PlainText veya HTMLolan alanlar için belirtebilirsiniz. Bkz. ALAN (Tanım) öğesi başvurusu.
/unused Proje koleksiyonunda tanımlı herhangi bir proje tarafından kullanılmayan tüm alanları listeler.
/noprompt Onay istemini devre dışı bırakır.
/? veya help Komut İstemi penceresinde komutla ilgili yardım görüntüler.

Kişi adlarını Active Directory ile eşitleme

Active Directory'ye başvuran kişi adlarını atamak için kullanılan tüm özel iş öğesi alanlarının eşitlemesini el ile etkinleştirmeniz gerekir. Özel alanları içeren her proje koleksiyonu için her alan için eşitlemeyi etkinleştirmeniz gerekir.

Kişi adlarını gösteren tüm sistem başvuru alanlarının özniteliği syncnamechanges olarak ayarlanmıştır true. Bu alanlar System.AuthorizedAs, System.AssignedTo, System.ChangedBy ve System.CreatedBy'yi içerir. uygulamasındaki eşitleme, varsayılan işlem şablonlarından birinde tanımlanan her kişi adı alanı için etkindir. Daha fazla bilgi için bkz . Atamalar ve iş akışı alanları.

Eşitleme etkinleştirildikten sonra, alanda artık statik bir dize gösteril kalmaz. Bunun yerine, alanında bir kullanıcı hesabıyla ilişkilendirilmiş ad gösterilir. Active Directory'de veya Çalışma Grubu'nda kullanıcı adını değiştirdiğinizde, olarak ayarlanmış true bir alan syncnamechanges yeni adı otomatik olarak gösterir.

Özniteliği bir Dize alanına atadığınızda syncnamechanges , alan her zaman geçerli kullanıcı adlarını kabul eder. Ancak, aşağıdaki koşullardan biri aşağıdakilerden truebiriyse, alan Team Foundation Server'da veya Active Directory'de depolanan grup adlara izin vermez:

  • Kural VALIDUSER tüm iş öğesi türlerinde belirtilir

  • Kural VALIDUSER bir iş öğesi türü için belirtilir

  • Kural ALLOWEDVALUES bir iş öğesi türü için belirtilir ve bu kuralın grupları dışlayan bir filtre ölçütü vardır

    Daha fazla bilgi için bkz . Tüm ALAN öğeleri.

Her iş öğesi türü için değiştirebileceğiniz öznitelikler

Alanın görüntülendiği iş öğesi türü tanımını değiştirerek bir alan için tanımlanan aşağıdaki öznitelikleri veya değerleri değiştirirsiniz:

Örnekler

Aksi belirtilmediği sürece, her örnekte aşağıdaki değerler geçerlidir:

  • Proje koleksiyonu için URI: http://AdventureWorksServer:8080/tfs/DefaultCollection
  • İş öğesi alan adı: AdventureWorks.Field
  • Varsayılan kodlama: UTF-8

Liste alanları

Kullanımdaki alan kümesini görmek, iş öğesi türüne eklemek üzere bir alan seçmek için kullanın witadmin listfields . Ayrıca, belirli bir alan için tanımlanan öznitelik atamalarını listeleyebilir ve hangi alanların hangi projeler tarafından kullanıldığını belirleyebilirsiniz.

İş öğesi alanının özniteliklerini görüntüleme

  • Belirtilen bir alan için tanımlanan öznitelikleri (örneğin Microsoft.VSTS.Common.Issue) listelemek için aşağıdaki komutu girin.

    witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:Microsoft.VSTS.Common.Issue

    Bu örnekte gösterildiği gibi, adlandırılmış alan için alan ve öznitelik bilgileri görüntülenir.

    Field: Microsoft.VSTS.Common.Issue  
Name: Issue  
Type: String  
Reportable As: dimension  
Use: Adventure Works (Shared Steps), AW Future (Shared Steps), AW Current (Shared Steps)  
Indexed: False

    Use parametresi, her projenin adını ve alanın kullanıldığı iş öğesi türünü gösterir. Alan öznitelikleri hakkında daha fazla bilgi için bkz . İş öğesi alanlarının dizini.

Proje koleksiyonundaki tüm alanları listeleme

  • Proje koleksiyonu için tanımlanan tüm alanları listelemek için aşağıdaki komutu girin.

    witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection

    Adlandırılmış proje koleksiyonunun tüm alanları için alan bilgileri görüntülenir. Bkz. İş öğesi alanlarının dizini.

Kullanılmayan alanları listeleme

  • Proje koleksiyonunda artık kullanılmayan alanları herhangi bir iş öğesi türüne göre listelemek için aşağıdaki komutu girin.

    witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /unused

    Bu örnekte gösterildiği gibi, kullanılmayan her alan için alan ve öznitelik bilgileri görüntülenir.

    Field: Microsoft.VSTS.CMMI.TaskType  
Name: Task Type  
Type: String  
Reportable As: dimension  
Use: Not In Use  
Indexed: False  

Field: Microsoft.VSTSUE.Common.Flag  
Name: Flag  
Type: String  
Reportable As: dimension  
Use: Not In Use  
Indexed: False  

Field: Microsoft.VSTSUE.Common.Progress  
Name: Progress  
Type: String  
Reportable As: dimension  
Use: Not In Use  
Indexed: False

Alanı yeniden adlandırma

Ekibinizin kullandığı adlandırma kurallarını karşılamak için bir iş öğesi alanının kolay adını değiştirebilirsiniz. Yeni adın, proje koleksiyonundaki tüm projelerde değiştirilen alana başvuran tüm iş öğesi türlerine uygulandığını unutmayın. Bir iş öğesi sorgusunda filtre ölçütleri tanımladığınızda kolay ad görüntülenir. İş öğesi formunda görüntülenen ad, alan için tanımlanan kolay addan farklı olabilir.

İş öğesi alanını yeniden adlandırmak için

  1. Önemli Derece'ye atanan kolay adı yeniden adlandırmak için Microsoft.VSTS.Common.Rankaşağıdaki komutu girin.

    witadmin changefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:Microsoft.VSTS.Common.Rank /name:"Important Rank"

  2. Onay istemine y yazın ve ENTER tuşuna basın. Aşağıdaki iletiyi alıncaya kadar bekleyin:

    Alan yeniden adlandırıldı.

Tek bir projeye aktarılan değişiklikleri doğrulamak için

  1. Takım Gezgini'nde Yenile'yi seçinYenile.

    En son güncelleştirmeler, alan adında yaptığınız değişiklikleri içeren sunucudan indirilir. Yenilemenin bitmesini birkaç saniye bekleyin.

  2. Sorgu oluşturmak için Yeni Sorgu'yu seçin.

  3. Sorgu Düzenleyicisi Satır eklemek için Buraya tıklayın yan tümcesi ekleyin bağlantısını seçin, boş Alan hücresini seçin ve hücreye Derece yazın. Sonuç listesinin üzerinde görüntülenen aşağıdaki ileti. Bu ileti, Derecenin bulunamadığını gösterir.

    Sorgu sonuçlarını görmek için sorguyu çalıştırın. TF51005: Sorgu var olmayan bir alana başvurur. Hata dereceden <<>>kaynaklanır.

  4. Alan hücresinden Rank değerini silin ve hücreye Önemli Derece yazın.

  5. İşleç hücresini seçin <> ve Değer hücresine 1 yazın.

  6. Sorgu araç çubuğunda Çalıştır'ı seçinSorgu Çalıştır.

  7. Sonuçlardaki herhangi bir satırın kısayol menüsünü açın ve Sütun Seçenekleri'ni seçin. Kullanılabilir sütunlar listesinde aşağı kaydırın. Derece alanının artık mevcut olmadığına, ancak Önemli Derece alanının mevcut olduğuna dikkat edin.

  8. Kullanılabilir sütunlar kutusunda Önemli Derece'yi seçin ve ardından düğmeyi > seçin (seçili sütunları ekleyin). Tamam'ı seçin.

    Microsoft.VSTS.Common.Rank kolay adının sorgu oluşturucusu ve sonuç listesi boyunca Derece'den Önemli Derece olarak yeniden adlandırıldığına dikkat edin.

  9. Sorguyu kapatın. Sorguyu kaydetmeniz istendiğinde Hayır'ı seçin.

  10. Yeni bir Görev iş öğesi oluşturun. Yeni İş Öğeleri bağlantısını ve ardından Görev'i seçin.

    Bu iş öğesi, değiştirip içeri aktardığınız iş öğesi türünden oluşturulur.

  11. Durum kutusunda, yeniden adlandırılan Rank alanının etiketinin değişmediğine dikkat edin. Bunun nedeni, iş öğesi formlarında alan etiketlerinin kapsamının üst proje olarak belirlenmiş olması ve az önce belirtilen sunucu genelindeki alan adından bağımsız olmasıdır.

    Not

    İş öğesi formlarında alan etiketlerini değiştirme hakkında daha fazla bilgi için bkz . Control XML öğesi başvurusu.

  12. Yeni Görevi kapatın ve iş öğesini kaydetmeniz istendiğinde Hayır'ı seçin.

Raporu alan için değer olarak değiştirme

Aşağıdaki komut, AdventureWorks.CreatedOn DateTime alanının türünü boyuta raporlama özelliğini belirtir. Bu alanın verileri, raporları filtrelemek için kullanılabilmesi için ambara ve Analysis Services veritabanlarına girer.

witadmin changefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:AdventureWorks.CreatedOn /reportingtype:dimension

Aşağıdaki komut, ölçülecek AdventureWorks.Field Çift alanının türünü raporlama özelliğini belirtir. Tüm ölçüler toplam olarak toplanır.

witadmin reportfield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:AdventureWorks.Field /reportingtype:measure

Özel bir kişi-adı alanının eşitlemesini etkinleştirme

Aşağıdaki komut, AW iş öğesi alanı için eşitlemeyi etkinleştirir. AdventureWorksServer'da Collection1 için tanımlanan CustomerName.

Dönüştürmek istediğiniz alanın veri türünü doğrulayın

  1. Aşağıdaki komutu girerek alana atanan MyCompany.CustomerName gibi eşitlemek istediğiniz veri türünü doğrulayın:

    witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.CustomerName

Eşitlemeyi etkinleştirme

  1. Kişi adlı bir alan için eşitlemeyi etkinleştirmek için aşağıdaki komutu yazın ve burada gösterilen bağımsız değişkenler için verilerinizi yazın:

    witadmin changefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.CustomerName /syncnamechanges:true

  2. Aşağıdaki onay istemi görüntülenir:

    Bu, Team Foundation Server'da alanın {0} özelliklerini değiştirir. Devam etmek istiyor musunuz?

  3. Alanı değiştirmek istediğinizi onaylamak için 0 yazın veya isteği iptal etmek için 1 yazın.

    Değişiklik isteği başarılı olursa aşağıdaki onay iletisi görüntülenir:

    Alan güncelleştirildi.

    Değişiklik isteği başarısız olursa bir hata iletisi görüntülenir. Yapılabilecek en yaygın hatalar, sistem başvuru alanını değiştirmeye çalışmak veya Dize dışında bir veri türündeki bir alanı değiştirmeye çalışmaktır. Bu işlemler desteklenmez.

Alan silme

Bir alanı silmeden önce alanın kullanımda olmadığını doğrulayın. Alan kullanımdaysa, proje koleksiyonundan silmeden önce alanı kullanan iş öğesi türlerinden kaldırmanız gerekir. Aşağıdaki komut, alanı AdventureWorks.Field Collection1'den siler:

witadmin deletefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:AdventureWorks.Field

Alanın kullanımda olmadığını doğrulama

  1. aşağıdaki komutu girin ve iş öğesi alanının başvuru adını (örneğin MyCompany.MyProcess.MyField) belirtin.

    witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.MyProcess.MyField

    Alanı için görüntülenen bilgilerde, bu örnekte gösterildiği gibi Kullanım değerinin "Kullanımda Değil" olduğunu doğrulayın.

    Field: MyCompany.MyProcess.MyField  
Name: MyField  
Type: String  
Reportable As: dimension  
Use: Not In Use  
Indexed: False

  2. Kullan alanı alanın kullanımda olduğunu gösteriyorsa, listelenen her proje için her iş öğesi türünden silmeniz gerekir. Örneğin, Microsoft.VSTS.TCM.SystemInfo alanı Hata ve Kod Hatası iş öğesi türleri tarafından dört proje için kullanıldığını gösterir: Arroyo, Çöl, Palm ve Yaylar.

    Field: Microsoft.VSTS.TCM.SystemInfo  
Name: System Info  
Type: Html  
Reportable As: None  
Use: Arroyo (Bug), Desert (Bug), Palm (Bug), Springs (Bug, Code Defect)  
Indexed: False

    Bu alanı silebilmeniz için önce, tanımlandığı her proje için listelenen iş öğesi türlerinin her birinden kaldırmanız gerekir. Alanı kaldırmak için, alan başvuru adını içeren ve Control öğelerini silerek FIELD iş öğesi türünün tanımını değiştirirsiniz. Bkz. İş öğesi türlerini içeri aktarma, dışarı aktarma ve yönetme, ALAN (Tanım) öğesi başvurusu ve Denetim.

Proje koleksiyonundan alan silme

Alanı silmek MyCompany.MyProcess.MyField için aşağıdaki komutu girin ve enter tuşuna basın.

witadmin deletefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:RefName

Bu adımı tamamlamak için onay istemine y girin.