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

Makale
06/09/2015

Aşağıdaki kullanarak bir takım projesi koleksiyonu için tanımlanan iş öğesi türü alanlarını yönetebilirsiniz witadmin komutları:

changefield: Bir alanın bir veya daha fazla özniteliklerini değiştirir.Aşağıdaki öznitelikler birini değiştirdiğinizde, tüm iş öğesi türleri ve takım projesi koleksiyonundaki takım projeleri için değiştirin:

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

Önemli
Yükseltme yaptığınızda Team Foundation Server geçerli sürümü, türü atama için için daha önceki bir sürüm açıklama (System.Description) alan öğesinden dönüştürülüp otomatik olarak PlainText için HTML.İle changefield komutunu düz metin görüntülemek için bu alanı içeriğini geri yükleyebilir.

Kolay ad iş öğesi sorguda görüntüler.Bu ad farklı olabilir iş öğesi formunda görüntülenen öğesinden.
Raporlama özelliklerini bir rapor, başvuru rapor adı ve raporlama türü göründüğü alanın adını içerir.
Eşitleme Active Directory ile -, etkinleştir/kişi ad alanlarını eşitlenmesini devre dışı bırakabilir.

deletefield: Belirtilen alan siler.
indexfield: Açmak veya kapatmak için belirtilen alan dizin oluşturma kapatır.Bir alan için dizin oluşturma etkinleştirdiğinizde, sorgularının alanı belirten iş öğeleri bulma, performansını artırabilir.Çalışma öğesi sorgularını çoğunu kullandığınız özel bir alan eklerseniz, bu alan için dizin oluşturma etkinleştirmek istediğiniz.
listfields: Tüm alanları veya belirtilen alan için öznitelikleri listeler.

Çalıştırmak için witadmin komut satırı aracı, bir komut istemi açmak nerede ya da Visual Studio veya Ekip Gezgini yüklü olduğundan ve girin:

cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE

Windows 32-bit sürümü üzerinde değiştirmek %programfiles(x86)% ile %programfiles%.

İle sağlanan varsayılan işlem şablonları içinde tanımlanan alanları genel bir bakış için Team Foundation Server, bakın Visual Studio ALM için çalışma öğesi alanı başvurusu.

[!NOT]

Oluşturabilir ve bir güç aracı olan işlem düzenleyicisini kullanarak iş öğesi alanları değiştirin Visual Studio.Bu aracı desteklenmiyor.Daha fazla bilgi için Microsoft Web sitesinde şu sayfaya bakın: Team Foundation Server güç araçları.

Gereksinimler

Alanları listelemek için olması gerekir, proje düzeyi bilgileri görüntüleyin ayarlanan koleksiyonu içinde takım projesi için izni izin.
Silin veya alanları yeniden adlandırın veya bir alanın bir özniteliği değiştirmek için bir üyesi olmalıdır Team Foundation Yöneticileri güvenlik grubu veya proje koleksiyonu yöneticileri güvenlik grubu.

Daha fazla bilgi için bkz. Team Foundation Server izinleri ve TFS varsayılan grupları, izinleri ve rolleri [yeniden yönlendirme].

[!NOT]

Yönetimsel izinler ile oturum olsa bile, çalışan bir sunucuda bu işlemi gerçekleştirmek için yükseltilmiş bir komut istemi penceresi açın Windows Server 2008.Yükseltilmiş bir komut istemi penceresi açmak için Başlat, açık komut istemi kısayol menüsünü ve ardından seçin yönetici olarak çalıştır.Daha fazla bilgi için Microsoft Web sitesine bakın: kullanıcı erişimi denetimi.

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 indexfield /collection:CollectionURL /n:Name /index:on|off 

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

Parametreler

Parametre	Açıklama
/collection:CollectionURL	Takım projesi koleksiyonu URI'sini belirtir.URI biçimi aşağıdaki gibidir: http://ServerName: Port/VirtualDirectoryName/CollectionName Sanal dizin kullanılırsa, ardından URI biçimi verilmiştir: http://ServerName: Port / CollectionName
/n:RefName /n:Name	Bir iş öğesi türü alanının başvuru adı.
/index	Etkinleştirebilir veya devre dışı belirtilen alan için dizin oluşturma belirtir.Belirtin on dizin oluşturma etkinleştirmek için ve off dizin oluşturma devre dışı bırakmak için.
/name:NewName	Alan için yeni adını belirtir.
/syncnamechanges	Çalışma öğesi alanı adları depolamak ve Active Directory veya çalışma grubunda yapılan değişiklikler olarak güncelleştirmek için kullanılacak belirtir.Bu seçenek yalnızca dize veri türüne sahip bir alan için belirtildiğinde geçerlidir typename. Belirtin true veri alanı için eşitlemeyi etkinleştirmek için belirtin false veri alanı için eşitlemeyi devre dışı bırakmak için.
/reportingname:ReportingName	Veri ambarı raporlama için kullanılacak alanın adını belirtir.
/reportingrefname:ReportingRefName	Veri ambarı raporlama için kullanılacak alanı başvurusu adını belirtir.
/reportingtype:Type	Raporlama için alan ambarında nasıl kullanıldığını belirtir.Şu değerler geçerlidir: dimension:Tamsayı, dize veya tarih/saat alanları için kullanılır. detail:Tamsayı, Double, dize veya tarih/saat alanları için kullanılır. measure:Tamsayı ve çift alanları için kullanılır.Varsayılan toplama türü toplamıdır.Kullanarak başka bir toplama türü belirtebilirsiniz formula parametresi. none:Raporlanabilirliği devre dışı bırakmak için kullanılır. Daha fazla bilgi için bkz. İş öğesi alanlarını tanımlama ve değiştirme.
/reportingformula:Formula	Alan olarak belirtilen yapılırken kullanılacak toplama formülü belirtir bir measure.Yalnızca desteklenen formülü sum.
/type:HTML \| PlainText	Alanın içeriğini dönüştürmek için belirtir PlainText için HTML veya HTML için PlainText.Bu seçenek yalnızca Type türü ataması alanları için belirtebilirsiniz PlainText veya HTML.Bkz. FIELD (Tanım) öğesi başvurusu.
/unused	Takım projesi koleksiyonunda tanımlanan herhangi bir takım projesi tarafından kullanılmayan tüm alanları listeler.
/noprompt	Onay istemini devre dışı bırakır.
/?or help	Komut isteminin komut hakkında Yardım görüntüler.

Açıklamalar

Dizinli alanları

Bir sorgu dizini etkin dizinlemeye sahip olması bu alanlar üzerinde temel alınarak oluşturulur.Bu dizin olduğunda çalışan dahil sorgu alanları dizine yanıt süresini artırır.

Varsayılan olarak şu alanlar dizinlenir: Şuna Atanmış, Oluşturulma Tarihi, Değiştiren, Durum, Neden, Alan Kimliği, Yineleme Kimliği ve İş Öğesi Türü.Takımınızın kendi sorgularda sık kullandığı diğer alan yoksa, sorgu dizine ekleyebilirsiniz.

Kişi adları Active Directory ile eşitleniyor

El ile Active Directory başvuran kişi adları atamak için kullanılan herhangi bir özel iş öğesi alanları eşitlenmesini etkinleştirmeniz gerekir.Eşitleme her alanı özel alanları içeren her takım projesi koleksiyonu için etkinleştirmeniz gerekir.

Kişi Adları Göster tüm sistem başvuru alanları özniteliğine sahip syncnamechanges ayarlanan true. Bu tür alanlar System.AuthorizedAs, System.AssignedTo, System.ChangedBy ve System.CreatedBy'ı içerir. Varsayılan işlem şablonlardan birini tanımlanan her kişi ad alanı için eşitleme etkin.Daha fazla bilgi için bkz. Atamalar ve iş akışı alan başvurusu.

Eşitleme etkinleştirildikten sonra alan artık statik bir dize gösterir.Bunun yerine, alan bir kullanıcı hesabı ile ilişkilendirilmiş adını gösterir.Kullanıcı adı Active Directory'de veya çalışma grubu, bir alanla değiştirdiğinizde syncnamechanges ayarlanan true otomatik olarak yeni adını gösterir.

Atadığınızda syncnamechanges özniteliği alan her zaman bir dize alanına geçerli kullanıcı adlarını kabul eder.Ancak, alan içinde depolanan Grup adları izin vermiyor Team Foundation Server veya Active Directory'de aşağıdaki koşullardan biri ise true:

Tüm iş öğesi türleri üzerinden belirtilen VALIDUSER'a
VALIDUSER kuralı için bir iş öğesi türü belirtildi
İzin verilen değerler kuralı için bir iş öğesi türünün belirtilir ve bu kural, gruplar dışlayan bir filtre ölçütünü sahip

Daha fazla bilgi için bkz. Tüm FIELD XML öğeleri başvurusu.

Her iş öğesi türü için değiştirebilirsiniz öznitelikleri

Aşağıdaki öznitelikler veya alan varsayıldığı iş öğesi türü tanımı değiştirerek bir alan için tanımlanan değerlerini değiştirin:

Adı iş öğesi formunda görüntüler.Bkz. Denetim XML öğesi başvurusu.
Yardım metni.Bkz. İş öğesi formunda yardım metnini tanımlama [yeniden yönlendirme].
İzin verilen değerler veya bir seçim listesi veya aşağı açılır menü içindeki öğeler.Bkz. Seçim listesini (açılan menü) özelleştirme [yeniden yönlendirildi].

Örnekler

Aksi belirtilmedikçe, her örnekte aşağıdaki değerler geçerlidir:

Takım projesi koleksiyonu için URI: http://AdventureWorksServer/tfs/DefaultCollection
Çalışma öğesi alanı adı: AdventureWorks.Field
Varsayılan kodlama: UTF-8

Liste alanları

Kullanmak witadmin listfields kullanımda bir iş öğesi türü eklemek için seçin alanlar kümesi görmek için.Ayrıca, belirli bir alan için tanımlanan öznitelik atamalarını listeleyebilir ve hangi alanların hangi takım projeleri tarafından kullanılan belirleyin.

Bir iş öğesi alanının özniteliklerini görüntüleyin

Microsoft.VSTS.Common.Issue gibi bir belirtilen alan için tanımlanan özniteliklere 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 alan ve öznitelik bilgileri adlandırılmış alan için 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
```
Kullanım parametresi her proje ve alan kullanıldığı iş öğesi türünün adını gösterir.Alan öznitelikleri hakkında daha fazla bilgi için bkz: Visual Studio ALM için çalışma öğesi alanı başvurusu.

Bir takım projesi koleksiyonundaki tüm alanları listeleyin

Bir takım projesi 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 koleksiyonu için tüm alanları için alan bilgileri görüntülenir.Bkz. Visual Studio ALM için çalışma öğesi alanı başvurusu.

Kullanılmayan listesi alanları

Artık takım projesi koleksiyonunda tüm iş öğesi türü tarafından kullanılan alanları listelemek için aşağıdaki komutu girin.

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

Bu örnekte gösterildiği gibi alan ve öznitelik bilgileri kullanılmadığından, her alan için 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

Takımınızın kullandığı adlandırma kurallarını karşılamak için bir iş öğesi alanı kolay adını değiştirebilirsiniz.Yeni adı proje koleksiyonunda tüm takım projeleri değiştirilen alana başvuran tüm iş öğesi türlerine uygulandığını unutmayın.Çalışma öğesi sorgusunda filtre ölçütünü tanımladığınız kolay adı görüntülenir.Bir iş öğesi formunda görünen ad alanı için tanımlanan kolay adı farklı olabilir.

Çalışma öğesi alanı yeniden adlandırma

Atanan kolay adı yeniden adlandır için aşağıdaki komutu girin Microsoft.VSTS.Common.Rank önemli sıra için.

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

Onay istemi türe y ve ardından ENTER tuşuna basın.Aşağıdaki iletisi kadar bekleyin:

Field renamed.

Tek bir projeye alınan değişiklikleri doğrulamak için

In Ekip Gezgini, choose Refresh.

En son güncelleştirmeleri alan adına yaptığınız değişiklikleri içeren sunucudan yüklenir.Yenileme tamamlanması birkaç dakika bekleyin.
Seçin yeni sorgu bir sorgu oluşturmak için.
Sorgu Düzenleyicisi'nde seçin bir koşul eklemek için burayı tıklatın boş'u seçin, satır eklemek için bağlantı alan hücreli ve sıra hücrede yazın.Sonuç listesinin üstünde görünür aşağıdaki ileti.Bu ileti derecesini bulunamıyor gösterir.

Sorgu sonuçlarını görüntülemek için sorguyu çalıştırın. TF51005: Sorgu varolmayan bir alana başvuruyor.Hata << derecesini tarafından >> neden olur.
Derecelendirme değeri öğesinden silme alan hücreli ve hücreye önemli sıra yazın.
Seçin <> içinde işleci hücreli ve 1'e yazın değeri hücre.
On the Query toolbar, choose Run.
Herhangi bir satır için kısayol menüsünü açın sonuçları ve seçin sütun seçenekleri.Scroll down in the Availablecolumns list.Dikkat derecesini alan varsa artık ancak önemli sıra alan.
Seçin önemli sıra içinde kullanılabilir sütunlar kutusunu işaretleyin ve sonra seçin > düğmesi (Seçili sütunları Ekle).Tamam'ı seçin.

Microsoft.VSTS.Common.Rank için kolay ad derecesini için önemli sıra sorgu oluşturucu ve sonuçlar listesi adı değiştirilmiş olduğunu dikkat edin.
Sorgu kapatın.Seçin Hayır zaman istenir sorguyu kaydedin.
Yeni bir görev iş öğesi oluşturun.Seçin yeni iş öğeleri bağlantısını ve ardından seçin görev.

Bu iş öğesi, değiştirildi ve içeri aktardığınız çalışma öğesi türünden oluşturulur.
Buna, bildirim durum kutusunda, yeniden adlandırılan alan etiketi derecesini, değişmediğini.İş öğesi formları üzerindeki alan etiketleri üst takım projesi için kapsamlı ve yalnızca belirtilen sunucu çapında alan adını bağımsız olmasıdır.

[!NOT]

İş öğesi formlarının alan etiketleri değiştirme hakkında daha fazla bilgi için bkz: Bir alanın etiketini değiştirme [yeniden yönlendirildi].
Yeni görevi kapatın ve seçin Hayır iş öğesini kaydetmek için istendiğinde.

Rapor bir alan için değer olarak değiştirin

Aşağıdaki komut DateTime alanı AdventureWorks.CreatedOn'un türünü boyuta rapor etme olanağı belirtir.Bu alanın veri ambarı ve Analysis Services veritabanları girer raporları filtrelemek için kullanılabilir.

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

Aşağıdaki komut çift alan ölçmek için olan türü rapor etme özelliğini belirtir.Tüm ölçüleri toplam toplanır.

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

Özel bir kişi adı alanın eşitlemeyi etkinleştir

Eşitleme iş öğesi alan AW için aşağıdaki komut etkinleştirir.AdventureWorksServer üzerinde Collection1 için tanımlanan MüşteriAdı.

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

Aşağıdaki komutu girerek eşitlemek için istediğiniz MyCompany.CustomerName, örneğin alanın atanan veri türü doğrulayın:
```
witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.CustomerName
```

Eşitlemeyi Etkinleştir

Bir kişi adlı alan için eşitleme etkinleştirmek için verilerinizi burada gösterilen bağımsız değişkenlerin koyarak aşağıdaki komutu yazın:
```
witadmin changefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.CustomerName /syncnamechanges:true
```
Aşağıdaki onay istemi görüntülenir:

This will change properties for field {0} on the Team Foundation Server.Do you want to continue?
Türü 0 alanı değiştirmek istediğiniz onaylamak için veya 1 isteği iptal etmek için.

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

The field was updated.

Değiştirme isteği başarısız olursa, bir hata iletisi görüntülenir.Yapılabilecek en yaygın hatalar bir sistem başvuru alanını değiştirmeye veya dize dışında bir veri türünde bir alan değiştirmeye.Bu işlemleri desteklenmez.

Bir alan Sil

Bir alanı silmeden önce alanın kullanımda olmadığından emin olun.Alan kullanılıyorsa, takım projesi koleksiyonundan silmeden önce kullanan iş öğesi türlerinden önce alan kaldırmanız gerekir.Aşağıdaki komut Collection1 alan olan siler:

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

Bir alan kullanımda olmadığından doğrulayın

Referans adı MyCompany.MyProcess.MyField gibi iş öğesi alanı için belirterek aşağıdaki komutu girin.

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

Alan için görüntülenen bilgileri doğrulayın değeri Use olan "Not In Use" gibi bu örnekte.

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

Varsa Use alan gösterir alan kullanılmakta olan, sonra her iş öğesi türü listelenen her takım projesi için silmelisiniz.Örneğin, bu hata ve kod hatası iş öğesi türleri tarafından dört projeleri için kullanıldığını Microsoft.VSTS.tcm.SYSTEMINFO alanı 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 her iş öğesi türleri, tanımlandığı her takım projesi için listelenen kaldırmanız gerekir.Alanı kaldırmak için iş öğesi türü için tanım silerek değişiklik FIELD ve Control alan başvuru adını içeren öğeler.Bkz. İş öğesi türlerini içeri aktarma, dışarı aktarma ve yönetme [witadmin], FIELD (Tanım) öğesi başvurusu, ve Denetim XML öğesi başvurusu.

Bir alan bir takım projesi koleksiyonundan Sil

MyCompany.MyProcess.MyField alanı silmek için aşağıdaki komutu yazın ve Enter'ı seçin.
```
witadmin deletefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:RefName
```
Girin y bu adımı tamamlamak için onay isteminde.

Soru - Yanıt

S: hangi özelleştirmeler ı hale getirebilir ve bir TFS yükselttikten sonra takım Projem güncelleştirmek için Yapılandırma Sihirbazı'nı kullanmaya devam?

Y: özel alanlar eklemek, seçim listesi Özelleştir ve bir alan kuralları ekleyin.Özelliklerini Yapılandırma Sihirbazı'nı , takım projeleri güncelleştirir ve en son özelliklere erişim kazanabilirsiniz.

Alan özniteliklerini değiştirilmesi önerilmez.Hangi özelleştirmeler hakkında güvenli hale getirebilirsiniz ve kaçının bilgi edinmek için deneyimi izleme iş özelleştirmek: özelleştirme önce Bakım ve yükseltme etkilerini.

Ayrıca bkz.

Kavramlar

Veri ambarında oluşan şema çakışmalarını çözümleme

Raporlamayı desteklemek üzere iş öğesi alanları ekleme veya değiştirme

Visual Studio ALM için çalışma öğesi alanı başvurusu

Visual Studio ALM için raporlanabilir alanlar başvurusu

Diğer Kaynaklar

witAdmin: İşi izlemek için nesneleri özelleştirme ve yönetme

Aracılığıyla paylaş