Model data untuk Analitik

Layanan Azure DevOps | Azure DevOps Server 2022 - Azure DevOps Server 2019

Model data Analitik untuk Azure DevOps terdiri dari kumpulan entitas, yang anggotanya (entitas) berisi properti yang dapat difilter, dikumpulkan, dan dirangkum. Selain itu, properti tersebut berisi properti navigasi yang menghubungkan entitas satu sama lain, menyediakan akses ke properti lain untuk memilih, memfilter, dan mengelompokkan.

Catatan

Layanan Analitik diaktifkan secara otomatis dan didukung dalam produksi untuk semua Layanan Azure DevOps. Integrasi dan akses Power BI ke umpan OData Dari Layanan Analitik umumnya tersedia. Kami mendorong Anda untuk menggunakannya dan memberi kami umpan balik. Data yang tersedia bergantung pada versi. Versi terbaru yang didukung adalah v2.0, dan versi pratinjau terbaru adalah v4.0-preview. Untuk informasi selengkapnya, lihat Penerapan versi OData API.

Namespace skema

Model data Analitik didasarkan pada dua namespace layanan skema:

• Microsoft.VisualStudio.Services.Analytics.Model
• Microsoft.VisualStudio.Services.Analytics.

Kumpulan entitas dan jenis entitas

Jenis entitas diberi nama jenis terstruktur dengan kunci. Mereka menentukan properti dan hubungan bernama dari setiap entitas. Kunci dibentuk EntityType dari subset properti primitif, misalnya—WorkItemId, PipelineId, ReleasePipelineId—dan lebih banyak jenis entitas.

Kumpulan entitas adalah kumpulan entitas bernama. Misalnya, WorkItems adalah set entitas yang berisi WorkItem entitas. Kunci entitas secara unik mengidentifikasi entitas dalam kumpulan entitas. Jika beberapa set entitas menggunakan jenis entitas yang sama, kombinasi nilai kunci yang sama dapat muncul di lebih dari satu set entitas dan mengidentifikasi entitas yang berbeda, satu per entitas yang ditetapkan tempat kombinasi kunci ini muncul. Masing-masing entitas ini memiliki id entitas yang berbeda. Kumpulan entitas menyediakan titik masuk ke dalam model data.

Kumpulan entitas dijelaskan dalam metadata OData, dan bervariasi menurut proyek. Anda dapat menjelajahi daftar lengkap kumpulan entitas, jenis entitas, dan properti dengan meminta metadata OData untuk proyek Anda. Untuk mempelajari caranya, lihat Membuat kueri OData untuk Analitik.

Entitas gabungan

Entitas komposit mendukung skenario tertentu. Sumber daya tersebut terdiri dari entitas yang lebih sederhana, sering kali memerlukan lebih banyak sumber daya komputasi untuk dihasilkan, dan dapat mengembalikan tataan hasil yang lebih besar. Untuk mencapai performa terbaik dan menghindari pembatasan yang tidak perlu, pastikan Anda mengkueri entitas yang benar untuk skenario Anda.

Misalnya, WorkItemSnapshot menggabungkan WorkItemRevisions dan Dates sehingga setiap tanggal memiliki satu revisi untuk setiap item kerja. Representasi ini mendukung kueri OData yang berfokus pada data tren untuk sekumpulan item kerja yang difilter. Namun, Anda tidak boleh menggunakan entitas komposit ini untuk mengkueri status item kerja saat ini. Sebagai gantinya WorkItems , Anda harus menggunakan kumpulan entitas untuk menghasilkan kueri yang lebih cepat berjalan.

Demikian pula, beberapa entitas mungkin berisi semua nilai historis, sementara yang lain mungkin hanya berisi nilai saat ini. WorkItemRevisions berisi semua riwayat item kerja, yang tidak boleh Anda gunakan dalam skenario di mana nilai saat ini menarik.

Hubungan

Untuk menghasilkan hasil kueri yang lebih kompleks, Anda bisa menggabungkan entitas menggunakan hubungan. Anda dapat menggunakan hubungan untuk memperluas, memfilter, atau meringkas data.

Beberapa properti navigasi menghasilkan satu entitas, sementara yang lain menghasilkan kumpulan entitas. Diagram berikut menunjukkan entitas tertentu dan properti navigasinya. Untuk kejelasan, beberapa entitas komposit dan hubungan telah dihilangkan.

Kunci hubungan

Hubungan entitas juga direpresentasikan sebagai kunci asing sehingga alat eksternal dapat bergabung dengan entitas. Properti ini memiliki akhiran "SK", dan merupakan jenis data bilangan bulat atau GUID. Properti tanggal memiliki properti kunci tanggal bilangan bulat yang sesuai dengan format berikut: YYYYMMDD.

Jenis entitas pelacakan kerja dan set entitas

Jenis entitas dan set entitas berikut didukung dengan versi API yang ditunjukkan. Untuk referensi lengkap, lihat Referensi metadata pelacakan kerja untuk Azure Boards Analytics.

EntityType/EntitySet	Deskripsi	v1.0	v2.0	v3.0-preview	v4.0-preview
Area/ Area	Item kerja Jalur Area, dengan properti untuk pengelompokan dan pemfilteran menurut hierarki area.	✔️	✔️	✔️	✔️
Iterasi/ Iterasi	Jalur Iterasi item kerja, dengan properti untuk pengelompokan dan pemfilteran menurut hierarki iterasi.	✔️	✔️	✔️	✔️
BoardLocation/ BoardLocations	Lokasi sel papan, seperti yang diidentifikasi oleh kolom papan, swimlane, dan pemisahan, termasuk pengaturan papan bersejarah. Untuk deskripsi setiap bidang papan, lihat Alur kerja dan bidang papan.	✔️	✔️	✔️	✔️
CalendarDate/ Tanggal	Tanggal yang digunakan untuk memfilter dan mengelompokkan entitas lain menggunakan hubungan.	✔️	✔️	✔️	✔️
Proyek/ Proyek	Semua proyek yang ditentukan untuk organisasi (cloud) atau koleksi proyek (lokal).	✔️	✔️	✔️	✔️
Proses/ Proses	Informasi backlog yang digunakan untuk memperluas atau memfilter item kerja dan jenis item kerja. Untuk contoh yang menggunakan Proses untuk memfilter laporan, lihat Laporan sampel pelacakan persyaratan.		✔️	✔️	✔️
Menandai/ Tag	Semua tag item kerja untuk setiap proyek. Untuk contoh yang menggunakan Tag untuk memfilter laporan, lihat Merilis laporan sampel burndown.	✔️	✔️	✔️	✔️
Tim/ Tim	Semua tim yang didefinisikan untuk proyek. Untuk contoh yang menggunakan Teams untuk memfilter laporan, lihat Menambahkan pemotong Tim ke laporan Power BI.	✔️	✔️	✔️	✔️
Pengguna/ Pengguna	Informasi pengguna yang digunakan untuk memperluas atau memfilter berbagai properti item kerja, misalnya Ditetapkan Ke, Dibuat Oleh.	✔️	✔️	✔️	✔️
WorkItemBoardSnapshot/ WorkItemBoardSnapshot	(Komposit) Status setiap item kerja pada setiap tanggal kalender, termasuk lokasi papan, digunakan untuk menghasilkan laporan tren. Untuk contoh laporan, lihat Laporan sampel Diagram Alur Kumulatif (CFD).	✔️	✔️	✔️	✔️
WorkItemLink/ WorkItemLinks	Tautan antara item kerja, misalnya, Turunan, Induk, dan Terkait. Hanya mencakup revisi tautan terbaru, tanpa riwayat. Hyperlink tidak disertakan.	✔️	✔️	✔️	✔️
WorkItemRevision/ WorkItemRevisions	Semua revisi item kerja historis, termasuk revisi saat ini. Tidak menyertakan item kerja yang dihapus.	✔️	✔️	✔️	✔️
WorkItemSnapshot/ WorkItemSnapshot	(Komposit) Status setiap item kerja pada setiap tanggal kalender, digunakan untuk mendukung pelaporan tren. Untuk contoh laporan, lihat Laporan sampel tren bug.	✔️	✔️	✔️	✔️
WorkItem/ WorkItems	Status item kerja saat ini. Digunakan untuk mendukung laporan status. Untuk contoh laporan, lihat Nilai item kerja turunan rollup ke laporan sampel induk.	✔️	✔️	✔️	✔️
WorkItemTypeField/ WorkItemTypeFields	Properti item kerja untuk setiap jenis dan proses item kerja. Digunakan untuk mendukung pembuatan laporan.	✔️	✔️	✔️	✔️

Jenis entitas alur dan set entitas

Jenis entitas dan set entitas berikut didukung dengan versi Analitik v3.0-preview atau v4.0-preview . Untuk referensi lengkap, lihat Referensi metadata alur .

EntityType/EntitySet	Deskripsi	v3.0-preview	v4.0-preview
Cabang/ Cabang	Informasi dasar tentang cabang yang digunakan dalam pengujian atau alur. Untuk contoh laporan, lihat Laporan sampel status kemajuan.	✔️	✔️
ParallelPipelineJobsSnapshot/ ParallelPipelineJobsSnapshot	(Komposit) Mendukung pemahaman tentang konsumsi alur paralel. Untuk informasi selengkapnya tentang pengujian alur paralel, lihat Menjalankan pengujian secara paralel menggunakan tugas Visual Studio Test.		✔️
Pipa/ Pipelines	Properti untuk alur.	✔️	✔️
PipelineJob/ PipelineJobs	Hasil eksekusi individual untuk Pengujian tertentu yang terkait dengan TestRun	✔️	✔️
PipelineRun/ PipelineRuns	Informasi eksekusi untuk alur. Untuk contoh laporan, lihat Laporan sampel tren laju lolos alur.	✔️	✔️
PipelineRunActivityResult/ PipelineRunActivityResults	Log gabungan dari semua tahapan, langkah, pekerjaan, dan tugas dalam eksekusi alur tertentu. Untuk contoh laporan, lihat Laporan sampel durasi tugas alur.	✔️	✔️
PipelineTask/ PipelineTasks	Properti untuk tugas yang digunakan dalam alur.	✔️	✔️
TaskAgentPoolSizeSnapshot/ TaskAgentPoolSizeSnapshots	(Komposit) Mendukung pemahaman tentang ukuran kumpulan, pekerjaan alur, dan konkurensi. Grafik Historis untuk kumpulan agen menggambarkan bagaimana kumpulan entitas ini dapat digunakan.		✔️
TaskAgentRequestSnapshot/ TaskAgentRequestSnapshots	(Komposit)		✔️

Menguji jenis entitas dan set entitas

Jenis entitas dan set entitas berikut didukung dengan versi Analitik v3.0-preview atau v4.0-preview . Untuk referensi lengkap, lihat Menguji referensi metadata.

EntityType/EntitySet	Deskripsi	v3.0-preview	v4.0-preview
TestConfiguration/ TestConfigurations	Menguji informasi konfigurasi paket. Untuk detail tentang mengonfigurasi pengujian, lihat Menguji konfigurasi yang berbeda	✔️	✔️
TestResult/ TestResults	Hasil eksekusi individual untuk Pengujian tertentu yang terkait dengan TestRun.	✔️	✔️
TestResultsDaily/ TestResultsDaily	Agregat rekam jepret harian eksekusi TestResult , dikelompokkan menurut Pengujian (bukan TestRun). Untuk contoh laporan, lihat Laporan sampel tren ringkasan pengujian.	✔️	✔️
TestRun/ TestRuns	Informasi eksekusi untuk pengujian yang dijalankan di bawah alur dengan TestResult agregat.	✔️	✔️
Ujian/ Tes	Properti untuk kasus pengujian, seperti nama pengujian dan pemilik pengujian. Untuk detail tentang menentukan kasus pengujian, lihat Membuat kasus pengujian manual.	✔️	✔️
TestPoint/ TestPoints	Informasi eksekusi untuk titik pengujian. Titik pengujian adalah kombinasi unik dari kasus pengujian, rangkaian pengujian, konfigurasi, dan penguji. Untuk contoh laporan, lihat Laporan sampel status kemajuan.	✔️	✔️
TestPointHistorySnapshot/ TestPointHistorySnapshots	(Komposit) Hasil eksekusi individual untuk Pengujian tertentu yang terkait dengan TestRun. Untuk contoh laporan, lihat Laporan sampel tren eksekusi pengujian manual	✔️	✔️
TestSuite/ TestSuites	Menguji informasi suite. Untuk detail tentang menentukan suite pengujian, lihat Membuat rencana pengujian dan suite pengujian.	✔️	✔️

Artikel terkait

• Panduan kueri OData Analytics
• Analitik WIT
• Data agregat
• Menjelajahi metadata Analitik OData
• Pelacakan kerja, proses, dan batas proyek
• Desain himpunan data tampilan analitik