Destekleme Raporu'na Çalışma Alanları'nı Ekleme ve Değiştirme

İş öğ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

• MSF İşlem Şablonunda Tanımlanan Raporlanabilir Alanlar

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.

• Visual Studio Team Foundation Server dağıtımında başka bir proje koleksiyonunda zaten tanımlanmış olan bir alanı kullanıp kullanamayacağınızı belirleyin. 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. Çalışma Öğesi Alanları Listeleyin ve Alanlara Atanmış Öznitelikleri Görüntüleyin.

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ışa 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 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 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:

1. 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].

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

3. 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. Team Foundation Server için Veri Ambarını ve Analysis Services Küpünü El ile İşleme.

   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 ayrıntılı bilgi için aşağıdaki konulara bakın:

• Çalışma Öğesi Alanları ile Çalışma

• Çalışma Öğesi Türüne Alan Ekleyin veya Çalışma Öğesi Türünden Alan Çıkarın

• ALAN (Tanımlama) Öğesi

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.

1. ProcessWarehouse WarehouseControlWebService kullanarak isteğe bağlı ilişkisel veri ambarını işleyin.

2. ProcessAnalysisDatabase WarehouseControlWebService kullanarak isteğe bağlı küpü işleyin.

3. 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 (etkin) veya Raporlar (etkin).

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:

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.

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.

MSF İşlem Şablonunda Tanımlanan Raporlanabilir Alanlar

Aşağıdaki tablolar Microsoft Çözüm Çerçevesi (MSF) işlem şablonları ve alanların varsayılan atamalarında tanımlanan alanları listeler. Bu alanlar, yalnızca bir MSF işlem şablonunun 5.0 sürümü ile oluşturulan takım projelerine ilişkin görünür. Yalnızca rapor edilebilir olarak ayarlanan bu alanlar listelenir.

• Ayrıntı Alanları

• Veri Alanları

• Ölçüm Alanları

MSF işlem şablonları içinde tanımlanan alanların tam listesi için bkz. MSF İşlem Şablonları Tarafından Tanımlanan Alanları ve Sistem Alanlarını Kullanma. Bir takım projesini yükselttiyseniz, bu alanların bazıları ile çalışabilmeniz için önce ek görevleri yerine getirmeniz gerekebilir. Daha fazla bilgi için bkz. Yeni Özelliklere Erişim İçin Yükseltilmiş Bir Takım Projesini Güncelleştirmek.

Ayrıntı Alanları

Veri Alanları

Ölçüm Alanları

Ayrıca bkz.

Başvuru

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

Kavramlar

Çalışma Öğesi Alanları ile Çalışma

Visual Studio ALM İçin Raporlar Oluşturma ve Özelleştirme

Diğer Kaynaklar

Team Foundation Server için Veri Ambarını ve Analysis Services Küpünü El ile İşleme

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

İş Öğesi Alanlarını Tanımlama