İş izleme için alan ekleme veya değiştirme

2025-05-12

Azure DevOps Server 2022 - Azure DevOps Server 2019

Projeniz Çevik, Temel, Scrum veya CMMI gibi oluşturmak için kullanılan işleme bağlı olarak 100 veya daha fazla veri alanı içerir. Her iş öğesi bir iş öğesi türüne (WIT) bağlıdır ve izleyebileceğiniz veriler bu WIT'ye atanan alanlara karşılık gelir. bir iş öğesi içindeki veri alanını değiştirerek iş öğesi verilerini güncelleştirebilirsiniz.

Not

Devralınan işlem modelini kullanıyorsanız bkz. İş öğesi türüne özel alan ekleme.

Var olan alanları değiştirebilir veya daha fazla veri izlemek için özel alanlar ekleyebilirsiniz. Örneğin, açılan menüden bir seçim listesini özelleştirebilir, varsayılan bir değer ayarlayabilir veya bir alanın kabul edebileceği değerleri kısıtlayabilirsiniz.

Seçme listeleri, aşağıdaki tabloda gösterildiği gibi kullanıcı arabirimi, WIT iş akışları veya bir projeye kullanıcı hesapları ekleyerek gibi farklı şekillerde tanımlanır.

WIT tanımı	Komut satırı değişikliği (Şirket içi XML işlemi)
- Seçim listesini özelleştirme - Alana kural ekleme - Özel alan ekleme - Formdaki alan etiketini değiştirme - Özel denetim ekleme	- Liste alanları - Alan özniteliğini değiştirme - Bir alanı sil - Bir alan dizinle

Önkoşullar

Kategori	Gereksinimler
Liste alanları	Koleksiyondaki proje için Proje düzeyinde bilgileri görüntüleme izninizin İzin Ver olarak ayarlanmasını sağlayın.
Alan ekleme veya özelleştirme	Proje Yöneticileri grubunun üyesi olun veya Proje düzeyi bilgilerini düzenleizninizin İzin Ver olarak ayarlanmasını sağlayın.
Alanı silme, yeniden adlandırma veya değiştirme	Team Foundation Yöneticileri güvenlik grubunun veya Proje Koleksiyonu Yöneticileri güvenlik grubunun üyesi olun.

Yönetici olarak eklemek için proje koleksiyonu düzeyi izinlerini değiştirin.

İş öğesi alanlarının eklendiği yöntemler

İş öğesi alanları bir iş öğesi türü için verileri izler, sorgu filtresi ölçütlerini tanımlar ve raporlar oluşturur. Sistem alanları dışında izlemek istediğiniz tüm veri öğelerinin iş öğesi alanı olarak tanımlanması gerekir. Bir iş öğesi türü (WIT) veya genel iş akışı tanımı içinde alanlar tanımlayabilirsiniz.

İş öğesi alanları proje koleksiyonu düzeyinde korunur ve aşağıdaki senaryolara eklenir:

Proje oluşturma: WIT'ler veya genel iş akışları için seçilen işlem şablonunda tanımlanan alanlar oluşturulur. Çekirdek sistem alanları her iş öğesi türü için otomatik olarak eklenir. Çekirdek sistem alanlarının listesi için bkz . İş öğesi alan dizini. Şablonlar hakkında daha fazla bilgi için bkz . İşlem şablonları.
WIT tanımını içeri aktarma: WIT tanımında tanımlanan yeni alanlar koleksiyona eklenir. Daha fazla bilgiyi Tüm WITD XML öğeleri hakkında başvuru kısmında edinin.
Genel iş akışı tanımını içeri aktarma: Genel iş akışında tanımlanan yeni alanlar koleksiyona eklenir. Genel iş akışları, birden çok iş öğesi türünde paylaşılan alanlara izin verir. Ayrıntılar için bkz. Genel iş akışını özelleştirme .

Koleksiyondaki alanların tamamı, WIT'lerde tanımlanan tüm alanları ve tüm projelerdeki genel iş akışlarını içerir. Öznitelikleri değiştirebilir, alanları yeniden adlandırabilir veya silebilirsiniz, ancak bu değişiklikler şirket içi sunucuları ve raporlamayı etkileyebilir.

Alan eklemek veya özelleştirmek için WIT tanımının XML içeriğini düzenleyin. ALANLAR bölümünde bir FIELD öğesi kullanarak her alanı tanımlayın. Daha fazla bilgi için Tüm ALAN XML öğeleri referansı kısmına bakın.

Alan ekleme, kural uygulama veya özniteliği değiştirme

Özel alan eklemek, alan kuralları eklemek veya iş öğesi formundaki bir alanın etiketini değiştirmek için WIT'yi veya alanı kullanan türleri değiştirin. İşlem modelinizle eşleşen özelleştirme sırasını izleyin.

Alan özniteliğini değiştirmek veya alanı yeniden adlandırmak için witadmin komut satırı aracını kullanın. Aksi takdirde, bir alanı değiştirmek için bir WIT tanımı içinde alanla ilişkili kuralları ekler veya değiştirirsiniz.

Alan özniteliklerinin ve alan kurallarının özetini gösteren ekran görüntüsü.

WIT tanım dosyasını düzenleme

Kural eklemek veya özel alan eklemek için WIT tanım dosyasını dışarı aktarın, düzenleyin ve içeri aktarın.

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

Verileri izlemek için, alanı WIT tanım dosyasına eklersiniz; sistem alanları dışında, bunlar System .. ile başlayan bir başvuru adına sahip alanlardır. Sistem alanları, WIT tanımına dahil olmasalar bile tüm WIT'ler için otomatik olarak tanımlanır. Ayrıntılar için bkz . İş öğesi alan dizini.

Onay kutusu veya Boole alanı ekleme

WIT tanımının ALANLAR bölümüne Boole alanı eklemek için aşağıdaki söz dizimini kullanın.

<FIELD name="Triage" refname="Fabrikam.Triage" type="Boolean" >
   <DEFAULT from="value" value="False" />
   <HELPTEXT>Triage work item</HELPTEXT>
</FIELD>

Ardından, alanın formda görünmesi için FORM bölümüne aşağıdaki söz dizimini ekleyin.

<Control Label="Triage" Type="FieldControl" FieldName="Fabrikam.Triage" />

Alan, formda onay kutusu olarak görünür.

Seçim listesini özelleştirme

Seçim listeleri, iş öğesi formlarındaki açılan menülerde ve sorgu düzenleyicisinin Değer sütununda görüntülenen numaralandırılmış değerlerdir. Çoğu dize veya tamsayı alanında seçim listesini özelleştirmek için WIT tanımını düzenleyin. Örneğin, seçim listesi içeren özel bir Çözümleme alanı eklemek için aşağıdaki XML'yi kullanın.

Özel alan ve seçme listesi
Özel seçim listesini gösteren ekran görüntüsü.

<FIELD name="Resolution" refname="MyCompany.Resolution" type="String">    
<ALLOWEDVALUES>
   <LISTITEM value="By Design" />
   <LISTITEM value="Duplicate" />
   <LISTITEM value="External" />
   <LISTITEM value="Fixed" />
   <LISTITEM value="Not Repro" />
   <LISTITEM value="Postponed" />
   <LISTITEM value="Won't Fix" />
</ALLOWEDVALUES>
</FIELD>

Kurallar listeleri birleştirmenize, listeye kimlerin erişebileceğini kısıtlamanıza ve iş öğesi formunda bir listenin ne zaman görüneceğine ilişkin koşullar belirlemenize olanak tanır. Bir dağıtım listesinin tek tek üyeleri gösterip göstermediğini veya belirli öğeleri filtreleyip filtrelemediğini denetlemek için expanditems ve filteritems özniteliklerini kullanabilirsiniz.

Bakımı basitleştirmek için WIT'ler veya projeler arasında paylaşılan listeler için genel listeleri kullanın. Genel listeler, paylaşılan listeleri güncelleştirmek için gereken çabayı azaltır. Bir listenin bölümlerinin WIT'ler veya projeler arasında farklı olması gerekiyorsa, seçim listesinin belirli bölümleri için genel bir liste tanımlayabilirsiniz. Daha fazla bilgi için bkz. Seçim listelerini tanımlama ve Genel listeleri tanımlama.

Alan(ına) kural ekle

Özel alan eklemek veya alana kurallar uygulamak için WIT tanımını düzenleyin. Kuralın kimlere uygulandığını veya dışlandığını tanımlamak için for veya not özniteliklerini kullanarak kuralları belirli kullanıcılara veya gruplara kısıtlayabilirsiniz.

Örneğin, aşağıdaki kod parçacığı yalnızca özel tanımlı bir grup olan Yönetim Ekibi üyelerinin bir iş öğesi oluşturulduktan sonra Stack Rank alanını değiştirebileceği bir kural uygular:

<FIELD name="Stack Rank" refname="Microsoft.VSTS.Common.StackRank" type="Double" reportable="dimension">  
   <FROZEN not="[project]\Management Team" />  
   <HELPTEXT>Work first on items with lower-valued stack rank. Set in triage.</HELPTEXT>
</FIELD>

Aşağıdaki eylemleri gerçekleştirmek için alanlara kurallar uygulayabilirsiniz:

Eylem	XML Öğesi
Bir alana bilgi balonu ekleyin.	HELPTEXT
Bir alanın sahip olabileceği değerleri tanımlayın veya kısıtlayın.	DEĞERKAYBEDİLEMEZ, BOŞ, DONMUŞ, AYNI DEĞİL, SALT OKUNUR, GEREKLİ
Bir değeri kopyalayın veya alan için varsayılan bir değer ayarlayın.	KOPYALA, VARSAYıLAN, SERVERDEFAULT
Bir alanı kimlerin değiştirebileceğini kısıtlayın.	VALIDUSER, için, değil
Dize alanları için desen eşleştirmesini zorunlu kıl.	MAÇ
Kuralları diğer alan değerlerine göre koşullu olarak uygulayın.	NE ZAMAN, NE ZAMAN DEĞİL, DEĞİŞİNCE, DEĞİŞMEYİNCE

"Sistem" ön eki ile tanımlanan sistem alanları( örneğin, System.ID) sınırlı kural özelleştirmesine izin verir. Örneğin, bir iş öğesini veya sistem tarafından yönetilen tarih-saat alanlarını oluşturan, değiştiren veya kapatan alanları kopyalayamaz veya temizleyemezsiniz.

Alan kuralları ve kısıtlamaları hakkında ayrıntılı bilgi için bkz. Kurallar ve kural değerlendirmesi.

Özel alan ekleme

Özel alan eklemek için WIT tanımını düzenleyerek ALANLAR bölümüne bir FIELD öğesi ve FORM bölümünde bir Control öğesi ekleyin.

WIT tanım dosyasını , kullandığınız işlem modeline göre dışarı aktarın.
XML dosyasının ile FIELDSbaşlayan bölümünü bulun.
FIELD Eklenecek özel alanın adını belirten öğesini ekleyin. Aşağıdaki gerekli öznitelikleri belirtmelisiniz: dostça name, refname (başvuru adı) ve type. Daha fazla bilgi için FIELD (Tanım) öğesi başvurusu bölümüne bakın.

Aşağıdaki kod, başvuru adı FabrikamFiber.MyTeam.Requestor olan ve izin verilen değerlerin seçim listesini içeren Requestor özel alanını, varsayılan değer olarak Müşteri ile belirtir.
```
<FIELD name="Requestor" refname="FabrikamFiber.MyTeam.Requestor" type="String" reportable="Dimension">
   <ALLOWEDVALUES>
      <LISTITEM value="Customer" />
      <LISTITEM value="Executive Management" />
      <LISTITEM value="Other" />
      <LISTITEM value="Support" />
      <LISTITEM value="Team" />
      <LISTITEM value="Technicians" />
      <DEFAULTVALUE value="Customer" />
    </ALLOWEDVALUES>
</FIELD>
```
İpucu

Listedeki öğeler, XML tanım dosyasına nasıl girdiğinizden bağımsız olarak her zaman alfasayısal sırada görünür. Başvuru Adı veya refname, alanın program adıdır. Diğer tüm kurallar refname öğesine başvurmalıdır. Daha fazla bilgi için bkz . Adlandırma kısıtlamaları ve kuralları.
Control öğesini, görünmesini istediğiniz öğe grubu içinde formda görünebilmesi için FORM bölümünün içine ekleyin.

Örneğin, aşağıdaki kod parçacığı, İstek Sahibi alanını iş öğesi formundaki Neden alanının altında görünecek şekilde ekler.
```
<Column PercentWidth="50">
   <Group Label="Status">
      <Column PercentWidth="100">
         <Control FieldName="System.AssignedTo" Type="FieldControl" Label="Assi&amp;gned To:" LabelPosition="Left" />
         <Control FieldName="System.State" Type="FieldControl" Label="&amp;State:" LabelPosition="Left" />
         <Control FieldName="System.Reason" Type="FieldControl" Label="Reason:" LabelPosition="Left" ReadOnly="True" />
         <Control FieldName="FabrikamFiber.MyTeam.Requestor" Type="FieldControl" Label="Requestor:" LabelPosition="Left" ReadOnly="True" />
      </Column>
   </Group>
</Column>
```
İpucu

İş izleme için şema tanımında, FORM öğesinin tüm alt öğeleri camel case kullanırken, diğer tüm öğelerin tamamen büyük harf ile yazılması gerekir. Doğrulama hatalarını önlemek için etiketleri açma ve kapatma olay yapısının XML söz dizimi kurallarıyla eşleştiğinden emin olun. Daha fazla bilgi için bkz. Control XML öğesi başvurusu.
WIT tanım dosyasını kullandığınız işlem modeline göre içeri aktarın.
Değişiklikleri görüntülemek için web portalını veya Takım Gezgini'ni açın. İstemci zaten açıksa sayfayı yenileyin.

Aşağıdaki çizimde, ürün kapsamı öğesinin iş öğesi formunun artık yeni alanı içerdiği gösterilmektedir.

İş öğesi formunda alan etiketini değiştirme

Alan etiketini değiştirmek için, öğe Control özniteliğine Label atanan değeri değiştirin. bir alanı iş öğesi formundan kaldırmak için, alanla ilişkilendirilmiş öğeyi silin Control .

WIT tanım dosyasını işlem modelinize göre dışarı aktarın.

FORM ve Layout bölümlerinde, değiştirmek istediğiniz alanın tanımını bulun. Bu örnek, Başlık alanının etiketini değiştirir:

<Column PercentWidth="70">  
   <Control Type="FieldControl" FieldName="System.Title" Label="Title" LabelPosition="Left" />  
</Column>

Bu projede çalışan Portekizce şube ofisinin iş öğesi formuyla çalışırken Başlık alanının adını okuyabilmesi için alanın etiketini değiştirin. Başlık alanına başlık için Portekizce sözcüğünü (Titulo) ekleyin.
```
<Column PercentWidth="70">  
   <Control Type="FieldControl" FieldName="System.Title" Label="Title (Titulo):" LabelPosition="Left" />  
</Column>
```
Değiştirilen WIT tanımını içeri aktarın.

Özel denetim ekleme

İş öğelerini izlemek için REST API'lerini kullanarak hataları, görevleri ve diğer iş öğesi türlerini (WIT' ler) program aracılığıyla oluşturabilir, güncelleştirebilir ve bulabilirsiniz. Ayrıca, bir iş öğesi formunun işlevselliğini geliştirmek için özel denetimler oluşturabilirsiniz.

Alternatif olarak, Visual Studio Market üzerinden sağlanan özel denetimleri kullanabilirsiniz, örneğin:

Çoklu değer denetimi: Onay kutularının listesini kullanarak bir alan için birden çok değerin girişini sağlar.
Renk seçim listesi denetimi: Seçim listesi öğelerine renk eklemeyi etkinleştirir.
İş öğesi tek seçimli eylemler oluşturur: Tek seçimli eylemler için özelleştirilebilir bir kural kümesi sağlar.

Yeni web formuna özel denetim eklemek için bkz . WebLayout ve Denetim öğeleri.

Varolan bir alanın özniteliğini değiştirme

Mevcut bir alanın özniteliklerini değiştirmek için witadmin changefield kullanırsınız. Örneğin, aşağıdaki komut MyCompany.Type için tanımlanan görünür adı Değerlendirme Yöntemi olarak değiştirir.

witadmin changefield /collection:http://AdventureWorksServer:8080/ DefaultCollection/n:MyCompany.Type /name:"Evaluation Method"

Aşağıdaki tabloda witadmin changefield kullanarak değiştirebileceğiniz öznitelikler özetlemektedir.

Öznitelik	Açıklama
Veri türü	Alanın kabul eden veri türünü belirtir. Genel olarak, alan veri türünü tanımlandıktan sonra değiştiremezsiniz. Alan veri türünü yalnızca HTML veya PlainText türünde alanlar için değiştirebilirsiniz.
Kullanıcı dostu ad	Kolay ad, iş öğesi sorgularının açılan menülerinde görünür ve proje koleksiyonu içinde tanımlanan tüm alanlarda benzersiz olmalıdır. Uygun ad, iş öğesi formunda görünen form etiketinden farklılık gösterebilir.
Raporlama öznitelikleri	Bir raporda görünen alanın adını, rapor başvuru adını ve raporlama türünü değiştirebilirsiniz. Raporlama kolay adını yerelleştirebilirsiniz. Raporlama türü, alanın verilerinin ilişkisel ambar veritabanına, hem ilişkisel ambar veritabanına hem de OLAP küpüne yazılıp yazılmayacağını veya OLAP küpünü işlerken değerlerin önceden hesaplanmış bir toplamını oluşturup oluşturmayacağını belirler. Varsayılan raporlanabilir alanların tam listesi için bkz . Raporlanabilir alanlar başvurusu . Raporlanabilir öznitelikler hakkında daha fazla bilgi için bkz . İş öğesi alanları ve öznitelikleri, Raporlanabilir öznitelikler.
Eşitleme	Active Directory ile kişi adı alanları için eşitlemeyi etkinleştirebilir veya devre dışı bırakabilirsiniz.

Alanın dizin özniteliğini değiştirme

Filtreleme sırasında sorgu yanıt sürelerini iyileştirmek için bir alan için dizin oluşturmayı etkinleştirin. Varsayılan olarak, şu alanlar dizine eklenir: Atanan, Oluşturulma Tarihi, Değiştiren, Durum, Neden, Alan Kimliği, Yineleme Kimliği ve İş Öğesi Türü.

Bir alan için dizin oluşturmayı etkinleştirmek veya devre dışı bırakmak için witadmin indexfield komutunu kullanın.

Bir alanı sil

Belirli bir WIT'den bir alanı kaldırdığınızda, alan artık herhangi bir WIT tarafından başvurulmasa bile koleksiyonda veya veritabanı sunucusunda kalır. Bir alanı tamamen kaldırmak için aşağıdaki adımları izleyin.

FIELD Tanımı tüm WIT tanımlarından ve buna başvuran tüm genel iş akışlarından kaldırın.

Alanın kullanımda olmadığını doğrulayın. Örneğin:

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

Field: MyCompany.CustomContact
Name: Custom Contact
Type: String
Reportable As: dimension
Use: Not In Use
Indexed: False

Alanı silin. Örneğin:

witadmin deletefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.CustomContact

Silinen alan raporlanabilirse ve projeniz SQL Server Reporting Services kullanıyorsa, eski alanı ve değerlerini temizlemek için veri ambarını yeniden oluşturun.

Daha fazla bilgi için bkz . İş öğesi alanlarını yönetme.

Test, derleme ve sürüm denetimi alanları

Bazı iş öğesi türleri Team Foundation Build, Microsoft Test Manager ve Team Foundation sürüm denetimiyle tümleşen otomatik işlemler tarafından oluşturulan alanları içerir. Bu alanları özel iş öğesi türlerinize (WIT' ler) eklemek için, daha önce açıklanan adımları izleyerek WIT tanımını düzenleyin .

Örneğin, hataları bulundukları veya düzeltildikleri derlemelerle ilişkilendiren Bulunduğu Yer ve Derlemeye Entegre Edildiği alanlarını ekleyebilirsiniz. Bu alanları bir WIT tanımına eklemek için aşağıdaki kod parçacığını kullanın:

<FIELD name="Found In" refname="Microsoft.VSTS.Build.FoundIn" type="String" reportable="dimension">
    <HELPTEXT>Product build number (revision) in which this item was found</HELPTEXT>
</FIELD>
<FIELD name="Integration Build" refname="Microsoft.VSTS.Build.IntegrationBuild" type="String" reportable="dimension">
    <HELPTEXT>Product build number this bug was fixed in</HELPTEXT>
</FIELD>

Daha fazla bilgi için Derleme ve test tümleştirme alanlarını temel alan sorgulama'ya bakın.

Alan adları ve raporlama

Raporlamayı desteklemek için alan ekleyebilir veya var olan alanların özniteliklerini değiştirebilirsiniz. Alanları eklediğinizde veya değiştirdiğinizde, alanlar mantıksal olarak klasörler halinde gruplandırıldığından, alanı Analysis Services küpü içinde bulabilmek için bunları sistematik olarak adlandırmanız gerekir. Daha fazla bilgi için bkz . Raporlamayı desteklemek için iş öğesi alanlarını ekleme veya değiştirme.