Bagikan melalui

Referensi metadata untuk Azure Boards Analytics

Layanan Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

Layanan Analytics mengumpulkan semua definisi pelacakan kerja Azure Boards dan aktivitas pembaruan. Anda dapat menjalankan kueri Analytics langsung di browser Anda dan menggunakan kombinasi properti untuk memfilter kueri, mengagregasi data, atau membuat laporan. Untuk informasi selengkapnya, lihat Menentukan kueri dasar menggunakan OData Analytics.

Artikel ini menjelaskan sebagian besar properti yang dapat Anda gunakan untuk membuat laporan Analitik pelacakan kerja. Analytics menyimpan semua bidang pelacakan kerja sebagai properti kecuali untuk bidang HTML/teks kaya dan riwayat. Bidang kustom secara otomatis ditambahkan ke Analytics sebagai properti kustom.

Catatan

Artikel ini menyediakan deskripsi entitas, properti, dan jenis enumerasi yang didukung oleh model data Analytics. Untuk mengkueri model data, lihat Membuat kueri OData untuk Analitik.

Gambaran umum kumpulan entitas

Saat Anda mengkueri Analitik untuk data pelacakan kerja, kueri kumpulan entitas WorkItems untuk menghasilkan laporan status dan rollup. Gunakan entitas WorkItemSnapshot yang ditetapkan untuk menghasilkan laporan tren, burndown, dan burn up.

Gunakan jenis entitas lain, seperti Area, Iterasi, Proyek, atau Tim untuk memfilter data atau memilih properti untuk dilaporkan. Misalnya laporan, lihat Contoh laporan dan indeks referensi cepat.

Catatan

Untuk menghasilkan laporan status dan tren tentang uji coba, hasil pengujian, atau data pengujian lainnya, kueri jenis entitas WorkItems dan WorkItemSnapshot dan filter berdasarkan jenis entitas TestRuns, TestPoints, TestResultsDaily, TestSuite, atau TestPointHistorySnapshot . Untuk informasi selengkapnya, lihat Menguji referensi metadata untuk Azure DevOps.

Set entitas Jenis entitas Deskripsi
Area Wilayah Jalur Area item kerja, dengan properti untuk pengelompokan dan pemfilteran menurut hierarki area.
Tanggal CalendarDate Tanggal yang digunakan untuk memfilter dan mengelompokkan entitas lain menggunakan hubungan.
Iterasi Iterasi Jalur Perulangan item kerja, dengan properti untuk pengelompokan dan pemfilteran menurut hierarki iterasi.
BoardLocations BoardLocation 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.
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. Didukung untuk Analytics v2.0 versi dan yang lebih baru.
Proyek Proyek Semua proyek yang ditentukan untuk organisasi atau koleksi proyek.
Tag Menandai 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 atau Dibuat Oleh.
Cuplikan Papan Item Kerja Cuplikan Papan Item Kerja Jenis entitas komposit yang menjelaskan 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).
WorkItemLinks WorkItemLink Tautan antara item kerja, misalnya Turunan, Induk, dan Terkait. Hanya menyertakan revisi tautan terbaru, tanpa riwayat, dan tidak menyertakan hyperlink.
WorkItemRevisions WorkItemRevision Semua revisi item kerja historis, termasuk revisi saat ini. Tidak menyertakan item kerja yang dihapus.
WorkItemSnapshot WorkItemSnapshot Jenis entitas komposit yang menjelaskan status setiap item kerja pada setiap tanggal kalender. Digunakan untuk mendukung pelaporan tren. Untuk contoh laporan, lihat Laporan sampel tren bug.
WorkItems WorkItem Status item kerja saat ini. Digunakan untuk mendukung laporan status. Untuk contoh laporan, lihat Nilai item kerja turunan rollup ke laporan sampel induk.
WorkItemTypeFields WorkItemTypeField Properti item kerja untuk setiap jenis dan proses item kerja. Digunakan untuk mendukung pembuatan laporan.

Cuplikan

Set entitas rekam jepret pelacakan kerja adalah WorkItemSnapshot dan WorkItemBoardSnapshot. Rekam jepret menulis ke Analytics secara bersamaan setiap hari dan menyediakan catatan nilai yang ditentukan untuk item kerja untuk hari itu. Anda dapat menggunakan rekam jepret untuk menghasilkan laporan tren.

Secara default, semua tabel rekam jepret dimodelkan sebagai tabel fakta rekam jepret harian. Kueri untuk rentang waktu mendapatkan nilai untuk setiap hari, dan rentang waktu panjang menghasilkan sejumlah besar rekaman. Jika Anda tidak memerlukan presisi tinggi seperti itu, Anda dapat menggunakan rekam jepret mingguan atau bulanan. Untuk informasi selengkapnya, lihat Menggunakan rekam jepret mingguan atau bulanan untuk kueri tren yang mencakup periode waktu yang lama.

Revisi item kerja

Setiap kali Anda memperbarui item kerja, sistem membuat revisi baru dan merekamnya di System.RevisedDate bidang , yang berguna untuk menentukan filter riwayat. Anda dapat mewakili tanggal yang direvisi berdasarkan RevisedDate (DateTime) properti dan RevisedDateSK (Int32) .

Gunakan properti kunci pengganti tanggal terakhir untuk performa terbaik. Kunci ini menunjukkan tanggal revisi dibuat, atau memperlihatkan nilai "9999-01-01T00:00:00Z" null tanggalwaktu OData untuk revisi aktif atau tidak lengkap. Jika Anda menginginkan semua tanggal sejak {startDate}, inklusif, tambahkan filter berikut ke kueri Anda: RevisedDateSK eq null or RevisedDateSK gt {startDateSK}.

Anda menggunakan entitas WorkItemRevisions yang diatur untuk memuat semua revisi untuk item kerja tertentu. Kueri mengembalikan semua revisi item kerja historis, termasuk revisi saat ini, untuk item kerja yang Anda filter, tidak termasuk item kerja yang dihapus.

Properti bersama di seluruh jenis entitas

Properti yang dapat Anda pilih dalam tampilan Analitik sesuai dengan bidang pelacakan kerja reguler dan properti Analitik yang dipilih, seperti Hari Waktu Siklus dan Hari Waktu Prospek. Properti ini didefinisikan untuk jenis entitas berikut, kecuali ditentukan lain:

  • WorkItem
  • WorkItemRevision
  • WorkItemSnapshot
  • Cuplikan Papan Item Kerja

Catatan

Tabel berikut mencantumkan dan menjelaskan sebagian besar properti yang dapat Anda pilih dalam tampilan Analitik, termasuk bidang pelacakan kerja reguler dan properti Analitik lainnya.

Nama tampilan Nama properti Jenis data Deskripsi Nama referensi
Diterima Oleh Microsoft_VSTS_CodeReview_AcceptedBy UserSK Nama orang yang merespons tinjauan kode. (Proses CMMI) Microsoft.VSTS.CodeReview.AcceptedBy
Tanggal Diterima AcceptedDate Tanggal dan Waktu Tanggal dan waktu saat orang tersebut merespons tinjauan kode. (Proses CMMI) Microsoft.VSTS.CodeReview.AcceptedDate
Diaktifkan Oleh ActivatedBy, ActivatedByUserSK UserSK Nama anggota tim yang mengaktifkan atau mengaktifkan kembali item kerja. Microsoft.VSTS.Common.ActivatedBy
Tanggal Diaktifkan ActivatedDate Tanggal dan Waktu Tanggal dan waktu saat anggota tim mengaktifkan atau mengaktifkan kembali bug atau item kerja. Microsoft.VSTS.CodeReview.ActivatedDate
Tinggi Activity string Jenis aktivitas atau disiplin yang ditetapkan untuk melakukan tugas. Nilai yang diizinkan adalah: Penyebaran, Desain, Pengembangan, Dokumentasi, Persyaratan, dan Pengujian. (Proses Agile, Scrum, dan Basic) Microsoft.VSTS.Common.Activity
AnalyticsUpdatedDate Pengaturan Waktu & Tanggal Data dan waktu entitas terakhir diperbarui.
Jenis Aplikasi string Jenis aplikasi yang memberikan umpan balik kepada pemangku kepentingan. Nilai defaultnya adalah Aplikasi Web, Komputer Jarak Jauh, dan Aplikasi Klien. Jenis yang valid ditentukan dalam file konfigurasi proses untuk proyek yang menggunakan proses XML lokal. Microsoft_VSTS_Feedback_ApplicationType
Jalur Area AreaPath, AreaSK string Fitur produk atau grup item kerja area tim. Harus merupakan simpul yang valid dalam hierarki proyek. System.AreaPath
Ditetapkan Ke AssignedTo, AssignedToUserSK UserSK Nama anggota tim yang saat ini memiliki item kerja. System.AssignedTo
Id Pengujian Otomatis AutomatedTestId string ID pengujian yang mengotomatiskan kasus pengujian. Microsoft.VSTS.TCM.AutomatedTestId
Nama Pengujian Otomatis AutomatedTestName string Nama anggota tim yang mengaktifkan atau mengaktifkan kembali item kerja. Microsoft.VSTS.TCM.AutomatedTestName
Penyimpanan Pengujian Otomatis AutomatedTestStorage string Assembly yang berisi pengujian yang mengotomatiskan kasus pengujian. Microsoft.VSTS.TCM.AutomatedTestStorage
Jenis Pengujian Otomatis AutomatedTestType string Jenis pengujian yang mengotomatiskan kasus pengujian. Microsoft.VSTS.TCM.AutomatedTestType
Status automasi AutomatedStatus string Status kasus pengujian dengan nilai yang diterima Otomatis, Tidak Otomatis, atau Terencana. Microsoft.VSTS.TCM.AutomationStatus
Prioritas Backlog BacklogPriority Laju Nomor yang ditetapkan oleh proses latar belakang sistem yang digunakan untuk menumpuk peringkat atau melacak urutan item pada backlog atau papan. (Proses scrum) Microsoft.VSTS.Common.BacklogPriority
Diblokir Blocked string Indikasi bahwa tidak ada pekerjaan lebih lanjut yang dapat dilakukan pada item kerja. Nilai yang valid adalah Ya atau Tidak. (Proses CMMI) Microsoft.VSTS.CMMI.Blocked
Nilai Bisnis BusinessValue Laju Unit pengukuran subjektif yang menangkap nilai bisnis relatif dari item atau fitur backlog produk dibandingkan dengan item lain dengan jenis yang sama. Item yang ditetapkan angka yang lebih tinggi dianggap memiliki nilai bisnis yang lebih besar daripada item yang ditetapkan angka yang lebih rendah. Microsoft.VSTS.Common.BusinessValue
Diubah Oleh ChangedBy, ChangedByUserSK UserSK Nama orang yang memodifikasi item kerja baru-baru ini. System.ChangedBy
Tanggal Diubah ChangedDate Tanggal dan Waktu Tanggal dan waktu ketika item kerja dimodifikasi. System.ChangedDate
ChangedDateSK Int32 Tanggal item kerja dimodifikasi, dinyatakan seperti YYYYMMDD di zona waktu yang ditentukan untuk organisasi. Digunakan oleh alat eksternal untuk menggabungkan entitas terkait.
ChangedOn Navigasi Properti navigasi ke Date entitas untuk tanggal item kerja dimodifikasi, di zona waktu yang ditentukan untuk organisasi. Umumnya digunakan untuk mereferensikan Date properti dari entitas dalam groupby pernyataan.
Ditutup Oleh ClosedBy, ClosedByUserSK UserSK Nama orang yang menutup item kerja. Microsoft.VSTS.Common.ClosedBy
Tanggal Tutup ClosedDate, , ClosedDateSKClosedOn Tanggal dan Waktu Tanggal dan waktu ketika item kerja ditutup. Microsoft.VSTS.Common.ClosedDate
Jumlah Komentar CommentCount Int32 Jumlah komentar yang ditambahkan ke bagian Diskusi dari item kerja. System.CommentCount
Berkomitmen Committed string Indikasi apakah persyaratan diterapkan dalam proyek. Nilai yang valid adalah Ya atau Tidak. (Proses CMMI) Microsoft.VSTS.CMMI.Committed
CompletedDateSK Int32 Tanggal properti navigasi yang diambil oleh Analitik yang menyimpan saat item kerja memasukkan status alur kerja yang terkait dengan kategori Status selesai .
CompletedOn Navigasi Properti navigasi ke Date entitas untuk tanggal item kerja memasukkan status alur kerja yang terkait dengan kategori Status selesai , di zona waktu yang ditentukan untuk organisasi. Umumnya digunakan untuk mereferensikan Date properti dari entitas dalam groupby pernyataan.
Pekerjaan Selesai CompletedWork Laju Ukuran jumlah pekerjaan yang dihabiskan untuk tugas. Microsoft.VSTS.Scheduling.CompletedWork
Dibuat Oleh CreatedBy, CreatedByUserSK UserSK Nama orang yang membuat item kerja. Microsoft.VSTS.Common.CreatedBy
Tanggal Dibuat CreatedDate, CreatedDateSK Tanggal dan Waktu Tanggal item kerja dibuat, dinyatakan dalam zona waktu yang ditentukan untuk organisasi. Umumnya digunakan untuk pemfilteran dan tampilan. Microsoft.VSTS.Common.CreatedDate
CreatedDateSK Int32 Tanggal item kerja dibuat, dinyatakan seperti YYYYMMDD di zona waktu yang ditentukan untuk organisasi. Digunakan oleh alat eksternal untuk menggabungkan entitas terkait.
CreatedOn Navigasi Properti navigasi ke Date entitas untuk tanggal item kerja dibuat, di zona waktu yang ditentukan untuk organisasi. Umumnya digunakan untuk mereferensikan Date properti dari entitas dalam groupby pernyataan.
Hari Waktu Siklus CycleTimeDays Laju Waktu siklus dihitung dari pertama kali memasukkan kategori status Sedang Berlangsung atau Diselesaikan hingga memasukkan kategori Status selesai . Untuk informasi selengkapnya, lihat widget Waktu Prospek dan Waktu Siklus.
Disiplin Discipline string Jenis aktivitas atau disiplin yang ditetapkan ke tugas. Nilai yang diizinkan adalah: Analisis, Pengembangan, Pengujian, Pendidikan Pengguna, dan Pengalaman Pengguna. (Proses CMMI) Microsoft.VSTS.Common.Activity
Tanggal Jatuh Tempo DueDate Tanggal dan Waktu Perkiraan tanggal jatuh tempo untuk masalah atau item kerja yang akan diselesaikan. (Proses tangkas) Microsoft.VSTS.Scheduling.DueDate
Usaha Effort Laju Perkiraan jumlah pekerjaan yang diperlukan item backlog produk (proses Scrum) atau masalah (Proses dasar) . Microsoft.VSTS.Scheduling.Effort
Tanggal Selesai FinishDate Tanggal dan Waktu Tanggal dan waktu jadwal menunjukkan item kerja akan diselesaikan. Microsoft.VSTS.Scheduling.FinishDate
Ditemukan Dalam FoundIn string Nomor build produk, juga dikenal sebagai revisi, di mana bug ditemukan. Microsoft.VSTS.Build.FoundIn
Tanggal InProgress InProgressDate Tanggal dan Waktu Tanggal tersimpan analitik yang mengambil tanggal-waktu saat item kerja dipindahkan ke status milik kategori status Sedang Berlangsung .
InProgressDateSK Int32 Tanggal item kerja dipindahkan ke Status yang termasuk dalam kategori status Sedang Berlangsung , yang dinyatakan seperti YYYYMMDD di zona waktu yang ditentukan untuk organisasi. Digunakan oleh alat eksternal untuk menggabungkan entitas terkait.
Build Integrasi IntegrationBuild string Nomor build produk yang menggabungkan kode atau memperbaiki bug. Microsoft.VSTS.Build.IntegrationBuild
Adalah Saat Ini IsCurrent Boolean Dukungan untuk memfilter data untuk melihat rekam jepret terbaru dari kumpulan item kerja yang difilter dengan mengatur nilai ke True. Berlaku untuk jenis entitas WorkItemRevision, WorkItemBoardSnapshot, dan BoardLocation.
Adalah Revisi Terakhir Hari Ini IsLastRevisionOfDay Boolean Indikasi bahwa rekam jepret mewakili revisi terakhir hari itu ketika diatur ke True.
Adalah Revisi Terakhir Periode IsLastRevisionOfPeriod Boolean Indikasi bahwa rekam jepret mewakili revisi terakhir periode saat diatur ke True.
Masalah Issue string Indikasi bahwa langkah bersama dikaitkan dengan hasil yang diharapkan. Nilai yang diizinkan adalah Ya dan Tidak. Microsoft.VSTS.Common.Issue
Hari Waktu Tunggu LeadTimeDays Laju Waktu tunggu dihitung dari pembuatan item kerja atau memasukkan kategori Status yang Diusulkan untuk memasukkan kategori Status selesai . Untuk informasi selengkapnya, lihat widget Waktu Prospek dan Waktu Siklus.
Perkiraan Asli OriginalEstimate Laju Ukuran jumlah pekerjaan yang diperlukan untuk menyelesaikan tugas. Microsoft.VSTS.Scheduling.OriginalEstimate
Id Item Kerja Induk ParentWorkItemId Int32 ID unik yang mengidentifikasi item kerja yang ditautkan sebagai induk. Berguna untuk menghasilkan laporan rollup. Bidang Induk valid untuk jenis entitas WorkItemRevision dan WorkItem. System.Parent
Prioritas Priority Int32 Peringkat subjektif bug, masalah, tugas, atau kasus pengujian karena berkaitan dengan bisnis. Nilai termasuk 1, 2, atau 3. Microsoft.VSTS.Common.Priority
Nama Proyek ProjectName Navigasi Nama proyek tempat item kerja berada. Untuk detailnya, lihat Properti proyek. System.TeamProject
ProjectSK GUID GUID yang ditetapkan ke proyek tempat item kerja berada.
Peringkat Reason string Jumlah bintang yang diterima item dari peninjau dalam sistem peringkat berbasis bintang (Respons Umpan Balik). Jumlah disimpan dalam sistem dan ditulis sebagai 0 - Tidak Dinilai, 1 - Miskin, 2 - Adil, 3 - Bagus, 4 - Sangat Baik, atau 5 - Sangat baik. Berlaku untuk jenis entitas WorkItemRevision dan WorkItem . Microsoft.VSTS.Common.Rating
Alasan Reason string Alasan mengapa item kerja dalam status saat ini. Setiap transisi dari satu status alur kerja ke status alur kerja lainnya dikaitkan dengan alasan yang sesuai. System.Reason
Sisa Pekerjaan RemainingWork Laju Mengukur jumlah pekerjaan yang tersisa untuk menyelesaikan tugas. Microsoft.VSTS.Scheduling.RemainingWork
Diselesaikan Oleh ResolvedBy, ResolvedByUserSK UserSK Nama anggota tim yang menyelesaikan bug atau cerita pengguna. Microsoft.VSTS.Common.ResolvedBy
Tanggal Terselesaikan ResolvedDate Tanggal dan Waktu Tanggal dan waktu ketika bug atau cerita pengguna diselesaikan. Microsoft.VSTS.Common.ResolvedDate
ResolvedDateSK Int32 Tanggal item kerja diselesaikan, dinyatakan seperti YYYYMMDD di zona waktu yang ditentukan untuk organisasi. Digunakan oleh alat eksternal untuk menggabungkan entitas terkait.
ResolvedOn Navigasi Properti navigasi ke Date entitas untuk tanggal item kerja diselesaikan, di zona waktu yang ditentukan untuk organisasi. Umumnya digunakan untuk mereferensikan Date properti dari entitas dalam groupby pernyataan.
Alasan Terselesaikan ResolvedReason string Alasan bug diselesaikan, seperti Diperbaiki. Microsoft.VSTS.Common.ResolvedReason
Revisi Revision Int32 Nomor yang ditetapkan ke revisi historis item kerja. System.Rev
Tanggal Direvisi RevisedDate Tanggal dan Waktu Tanggal dan waktu ketika item kerja dimodifikasi atau diperbarui.
RevisedDateSK Int32 Tanggal item kerja direvisi, dinyatakan seperti YYYYMMDD di zona waktu yang ditentukan untuk organisasi. Digunakan oleh alat eksternal untuk menggabungkan entitas terkait.
RevisedOn Navigasi Properti navigasi ke Date entitas untuk tanggal item kerja direvisi, di zona waktu yang ditentukan untuk organisasi. Umumnya digunakan untuk mereferensikan Date properti dari entitas dalam groupby pernyataan.
Risiko Risk Laju Peringkat subjektif ketidakpastian relatif tentang keberhasilan penyelesaian item kerja. Nilai yang valid termasuk 1 - Tinggi, 2 - Sedang, dan 3 - Rendah. Microsoft.VSTS.Common.Risk
Keparahan Severity Laju Peringkat subjektif efek bug, masalah, atau risiko pada proyek. Nilai yang valid termasuk 1 - Kritis, 2 - Tinggi, 3 - Sedang, dan 4 - Rendah. Microsoft.VSTS.Common.Severity
Ukuran Size Laju Perkirakan jumlah pekerjaan yang perlu diimplementasikan oleh persyaratan. (Proses CMMI) Microsoft.VSTS.Scheduling.Size
Peringkat Tumpukan StackRank Laju Nomor yang ditetapkan oleh proses latar belakang sistem yang digunakan untuk menumpuk peringkat atau melacak urutan item pada backlog atau papan. (Proses Agile, Scrum, dan Basic) Microsoft.VSTS.Common.StackRank
Tanggal Mulai StartDate Tanggal dan Waktu Tanggal dan waktu yang ditetapkan ke item kerja agar pekerjaan dimulai. Microsoft.VSTS.Scheduling.StartDate
Solid State string Status item kerja saat ini. Nilai yang valid untuk status khusus untuk setiap jenis item kerja dan kustomisasi yang dibuat untuknya. System.State
Kategori Status StateCategory string Cara Azure Boards dan memilih widget dasbor memperlakukan setiap status alur kerja. Kategori status termasuk Diusulkan, Sedang Berlangsung, Diselesaikan, Dihapus, dan Selesai. Untuk informasi selengkapnya, lihat Cara menggunakan status alur kerja dan kategori status. Hanya berlaku untuk WorkItemRevision jenis entitas.
Tanggal Perubahan Status StateChangeDate Tanggal dan Waktu Tanggal dan waktu nilai bidang Status berubah. Microsoft.VSTS.Common.StateChangeDate
StateChangeSK Int32 Tanggal status item kerja berubah, dinyatakan seperti YYYYMMDD di zona waktu yang ditentukan untuk organisasi. Digunakan oleh alat eksternal untuk menggabungkan entitas terkait.
StateChangeOn Navigasi Properti navigasi ke Date entitas untuk tanggal status item kerja diubah, di zona waktu yang ditentukan untuk organisasi. Umumnya digunakan untuk mereferensikan Date properti dari entitas dalam groupby pernyataan.
Titik Cerita StoryPoints Laju Perkiraan jumlah pekerjaan yang diperlukan cerita pengguna untuk diterapkan, biasanya dikumpulkan sebagai jumlah. (Proses tangkas) Microsoft.VSTS.Scheduling.StoryPoints
Tag TagNames string Daftar tag yang dibatasi titik koma yang ditetapkan ke satu atau beberapa item kerja untuk tujuan pemfilteran atau kueri. System.Tags
Tanggal Target TargetDate Tanggal dan Waktu Perkiraan tanggal jatuh tempo untuk masalah atau item kerja lainnya untuk diselesaikan atau diselesaikan. Microsoft.VSTS.Scheduling.TargetDate
Jenis Rangkaian Pengujian string Jenis rangkaian pengujian. Nilai yang valid termasuk Berbasis Kueri, Berbasis Persyaratan, dan Statis. Microsoft_VSTS_TCM_TestSuiteType
Id Jenis Rangkaian Pengujian Int64 Nomor yang ditetapkan sistem yang sesuai dengan kategori rangkaian pengujian. Hanya berlaku untuk suite pengujian. Nilai yang ditetapkan adalah 1 (Statis), 2 (Berbasis kueri), dan 3 (Berbasis persyaratan). Microsoft_VSTS_TCM_TestSuiteTypeId
Kekritisan Waktu TimeCriticality Laju Unit pengukuran subjektif yang menangkap bagaimana nilai bisnis berkurang dari waktu ke waktu. Nilai yang lebih tinggi menunjukkan epik atau fitur secara inheren lebih penting waktu daripada item dengan nilai yang lebih rendah. Microsoft.VSTS.Common.TimeCriticality
Judul Title string Deskripsi singkat yang meringkas item kerja yang membantu anggota tim membedakannya dari item kerja lain dalam daftar. System.Title
Area Nilai ValueArea string Area nilai pelanggan yang ditangani oleh item epik, fitur, atau backlog. Nilai termasuk Arsitektur atau Bisnis. Microsoft.VSTS.Common.ValueArea
Watermark Watermark string Bidang yang dikelola sistem yang mengalami kenaikan dengan perubahan yang dilakukan pada item kerja. Berlaku untuk jenis entitas WorkItemRevision dan WorkItem . System.Watermark
Id Item Kerja WorkItemId Int32 Pengidentifikasi unik yang ditetapkan ke item kerja. ID item kerja unik di semua proyek dalam organisasi atau koleksi proyek. System.Id
WorkItemRevisionSK Int32 Kunci unik analitik untuk revisi item kerja, digunakan oleh alat eksternal untuk menggabungkan entitas terkait.
Tipe Item Kerja WorkItemType string Nama jenis item kerja. Jenis item kerja yang tersedia didasarkan pada proses yang digunakan proyek. Untuk informasi selengkapnya, lihat Tentang proses dan templat proses. System.WorkItemType

Properti navigasi OData adalah atribut referensi entitas yang menunjuk ke entitas lain. Tabel berikut ini menyediakan ringkasan properti navigasi, batasan referensialnya, dan jenis entitas yang valid.

Nama tampilan Nama Batasan referensial Properti referensial Jenis entitas yang valid
ChangedOn ChangedDateSK DateSK WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot
ClosedOn ClosedDateSK DateSK WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot
CreatedOn CreatedDateSK DateSK WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot
ResolvedOn ResolvedDateSK DateSK WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
StateChangeOn StateChangeDateSK DateSK WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
InProgressOn InProgressDateSK DateSK WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
CompletedOn CompletedDateSK DateSK WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
ChangedOn ChangedDateSK DateSK WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
RevisedOn RevisedDateSK DateSK WorkItemRevision, WorkItemSnapshot
Date DateSK DateSK WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot
Area Area AreaSK WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
BoardLocation WorkItemRevision, WorkItem, WorkItemBoardSnapshot
Iterasi Iteration IterationSK WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
Ditetapkan Ke AssignedTo AssignedToUserSK UserSK WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
Diubah Oleh ChangedBy ChangedByUserSK UserSK WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
Dibuat Oleh CreatedBy CreatedByUserSK UserSK WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
Diaktifkan Oleh ActivatedBy ActivatedByUserSK UserSK WorkItemRevision,WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
Ditutup Oleh ClosedBy ClosedBySK UserSK WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
DiselesaikanOleh ResolvedBy ResolvedByUserSK UserSK WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot
Tim Area, BoardLocation, Iterasi, WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot
Tag WorkItem, WorkItemRevision, WorkItemBoardSnapshot
Proyek Project ProjectSK ProjectSK Tag, WorkItemBoardSnapshot, WorkItemLink, WorkItemRevision, WorkItemSnapshot, WorkItemTypeField
Proses WorkItemRevision, WorkItem, WorkItemSnapshot
Revisi WorkItem
Tautan WorkItem
Anak WorkItem
Ortu WorkItem
Keturunan WorkItem
WorkItem* WorkItemId WorkItemRevision

*Entitas WorkItem juga mendukung PredictTags fungsi dan Predict , yang mendukung tren prediktif pada laporan dan widget Analitik bawaan tertentu.

BoardLocation dan WorkItemBoardSnapshot

Tabel berikut ini mencantumkan dan menjelaskan properti yang ditentukan untuk jenis entitas BoardLocation dan WorkItemBoardSnapshot , kecuali disebutkan. Anda dapat menggunakan bidang ini untuk memfilter data item kerja berdasarkan status item kerja dalam kolom papan tim, swimlane, atau tingkat backlog. Untuk contoh yang mengkueri kumpulan entitas WorkItemBoardSnapshot , lihat Laporan sampel Diagram Alur Kumulatif (CFD).

Nama tampilan Nama properti Jenis data Deskripsi
Id Papan BoardId Panduan GUID unik yang ditetapkan ke papan. Setiap tim dikaitkan dengan satu atau beberapa papan.
Nama Referensi Kategori Papan BoardCategoryReferenceName string Nama yang ditetapkan ke kategori jenis item kerja yang digunakan untuk mengisi papan. Misalnya, papan backlog produk dikaitkan dengan kategori Persyaratan. Untuk informasi selengkapnya, lihat Menyesuaikan backlog atau papan Anda (Proses warisan).
Nama Papan BoardName string Nama yang ditetapkan ke papan, misalnya Cerita, Item Backlog, Fitur, atau Epik.
Tingkat Papan BoardLevel Int32 Nomor yang ditetapkan ke papan berdasarkan tempatnya berada dalam hierarki papan.
Jenis Backlog BacklogType string Nama jenis backlog, misalnya Iterasi, Persyaratan, atau Portofolio.
Nama Kolom ColumnName string Nama kolom papan tempat item kerja saat ini ditetapkan, seperti Aktif, Tertutup, Berkomitmen, Selesai, atau label kolom kustom. Nama referensi: System.BoardColumn
Urutan Kolom ColumnOrder Int32 Nomor yang ditetapkan ke kolom papan dalam hal urutannya dalam papan.
Selesai Done Disebutkan Indikator lokasi pisah kolom.*
Batas Item Kolom ColumnItemLimit Int32 Nomor yang ditetapkan ke kolom papan dalam hal urutannya.
Apakah Papan Terlihat IsBoardVisible Boolean Indikasi apakah tim terpilih untuk membuat papan terlihat.
Adalah Pemisahan Kolom IsColumnSplit Boolean Indikasi apakah kolom dibagi menjadi kolom Lakukan dan Selesai seperti yang dijelaskan di Pisahkan kolom di papan Anda untuk memperlihatkan pekerjaan yang sedang berlangsung.
Adalah Saat Ini IsCurrent Boolean Properti yang mendukung pemfilteran data untuk melihat rekam jepret terbaru dari item kerja yang difilter saat diatur ke True.
Adalah Jalur Default IsDefaultLane Boolean Indikasi bahwa item kerja ditetapkan ke swimlane default saat diatur ke True.
Selesai IsDone Boolean Penetapan item kerja saat ini dalam kolom ke Lakukan jika False atau Selesai saat True. Hanya valid saat kolom terpisah diaktifkan untuk kolom papan. Nama referensi: System.BoardColumnDone
Id Jalur LaneId Panduan GUID unik yang ditugaskan untuk papan renang. Setiap tim dapat menambahkan satu atau beberapa baju renang ke papan. Untuk informasi selengkapnya tentang swimlanes, lihat Mempercepat pekerjaan tim Anda dengan menggunakan swimlanes di papan Anda.
Nama Jalur LaneName string Nama yang ditugaskan untuk papan renang. Nama referensi: System.BoardLane
Urutan Jalur LaneOrder Int32 Nomor yang ditetapkan untuk papan renang dalam hal urutannya.

*Tabel berikut mencantumkan nama anggota untuk BoardColumnSplit jenis enumerasi, yang bisa Anda gunakan untuk memfilter item kerja di kolom papan Lakukan atau Selesai .

Nama anggota Nilai Nama tampilan
Doing 0 Sedang Dikerjakan
Done 1 Selesai
Unknown 2 Tidak diketahui (tidak dibagi)

Untuk informasi selengkapnya tentang kolom papan untuk tim, lihat artikel berikut ini:

Daerah

Properti berikut ini valid untuk kumpulan entitas Area , yang terkait dengan bidang Jalur Area. Kunci pengganti yang terkait dengan Area termasuk AreaSK dan ProjectSK. Anda dapat menggunakan properti ini untuk memfilter atau melaporkan data pelacakan kerja berdasarkan penetapan jalur area.

Nama tampilan Nama Jenis data Deskripsi
AnalyticsUpdatedDate Tanggal dan Waktu Marka air yang menunjukkan terakhir kali data Analytics diperbarui.
Number Int32 Nilai bilangan bulat yang ditetapkan ke simpul jalur area saat pembuatan.
Kedalaman Depth Int32 Tingkat jalur area berdasarkan kedalamannya dari tingkat akar.
Area Id AreaId GUID Pengidentifikasi unik yang ditetapkan ke jalur area saat pembuatan.
Area Level 1 hingga Area Level 14 AreaLevel1 melalui AreaLevel14 string Tingkat node jalur area hingga 14 tingkat berlapis. Area Tingkat 1 selalu sesuai dengan simpul akar dan nama proyek.
Nama Area AreaName string Nama yang ditentukan untuk jalur area saat pembuatan.
Jalur Area AreaPath string Jalur lengkap jalur area yang dimulai dengan simpul akar.

Penting

Menghapus nilai Jalur Area atau mengonfigurasi ulang nilai Jalur Perulangan menyebabkan kehilangan data yang tidak dapat diubah dalam bagan berikut:

  • Bagan widget burndown dan burn up
  • Bagan Sprint Burndown
  • Diagram kecepatan untuk tim dengan jalur area yang telah diubah
  • Bagan tren historis yang mereferensikan nilai Jalur Area dan Jalur Perulangan seperti yang ditentukan pada saat untuk setiap item kerja

Anda dapat menghapus jalur area dan iterasi hanya saat tidak lagi digunakan oleh item kerja apa pun. Saat menghapus jalur ini, Anda tidak dapat lagi mengambil data historisnya.

Properti navigasi untuk jenis entitas Area dan kumpulan entitas Area mencakup Proyek dan Teams.

Untuk informasi selengkapnya tentang Jalur Area, lihat artikel berikut ini:

Perulangan

Properti berikut ini valid untuk kumpulan entitas Iterasi , yang terkait dengan bidang Jalur Perulangan. Kunci pengganti yang terkait dengan Iterasi termasuk IterationSK dan ProjectSK. Anda dapat menggunakan properti ini untuk memfilter atau melaporkan data pelacakan kerja berdasarkan penetapan jalur iterasi.

Nama tampilan Nama Jenis data Deskripsi
AnalyticsUpdatedDate Tanggal dan Waktu Marka air yang menunjukkan terakhir kali data Analytics diperbarui.
Number Int32 Nilai bilangan bulat yang ditetapkan ke simpul jalur iterasi saat pembuatan.
Kedalaman Depth Int32 Tingkat jalur iterasi berdasarkan kedalamannya dari tingkat akar.
Tanggal Akhir EndDate Tanggal dan Waktu Tanggal akhir yang ditentukan untuk jalur perulangan.
Terendah IsEnded Boolean Indikasi bahwa tanggal akhir jalur iterasi berada di masa lalu ketika diatur ke True.
Id Perulangan IterationId GUID Pengidentifikasi unik yang ditetapkan ke jalur iterasi saat pembuatan.
Iterasi Tingkat 1 hingga Iterasi Tingkat 14 IterationLevel1 melalui IterationLevel14 string Tingkat simpul jalur iterasi hingga 14 tingkat berlapis. Iterasi Tingkat 1 selalu sesuai dengan simpul akar dan nama proyek.
Nama Perulangan IterationName string Nama yang ditentukan untuk jalur iterasi saat pembuatan.
Jalur Perulangan IterationPath string Jalur iterasi penuh dimulai dengan simpul akar. Iterasi harus merupakan simpul yang valid dalam hierarki proyek. Nama referensi: System.IterationPath
Tanggal Mulai StartDate Tanggal dan Waktu Tanggal mulai yang ditentukan untuk jalur iterasi.

Penting

Menghapus nilai Jalur Area atau mengonfigurasi ulang nilai Jalur Perulangan menyebabkan kehilangan data yang tidak dapat diubah dalam bagan berikut:

  • Bagan widget burndown dan burn up
  • Bagan Sprint Burndown
  • Diagram kecepatan untuk tim dengan jalur area yang telah diubah
  • Bagan tren historis yang mereferensikan nilai Jalur Area dan Jalur Perulangan seperti yang ditentukan pada saat untuk setiap item kerja

Anda dapat menghapus jalur area dan iterasi hanya saat tidak lagi digunakan oleh item kerja apa pun. Saat menghapus jalur ini, Anda tidak dapat lagi mengambil data historisnya.

Properti navigasi untuk jenis entitas Iterasi dan kumpulan entitas Iterasi mencakup Project dan Teams.

Untuk informasi selengkapnya tentang Jalur Perulangan, lihat artikel berikut ini:

Proses

Properti berikut ini valid untuk jenis entitas Proses dan set entitas Proses . Kunci pengganti yang terkait dengan Proses meliputi ProcessSK, , ProjectSKdan TeamSK. Gunakan properti ini untuk memfilter atau melaporkan data pelacakan kerja pada jenis item kerja untuk proyek atau tim.

Catatan

Versi Analitik v-2.0, v3.0-preview, dan v4.0-preview mendukung jenis entitas Proses dan set entitas Proses .

Anda dapat menggunakan properti ini untuk memfilter data pelacakan kerja berdasarkan tingkat backlog.

Nama tampilan Nama Jenis data Deskripsi
AnalyticsUpdatedDate Tanggal dan Waktu Marka air yang menunjukkan terakhir kali data Analytics diperbarui.
ProjectSK GUID Kunci proyek yang terkait dengan proses.
TeamSK GUID Kunci tim yang terkait dengan proses.
Nama Referensi Kategori Backlog BacklogCategoryReferenceName string Nama referensi kategori ditetapkan ke backlog yang terkait dengan jenis item kerja. Contohnya termasuk Microsoft.EpicCategory, , Microsoft.FeatureCategoryMicrosoft.RequirementCategory, dan Microsoft.TaskCategory.
Nama Backlog BacklogName Boolean Nama referensi yang ditetapkan ke backlog yang terkait dengan jenis item kerja
Jenis Backlog BacklogType GUID Pengidentifikasi unik yang ditetapkan ke backlog saat pembuatan.
Tingkat Backlog BacklogLevel string Tingkat backlog yang terkait dengan jenis item kerja. Nilai null mengembalikan jika jenis item kerja tidak terkait dengan tingkat backlog.
Tipe Item Kerja WorkItemType string Nama yang ditentukan untuk jenis item kerja.
Memiliki Backlog HasBacklog string Indikasi apakah jenis item kerja milik backlog.
Adalah Tipe Tersembunyi IsHiddenType Boolean Indikasi apakah jenis item kerja dinonaktifkan.
Adalah Jenis Bug IsBugType Boolean Indikasi apakah jenis item kerja termasuk dalam kategori Bug .
Dihapus IsDeleted Boolean Indikasi apakah jenis item kerja dihapus.

Untuk informasi selengkapnya tentang proses backlog dan jenis item kerja, lihat artikel berikut ini:

Tag

Properti berikut ini valid untuk kumpulan entitas Tag . Kunci pengganti yang terkait dengan Tag sertakan TagSK dan ProjectSK. Properti navigasi termasuk Project dan batasan ProjectSKreferensialnya . Untuk informasi selengkapnya tentang menggunakan tag, lihat Menambahkan tag item kerja untuk mengategorikan dan memfilter daftar dan papan.

Anda dapat menggunakan properti ini untuk memfilter atau melaporkan data pelacakan kerja.

Nama tampilan Nama Jenis data Deskripsi
Tag Id TagId GUID ID unik yang ditetapkan ke tag saat pembuatan.
Nama Tag TagName string Nama tag.

Tim

Properti berikut ini valid untuk jenis entitas Tim dan kumpulan entitas Teams . Kunci pengganti yang terkait dengan Tim menyertakan TeamSK dan ProjectSK. Anda dapat menggunakan properti ini untuk memfilter atau melaporkan data pelacakan kerja berdasarkan penetapan tim. Untuk informasi tentang menggunakan dan menambahkan tim, lihat Tentang tim dan alat Agile dan Membuat atau menambahkan tim.

Nama tampilan Nama Jenis data Deskripsi
AnalyticsUpdatedDate Tanggal dan Waktu Marka air yang menunjukkan terakhir kali data Analytics diperbarui.
Id Tim TeamId GUID ID unik yang ditetapkan kepada tim saat pembuatan.
Nama Tim TeamName string Nama tim.

Properti navigasi untuk kumpulan entitas Teams mencakup Proyek, Area, dan Iterasi.

Properti berikut ini valid untuk kumpulan entitas WorkItemLinks . Kunci pengganti referensi properti adalah WorkItemLinkSK. Query WorkItemLinks untuk melaporkan induk/anak, terkait, pendahulu/penerus, atau jenis tautan lainnya.

Nama tampilan Nama Jenis data Deskripsi
AnalyticsUpdatedDate Tanggal dan Waktu Marka air yang menunjukkan terakhir kali data Analytics diperbarui.
WorkItemLinkSK Int32 Kunci pengganti yang ditetapkan ke entitas WorkItemLink .
Tanggal Dibuat CreatedDate GUID Tanggal tautan dibuat.
Komentar Comment string Komentar ditambahkan saat tautan dibuat.
Tanggal Dihapus DeletedDate string Tanggal tautan dihapus.
Id Tipe Tautan LinkTypeId Int32 ID yang ditetapkan ke item kerja tertaut target.
Nama Tipe Tautan LinkTypeName string Nama yang mudah diingat ditetapkan ke jenis tautan.
Nama Referensi Tipe Tautan LinkTypeReferenceName string Nama referensi yang ditetapkan ke jenis tautan.
Jenis Tautan Adalah Acyclic LinkTypeIsAcyclic Boolean Indikasi bahwa jenis tautan memungkinkan hubungan melingkar saat diatur ke True. Misalnya, tautan jenis pohon membatasi hubungan melingkar.
Jenis Tautan Bersifat Terarah LinkTypeIsDirectional Boolean Indikasi apakah jenis tautan bersifat terarah. Jenis tautan arah didefinisikan berpasangan dengan komponen maju dan terbalik.
Id Item Kerja Sumber SourceWorkItemId Int32 ID yang ditetapkan ke item kerja sumber tautan.
Id Item Kerja Target TargetWorkItemId Int32 ID yang ditetapkan ke item kerja target tautan.

Properti navigasi untuk jenis entitas WorkItemLink termasuk Projects, SourceWorkItem, dan TargetWorkItem.

Untuk informasi selengkapnya tentang tautan dan jenis tautan, lihat artikel berikut ini:

BidangTipeItemKerja

Properti berikut ini valid untuk kumpulan entitas WorkItemTypeFields . Kunci referensi properti adalah FieldName, ProjectSK, dan WorkItemType.

Nama tampilan Nama Jenis data Deskripsi
Nama Bidang FieldName string Nama yang mudah diingat ditetapkan ke bidang oleh sistem atau saat pembuatan.
Nama Referensi Bidang FieldReferenceName string Nama referensi yang ditetapkan ke bidang oleh sistem atau saat membuat bidang kustom.
Tipe Bidang FieldType string Jenis data yang ditetapkan ke bidang.
Tipe Item Kerja WorkItemType string Jenis item kerja yang didefinisikan untuk bidang.

Properti navigasi mencakup Project. Untuk indeks semua bidang yang ditentukan untuk proyek, lihat Deskripsi bidang untuk bidang item kerja. Untuk informasi lebih lanjut, baca artikel berikut:

Properti khusus

Bidang kustom secara otomatis ditambahkan ke layanan Analytics sebagai properti kustom. Custom_ atau Custom. ditambahkan ke nama properti. Periksa metadata koleksi Anda seperti yang dijelaskan dalam Mengkueri metadata. Contoh berikut menunjukkan sintaks metadata untuk bidang kustom Peluang Risiko.

<Property Name="Custom_RiskOpportunity" Type="Edm.Double">
<Annotation Term="Display.DisplayName" String="Risk Opportunity"/>
<Annotation Term="Ref.ReferenceName" String="Custom.RiskOpportunity"/>
<Annotation Term="Display.Description" String="Risk Reduction | Opportunity Enablement Value. Enter a value from 1 to 5. 5 represents high risk reduction or high opportunity enablement."/>
</Property>

Jenis item kerja kustom dan kategori backlog

Data untuk jenis item kerja kustom secara otomatis ditambahkan ke layanan Analytics. Kategori kustom dibuat saat jenis item kerja kustom dan tingkat backlog ditentukan, dengan Custom_ atau Custom. didahului ke GUID kategori. Misalnya, kategori kustom seperti Custom.49b81c4e-9c4f-4c04-94fd-d660cbf3a000 mungkin ditetapkan ke jenis item kerja kustom Portofolio dalam backlog Portofolio.

Konten terkait

  • Last updated on