Analiz için veri modeli
Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019
Azure DevOps için analiz veri modeli, üyeleri (varlıklar) filtrelen, toplanmış ve özetlenebilirsiniz özellikleri içeren varlık kümelerinden oluşur. Buna ek olarak, varlıkları bir diğer ile ilişkili gezinti özellikleri içerirler ve bu özellikler seçme, filtreleme ve gruplama için diğer özelliklere erişim sağlar.
Not
Analytics hizmeti tüm hizmetler için otomatik olarak Azure DevOps Services. Üretimde kullanım için de desteklemektedir. Power BI analytics hizmetinin OData akışına tümleştirme ve erişim önizlemededir. Bunu kullanmanız ve bize geri bildirim sağlamanız için sizi teşvik ederiz. .
Not
Analytics hizmeti, Azure DevOps Server 2020 için tüm yeni proje koleksiyonlarında otomatik olarak yüklenir. Üretimde kullanım için de desteklemektedir. Power BI analytics hizmetinin OData akışına tümleştirme ve erişim önizlemededir. Bunu kullanmanız ve bize geri bildirim sağlamanız için sizi teşvik ederiz. Azure DevOps Server 2019'dan yükseltme yaptıysanız, yükseltme sırasında Analytics hizmetini yükleme seçeneği sağlanır.
Not
Analytics hizmeti, Azure DevOps Server 2019 için önizlemededir. Analytics'e bir proje koleksiyonu için etkinleştirerek veya yükleyerek erişin. Power BI analytics hizmetinin OData akışına tümleştirme ve erişim önizlemededir. Bunu kullanmanız ve bize geri bildirim sağlamanız için sizi teşvik ederiz.
EntityTypes ve EntitySets
Varlık türleri, anahtarla adlandırılmış yapılandırılmış türlerdir. Her varlığın adlandırılmış özelliklerini ve ilişkilerini tanımlar. EntityType anahtarı, ilkel özelliklerin bir alt kümesinden oluşturulur; örneğin:WorkItemId, PipelineId, ReleasePipelineId— ve varlık türünün daha fazlası.
Varlık kümeleri, varlıkların adlandırılmış koleksiyonlarıdır. Örneğin, WorkItems, WorkItem varlıklarını içeren bir varlık kümesidir. Bir varlığın anahtarı, varlık kümesi içindeki varlığı benzersiz olarak tanımlar. Birden çok varlık kümesi aynı varlık türünü kullanıyorsa, aynı anahtar değerleri bileşimi birden fazla varlık kümesinde görünebilir ve bu anahtar bileşiminin göründüğü varlık kümesi başına bir tane olmak üzere farklı varlıkları tanımlar. Bu varlıkların her biri farklı bir varlık kimliğine sahip. Varlık kümeleri, veri modeline giriş noktaları sağlar.
Not
Varlık kümeleri OData meta verilerinde açıklanmıştır ve projeye göre değişiklik gösterir. Projeniz için OData meta verilerini isteğip varlık kümelerinin, varlık türlerinin ve özelliklerin tam listesini keşfedebilirsiniz.
https://analytics.dev.azure.com/{OrganizationName}/{ProjectName}/_odata/{version}/$metadata
https://{servername}:{port}/tfs/{OrganizationName}/{ProjectName}/_odata/{version}/$metadata
Not
Değeri {version} olarak v1.0 biçimlendirildi. Desteklenen en son sürüm , v2.0 en son önizleme sürümü ise sürümüdür. v4.0-preview Daha fazla bilgi için bkz. OData API sürümü.
Aşağıdaki EntitySet'ler belirtilen API sürümleriyle birlikte de kullanılabilir. En son sürüm bilgileri için bkz. OData API sürümü.
İş izleme EntityTypes ve EntitySets
| EntityType/EntitySet | Description | v1.0 | v2.0 | v3.0-preview | v4.0-preview |
|---|---|---|---|---|---|
| Alan Alanlar |
Alan hiyerarşisine göre gruplamave filtreleme özelliklerine sahip alan yolları iş öğesi. | ✔️ | ✔️ | ✔️ | ✔️ |
| Yineleme Yinelemeler |
Yineleme hiyerarşisine göre gruplamave filtreleme özelliklerine sahip iş öğesi Yineleme Yolları. | ✔️ | ✔️ | ✔️ | ✔️ |
| BoardLocation BoardLocations |
Board sütunu, kulvar ve bölme ile tanımlanan Kanban panosu hücre konumları, tarihi panosu ayarlarını içerir. Kanban panosu alanlarının her biri için bkz. İş akışı ve Kanban panosu alanları. | ✔️ | ✔️ | ✔️ | ✔️ |
| CalendarDate Tarihler |
İlişkileri kullanarak diğer varlıkları filtrelemek ve grup etmek için kullanılan tarihler. | ✔️ | ✔️ | ✔️ | ✔️ |
| Project Projeler |
Bir kuruluş için tanımlanan tüm projeler. | ✔️ | ✔️ | ✔️ | ✔️ |
| Işlem İşlemler |
İş öğelerini ve iş öğesi türlerini genişletmek veya filtrelemek için kullanılan biriktirme listesi bilgileri. Bir raporu filtrelemek için İşlemler'i kullanan bir örnek için bkz. Gereksinimler izleme örnek raporu. | ✔️ | ✔️ | ✔️ | |
| Etiket Etiketler |
Her proje için tüm iş öğesi etiketleri. Bir raporu filtrelemek için Etiketler kullanan bir örnek için bkz. Sürüm yazma örnek raporu. | ✔️ | ✔️ | ✔️ | |
| Takım Teams |
Proje için tanımlanan tüm takımlar. Bir raporu filtrelemek için Teams kullanan bir örnek için bkz. Bir rapora takım Power BI ekleme. | ✔️ | ✔️ | ✔️ | ✔️ |
| Kullanıcı Kullanıcılar |
Çeşitli iş öğesi özelliklerini genişletmek veya filtrelemek için kullanılan kullanıcı bilgileri , Oluşturan Atanangibi. | ✔️ | ✔️ | ✔️ | ✔️ |
| WorkItemBoardSnapshot WorkItemBoardSnapshot |
(Bileşik) Eğilim raporları oluşturmak için kullanılan Kanban panosu konumu da dahil olmak üzere her takvim tarihine sahip her iş öğesinin durumu. Örnek rapor için bkz. Toplu Flow Diyagramı (CFD) örnek raporu. | ✔️ | ✔️ | ✔️ | ✔️ |
| Workıtemlink WorkItemLinks |
İş öğeleri arasındaki bağlantılar; örneğin, Alt, Üstve İlgili. Yalnızca bağlantıların en son düzeltmelerini içerir, geçmiş yoktur. Köprüler dahil değildir. | ✔️ | ✔️ | ✔️ | ✔️ |
| WorkItemRevision WorkItemRevisions |
Geçerli düzeltme de dahil olmak üzere tüm eski iş öğesi düzeltmeleri. Silinen iş öğelerini dahil değildir. | ✔️ | ✔️ | ✔️ | ✔️ |
| WorkItemSnapshot WorkItemSnapshot |
(Bileşik) Eğilim raporlamayı desteklemek için kullanılan her takvim tarihine göre her iş öğesinin durumu. Örnek rapor için bkz. Hata eğilimleri örnek raporu. | ✔️ | ✔️ | ✔️ | ✔️ |
| Workıtem Workıtems |
İş öğelerinin geçerli durumu. Durum raporlarını desteklemek için kullanılır. Örnek rapor için bkz. Alt iş öğesi değerlerini üst örnek rapora toplama. | ✔️ | ✔️ | ✔️ | ✔️ |
| WorkItemTypeField WorkItemTypeFields |
Her iş öğesi türü ve işlemi için iş öğesi özellikleri. Rapor binalarını desteklemek için kullanılır. | ✔️ | ✔️ | ✔️ | ✔️ |
Ek kaynaklar:
- Analiz görünümleri veri kümesi tasarımı
- Alan ve yineleme (sprint) yolları hakkında
- Takımlar ve Çevik araçlar hakkında
- Project ve ekip hızlı başvurusu
- Listeleri ve panoları kategorilere ayırmak ve filtrelemek için iş öğesi etiketleri ekleme
- Takım ekleme
- Bağlantı türü başvurusu
Branch, Pipelines ve Test EntityTypes and EntitySets
Aşağıdaki EntityTypes ve EntitySets,v3.0-preview veya v4.0-preview API sürümleriyle birlikte de kullanılabilir.
| EntityType/EntitySet | Description | v3.0-preview | v4.0-preview |
|---|---|---|---|
| Şube Dallar |
Testlerde veya işlem hatlarında kullanılan dallar hakkında temel bilgiler. Örnek rapor için bkz. İlerleme durumu örnek raporu. | ✔️ | ✔️ |
| ParallelPipelineJobsSnapshot ParallelPipelineJobsSnapshot |
(Bileşik) Paralel işlem hattı tüketiminin anlaşılmasını destekler. Paralel işlem hattı testleri hakkında daha fazla bilgi edinmek için bkz. Visual Studio Test görevini kullanarak testleri paralel olarak çalıştırma. | ✔️ | |
| Boru hattı Pipelines |
İşlem hattının özellikleri. | ✔️ | ✔️ |
| PipelineJob PipelineJobs |
Bir Test Çalıştırması ile ilişkili belirli bir Test için tek tek yürütme sonuçları | ✔️ | ✔️ |
| PipelineRun PipelineRuns |
İşlem hatları için yürütme bilgileri. Örnek rapor için bkz. İşlem hattı geçiş oranı eğilimi örnek raporu. | ✔️ | ✔️ |
| PipelineRunActivityResult PipelineRunActivityResults |
Belirli bir işlem hattı yürütmesi içindeki tüm aşamaların, adımların, işlerin ve görevlerin birleştirilmiş günlüğü. Örnek rapor için bkz. İşlem hattı görev süresi örnek raporu. | ✔️ | ✔️ |
| PipelineTask PipelineTasks |
İşlem hattı içinde kullanılan görevlerin özellikleri. | ✔️ | ✔️ |
| Testconfiguration TestConfigurations |
Plan yapılandırma bilgilerini test edin. Testleri yapılandırma hakkında ayrıntılı bilgi için bkz. Farklı yapılandırmaları test edin | ✔️ | ✔️ |
| TestResult Testresults |
TestRun ile ilişkili belirli bir Test için tek tek yürütme sonuçları. | ✔️ | ✔️ |
| TestResultsDaily TestResultsDaily |
TestResult yürütmelerinin Test (TestRun değil) tarafından gruplanmış günlük anlık görüntü toplaması. Örnek rapor için bkz. Test özeti eğilimi örnek raporu. | ✔️ | ✔️ |
| TestRun Test Çalıştırmaları |
TestResult toplaması ile işlem hattı altında çalıştırilen testler için yürütme bilgileri. | ✔️ | ✔️ |
| Test Testler |
Test adı ve test sahibi gibi bir test örneğinin özellikleri. Test çalışmalarını tanımlama hakkında ayrıntılı bilgi için bkz. El ile test çalışmalarını oluşturma. | ✔️ | ✔️ |
| Testpoint Test Noktaları |
Test noktaları için yürütme bilgileri. Test noktası, test testi, test paketi, yapılandırma ve tester'ın benzersiz bir bileşimidir. Örnek rapor için bkz. İlerleme durumu örnek raporu. | ✔️ | ✔️ |
| TestPointHistorySnapshot TestPointHistorySnapshots |
(Bileşik) TestRun ile ilişkili belirli bir Test için tek tek yürütme sonuçları. Örnek rapor için bkz. El ile test yürütme eğilimi örnek raporu | ✔️ | ✔️ |
| TestSuite TestSuites |
Test paketleri bilgileri. Test paketlerini tanımlama hakkında ayrıntılı bilgi için bkz. Test planları ve test paketleri oluşturma. | ✔️ | ✔️ |
| TaskAgentPoolSizeSnapshot TaskAgentPoolSizeSnapshots |
(Bileşik) Havuz boyutunu, işlem hattı işlerini ve eşzamanlılığı anlamayı destekler. Aracı havuzlarının Geçmiş grafiği, bu varlık kümesine nasıl kullanıla bir örnektir. | ✔️ | |
| TaskAgentRequestSnapshot TaskAgentRequestSnapshots |
(Bileşik) | ✔️ |
Ek kaynaklar:
Bileşik varlıklar
Bileşik varlıklar belirli senaryoları destekler. Bunlar daha basit varlıklardan oluşur, genellikle oluşturmak için daha fazla bilgi işlem kaynağı gerektirir ve daha büyük sonuç kümeleri dönüşebilr. En iyi performansı elde etmek ve gereksiz azaltmayı önlemek için senaryonuz için doğru varlığı sorgulaya dikkat edin.
Örneğin, WorkItemSnapshot,WorkItemRevisions ve Dates'i birleştirir; böylece her bir tarih, her iş öğesi için bir düzeltmeye sahip olur. Bu gösterim, filtrelenmiş iş öğeleri kümesi için eğilim verilerine odaklanan OData sorgularını destekler. Ancak, iş öğelerinin geçerli durumunu sorgulamak için bu bileşik varlığı kullanmamalısınız. Bunun yerine, daha hızlı çalışan bir sorgu oluşturmak için WorkItems varlık kümesi kullanabilirsiniz.
Benzer şekilde, bazı varlıklar tüm eski değerleri, diğerleri ise yalnızca geçerli değerleri içerebilir. WorkItemRevision, geçerli değerlerin ilgini gösterdiği senaryolarda kullanmaması gereken tüm iş öğesi geçmişini içerir.
İlişkiler
Daha karmaşık sorgu sonuçları oluşturmak için ilişkileri kullanarak varlıkları birleştirebilirsiniz. Verileri genişletmek, filtrelemek veya özetlemek için ilişkileri çalıştırabilirsiniz.
Bazı gezinti özellikleri tek bir varlıkla, diğerleri ise varlık koleksiyonuyla sonuçlandır. Aşağıdaki diyagramda, varlık seçme ve bunların gezinti özellikleri gösterildi. Netlik sağlamak için bazı bileşik varlıklar ve ilişkiler atlanmıştır.
İlişki anahtarları
Dış araçların varlıkları birleştirmesi için varlık ilişkileri de yabancı anahtar olarak temsil eder. Bu özellikler "SK" soneki içerir ve tamsayı veya GUID veri türleridir. Tarih özelliklerine karşılık gelen tamsayı tarih anahtarı özellikleri şu biçimdedir: YYYYMMDD.
Varlık özellikleri
Aşağıdaki tabloda bazı yaygın ayrıntıları göstermek içinWorkItemRevision varlık özelliklerinin kısmi bir listesi yer alır. İlk üç özellik (CreatedDate, CreatedDateSK, CreatedOn)aynı değerin genellikle her biri farklı senaryolar için tasarlanmış birden çok özellikte ifade edildiklerini gösterir.
| Özellik | Tür | Description |
|---|---|---|
| CreatedDate | DateTimeOffset | İş öğesinin kuruluş için tanımlanan saat diliminde ifade edildik şekilde oluşturulma tarihi. Genellikle filtreleme ve görüntüleme için kullanılır. |
| CreatedDateSK | Int32 | İş öğesinin kuruluş için tanımlanan saat YYYYMMDD diliminde olduğu gibi oluşturulacak tarih. Dış araçlar tarafından ilgili varlıkları birleştirmek için kullanılır. |
| CreatedOn | Gezinti | kuruluş için tanımlanan saat diliminde iş öğesinin oluşturulma tarihi için Date varlığa gezinti özelliği. Deyimlerde Date varlığından özelliklere başvuru yapmak için groupby yaygın olarak kullanılır. |
| StoryPoints | Çift | Bir iş öğesine atanan ve genellikle toplam olarak toplanan noktalar. |
| Etiketler | Gezinti | Etiket varlık koleksiyonuna gezinti özelliği. Deyimlerde birden $expand çok iş öğesi etiketi için Name özelliğine erişmek için yaygın olarak kullanılır. |
| Başlık | Dize | İş öğesi başlığı. |
| Revizyon | Int32 | İş öğesinin düzeltmesi. |
| WorkItemId | Int32 | İş öğesinin kimliği. |
| WorkItemRevisionSK | Int32 | İlgili varlıkları birleştirmek için dış araçlar tarafından kullanılan iş öğesi düzeltmesi için Analytics benzersiz anahtarı. |
| Workıtemtype | Dize | İş öğesi türü, örneğin Hata, Görev, Kullanıcı Hikayesi. |
Not
Özel iş öğesi alanlarında yapılan değişiklikler veri modelinizin şeklini etkiler ve tüm iş öğesi düzeltmelerini etkiler. Örneğin, yeni bir alan eklersiniz, önceden var olan düzeltme verilerine yapılan sorgular yeni alanın varlığını yansıtacak.