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

Makale
06/10/2015

İş öğ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ırsınız.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 iş öğ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ırıldığı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ı Listeleyin
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ında tanımlanan raporlanabilir alanların listesi için, bkz. Visual Studio ALM için raporlanabilir alanlar başvurusu.

En İyi Yöntemler

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

Takım projenizi içeren bir takım 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.
Visual Studio Team Foundation Server öğesinin dağıtımında başka bir proje koleksiyonunda önceden tanımlı bir alanı kullanıp kullanamayacağınızı belirler.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 iş öğ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.İş öğ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 içinde 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 etiket.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 etiket.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 konudaki 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 Raporlamayı Desteklemek İçin Alan Ekleyin bölümüne bakın.

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

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 alanlar Detail, Dimension veya Measure olan bir reportable öznitelik değerine sahiptir.Aşağıdaki öznitelikler iş öğ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, 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ı, 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 ve Double alanları için kullanın.
  
  Ölçüyü 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 veya ayırmak için kullanabilirsiniz.Farklı başvuru adlarına sahip ve farklı proje koleksiyonlarında tanımlanmış iki alanı birleştirmek için, her iki alana da aynı reportingrefname öğesini atayın.Aynı başvuru adına sahip, farklı proje koleksiyonlarında tanımlı iki alanı ayırmak için her alana farklı bir reportingrefname atarsınız.

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 veriyi 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 Deneyimler.

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 takım proje koleksiyonu için alıştırma yaparsınız.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ü.
- Raporlama adı.
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 özniteliklerini 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 iş öğesi türünün veya türlerinin tanımına alan ekleyebilirsiniz.Alanı eklediğinizde, alanın raporlamayı desteklediği tüm iş öğesi türleri için aynı alan öğesi tanımını eklemeniz gerekir.Alanın projeler arası raporlama desteklemesini istiyorsanız, 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. İş öğesi alanlarını tanımlama ve değiştirme.

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]

WarehouseControlWebService hakkında daha fazla bilgi için bkz. Veri Deposunu ve Analiz Hizmetleri Küpünü Team Foundation Server için El İle İş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: Panolar veya Raporlar (SQL Server Raporlama Hizmetleri).

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.Ek olarak, alanlar kullanışlı 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 veri tek bir ilişkisel veri ambarına yazıldı için sistematik bir adlandırma kuralı uygulamak giderek önemli bir hale gelmektedir.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 iş öğ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 çizimde gösterildiği gibi, ortak bir öneki paylaşan her bir önek alanları grubu için bir klasör eklenir:

Veri OLAP küpünde klasör yapısı

Aşağıdaki tablo başvuru adları "Sistem" ile başlayan ve "İş öğesi." öneki ile PivotTable 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]

SQL Server Çözümleme Hizmetlerinin Enterprise sürümünü kullanmayan dağıtımların 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ü
İş Öğesi.Alan Yolu	System.AreaPath	TreeType
İş Öğesi.Atanan	System.AssignedTo	String
İş Öğesi.Değiştiren	System.ChangedBy	String
İş Öğesi.Değiştirilme Tarihi	System.ChangedDate	DateTime
İş Öğesi.Oluşturan	System.Created By	String
İş Öğesi.Oluşturulma Tarihi	System.CreatedDate	DateTime
İş Öğesi.Kimlik	System.Id	Integer
İş Öğesi.Yineleme Yolu	System.IterationPath	TreeType
İş Öğesi.Önceki Durum	System.PreviousState	String
İş Öğesi.Neden	System.Reason	String
İş Öğesi.Sür	System.Rev	Integer
İş Öğesi.Durum	System.State	String
İş Öğesi.Başlık	System.Title	String
İş Öğesi.İş Öğesi Türü	System.WorkItemType	String

Aşağıdaki tablo Çalışma Öğesi boyutu altında "Microsoft.VSTS.Common" olarak etiketli klasördeki PivotTable 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
İş Öğesi.Etkinleştirilme Tarihi	Microsoft.VSTS.Common.ActivatedDate	DateTime
İş Öğesi.Kapatan	Microsoft.VSTS.Common.ClosedBy	String
İş Öğesi.Kapanma Tarihi	Microsoft.VSTS.Common.ClosedDate	DateTime
İş Öğesi.Oluşturan	Microsoft.VSTS.Common.CreatedBy	String
İş Öğesi.Oluşturulma Tarihi	Microsoft.VSTS.Common.CreatedDate	DateTime
İş Öğesi.Çözen	Microsoft.VSTS.Common.ResolvedBy	String
İş Öğesi.Çözülme Tarihi	Microsoft.VSTS.Common.ResolvedDate	DateTime
İş Öğesi.Çözülme Nedeni	Microsoft.VSTS.Common.ResolvedReason	String
İş Öğesi.Öncelik	Microsoft.VSTS.Common.Priority	Integer
İş Öğesi.Önem	Microsoft.VSTS.Common.Severity	String
İş Öğesi.Yığın Derecesi	Microsoft.VSTS.Common.StackRank	Double

Ayrıca bkz.

Aracılığıyla paylaş