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

Makale
02/26/2013

İş öğesi alanlarını, iş öğesi türü için verileri izlemek amacıyla ve sorgular için filtre kriterleri tanımlamak ve raporlarda kullanmak için kullanın.Sistem alanları dışında raporda görünmesini istediğiniz herhangi bir alan, alanın izleyeceği iş öğelerinin türlerine ilişkin tanım dosyasında tanımlanmalıdır.Sistem alanları, her çalışma öğesi türü için otomatik olarak tanımlanmıştır.Ancak, veri girişini desteklemek için iş öğe formunda yer almalıdırlar.

Raporlamayı desteklemek için alan ekleyebilir veya varolan alanların özniteliklerini değiştirebilirsiniz.Alanları eklediğinizde veya değiştirdiğinizde verinin SQL Server Çözümleme Hizmetleri küpünde mantıksal olarak klasörlere gruplandığından emin olmak için sistematik adlandırma kurallarını uygulamanız gerekir.

Bu konuda

En İyi Yöntemler
Varolan Bir Alanı Kullanın
Bir Takım Projesi Koleksiyonu için Tanımlanmış Alanları Listele
Raporlanabilir Alan Öznitelikleri
Bir Alan İçin Raporlanabilir Özniteliği Değiştirin
Destek Raporlamaya Alanlar Ekleyin
Raporlanabilir Alan Özniteliklerine Yapılan Değişiklikleri Doğrulayın
Raporlama Başvuru İsimlerini Atarken En İyi Uygulamalar

Varsayılan işlem şablonları içinde tanımlanan raporlanabilir alanlar listesi için bkz: Visual Studio alm reportable alanlar başvuru.

En İyi Yöntemler

Bir alan eklemeden veya değiştirmeden önce aşağıdaki en iyi yöntemleri gözden geçirin:

Ekip projenizi içeren bir ekip projesi koleksiyonu içinde zaten tanımlanmış olan bir alanı kullanıp kullanamayacağınızı belirleyin.Varolan bir alanın kullanımı projeler arası raporlamayı destekler.
Dağıtımını başka bir proje koleksiyonunda tanımlı bir alanı kullanıp kullanamayacağınızı belirleyin Visual Studio Team Foundation Server. Varolan bir alanın kullanımı projeler arası raporlamayı destekler.
Her proje koleksiyonunda 1,024 üzerinde alanınız olamaz, Team Foundation Server dağıtımı boyunca tüm proje koleksiyonlarında ise 1,024 üzerinde benzersiz rapor edilebilir alanınız olamaz.Birleştirilmiş alanlar, rapor edilebilir bir alan olarak kabul edilir.
İşlem şablonlarına, takım projelerine veya proje koleksiyonlarına alan eklemek ve alanları değiştirmek için bir standart yordam ve gözden geçirme işlemi oluşturun.
Raporlama için alanları etiketlerken sistematik adlandırma kuralları kullanın.Team Foundation Server öğesinin bir dağıtımında, tüm takım proje koleksiyonları boyunca sistematik bir şekilde başvuru adları atadığınızda, daha tutarlı ve kullanışlı ambar ve küp şemasını garanti edersiniz, ve ambardaki şema çatışmalarını önlersiniz.Daha fazla bilgi için bkz. Veri Ambarında Oluşan Şema Çakışmalarını Çözümleme.

Bir çalışma öğesi alanına dört adede kadar etiket özniteliği atayabilirsiniz:

[!NOT]

Microsoft Solutions Framework işlem şablonları içinde tanımlanan alanlara bir raporlama adı veya raporlama başvuru adı atanmaz.Varsayılan olarak, başvuru adı ve ad öznitelikleri kullanılır.
- name.Çalışma öğesi sorgularının açılan menüsünde görünen alanın kolay adı.Kolay ad, bir takım projesinde tanımlanan tüm alanlar boyunca benzersiz olmalıdır.Ayrıca, yakın ad, iş öğesi formundaki alana atanan görüntülenmiş etiketten farklı olabilir.Daha fazla bilgi için bkz. Denetim XML Öğesi Başvurusu.
- refname.Takım proje koleksiyonlarında tanımlanan tüm diğer alanlardan bu alanı ayıran alana atanan benzersiz etiketi.refname öğesine atanan değer değiştirilemez.
  
  Alanlar için kolay adlarda ve başvuru adlarında gereksinimler ve sınırlamalar için bkz. İş Öğesi İzleme Nesneleri için Adlandırma Kuralları.
- reportingname.İsteğe bağlı öznitelik.Raporlardaki bir alanı tanımlamak için kullanılan ad.Açık bir biçimde ayarlanmadıkça name özniteliğine atanmış değer kullanılır.
- reportingrefname.İsteğe bağlı öznitelik.Tüm takım proje koleksiyonlarında tanımlanan tüm diğer raporlanabilir alanlardan bir raporlanabilir alanı ayıran alana atanan benzersiz etiketi.Açık bir biçimde ayarlanmadıkça refname özniteliğine atanmış değer kullanılır.Önerilen adlandırma kuralları için, bu konuda yer alan Başvuru Adları Bildirimleri Atamak İçin En İyi Uygulamalar bölümüne bakın.
  
  [!NOT]
  
  Raporlama başvuru adları, yalnızca PivotTable raporundan veya Çözümleme Hizmetleri küpünden görülebilir.

Varolan Bir Alanı Kullanın

Bu alanda izlemek ve raporlamak istediğiniz bilgiler eşleşiyorsa zaten tanımlı bir alan kullanmanız gerekir.Varolan bir alanı kullanmak için aşağıdaki adımları gerçekleştirin:

Kullanmak istediğiniz alanı tanımlayın.Tüm proje koleksiyonları için tanımlanmış alanları ve özniteliklerini tanımlamak için witadmin listfields komutunu kullanın.Daha fazla bilgi için, bu konuda Bir Takım Projesi Koleksiyonu için Tanımlanmış Alanları Listele bölümüne bakın.
Alanın rapor edilebilir olup olmadığını ve rapor edilebilir özniteliklerin raporlama gereksinimlerinizi karşılayıp karşılamadığını belirleyin.
Raporlanamıyorsa, kullanıldığı proje koleksiyonu için raporlanabilir özniteliğini değiştirmek için witadmin changefield kullanın.Daha fazla bilgi için, bu konudaki Bir Alan İçin Raporlanabilir Özniteliği Değiştirin bölümüne bakın.
Alanın tanımlanmadığı proje koleksiyonu için, verileri izlemek üzere kullanmak istediğiniz iş öğesi türleri için XML tanım dosyalarını ekleyin.Daha fazla bilgi için bu konudaki Raporlama Desteği için Alan Ekleyin kısmına bakınız.

Bir Takım Projesi Koleksiyonu için Tanımlanmış Alanları Listele

witadmin listfields komutunu alanları ve özniteliklerini listelemek için kullanabilirsiniz.Bir proje koleksiyonunda tanımlı belirtilen bir alanı veya tüm alanları listeleyebilirsiniz.witadmin listfields komutu aşağıdaki sözdizimini içerir:

witadmin listfields /collection:CollectionURL /n:RefName

Daha fazla bilgi için bkz. İş Öğesi Alanlarını Yönetme [witadmin].

Raporlanabilir Alan Öznitelikleri

Raporlanabilir alanlarDetail, Dimension veya Measure olan bir reportable öznitelik değerine sahiptir.Aşağıdaki öznitelikler çalışma öğesi alanlarının nasıl dışarı aktarıldığını ve veri ambarı veritabanlarına nasıl işlendiklerini belirler:

reportingtype.Raporlara bir alan dahil etmek için reportable özniteliğine aşağıdaki değerlerden birini atamanız gerekir:
- Alanı küpe değil de ilişkisel ambar veritabanına dışarı aktarmak için Detail atayın.Aşağıdaki örnekte gösterildiği gibi, Detail tipini yalnızca Tamsayı, Çift, Dize veya Tarih/Saat alanları için kullanın.
```
<FIELD refname="MyCorp.Summary" name="Summary" type="String" reportable="detail">
```
- Alanı hem ilişkisel ambar veritabanına hem de küpe dışarı aktarmak için Dimension atayın.Aşağıdaki örnekte gösterildiği gibi, Dimension öğesini yalnızca Tamsayı, Çift, Dize veya Tarih/Saat alanları için kullanın.Bu değer, raporları filtrelemek için kullanılan alanları (örneğin geçerli değer listelerine sahip alanlar) dahil etmek için kullanışlıdır.
```
<FIELD refname="MyCorp.Category" name="Category" type="String" reportable="dimension">
```
- Küpte önceden hesaplanmış değerlerin işlenmesini desteklemek için Measure atayın.Measure türünü, yalnızca Integer (tamsayı) ve Double alanları için kullanın.
  
  Ölç'ü reportingtype olarak atadığınızda sum öğesini aşağıdaki örnekte de gösterildiği gibi formula olarak atamanız gerekir.
```
<FIELD refname="MyCorp.Cost" name="Cost" type="Integer" reportable="measure" formula="sum">
```
reportingrefname.Raporlanabilir olarak işaretlenmiş bir alana farklı bir başvuru adı atayabilirsiniz.Hiçbir değer belirtilmemişse, refname özniteliğine atanmış değer kullanılır.

Bu özniteliği raporlardaki alanları birleştirmek ya da ayırmak için kullanabilirsiniz.Farklı başvuru adları taşıyan ve farklı proje koleksiyonlarında tanımlanmış iki alanı birleştirmek için, her ikisine de aynı reportingrefname öğesini atayın.Aynı adı taşıyan fakat farklı proje koleksiyonlarında tanımlanmış iki alanı ayırmak için, her bir alana farklı bir reportingrefname atayın.

Depodaki alan sayısını mümkün olduğunca aza indirmek ve raporlanabilir en fazla alan sayısı sınırını 1024'ün altında tutmak için alanları birleştirmeniz gerekir.Birleştirilmiş raporlarla çapraz grup raporları oluşturabilirsiniz.

reportingname.Raporlardaki verileri görüntülemek için kullanılan bir alana farklı bir etiket atayabilirsiniz.Hiçbir değer belirtilmemişse, name özniteliğine atanmış kolay ad kullanılır.reportingname öğesine atanan değer küpün içinde görünür.reportingrefname öğesine atanan değer görünmez.

Önemli
Raporlama alanlarını etiketlemek için en iyi yöntemleri kullanmanız gerekir böylelikle alanlar PivotTable raporlarında birlikte gruplandırılabilirler.Daha fazla bilgi için bkz. Raporlama Başvuru Adlarını Atamadaki En İyi Deneyim.

Bir İş Öğesi Alanı İçin Raporlanabilir Özniteliği Değiştirin

Bir proje koleksiyonu için tanımlı alanın öznitelik atamalarını değiştirerek varolan bir alanı rapor edilebilir duruma getirebilirsiniz.Varolan bir alan, bir veya daha fazla iş öğesi türü tanımlarında tanımlanır.Ayrıca, bir alanın veri ambarlarında nasıl işleneceğini belirleyen tüm öznitelikleri değiştirebilirsiniz.

Aşağıdaki adımları dizisini bir alanın öznitelik atamasını değiştirmek için kullanabilirsiniz:

witadmin changefield komutunu bir alana yapılan öznitelik atamasını değiştirmek için kullanabilirsiniz.Bu komutla bir ekip proje koleksiyonu için alıştırma yapın.Aşağıdaki sözdizimini kullanın:
```
witadmin changefield /collection:CollectionURL /n:RefName [/name:NewName] [/syncnamechanges:true | false] [/reportingname:ReportingName] [/reportingrefname:ReportingRefName] [/reportingtype:Type] [/reportingformula:Formula] [/noprompt]
```
Varolan bir alanı raporlanabilir yapmak için raporlama türünü değiştirin.Örneğin, AW.Common.TeamPriority alanını rapor filtreleme için kullanılabilir hale getirmek için, ona Boyut değerini atayın:
```
witadmin changefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AW.Common.TeamPriority /reportingtype:dimension 
```
Daha fazla bilgi için bkz. İş Öğesi Alanlarını Yönetme [witadmin].
(İsteğe bağlı) Birden fazla proje koleksiyonunuz varsa, bu koleksiyonda tanımlanan iş öğesi alanında benzer değişiklikler yapmak isteyebilirsiniz.Ambar veri tabanlarına veri dışarı aktarırken ve işlerken şablon çakışmalarını önlemek için şu özniteliklere tüm koleksiyonlar boyunca aynı değerleri atamanız gerekir:
- Alan türü (Bu alan için değer varolan bir alana değiştirilemez).
- Raporlama türüdür.
- Raporlama adıdır.
Daha fazla bilgi için bkz. Veri Ambarında Oluşan Şema Çakışmalarını Çözümleme.
Raporlama için kullanmak istediğiniz iş öğesi alanlarında tüm değişiklikleri yaptıktan sonra, veri ambarı veritabanlarını işlemelisiniz.WarehouseControlWebService aracılığıyla kullanılabilen ProcessWarehouse ve ProcessAnalysis Web Hizmetlerini kullanabilirsiniz.

Bu adım, alan niteliklerini değiştirdiğiniz zaman raporları kullanan kişilerin bir hata görmemelerini sağlar.

Daha fazla bilgi için bkz. İş Öğesi Alanlarını Yönetme [witadmin].

Destek Raporlamaya Alanlar Ekleyin

Bir çalışma öğesi türünün veya çalışma öğesi türlerinin tanımına alan ekleyebilirsiniz.Alanı eklediğinizde, alanın raporlamayı desteklediği tüm çalışma öğesi türleri için aynı alan öğesi tanımını eklemeniz gerekir.Alanın projeler arası raporlama desteklemesini isterseniz, haklarında raporlama yapılacak bütün takım projelerindeki iş öğesi türlerine alanın eklenmesi gerekir.

Daha fazla bilgi için bkz. Çalışma Öğesi Alanları ile Çalışma.

Raporlanabilir Alan Özniteliklerine Yapılan Değişiklikleri Doğrulayın

Raporlanabilir alan özniteliklerinde yaptığınız değişiklikleri istendiğinde veri ambarlarını işleyerek ve raporların güncelleştirildiğini denetleyerek doğrulayabilirsiniz.Veya depo bağdaştırıcı işleri çalışana kadar bekleyebilirsiniz.Varsayılan olarak, ilişkisel veritabanı birkaç dakikada bir işlenir.Ancak, küp varsayılan olarak her iki saatte bir işlenir.

[!NOT]

Hakkında daha fazla bilgi için WarehouseControlWebService, bkz: veri ambarı ve Team Foundation Server için Analysis Services küpünü el ile işleme.

ProcessWarehouse WarehouseControlWebService kullanarak isteğe bağlı ilişkisel veri ambarını işleyin.
ProcessAnalysisDatabase WarehouseControlWebService kullanarak isteğe bağlı küpü işleyin.
Raporların güncelleştirilmekte olduğunu doğrulayın.Bir pano veya Rapor Yöneticisi aracılığıyla bir raporu görüntüleyin.Daha fazla bilgi için bkz: Kontrol panelleri (hızlı) veya Raporlar (hızlı).

Raporlama Başvuru İsimlerini Atarken En İyi Uygulamalar

Başvuru adlarını bildirmek için Özet Tablo raporu ve küp içindeki alanları kolayca bulabilmenizi sağlayan etiketler atamak istersiniz.Bunu alanların mantıksal bir sırada gruplanmasını sağlamak üzere sistematik adlandırma kuralları uygulayarak gerçekleştirebilirsiniz.Ayrıca, alanlar yararlı bir şekilde gruplandırılmışsa, alanın raporlama başvuru adını değiştirebilirsiniz.

Tüm proje koleksiyonlarında tanımlanmış tüm ekip projelerinden gelen tüm raporlanabilir veriler tek bir ilişkisel veri ambarına yazıldığından sistematik bir adlandırma kuralı uygulamak giderek önemli bir hale gelir.Ardından söz konusu ambardaki veriler işlenir ve küpe yazılır.İş öğesi alanları her bir proje koleksiyonu için ayrı ayrı yönetildiği için, farklı etiketler uygulanabilir ve bu da raporlar yazmayı destekleyecek şekilde iyi düzenlenmemiş bir alanlar kümesine neden olabilir.

raporlanabilir türde boyuta sahip çalışma öğesi alanları küpteki boyut özniteliklerine karşılık gelmez.Boyut öznitelikleri işlem şablonu veya iş öğesi türü tanımı üzerinde atanmış olan raporlama başvuru adına göre klasörler içinde düzenlenmiştir.Aşağıdaki eşleme türleri oluşur:

"Sistem" önekleri olan alanlar dahili veya alanlar etkileşimlidir ve doğrudan İş Öğesi boyutunun altında, "İş Öğesi" eklenmiş olarak, listelenir.
Diğer alanlar, adları başvuru adlarının öneklerine karşılık gelen klasörlere yerleştirilir.Örneğin, "Microsoft.VSTS.Common" önekine sahip alanlar, "Microsoft VSTS Common" etiketini taşıyan klasörün altında listelenmektedir.

Aşağıdaki resimde gösterildiği gibi, ortak bir öneki paylaşan her bir önek alanları grubu için bir klasör eklenir:

OLAP veri küpü klasör yapısında

Aşağıdaki tablo başvuru adları "Sistem" ile başlayan ve "İş öğesi." öneki ile Özet Tablo raporunda listelenen alanları listeler. Bu alanlar doğrudan İş Öğesi boyutu altına toplanır.Diğer tüm alanlar, adları başvuru adlarının öneklerine karşılık gelen klasörlere yerleştirilir.

[!NOT]

Çözümleme Hizmetleri'nin Enterprise sürümünü kullanmayan dağıtımların SQL Server bu sürüm tarafından sağlanan çeviri özelliklerine erişimi yoktur.Bu dağıtımlarda, alanlar küpteki tam başvuru adları ile, '.' yerine '_' kullanılarak tanımlanır (örneğin, "System_Id" ve "System_Title").

PivotTable raporunda ve küpünde bulunan ad	Başvuru adı	Veri türü
Work Item.Area Path	System.AreaPath	TreeType
Work Item.Assigned To	System.AssignedTo	String
Work Item.Changed By	System.ChangedBy	String
Work Item.Changed Date	System.ChangedDate	DateTime
Work Item.Created By	System.Created By	String
Work Item.Created Date	System.CreatedDate	DateTime
Work Item.ID	System.Id	Integer
Work Item.Iteration Path	System.IterationPath	TreeType
Work Item.Previous State	System.PreviousState	String
Work Item.Reason	System.Reason	String
Work Item.Rev	System.Rev	Integer
Work Item.State	System.State	String
Work Item.Title	System.Title	String
Work Item.Work Item Type	System.WorkItemType	String

Aşağıdaki tablo Çalışma Öğesi boyutu altında "Microsoft.VSTS.Common" olarak etiketli klasördeki Özet Tablo raporunda görünen alanları listeler.Bu alanlar "Microsoft.VSTS.Common." ile başlayan başvuru adlarını içerir.

PivotTable raporunda ve küpünde bulunan ad	Başvuru adı	Veri türü
Work Item.Activated By	Microsoft.VSTS.Common.ActivatedBy	String
Work Item.Activated Date	Microsoft.VSTS.Common.ActivatedDate	DateTime
Work Item.Closed By	Microsoft.VSTS.Common.ClosedBy	String
Work Item.Closed Date	Microsoft.VSTS.Common.ClosedDate	DateTime
Work Item.Created By	Microsoft.VSTS.Common.CreatedBy	String
Work Item.Created Date	Microsoft.VSTS.Common.CreatedDate	DateTime
Work Item.Resolved By	Microsoft.VSTS.Common.ResolvedBy	String
Work Item.Resolved Date	Microsoft.VSTS.Common.ResolvedDate	DateTime
Work Item.Resolved Reason	Microsoft.VSTS.Common.ResolvedReason	String
Work Item.Priority	Microsoft.VSTS.Common.Priority	Integer
Work Item.Severity	Microsoft.VSTS.Genel.Zorluk	String
Work Item.Stack Rank	Microsoft.VSTS.Common.StackRank	Double

Ayrıca bkz.

Aracılığıyla paylaş