Raporlamayı desteklemek için iş öğesi alanları ekleme veya değiştirme

Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018-TFS 2013
Azure DevOps Server daha önce Visual Studio Team Foundation Server olarak adlandırılmıştı.

İş öğesi alanlarını, bir iş öğesi türü için verileri izlemek, sorgular için filtre ölçütlerini tanımlamak ve raporlarda kullanmak için kullanabilirsiniz. Bir raporda görünmesini istediğiniz sistem alanları dışındaki tüm alanlar, alanın izleyecektir iş öğelerinin türleri için 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ş öğesi formuna eklenmeleri gerekir.

Raporlamayı desteklemek için alanları ekleyebilir veya mevcut alanların özniteliklerini değiştirebilirsiniz. alanları eklediğinizde veya değiştirirken, verilerin SQL Server Analysis Services küpünde mantıksal olarak klasörlere gruplandığından emin olmak için sistematik adlandırma kurallarını uygulamanız gerekir.

Varsayılan işlem şablonlarında tanımlanan raporlanabilir alanların bir listesi için bkz. raporlanabilir alan başvurusu.

En iyi uygulamalar

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

• Projenizi içeren proje koleksiyonunda zaten tanımlanmış olan bir alanı kullanıp kullanmayacağınızı saptayın. Mevcut 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 kullanmayacağınızı öğrenin. Mevcut bir alanın kullanımı, projeler arası raporlamayı destekler.

• Her proje koleksiyonunda 1.024 ' den fazla alan ve Team Foundation Server dağıtımı boyunca tüm proje koleksiyonlarında en fazla 1.024 benzersiz raporlanabilir alan olabilir. Birleştirilmiş alanlar bir raporlanabilir alan olarak sayılır.

• İşlem şablonlarına, projelere veya proje koleksiyonlarına alanları eklemek ve değiştirmek için standart bir yordam ve gözden geçirme işlemi yapın.

• Raporlama için alanları etiketlendirçalışırken Systematik adlandırma kurallarını kullanın. başvuru adlarını bir Team Foundation Server dağıtımındaki tüm proje koleksiyonları genelinde sistematik bir şekilde atadığınızda, daha tutarlı ve kullanılabilir bir ambar ve küp şemasını garanti edersiniz ve ambardaki şema çakışmalarını önleyin. Daha fazla bilgi için bkz. veri ambarı şema çakışmalarını çözümleme.

  Bir iş öğesi alanına en fazla dört etiket özniteliği atayabilirsiniz:

  Not

  Microsoft Çözüm Çerçevesi için işlem şablonlarında 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ülerinde görüntülenen alanın kolay adı. Kolay ad, bir projede tanımlanmış tüm alanlar arasında benzersiz olmalıdır. Ayrıca, kolay ad, iş öğesi formundaki alana atanan görüntülenen etiketten farklı olabilir. Daha fazla bilgi için bkz. Denetim.

  • refname. Proje koleksiyonunda tanımlanan tüm diğer alanlardan ayırt edilen alana atanan benzersiz etiket. Öğesine atanan değer refname değiştirilemez.

    Alanlar için kolay adlar ve başvuru adlarıyla ilgili gereksinimler ve kısıtlamalar için bkz. iş öğesi izleme nesneleri Için adlandırma kuralları.

  • reportingname. İsteğe bağlı öznitelik. Raporlardaki bir alanı tanımlamak için kullanılan ad. Açıkça ayarlanmamışsa özniteliğe atanan değer name kullanılır.

  • reportingrefname. İsteğe bağlı öznitelik. Tüm proje koleksiyonlarında tanımlanan diğer raporlanabilir alanların tümünü ayırt eden raporlanabilir bir alana atanan benzersiz etiket. Açıkça ayarlanmamışsa özniteliğe atanan değer refname kullanılır. Önerilen adlandırma kuralları için, bu konunun ilerleyen kısımlarında raporlama başvuru adlarını atarken En Iyi uygulamalar bölümüne bakın.

    Not

    Raporlama başvuru adları yalnızca bir PivotTable raporundan veya Analysis Services küpünde görülebilir.

Mevcut bir alanı kullan

Bu alan, izlemek ve raporlamak istediğiniz bilgilerle eşleşiyorsa, zaten tanımlanmış olan bir alanı kullanmanız gerekir. Var olan bir alanı kullanmak için aşağıdaki adımları gerçekleştirin:

• Kullanmak istediğiniz alanı belirler. Tüm proje koleksiyonları için tanımlanan alanları ve özniteliklerini tanımlamak için witadmin listfields komutunu kullanın. Daha fazla bilgi için, bu konunun ilerleyen kısımlarında bir proje koleksiyonu için tanımlanan liste alanlarını inceleyin.

• Alanın raporlanabilir olup olmadığını ve raporlanabilir özniteliklerin raporlama gereksinimlerinizi karşılayıp karşılamadığını belirleme.

• Raporlanabilir değilse, ' nin kullanıldığı proje koleksiyonları için raporlanabilir özniteliğini değiştirmek için witadmin changefield ' ı kullanın. Daha fazla bilgi için, bu konunun ilerleyen kısımlarında bulunan bir alan için raporlanabilir bir özniteliği değiştirme konusuna 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ına ekleyin. Daha fazla bilgi için, bu konunun ilerleyen kısımlarında, destek raporlamaya alan ekleme bölümüne bakın.

Proje koleksiyonu için tanımlanan alanları listeleyin

Witadmin listfields komutunu alanları ve bunların özniteliklerini listelemek için kullanabilirsiniz. Belirtilen bir alanı veya bir proje koleksiyonunda tanımlanan tüm alanları listeleyebilirsiniz. Witadmin listfields komutu aşağıdaki sözdizimine sahiptir:

witadmin listfields /collection:CollectionURL /n:RefName  

Daha fazla bilgi için bkz. iş öğesi alanlarını yönetme.

Raporlanabilir alan öznitelikleri

Raporlanabilir alanların,, reportable veya öznitelik değeri Detail vardır DimensionMeasure . Aşağıdaki öznitelikler iş öğesi alanlarının veri ambarı veritabanlarına nasıl verildiğini ve işleneceğini belirlemektir:

• reportingtype. Raporlara bir alan eklemek için aşağıdaki değerlerden birini özniteliğe atamanız gerekir reportable :

  • DetailAlanı küpe değil, ilişkisel ambar veritabanına dışarı aktarmak için atayın. Aşağıdaki örnekte gösterildiği gibi, Detail türü yalnızca Integer, Double, String veya DateTime alanları için kullanın:

    <FIELD refname="MyCorp.Summary" name="Summary" type="String" reportable="detail">  
    

  • DimensionAlanı hem ilişkisel ambar veritabanına hem de küpe dışarı aktarmak için atayın. Aşağıdaki örnekte gösterildiği gibi, Dimension yalnızca Integer, String veya DateTime alanları için kullanın. Bu değer, raporları filtrelemek için kullanılan alanları eklemek için yararlıdır (örneğin, geçerli değerler listesi olan alanlar).

    <FIELD refname="MyCorp.Category" name="Category" type="String" reportable="dimension">  
    

  • MeasureKüpe önceden hesaplanmış değerlerin işlenmesini desteklemek için atayın. MeasureTürü yalnızca Integer ve Double alanları için kullanın.

    Ölçüsünü olarak atadığınızda, reportingtypesum Aşağıdaki örnekte gösterildiği gibi, olarak atamanız gerekir formula :

    <FIELD refname="MyCorp.Cost" name="Cost" type="Integer" reportable="measure" formula="sum">  
    

• reportingrefname. Raporlanabilir olarak işaretlenen bir alana farklı bir başvuru adı atayabilirsiniz. Hiçbir değer belirtilmemişse, özniteliğine atanmış değer refname kullanılır.

  Bu özniteliği, raporlara dahil edilen alanları birleştirmek ya da ayırmak için kullanabilirsiniz. Ayrı başvuru adlarına sahip ve farklı proje koleksiyonlarında tanımlanmış iki alanı birleştirmek için, reportingrefname her ikisine de aynı atayın. Aynı başvuru adına sahip ancak farklı proje koleksiyonlarında tanımlı iki alanı ayırmak için, her bir alana farklı bir atayabilirsiniz reportingrefname .

  Ambardaki alanların sayısını en aza indirmek ve 1024 raporlanabilir alan sayısı üst sınırı altında tutmak için, alanları birleştirme olanağınız vardır. Birleştirilmiş alanlarla çapraz grup raporları oluşturabilirsiniz.

• reportingname. Raporlardaki verileri göstermek için kullanılan alana farklı bir etiket atayabilirsiniz. Hiçbir değer belirtilmemişse, öznitelik için atanan kolay ad name kullanılır. Öğesine atanan değer reportingname küpte görünür. Öğesine atanan değer reportingrefname görünmüyor.

  Önemli

  Raporlama alanlarını etiketlemek için en iyi uygulamaları kullanarak, PivotTable raporlarında bir araya getirilir. Daha fazla bilgi için bkz. raporlama başvuru adlarını atarken En Iyi uygulamalar.

Bir iş öğesi alanı için raporlanabilir bir özniteliği değiştirme

Bir proje koleksiyonu için tanımlanan alanın öznitelik atamalarını değiştirerek varolan bir alanı raporlanabilir hale getirebilirsiniz. Varolan bir alan, bir veya daha fazla iş öğesi türü tanımında tanımlanır. Ayrıca, veri ambarlarında bir alanın nasıl işlendiğini tespit eden tüm öznitelikleri değiştirebilirsiniz.

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

1. Bir alana öznitelik atamasını değiştirmek için witadmin changefield komutunu kullanabilirsiniz. Bu komutu bir proje koleksiyonu için alıştırı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 reportingtype değerini değiştirin. Örneğin, AW oluşturmak için. Ortak. Teampriınıd alanı raporların filtrelenmesi için kullanılabilir, boyut değerini bu değere atayın:

   witadmin changefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AW.Common.TeamPriority /reportingtype:dimension   
   

   Daha fazla bilgi için bkz. iş öğesi alanlarını yönetme.

2. Seçim Birden fazla proje koleksiyonunuz varsa, bu koleksiyonda tanımlanan iş öğesi alanında benzer değişiklikler yapmak isteyebilirsiniz. Verileri veri ambarı veritabanlarına dışarı ve işleme yaptığınızda şema çakışmalarını önlemek için, tüm koleksiyonlar genelinde bu özniteliklere aynı değerleri atamanız gerekir:

   • Alan türü (bu alanın değeri var olan bir alan için değiştirilemez).

   • Raporlama türü.

   • Raporlama adı.

     Daha fazla bilgi için bkz. veri ambarı ş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şlemelidir. WarehouseControlWebServicearacılığıyla kullanılabilen ProcessWarehouse ve ProcessAnalysis Web hizmetlerini kullanabilirsiniz.

   Bu adım, alan özniteliklerini değiştirirken raporları kullanan kişilerin bir hata görmediğinden emin olur.

   Daha fazla bilgi için bkz. iş öğesi alanlarını yönetme.

Destek raporlamaya alanlar ekleyin

Bir iş öğesi türü veya türleri tanımına alan ekleyebilirsiniz. Alanı eklediğinizde, alanın raporlamayı destekleyeceği tüm iş öğesi türlerine aynı alan öğesi tanımını eklemeniz gerekir. Alanı projeler arası raporlamayı desteklemek istiyorsanız, alanı üzerinde bildirilecek tüm projelerdeki tüm iş öğesi türlerine eklenmelidir.

Daha fazla bilgi için bkz. iş öğesi alanları ve öznitelikleri hakkında.

Raporlanabilir alan özniteliklerinde yapılan değişiklikleri doğrulayın

Veri ambarlarını talep üzerine işleyerek ve sonra raporların güncelleştirildiğini doğrulamak üzere raporları denetleyerek, raporlanabilir alan özniteliklerine yaptığınız değişiklikleri doğrulayabilirsiniz. Ya da, ambar bağdaştırıcısı işlerinin çalışmasına 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 WarehouseControlWebServicekullanarak isteğe bağlı olarak ilişkisel veri ambarını işleyin.

2. ProcessAnalysisDatabase öğesini WarehouseControlWebServicekullanarak küpü isteğe bağlı olarak işleyin.

3. Raporların güncelleştirildiğinden emin olun. Pano veya Rapor Yöneticisi bir rapor görüntüleyin.

Raporlama başvuru adlarını atarken en iyi uygulamalar

Başvuru adlarını raporlamak için, PivotTable raporundaki ve küpteki alanları kolayca bulabilmeniz için Etiketler atamak istersiniz. Alanların mantıksal bir dizide gruplanabilmesi için sistematik adlandırma kuralları uygulayarak bunu elde edebilirsiniz. Ayrıca, alanlar kullanışlı bir şekilde gruplandırılmamışsa, bir alanın raporlama başvuru adını değiştirebilirsiniz.

Tüm proje koleksiyonlarında tanımlanan tüm projelerden raporlanabilir tüm veriler tek bir ilişkisel veri ambarına yazıldığı için sistematik bir adlandırma kuralının uygulanması giderek önemli hale gelir. Daha sonra söz konusu Ambardaki veriler işlenir ve küpe yazılır. İş öğesi alanları her bir proje koleksiyonu için ayrı olarak yönetildiğinden, farklı Etiketler uygulanabilir ve rapor yazmayı desteklemek için iyi düzenlenmediği bir alan kümesine yol açabilir.

Raporlanabilir bir boyut türüne sahip iş öğesi alanları küpteki boyut özniteliklerine karşılık gelir. Boyut öznitelikleri, işlem şablonunda veya iş öğesi türü tanımında atanan raporlama başvuru adına dayalı klasörler halinde düzenlenir. Aşağıdaki tür eşleme gerçekleşir:

• "Sistem" öneki olan alanlar dahili ve doğrudan Iş öğesi boyutu altında, "Iş öğesi" eklenmiş olarak listelenir.

• Diğer alanlar, adları başvuru adlarında öneklere karşılık gelen klasörlere yerleştirilir. Örneğin, "Microsoft. VSTS. Common" önekine sahip alanlar, "Microsoft VSTS Common" etiketli klasörün altında listelenir.

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

  

  Aşağıdaki tabloda, başvuru adları "sistem" ile başlayan ve "çalışma öğesi" önekiyle birlikte PivotTable raporunda listelenen alanlar listelenmektedir. Bu alanlar doğrudan Iş Öğesi boyutunun altına konur. Diğer tüm alanlar, adları başvuru adlarında öneklere karşılık gelen klasörlere yerleştirilir.

Aşağıdaki tabloda, Iş öğesi boyutu altında "Microsoft. VSTS. Common" olarak etiketlenmiş klasördeki PivotTable raporunda görünen alanlar listelenmektedir. Bu alanlar, "Microsoft. VSTS. Common" ile başlayan başvuru adlarına sahiptir.

İlgili makaleler:

• İş öğesi alanlarını yönetme
• Veri ambarı şema çakışmalarını çözme
• Bir alanı değiştirme veya özel alan ekleme
• İş öğesi alanlarının dizini
• Projeye rapor ekleme
• Panolar ve raporlar