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 dalam Azure DevOps Services. Integrasi Power BI dan akses ke umpan OData dari layanan Analytics kini tersedia secara umum. Anda dianjurkan untuk menggunakan umpan OData Analytics dan memberikan umpan balik.

Data yang tersedia bergantung pada versi. Versi terbaru yang didukung dari API OData adalah v2.0, dan versi pratinjau terbaru adalah v4.0-preview. Untuk informasi selengkapnya, lihat versi OData API.

Ruang nama skema

Model data Analitik didasarkan pada dua skema namespace.

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

Kumpulan entitas dan jenis entitas

Jenis entitas diberi nama jenis terstruktur dengan kunci. Mereka menentukan sifat dan relasi diberi nama dari setiap entitas. Kunci dari EntityType dibentuk dari subset properti primitif, misalnya—WorkItemId, PipelineId, ReleasePipelineId—dan jenis entitas lainnya.

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. Mereka terdiri dari entitas yang lebih sederhana, sering kali memerlukan lebih banyak sumber daya komputasi untuk dihasilkan, dan dapat mengembalikan hasil yang lebih besar. Untuk mencapai performa terbaik dan menghindari pembatasan yang tidak perlu, pastikan Anda melakukan kueri pada 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, Anda harus menggunakan kumpulan entitas WorkItems untuk menghasilkan kueri yang berjalan lebih cepat.

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 yang penting.

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 kumpulan 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
Wilayah/ Area	Item kerja Area Path dengan atribut untuk pengelompokan dan pemfilteran berdasarkan hierarki area.	✔️	✔️	✔️	✔️
Iterasi/ Iterasi	Item kerja Jalur Iterasi, dengan properti untuk pengelompokan dan pemfilteran menurut hierarki iterasi.	✔️	✔️	✔️	✔️
BoardLocation/ BoardLocations	Lokasi sel papan, seperti yang diidentifikasi oleh kolom papan, jalur berenang, dan pemisahan, termasuk setelan papan yang bersejarah. Untuk deskripsi setiap bidang papan, lihat Alur kerja dan bidang papan.	✔️	✔️	✔️	✔️
CalendarDate/ Tanggal	Tanggal digunakan untuk memfilter dan mengelompokkan entitas lain melalui hubungan.	✔️	✔️	✔️	✔️
Proyek/ Proyek	Semua proyek yang ditentukan untuk organisasi (cloud) atau kumpulan proyek (di tempat).	✔️	✔️	✔️	✔️
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.		✔️	✔️	✔️
Label/ Tag	Semua tag item kerja untuk setiap proyek. Untuk contoh yang menggunakan Tag untuk memfilter laporan, lihat contoh laporan burndown.	✔️	✔️	✔️	✔️
Tim/ Tim	Semua tim telah 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/ Cuplikan Papan Item Kerja	(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 Rollup nilai item kerja anak ke laporan contoh induk.	✔️	✔️	✔️	✔️
WorkItemTypeField/ WorkItemTypeFields	Properti item kerja untuk setiap jenis dan proses item kerja. Digunakan untuk mendukung pembuatan laporan.	✔️	✔️	✔️	✔️

Jenis entitas pipa dan set entitas

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

JenisEntitas/SetEntitas	Deskripsi	v3.0-preview	v4.0-preview
Cabang/ Cabang	Informasi dasar tentang cabang yang digunakan dalam pengujian atau rangkaian proses. 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/ Saluran Pipa	Properti untuk pipa saluran.	✔️	✔️
PipelineJob/ PipelineJobs	Hasil eksekusi individual untuk Pengujian tertentu yang terkait dengan TestRun	✔️	✔️
PipelineRun/ PipelineRuns	Informasi eksekusi untuk pipeline. Untuk contoh laporan, lihat laporan contoh tren tingkat kelulusan pipeline.	✔️	✔️
PipelineRunActivityResult/ PipelineRunActivityResults	Log gabungan dari semua tahapan, langkah, pekerjaan, dan tugas dalam eksekusi alur tertentu. Untuk contoh laporan, lihat Laporan sampel durasi tugas dalam alur kerja.	✔️	✔️
PipelineTask/ PipelineTasks	Properti untuk tugas yang digunakan dalam pipa.	✔️	✔️
TaskAgentPoolSizeSnapshot/ TaskAgentPoolSizeSnapshots	(Komposit) Mendukung pemahaman tentang ukuran kumpulan, tugas pipeline, dan keserentakan. Grafik Historis untuk kumpulan agen menggambarkan bagaimana kumpulan entitas ini dapat digunakan.		✔️
TaskAgentRequestSnapshot/ TaskAgentRequestSnapshots	(Komposit)		✔️

Menguji jenis entitas serta himpunan entitas

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

EntityType/EntitySet	Deskripsi	v3.0-preview	v4.0-preview
TestConfiguration/ TestConfigurations	Informasi konfigurasi rencana pengujian. Untuk detail tentang mengonfigurasi pengujian, lihat Menguji konfigurasi yang berbeda	✔️	✔️
TestResult/ TestResults	Hasil eksekusi individu untuk Test tertentu yang terkait dengan TestRun.	✔️	✔️
TestResultsDaily/ TestResultsDaily	Agregat cuplikan harian pelaksanaan TestResult, dikelompokkan menurut Pengujian (bukan TestRun). Untuk contoh laporan, lihat contoh laporan tren ringkasan pengujian.	✔️	✔️
TestRun/ TestRuns	Informasi eksekusi untuk pengujian yang dijalankan di dalam pipa dengan hasil pengujian agregat.	✔️	✔️
Tes/ 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 pelaksanaan 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	Informasi suite pengujian. 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 OData Analisis
• Pelacakan kerja, proses, dan batas proyek
• Desain himpunan data tampilan analitik