İş Öğesi Alanlarını Yönetme [witadmin]

Makale
03/22/2013

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

changefield: Bir alanın bir veya daha fazla özniteliği değiştirir. Aşağıdaki özniteliklerden birini değiştirdiğinizde, tüm iş öğesi türleri ve takım projesi koleksiyonu içerisinden 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 tür atama için geçerli sürümüne önceki bir sürümünden Açıklama (System.Description) alan dan dönüştürülmüş otomatik olarak PlainText için HTML.İle changefield komutu, düz metin görüntülemek için bu alanın içeriğini geri yükleyebilir.
- Kolay ad çalışma öğesi sorgusunda görüntüler. Bu adı farklı olabilir çalışma öğesi formunda görüntülenen gelen.
- Raporlama özelliklerini bir rapor, raporu başvuru adı ve raporlama türünü göründüğü gibi alanın adını içerir.
- Eşitleme - Active Directory ile etkinleştirebilir/devre kişi adı alanları eşitleme dışı.
deletefield: Belirtilen alanı siler.
indexfield: Belirtilmiş bir alanın dizinlenmesini açar veya kapar. Alan için dizinlemeyi etkinleştirdiğinizde, sorgularının bu alanı belirttiği çalışma öğelerini bulma performansını artırabilirsiniz. Çalışma öğesi sorgularınızın çoğunda kullandığınız özel alanı eklerseniz, bu alan için dizinlemeyi etkinleştirmek isteyebilirsiniz.
listfields: Belirttiğiniz bir alanın veya bütün alanların özniteliklerini listeler.

Çalıştırmak için witadmin komut satırı aracı, bir komut istemi penceresi açın burada ya da Visual Studio veya Ekip Gezgini yüklenir ve girin:

cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE

Windows'un 64-bit edition üzerinde yerini %programfiles% ile %programfiles(x86)%.

İle sağlanan varsayılan işlem şablonları içinde tanımlanan alanların genel bakışı için Team Foundation Server, bkz: Visual Studio ALM için Çalışma Öğesi Alan Başvurusu.

Not

Visual Studio için bir güç aracı olan İşlem Düzenleyicisini kullanarak iş öğesi alanlarını oluşturabilir ve değiştirebilirsiniz.Bu araç desteklenmemektedir.Daha fazla bilgi için Microsoft Web sitesindeki şu sayfaya bakın: Team Foundation Server Güç Araçları.

Gereksinimler

Alanları listelemek için bilgisayarınızda yüklü olmalıdır, Proje-seviyesi bilgisi görüntüle takım projesi koleksiyonu için izin ayarlamak izin.
Silmek veya alanları yeniden adlandırın veya bir alanın özniteliğini değiştirmek için bir üyesi olmanız Team Foundation Yöneticileri güvenlik grubunun veya Proje koleksiyonu yöneticileri güvenlik grubu.

Daha fazla bilgi için, bkz. Takım Kuruluş Sunucusu İzinleri ve Team Foundation Server Varsayılan Grupları, İzinleri ve Rolleri.

Not

Yönetimsel izinler ile oturum açsanız bile, Windows Server 2008 çalıştıran bir sunucuda bu işlemi gerçekleştirmek için yükseltilmiş bir Komut İstemi penceresi açmalısınız.Yükseltilmiş bir komut istemi penceresi açmak için seçim Başlangıç, açık komut istemi kısayol menüsünü ve sonra seçin yönetici olarak çalıştır.Daha fazla bilgi için bkz. Microsoft Web sitesi: 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	Tanımlama
/collection:CollectionURL	Takım projesi koleksiyonunun URI'sini belirtir. URI biçimi aşağıdaki gibidir: http://ServerName:Port/VirtualDirectoryName/CollectionName Sanal dizin kullanılmamışsa URI biçimi aşağıdaki şekildedir: http://SunucuAdı:BağlantıNoktası/SanalDizinAdı/KoleksiyonAdı.
/n:RefName /n:Name	İş öğesi türü alanının başvuru adı.
/index	Belirtilen alan için dizine almanın etkinleştirileceğini veya devre dışı bırakılacağını belirtir. Dizine eklemeyi etkinleştirmek için on öğesini ve dizine eklemeyi devre dışı bırakmak için off öğesini belirtin.
/name:NewName	Alan için yeni adı belirtir.
/syncnamechanges	Active Directory'de veya bir çalışma grubunda değişiklik yapıldıkça adları depolamak ve güncelleme gerçekleştirmek üzere çalışma öğesi alanının kullanılacağını belirtir. Bu seçenek sadece typename için String veri tipine sahip bir alan belirlenmişse geçerlidir. Veri alanı için eşitlemeyi etkinleştirmek için true 'yu belirtin, veri alanı için eşitlemeyi devre dışı bırakmak için false'u belirtin.
/reportingname:ReportingName	Raporlamada kullanılan veri ambar alanının adını belirtir.
/reportingrefname:ReportingRefName	Raporlamada kullanılacak veri ambar alanının başvuru adını belirtir.
/reportingtype:Type	Alanın ambarda raporlama için nasıl kullanıldığını belirtir. Aşağıdaki değerler geçerlidir: dimension: Tam Sayı, Dize veya DateTime alanları için kullanılır. detail: Tam Sayı, Çift, Dize veya DateTime alanları için kullanılır. measure: Tamsayı ve Çift alanları için kullanılır. Varsayılan yığılma türü toplamdır. formula parametresini kullanarak başka bir toplama türü belirtebilirsiniz. disable:Alanda raporlanabilirliği devre dışı bırakmak için kullanılır. Daha fazla bilgi için bkz. Çalışma Öğesi Alanları ile Çalışma.
/reportingformula:Formula	Alan bir measure olarak bildirildiğinde kullanılacak toplama formülünü belirtir. Desteklenen tek formül sum öğesidir.
/type:HTML \| PlainText	Alan içeriğini dönüştürmek belirtir PlainText için HTML veya HTML için PlainText. Bu seçenek yalnızca, tür atama alanları için belirttiğiniz PlainText veya HTML. Bkz: ALAN (Tanımlama) Öğesi
/unused	Takım projesi koleksiyonunda tanımlanan herhangi bir takım projesi tarafından kullanılmayan bütün alanları listeler.
/noprompt	Onay istemini devre dışı bırakır.
/? or help	Komut İstemi penceresinde komut hakkındaki yardımı görüntüler.

Notlar

Dizinli alanlar

Sorgu dizini dizin oluşturma etkin olan bu alanları temel alınarak oluşturulur. Bu dizin ne zaman alanları içeren sorguları çalıştırmak için dizin yanıt süresini artırır.

Varsayılan olarak, aşağıdaki alanları dizinlenir: atandı, oluşturulma tarihi, değiştiren, durumu, nedeni, alan kimliği, Yineleme Kimliği ve iş öğesi türü. Bunların sorgularda sık Takımınızın kullandığı diğer alanlar varsa, sorgu dizine ekleyebilirsiniz.

Active Directory ile kişi adlarının eşzamanlaması

Active Directory'e başvuran kişi adları atamak için kullanılan özel iş öğesi alanlarının eşitlemesini el ile etkinleştirmeniz gerekir. Özel alanlar içeren her bir takım projesi koleksiyonu için alan eşitlemesini etkinleştirmelisiniz.

Kişi adlarını gösteren bütün sistem başvuru alanları özniteliğine sahip syncnamechanges ayarlamak true. Böyle alanlar System.AuthorizedAs, System.AssignedTo, System.ChangedBy ve System.CreatedBy'ı içerir. Varsayılan işlem şablonlarının birinde tanımlı her kişinin ad alanı eşitlemesi etkinleştirilmiş. Daha fazla bilgi için bkz. Atamalar ve İş Akışı Alan Başvurusu.

Eşitleme etkinleştirildikten sonra alan artık statik bir dize göstermez. Bunun yerine alan bir kullanıcı hesabıyla ilişkili adı gösterir. Active Directory'de veya Çalışma grubunda kullanıcı ismini değiştirirseniz, syncnamechanges'in true'ya ayarlandığı bir alan otomatik olarak yeni adı gösterir.

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

VALIDUSER kuralı tüm çalışma öğesi türleri arasında belirtilir
VALIDUSER kuralı bir çalışma öğesi türü için belirtilir
ALLOWEDVALUES kuralı bir iş öğesi türü için belirtilir ve bu kural grupları dışarıda bırakan bir filtre ölçütüne sahiptir.

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

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

Aşağıdaki öznitelikleri veya iş öğesi türü tanım alanı göründüğü değiştirerek bir alan için tanımlanan değerleri değiştirin:

Adı iş öğesi formunda görüntüler. Bkz: Denetim XML Öğesi Başvurusu
Yardım metni. Bkz: Çalışma Öğesi Alanı için Yardım Metni Tanımlama
İzin verilen değerler veya bir seçim listesi veya açılır menü öğeleri. Bkz: Kullanıcı Listeleri, Seçim Listeleri ve Genel Listeler Tanımlama

Örnekler

Aksi belirtilmediği takdirde, aşağıdaki değerler her bir örneğe uygulanır:

Takım projesi koleksiyonu için URI: http://AdventureWorksServer:8080/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çmek için alanları kümesini 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ıldığını belirleyebilirsiniz.

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

Microsoft.VSTS.Common.Issue gibi belirli bir alan için tanımlanan özniteliklerini listelemek için aşağıdaki komutu girin.
```
witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:Microsoft.VSTS.Common.Issue
```
Alan ve öznitelik bilgileri, bu örnekte gösterildiği gibi 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 parametresi alanın kullanıldığı her proje ve çalışma öğesi türü 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 koleksiyonuna ilişkin 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 alanlar listesi

Takım projesi koleksiyonundaki herhangi bir iş öğesi türü tarafından artık kullanılmayan alanları listelemek için aşağıdaki komutu girin.

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

Alan ve öznitelik bilgileri her alan için kullanılmadığından, bu örnekte gösterildiği gibi görünür.

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

Bir alanı yeniden adlandırma

Takımınızın kullandığı adlandırma kurallarını karşılamak için çalışma öğesi alanı kolay adını değiştirebilirsiniz. Yeni isim, proje koleksiyonundaki tüm takım projeleri içinde değiştirilen alana başvuran tüm çalışma öğesi türlerine uygulandığına dikkat edin. Yakın ad, çalışma öğesi sorgusunda filtre kriteri tanımladığınızda görüntülenir. Çalışma öğesi formunda görünen ad, alan için tanımlanan yakın addan farklı olabilir.

Çalışma öğesi türü alanını yeniden adlandırmak için

Atanan kolay adını yeniden adlandırmak 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"

Doğrulama istemine y yazın ve ENTER tuşuna basın. Aşağıdaki iletiyi alana kadar bekleyin:

Field renamed.

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

In Ekip Gezgini, choose Refresh.

Alan adına yaptığınız değişiklikleri içeren son güncellemeler sunucudan indirilir. Yenilemeyi tamamlamak birkaç saniye bekleyin.
Seçim Yeni bir sorgu bir sorgu oluşturmak için.
Sorgu Düzenleyicisi'nde seçin bir yan tümce eklemek için burayı tıklatın bir satır eklemek için boş'u seçin, bağlantı alan hücre ve hücre içine Sıra yazın. Aşağıdaki ileti sonuç listesinin üstünde görünür. Bu ileti Rank (Sıra)'nın bulunamadığını gösterir.

Sorgu sonuçlarını görüntülemek için sorguyu çalıştırın. TF51005: Sorgu, mevcut olmayan bir alana başvurur. Hata <<Rank>> (Sıra) yüzünden olur.
Alan hücresinden Sıra değerini silin ve hücreye Önemli Sıra yazın.
İşleç hücresinde <> işaretini seçin ve Değer hücresine 1 yazın.
Üzerinde sorgu araç, seçim çalıştırmak.
Herhangi bir satır için kısayol menüsünü seçin ve sonuçları açmak Sütun Seçenekleri. Kullanılabilir sütunlar listesini aşağı kaydırın. Rank (Sıra) alanının artık olmadığını fakat Important Rank (Önemli Sıra) alanının olduğunu farkedin.
Seçin Önemli derece , Kullanılabilir sütunlar kutusunu tıklatın ve sonra seçin > düğmesini (Seçili sütunları Ekle). Tamam'ı seçin.

Microsoft.VSTS.Common.Rank için yakın adın, sorgu oluşturucu ve sonuçlar listesi aracılığıyla, Rank (Sıra)'dan Important Rank (Önemli Sıra) olarak değiştirildiğini farkedin.
Sorguyu kapatın. Seçim No sizden istendiğinde sorguyu kaydetmek için.
Yeni bir çalışma öğesi oluşturun. Seçim Yeni iş öğeleri bağlayın ve sonra görev.

Bu çalışma öğesi, değiştirdiğiniz ve içeri aktardığınız çalışma öğesi türünden oluşturulur.
Durum kutusunda, yeniden adlandırılan alan Rank (Sıra) için etiketin değişmediğini farkedin. Bu, çalışma öğesi formu üzerindeki alan etiketleri üst takım projesi kapsamında olması nedeniyle ve henüz belirtilen sunucu çapında alan adından bağımsız olması nedeniyledir.

Not

Çalışma öğesi formu üzerinde alan etiketlerinin nasıl değiştirildiği hakkında daha fazla bilgi için, bkz. Bir Alanının Etiketini Değiştirme.
Yeni görevi kapatmak ve seçin No sizden istendiğinde iş öğesini kaydetmek için.

Raporu bir alan için değer olarak değiştir

Aşağıdaki komut DateTime alanı AdventureWorks.CreatedOn'un türünü boyuta rapor etme özelliğini belirtir. Bu alanın verileri ambara ve Çözümleme Hizmetleri veritabanlarına girer, dolayısıyla 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 AdventureWorks.CreatedOn'un türünü ölçüye rapor etme özelliğini belirtir. Tüm ölçümler toplama göre birleştirilir.

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

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

Aşağıdaki komut AdventureWorksServer'da Collection1 için tanımlanan çalışma öğesi alanı AW.CustomerName için eşitlemeyi sağlar.

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

Aşağıdaki komut girerek eşitlemek istediğiniz MyCompany.CustomerName gibi bir alana atanan veri türünü doğrulayın:
```
witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.CustomerName
```

Eşitlemeyi Etkinleştir

Kişi adlı bir alanı için eşitlemeyi etkinleştirmek için burada gösterilen bağımsız değişkenlerin yerine verinizi geçirerek 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ünür:

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

Değiştirme isteği başarıyla sonuçlanırsa aşağıdaki onay mesajı görünür:

The field was updated.

Değiştirme isteği gerçekleşmezse bir hata mesajı görünür. Yapılabilecek ortak hatalar bir sistem başvuru alanını değiştirmeye çalışmak veya veri tipi String olmayan bir alanı değiştirmeye çalışmaktır. Bu işlemler desteklenmemektedir.

Bir alanı silme

Bir alanı silmeden önce alanın kullanımda olmadığından emin olun. Alan kullanımda ise, takım projesi koleksiyonundan silmeden önce kullandığınız çalışma öğesi türleri arasında ilk alanı kaldırmalısınız. Aşağıdaki komut AdventureWorks.Field alanını Collection1'den siler:

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

Bir alanın kullanılmadığını doğrulayın

İçin MyCompany.MyProcess.MyField gibi çalışma öğesi alanının başvuru adını 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 bilgilerde, Use değerinin bu örnekteki gibi "Not In Use" olduğunu doğrulayın.

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

Use alanı, alanın kullanımda olduğunu gösteriyorsa, onu listelenen her takım projesi için her iş öğesi türünden silmelisiniz. Örneğin, Microsoft.VSTS.TCM.SystemInfo alanı dört proje için Hata ve Kod Hatası iş öğesi türleri tarafından kullanılmakta olduğunu gösterir: Arroyo, Desert, Palm ve Springs.
```
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, onu tanımlanan her takım projesi için listelenen her iş öğesi türünden kaldırmanız gerekir. Alanı kaldırmak için çalışma öğesi türü için tanım silerek değişiklik FIELD ve Control , alan başvuru adını içeren öğeler. See İş Öğesi Türlerini Özelleştirme ve Yönetme [witadmin], ALAN (Tanımlama) Öğesi, and Denetim XML Öğesi Başvurusu.

Bir takım projesi koleksiyonundan bir alanı silme

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

Ayrıca bkz.

Kavramlar

Veri Ambarında Oluşan Şema Çakışmalarını Çözümleme

Raporlamayı Desteklemek Üzere Çalışma Öğesi Alanları Ekleme ve Değiştirme

Visual Studio ALM için Çalışma Öğesi Alan Başvurusu

Visual Studio alm reportable alanlar başvuru

Diğer Kaynaklar

witAdmin: İş Öğelerini İzlemek için Nesneleri Özelleştirme ve Yönetme

Aracılığıyla paylaş