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

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

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

witadmin komut satırı aracı, proje koleksiyonunuzdaki iş öğesi alanlarını yönetmek için güçlü özellikler sağlar. Alanları yeniden adlandırmanız, veri türlerini ayarlamanız veya kimlik sağlayıcılarıyla eşitlemeyi yapılandırmanız gereksin, bu komutlar size iş izleme deneyiminiz üzerinde ayrıntılı denetim sağlar.

witadmin alan komutlarıyla yapabilecekler

Koleksiyonunuzdaki tüm iş öğesi türleri ve projeleri genelinde alanları yönetmek için aşağıdaki witadmin komutlarını kullanın:

• changefield: Koleksiyon genelinde uygulayan alan özniteliklerini değiştirin; örneğin:
  • ve biçimleri arasında PlainTextHTML

  Önemli

  Azure DevOps Server'ı yükselttiğiniz zaman , Açıklama alanı (System.Description) otomatik olarak 'den'e PlainTextHTMLdönüştürülür. changefield Gerekirse bunu geri almak için komutunu kullanın.

  • İş öğesi sorgularında görüntülenen kolay adlar (form etiketlerinden farklı olabilir)
  • Veri ambarı tümleştirmesi için raporlama öznitelikleri
  • Microsoft Entra Id veya Active Directory ile kimlik eşitleme
• deletefield: Kullanılmayan alanları koleksiyonunuzdan kaldırma
• listfields: Projelerde alan özniteliklerini ve kullanımını görüntüleme

İpucu

• Şirket içi XML ortamlarına genel alanlar eklemek için genel iş akışı dosyasını değiştirin ve koleksiyonunuza aktarın.
• Komut witadmin indexfield kullanım dışıdır. Alan dizin oluşturma işlemi otomatik olarak gerçekleşir.

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.

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

Görev	Gerekli İzinler
Liste alanları	Koleksiyondaki projeye izin ver olarak ayarlanan proje düzeyi bilgi iznini görüntüleme
Alanları silme veya yeniden adlandırma	Proje Koleksiyonu Yöneticileri güvenlik grubunun üyesi
Alan özniteliklerini değiştirme	Proje Koleksiyonu Yöneticileri güvenlik grubunun üyesi

Daha fazla bilgi için bkz. proje koleksiyonu düzeyindeki grup izinlerini değiştirme.

Not

Yönetici izinleriyle oturum açsanız bile, bu işlevi Windows Server ç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 Olarak Çalıştır'ı seçin.

Sözdizimi

İş öğesi alanlarını witadmin aracıyla yönetmek için aşağıdaki komut söz dizimi desenlerini kullanın:

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ı.
/name:NewName	Alanın yeni adını belirtir.
/syncnamechanges	Microsoft Entra Id, Active Directory 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. Veri alanı için eşitlemeyi etkinleştirmek için belirtin true . Veri alanı için eşitlemeyi devre dışı bırakmak için belirtin false .
/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ımlanan 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ı Microsoft Entra Id ve Active Directory ile eşitleme

Kimlik sağlayıcınızda kullanıcı adları değiştiğinde otomatik olarak güncelleştirilecek özel kişi adı alanlarını yapılandırın.

Eşitlemenin ne zaman etkinleştirileceği

Yalnızca özel alanlar: Kişi adlarını atamak için kullanılan tüm özel iş öğesi alanları için eşitlemeyi el ile etkinleştirmeniz gerekir.

Sistem alanları: Tüm yerleşik kişi adı alanlarında otomatik olarak eşitleme etkindir:

• System.AssignedTo
• System.ChangedBy
• System.CreatedBy

Kimlik sağlayıcısı desteği

Çevre	Kimlik Sağlayıcısı
Azure DevOps Hizmetleri	Microsoft Entra Kimliği
Azure DevOps Server	Active Directory veya çalışma grubu

Eşitleme nasıl çalışır?

Devlet	Davranış
Etkinleştirmeden önce	Alan statik metin dizelerini gösterir
Etkinleştirdikten sonra	Alan, kimlik sağlayıcısından geçerli kullanıcı adını görüntüler
Adlar değiştiğinde	Otomatik olarak güncelleştirilen syncnamechanges=true alanlar

Grup adı kısıtlamaları

Dize alanında özniteliği etkinleştirdiğinizde syncnamechanges , geçerli kullanıcı adlarını kabul eder ancak bu koşullardan herhangi biri geçerliyse grup adlarına izin vermez :

• VALIDUSER tüm iş öğesi türlerinde belirtilen kural
• VALIDUSER belirli bir iş öğesi türü için belirtilen kural
• ALLOWEDVALUES grupları dışlayan filtre ölçütleriyle belirtilen kural

Yapılandırma kapsamı

Önemli

Özel alanları içeren her proje koleksiyonundaki her alan için eşitlemeyi etkinleştirmeniz gerekir.

Daha fazla bilgi için bakınız:

• Atamalar ve iş akışı alanları
• Tüm FIELD öğ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:

• İş öğesi formunda görüntülenen ad . Bkz. WebLayout ve Control öğeleri veya Control XML öğesi başvurusu.
• Yardım metni. Bkz. Kurallar ve kural değerlendirmesi.
• Seçim listesi veya açılan menü içindeki izin verilen değerler veya öğeler. Bkz . ALLOWEDVALUES, SUGGESTEDVALUES ve PROHIBITEDVALUES XML öğeleri.

Ö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, proje koleksiyonundaki tüm projelerde değiştirilen alana başvuran tüm iş öğesi türlerine uygulanır. 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 isteminde girin y 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çin .

   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'nde, 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 yazın Rank. 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. Hataya neden olur <\<Rank>>.

4. Alan hücresinden Rank değerini silin ve hücreye girinImportant Rank.

5. <> hücresini seçin ve 1 hücresine girin.

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

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 için kolay adın olduğuna dikkat edin. Sıralama, sorgu oluşturucusu ve sonuç listesi boyunca Derece'denÖnemli Derece olarak yeniden adlandırılır.

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ğini fark edin. İş öğesi formlarında alan etiketlerinin kapsamı üst proje olarak belirlenmiş ve belirtilen sunucu genelindeki alan adından bağımsızdı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 toplamaya göre 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

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, Azure DevOps Sunucusu'nda alanının {0} özelliklerini değiştirir. Devam etmek istiyor musunuz?

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

   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ı silmeden ö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 FIELD öğelerini silerek Control 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.

İlgili makaleler

• İş izleme deneyiminizi özelleştirme
• İş öğesi alan dizini
• witAdmin: İşleri izlemek için nesneleri özelleştirme ve yönetme