Bagikan melalui


Referensi metadata untuk Azure Boards Analytics

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

Layanan Analytics mengumpulkan semua aktivitas pelacakan kerja yang ditentukan dan diperbarui melalui Azure Boards. Analitik menyimpan sebagai properti semua bidang pelacakan kerja, kecuali untuk bidang HTML/teks kaya dan Riwayat. Properti kustom untuk bidang kustom secara otomatis ditambahkan ke Analytics.

Artikel ini menjelaskan sebagian besar properti yang dapat Anda gunakan untuk membuat laporan Analytics untuk pelacakan kerja. Anda menggunakan kombinasi properti untuk memfilter kueri, mengagregasi data, atau membuat laporan. Anda dapat menjalankan kueri ini langsung di browser Anda. Untuk informasi selengkapnya, lihat Menentukan kueri dasar menggunakan OData Analytics. Jika Anda baru menggunakan pelacakan kerja dan Azure Boards, kami sarankan Anda meninjau artikel berikut:

Catatan

Deskripsi entitas, properti, dan jenis enumerasi yang didukung oleh model data Analytics disediakan. Ini adalah draf awal. Harap berikan umpan balik tentang area yang ingin Anda miliki informasi lebih lanjut. Untuk mengkueri model data, lihat Membuat kueri OData untuk Analitik.

Gambaran umum kumpulan entitas

Saat mengkueri Analitik untuk data pelacakan kerja, gunakan salah satu jenis entitas atau set entitas berikut.

  • Kueri WorkItems untuk menghasilkan laporan status dan rollup
  • Kueri WorkItemSnapshot untuk menghasilkan laporan tren, burndown, dan burnup

Gunakan jenis entitas lain, seperti Area, , IterationProject, Team, atau entitas lain untuk memfilter data atau memilih properti untuk dilaporkan. Untuk ringkasan contoh laporan, lihat Contoh laporan dan indeks referensi cepat.

Catatan

Untuk menghasilkan laporan status dan tren tentang jenis item kerja khusus pengujian, kueri WorkItems jenis dan filter entitas dan WorkItemSnapshot berdasarkan jenis item kerja. Untuk informasi tentang eksekusi pengujian, hasil pengujian, atau data pengujian lainnya, kueri TestRunsjenis entitas , , TestResultsDailyTestPoints, TestSuite atau TestPointHistorySnapshot . Untuk informasi selengkapnya, lihat Menguji referensi metadata untuk Azure DevOps.

EntitySet EntityType Deskripsi
Area Area Item kerja Jalur Area, 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 Iterasi 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 (cloud) atau koleksi proyek (lokal).
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, 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).
WorkItemLinks WorkItemLink Tautan antara item kerja, misalnya, Turunan, Induk, dan Terkait. Hanya mencakup revisi tautan terbaru, tanpa riwayat. Hyperlink tidak disertakan.
WorkItemRevisions WorkItemRevision 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.
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.

Tentang rekam jepret

Ada dua set entitas rekam jepret pelacakan kerja: WorkItemSnapshot dan WorkItemBoardSnapshot.

Rekam jepret menyediakan catatan nilai yang ditentukan untuk item kerja setiap hari. Catatan ditulis ke Analytics sekali sehari pada saat yang sama setiap hari. Anda menggunakan rekam jepret saat ingin membuat laporan tren. Secara default, semua tabel rekam jepret dimodelkan sebagai tabel fakta rekam jepret harian. Jika Anda mengkueri rentang waktu, maka akan mendapatkan nilai untuk setiap hari. Rentang waktu yang lama menghasilkan sejumlah besar rekaman. Jika Anda tidak memerlukan presisi tinggi seperti itu, Anda dapat menggunakan rekam jepret mingguan atau bahkan bulanan.

Untuk informasi selengkapnya, lihat Panduan kueri OData, Gunakan rekam jepret mingguan atau bulanan untuk kueri tren yang mencakup periode waktu yang lama.

Tentang revisi item kerja

Setiap kali Anda memperbarui item kerja, sistem membuat revisi baru dan merekam tindakan ini di System.RevisedDate bidang , yang membuatnya berguna untuk menentukan filter riwayat. Tanggal revisi diwakili oleh RevisedDate properti (DateTime) dan RevisedDateSK (Int32). Untuk performa terbaik, gunakan kunci pengganti tanggal terakhir. Ini menunjukkan tanggal ketika revisi dibuat atau memiliki null untuk revisi aktif atau tidak lengkap.

Jika Anda menginginkan semua tanggal sejak inklusif {startDate} , tambahkan filter berikut ke kueri Anda.

RevisedDateSK eq null or RevisedDateSK gt {startDateSK}

Anda menggunakan WorkItemRevisions kumpulan entitas 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. Ini tidak termasuk item kerja yang dihapus.

Properti bersama di beberapa jenis entitas

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

  • WorkItem
  • WorkItemRevision
  • WorkItemSnapshot
  • WorkItemBoardSnapshot

Catatan

Layanan Analitik tidak menyimpan data apa pun untuk bidang teks panjang yang ditetapkan HTML atau jenis data teks kaya. Ini termasuk bidang Deskripsi dan Riwayat . Analitik juga tidak menyimpan tautan atau jumlah file terlampir. Untuk daftar lengkap bidang yang ditentukan dalam templat proses default, lihat Indeks bidang item kerja. Untuk deskripsi setiap jenis data, lihat Bidang kueri, operator, dan makro.
Tidak semua properti yang terkait dengan bidang khusus proses Scrum dan CMMI disertakan dalam tabel berikut. Untuk daftar bidang ini, lihat Deskripsi bidang untuk bidang item default dan pekerjaan yang digunakan dalam templat proses, Bidang yang digunakan untuk melacak item kerja CMMI.

Banyak properti berbasis tanggal atau berbasis pengguna. Properti ini dikaitkan dengan kumpulan entitas CalendarDate dan Pengguna yang dijelaskan dalam referensi tanggal Kalender, Proyek, dan metadata Pengguna.

Nama tampilan
Property name
Jenis data Keterangan
Reference name
Diterima Oleh
Microsoft_VSTS_CodeReview_AcceptedBy
UserSK Nama orang yang merespons tinjauan kode. (Proses CMMI)
Microsoft.VSTS.CodeReview.AcceptedBy
Tanggal Diterima
AcceptedDate
DateTime 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
DateTime Tanggal dan waktu saat anggota tim mengaktifkan atau mengaktifkan kembali bug atau item kerja.
Microsoft.VSTS.CodeReview.ActivatedDate
Tinggi
Activity
String Jenis aktivitas yang diperlukan untuk melakukan tugas.
Microsoft.VSTS.Common.Activity

Jenis aktivitas atau disiplin yang ditetapkan ke tugas. Nilai yang diizinkan adalah: Penyebaran, Desain, Pengembangan, Dokumentasi, Persyaratan, dan Pengujian. (Proses Agile, Scrum, dan Basic)
Microsoft.VSTS.Common.Activity
AnalyticsUpdatedDate DateTimeOffset Data dan waktu entitas terakhir diperbarui.
Jenis Aplikasi String Jenis aplikasi yang akan diberikan 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 Mengelompokkan item kerja ke dalam fitur produk atau area tim. Area 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 Rakitan 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 berikut: Otomatis, Tidak Otomatis, atau Terencana.
Microsoft.VSTS.TCM.AutomationStatus
Prioritas Backlog
BacklogPriority
Laju Angka 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
Blocked
Blocked
String Menunjukkan 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 diberi angka yang lebih tinggi harus dianggap memiliki nilai bisnis yang lebih besar daripada item yang diberi 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
DateTime 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
ClosedDateSK
ClosedOn
DateTime 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 Menunjukkan 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 alur kerja selesai.
CompletedOn Navigasi Properti navigasi ke Date entitas untuk tanggal item kerja memasukkan Status alur kerja yang terkait dengan kategori Status alur kerja 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
DateTime Tanggal item kerja dibuat, dinyatakan dalam zona waktu yang ditentukan untuk organisasi. Umumnya digunakan untuk pemfilteran dan untuk 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
DateTime Perkiraan tanggal jatuh tempo di mana masalah atau item kerja 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
DateTime Tanggal dan waktu ketika jadwal menunjukkan bahwa item kerja akan selesai.
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
DateTime Tanggal tersimpan Analitik yang mengambil tanggal-waktu saat item kerja dipindahkan ke Status yang termasuk dalam 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 Mendukung pemfilteran data untuk melihat rekam jepret terbaru dari kumpulan item kerja yang difilter dengan mengatur nilai ke True.
Valid untuk jenis entitas ini: WorkItemRevision, WorkItemBoardSnapshot, dan BoardLocation.
Adalah Revisi Terakhir Hari Ini
IsLastRevisionOfDay
Boolean Menunjukkan bahwa rekam jepret mewakili revisi terakhir hari itu ketika diatur ke True.
Adalah Revisi Terakhir Periode
IsLastRevisionOfPeriod
Boolean Menunjukkan bahwa rekam jepret mewakili revisi terakhir periode saat diatur ke True.
Masalah
Issue
String Menunjukkan 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 tersedia dari Azure DevOps Server 2020 dan versi yang lebih baru. Valid untuk jenis entitas ini: WorkItemRevision dan WorkItem.
System.Parent
Prioritas
Priority
Int32 Peringkat subjektif bug, masalah, tugas, atau kasus pengujian karena berkaitan dengan bisnis. Nilai meliputi: - 1, 2, atau 3.
Microsoft.VSTS.Common.Priority
Nama Proyek
ProjectName
Navigasi Nama proyek tempat item kerja berada. Untuk detailnya, lihat Tanggal kalender, Proyek, dan Referensi metadata Pengguna, Properti proyek.
System.TeamProject
ProjectSK GUID GUID ditetapkan ke proyek tempat item kerja berada.
Rating
Reason
String Jumlah bintang yang diterima item dari peninjau dalam sistem peringkat berbasis bintang. (Respons Umpan Balik) Jumlah disimpan dalam sistem dan ditulis sebagai berikut: - 0 - Tidak Dinilai, 1 - Miskin, 2 - Adil, 3 - Baik, 4 - Sangat Baik, dan 5 - Sangat Baik. Valid untuk jenis entitas ini: WorkItemRevision dan WorkItem.
Microsoft.VSTS.Common.Rating
Alasan
Reason
String Alasan mengapa item kerja berada 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 Ukuran 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
DateTime 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 bahwa bug diselesaikan (misalnya, itu diperbaiki).
Microsoft.VSTS.Common.ResolvedReason
Revisi
Revision
Int32 Angka yang ditetapkan ke revisi historis item kerja.
System.Rev
Tanggal Direvisi
RevisedDate
DateTime 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 dari ketidakpastian relatif tentang keberhasilan penyelesaian cerita pengguna. Nilai yang valid meliputi: 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 meliputi: 1 - Kritis, 2 - Tinggi, 3 - Sedang, dan 4 - Rendah.
Microsoft.VSTS.Common.Severity
Ukuran
Size
Laju Perkiraan jumlah pekerjaan yang perlu diterapkan oleh persyaratan (proses CMMI).
Microsoft.VSTS.Scheduling.Size
Peringkat Tumpukan
StackRank
Laju Angka 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
DateTime 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 Kategori status menentukan bagaimana Azure Boards dan memilih widget dasbor memperlakukan setiap status alur kerja. Kategori status yang digunakan meliputi: 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
DateTime Tanggal dan waktu ketika nilai bidang Status berubah.
Microsoft.VSTS.Common.StateChangeDate
StateChangeSK Int32 Tanggal Status untuk item kerja diubah, 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 untuk 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 (Proses tangkas) untuk diimplementasikan, umumnya dikumpulkan sebagai jumlah.
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
DateTime Perkiraan tanggal jatuh tempo di mana masalah atau item kerja lainnya akan diselesaikan atau diselesaikan.
Microsoft.VSTS.Scheduling.TargetDate
Jenis Rangkaian Pengujian String Menentukan jenis rangkaian pengujian. Nilai yang valid meliputi: 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 dan 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 bahwa 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 apa itu item kerja dan 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 meliputi: Arsitektur atau Bisnis.
Microsoft.VSTS.Common.ValueArea
Watermark
Watermark
String Bidang yang dikelola sistem yang berlipat dengan perubahan yang dibuat pada item kerja. Valid untuk jenis entitas ini: WorkItemRevision dan WorkItem.
System.Watermark
Id Item Kerja
WorkItemId
Int32 Pengidentifikasi unik yang ditetapkan ke item kerja. ID item kerja unik di semua proyek dan dalam organisasi atau koleksi proyek.
System.Id
WorkItemRevisionSK Int32 Kunci unik Analitik untuk revisi item kerja yang digunakan oleh alat eksternal untuk menggabungkan entitas terkait.
Tipe Item Kerja
WorkItemType
String Nama jenis item kerja. Jenis item kerja ditentukan berdasarkan proses yang digunakan saat Anda membuat proyek Anda. Untuk informasi selengkapnya, lihat Tentang proses dan templat proses.
System.WorkItemType

Properti navigasi di 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 dan properti
Valid untuk Jenis Entitas
ChangedOn
ChangedDateSK, DateSK
WorkItemRevision, , WorkItemSnapshotWorkItemBoardSnapshot
ClosedOn
ClosedDateSK, DateSK
WorkItemRevision, , WorkItemSnapshotWorkItemBoardSnapshot
CreatedOn
CreatedDateSK, DateSK
WorkItemRevision, , WorkItemSnapshotWorkItemBoardSnapshot
ResolvedOn
ResolvedDateSK, DateSK
WorkItemRevision, , WorkItemWorkItemSnapshot,WorkItemBoardSnapshot
StateChangeOn
StateChangeDateSK, DateSK
WorkItemRevision, , WorkItemWorkItemSnapshot,WorkItemBoardSnapshot
InProgressOn
InProgressDateSK, DateSK
WorkItemRevision, , WorkItemWorkItemSnapshot,WorkItemBoardSnapshot
CompletedOn
CompletedDateSK, DateSK
WorkItemRevision, , WorkItemWorkItemSnapshot,WorkItemBoardSnapshot
ChangedOn
ChangedDateSK, DateSK
WorkItemRevision, , WorkItemWorkItemSnapshot,WorkItemBoardSnapshot
RevisedOn
RevisedDateSK, DateSK
WorkItemRevision, WorkItemSnapshot
Date
DateSK, DateSK
WorkItemRevision, , WorkItemSnapshotWorkItemBoardSnapshot
Area Area
AreaSK
WorkItemRevision, , WorkItemWorkItemSnapshot,WorkItemBoardSnapshot
BoardLocation WorkItemRevision, , WorkItemWorkItemBoardSnapshot
Iterasi Iteration
IterationSK
WorkItemRevision, , WorkItemWorkItemSnapshot,WorkItemBoardSnapshot
Ditetapkan Ke AssignedTo
AssignedToUserSK, UserSK
WorkItemRevision, , WorkItemWorkItemSnapshot,WorkItemBoardSnapshot
Diubah Oleh ChangedBy
ChangedByUserSK, UserSK
WorkItemRevision, , WorkItemWorkItemSnapshot,WorkItemBoardSnapshot
Dibuat Oleh CreatedBy
CreatedByUserSK, UserSK
WorkItemRevision, , WorkItemWorkItemSnapshot,WorkItemBoardSnapshot
Diaktifkan Oleh ActivatedBy
ActivatedByUserSK, UserSK
WorkItemRevision,WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
Ditutup Oleh ClosedBy
ClosedBySK, UserSK
WorkItemRevision, , WorkItemWorkItemSnapshot,WorkItemBoardSnapshot
ResolvedBy ResolvedBy
ResolvedByUserSK, UserSK
WorkItemRevision, , WorkItemSnapshotWorkItemBoardSnapshot
Tim Area, , BoardLocationIteration, WorkItemRevision, , WorkItemSnapshot,WorkItemBoardSnapshot
Tag WorkItem, , WorkItemRevisionWorkItemBoardSnapshot
Proyek Project
ProjectSK, ProjectSK
Tag, , WorkItemBoardSnapshotWorkItemLink, WorkItemRevision, WorkItemSnapshot, , WorkItemTypeField,
Proses WorkItemRevision, , WorkItemWorkItemSnapshot
Revisi WorkItem
Tautan WorkItem
Anak WorkItem
Ortu WorkItem
Keturunan WorkItem
WorkItem WorkItemId WorkItemRevision

Memprediksi fungsi

Dua fungsi berikut didukung untuk entitas WorkItem . Fungsi-fungsi ini digunakan dalam mendukung tren prediktif pada laporan dan widget bawaan Analytics tertentu.

  • PredictTags
  • Predict

BoardLocation dan WorkItemBoardSnapshot

Properti yang tercantum dan dijelaskan dalam tabel berikut didefinisikan untuk jenis entitas berikut, kecuali disebutkan secara khusus. Dengan bidang ini, Anda dapat memfilter data item kerja berdasarkan status item kerja dalam kolom papan tim, swimlane, atau tingkat backlog.

  • BoardLocation
  • WorkItemBoardSnapshot

Untuk contoh yang mengkueri WorkItemBoardSnapshot kumpulan entitas, lihat Laporan sampel Diagram Alur Kumulatif (CFD).

Nama tampilan
Property name
Jenis data Keterangan
Reference name
Id Papan
BoardId
Guid 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, dan 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 lainnya.
System.BoardColumn
Urutan Kolom
ColumnOrder
Int32 Nomor yang ditetapkan ke kolom papan dalam hal urutannya dalam papan.
Selesai
Done
Disebutkan Menunjukkan lokasi pisah kolom. Nilai yang valid tercantum di bawah ini untuk BoardColumnSplit.
Batas Item Kolom
ColumnItemLimit
Int32 Angka yang ditetapkan ke kolom papan dalam hal urutannya.
Apakah Papan Terlihat
IsBoardVisible
Boolean Menunjukkan apakah tim telah memilih untuk membuat papan terlihat atau tidak.
Adalah Pemisahan Kolom
IsColumnSplit
Boolean Menunjukkan apakah kolom telah dibagi menjadi kolom Lakukan dan Selesai seperti yang dijelaskan dalam 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 kumpulan item kerja yang difilter dengan mengatur nilai ke True.
Adalah Jalur Default
IsDefaultLane
Boolean Properti yang menunjukkan item kerja ditetapkan ke swimlane default (True) atau tidak (False).
Selesai
IsDone
Boolean Penetapan item kerja saat ini ke Melakukan (Salah) atau Selesai (Benar) dalam kolom. Hanya ditetapkan saat kolom terpisah diaktifkan untuk kolom papan.
System.BoardColumnDone
Id Jalur
LaneId
Guid GUID unik yang ditetapkan ke jalur renang papan. Setiap tim dapat menambahkan satu atau beberapa jalur 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.
System.BoardLane
Urutan Jalur
LaneOrder
Int32 Nomor yang ditugaskan untuk papan renang dalam hal urutannya.

Anggota enumerasi BoardColumnSplit

Tabel berikut mencantumkan nama anggota untuk BoardColumnSplit jenis enumerasi, yang dapat digunakan 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 Keterangan
AnalyticsUpdatedDate DateTime Marka air yang menunjukkan terakhir kali data Analytics diperbarui.
Number Int32 Nilai bilangan bulat yang ditetapkan ke simpul Jalur Area saat dibuat.
Kedalaman Depth Int32 Tingkat di mana Jalur Area didefinisikan berdasarkan kedalamannya dari tingkat akar.
Area Id AreaId GUID Pengidentifikasi unik yang ditetapkan ke Jalur Area saat dibuat.
Area Tingkat 1 hingga
Area Tingkat 14
AreaLevel1 melalui
AreaLevel14
String Nama yang terkait dengan tingkat simpul jalur area. Hingga 14 tingkat berlapis didukung. Misalnya, Area Level 1 selalu sesuai dengan simpul akar dan nama proyek.
Nama Area AreaName String Nama yang ditentukan untuk Jalur Area saat dibuat.
Jalur Area AreaPath String Jalur lengkap Jalur Area yang dimulai dengan simpul akar.

Penting

  • Menghapus Jalur Area atau mengonfigurasi ulang Jalur Iterasi menyebabkan kehilangan data yang tidak dapat diubah. Misalnya, bagan widget burndown dan burnup, sprint burndown, dan bagan kecepatan untuk tim dengan Jalur Area yang diubah tidak akan menampilkan data yang akurat. Bagan tren historis mereferensikan Jalur Area dan Jalur Perulangan seperti yang ditentukan pada saat untuk setiap item kerja. Setelah dihapus, Anda tidak dapat mengambil data historis untuk jalur ini.
  • Anda hanya dapat menghapus jalur area dan iterasi yang tidak lagi digunakan oleh item kerja apa pun.

Properti navigasi untuk jenis entitas Area dan kumpulan entitas Area meliputi Project 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 Perulangan.

Nama tampilan Nama Jenis data Keterangan
AnalyticsUpdatedDate DateTime Marka air yang menunjukkan terakhir kali data Analytics diperbarui.
Number Int32 Nilai bilangan bulat yang ditetapkan ke simpul Jalur Perulangan saat dibuat.
Kedalaman Depth Int32 Tingkat di mana Jalur Perulangan didefinisikan berdasarkan kedalamannya dari tingkat akar.
Tanggal Akhir EndDate DateTime Tanggal akhir yang ditentukan untuk Jalur Perulangan.
Terendah IsEnded Boolean Saat diatur ke True, menunjukkan bahwa Tanggal Akhir Jalur Perulangan berada di masa lalu.
Id Perulangan IterationId GUID Pengidentifikasi unik yang ditetapkan ke Jalur Perulangan saat dibuat.
Iterasi Tingkat 1 hingga
Iterasi Tingkat 14
IterationLevel1 melalui
IterationLevel14
String Nama yang terkait dengan tingkat simpul jalur iterasi. Hingga 14 tingkat berlapis didukung. Misalnya, Iterasi Tingkat 1 selalu sesuai dengan simpul akar dan nama proyek.
Nama Perulangan IterationName String Nama yang ditentukan untuk Jalur Perulangan saat dibuat.
Jalur Perulangan IterationPath String Jalur lengkap Jalur Perulangan yang dimulai dengan simpul akar. Iterasi harus merupakan simpul yang valid dalam hierarki proyek.
System.IterationPath
Tanggal Mulai StartDate DateTime Tanggal mulai yang ditentukan untuk Jalur Perulangan.

Penting

  • Menghapus Jalur Area atau mengonfigurasi ulang Jalur Iterasi menyebabkan kehilangan data yang tidak dapat diubah. Misalnya, bagan widget burndown dan burnup, sprint burndown, dan bagan kecepatan untuk tim dengan Jalur Area yang diubah tidak akan menampilkan data yang akurat. Bagan tren historis mereferensikan Jalur Area dan Jalur Perulangan seperti yang ditentukan pada saat untuk setiap item kerja. Setelah dihapus, Anda tidak dapat mengambil data historis untuk jalur ini.
  • Anda hanya dapat menghapus jalur area dan iterasi yang tidak lagi digunakan oleh item kerja apa pun.

Properti navigasi untuk jenis entitas Iterasi dan kumpulan entitas Iterasi meliputi 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. Anda dapat menggunakan properti ini untuk memfilter atau melaporkan data pelacakan kerja berdasarkan jenis item kerja yang digunakan oleh proyek atau tim.

Catatan

Jenis entitas Proses dan set entitas Proses didukung dengan versi Analitik v-2.0, v3.0-preview, dan v4.0-preview.

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

Nama tampilan Nama Jenis data Keterangan
AnalyticsUpdatedDate DateTime 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 yang ditetapkan ke backlog yang terkait dengan jenis item kerja. Contohnya termasuk Microsoft.EpicCategory, Microsoft.FeatureCategory, Microsoft.RequirementCategory, 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 Jalur Perulangan saat dibuat.
Tingkat Backlog BacklogLevel String Menentukan tingkat backlog yang terkait dengan jenis item kerja. Jika jenis item kerja tidak terkait dengan tingkat backlog, nilai yang dikembalikan adalah null.
Tipe Item Kerja WorkItemType String Nama yang ditentukan untuk jenis item kerja.
Memiliki Backlog HasBacklog String Menunjukkan apakah jenis item kerja milik backlog.
Adalah Tipe Tersembunyi IsHiddenType Boolean Menunjukkan apakah jenis item kerja telah dinonaktifkan.
Adalah Jenis Bug IsBugType Boolean Menunjukkan apakah jenis item kerja termasuk dalam kategori Bug.
Dihapus IsDeleted Boolean Menunjukkan apakah jenis item kerja telah dihapus.

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

Jenis item kerja kustom dan kategori backlog kustom

Data untuk jenis item kerja kustom secara otomatis ditambahkan ke layanan Analytics.

Kategori kustom dibuat saat jenis item kerja kustom dan tingkat backlog ditentukan. Custom_ didahului ke kategori GUID. Misalnya, untuk jenis item kerja kustom Portofolio dengan backlog Portofolio, GUID ditetapkan ke kategori kustom, seperti Custom.49b81c4e-9c4f-4c04-94fd-d660cbf3a000.

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 Keterangan
Tag Id TagId GUID ID unik yang ditetapkan ke tag saat dibuat.
Nama Tag TagName String Nama tag.

Teams

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 Keterangan
AnalyticsUpdatedDate DateTime Marka air yang menunjukkan terakhir kali data Analytics diperbarui.
Id Tim TeamId GUID ID unik yang ditetapkan ke tim saat dibuat.
Nama Tim TeamName String Nama tim.

Properti navigasi untuk kumpulan entitas Teams meliputi Projects, , Areasdan Iterations.

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

Nama tampilan Nama Jenis data Keterangan
AnalyticsUpdatedDate DateTime Marka air yang menunjukkan terakhir kali data Analytics diperbarui.
WorkItemLinkSK Int32 Kunci pengganti yang ditetapkan ke WorkItemLink entitas.
Tanggal Dibuat CreatedDate GUID Tanggal saat tautan dibuat.
Komentar Comment String Komentar ditambahkan saat tautan dibuat.
Tanggal Dihapus DeletedDate String Tanggal saat tautan dihapus.
Id Tipe Tautan LinkTypeId Int32 ID yang ditetapkan ke item kerja target yang ditautkan.
Nama Tipe Tautan LinkTypeName String Nama ramah yang ditetapkan ke jenis tautan.
Nama Referensi Tipe Tautan LinkTypeReferenceName String Nama referensi yang ditetapkan ke jenis tautan.
Jenis Tautan Adalah Acyclic LinkTypeIsAcyclic Boolean Nilai atribut jenis tautan yang menunjukkan jenis tautan memungkinkan hubungan melingkar saat nilai diatur ke True. Misalnya, tautan jenis pohon membatasi hubungan melingkar.
Jenis Tautan Bersifat Terarah LinkTypeIsDirectional Boolean Nilai atribut jenis tautan yang menunjukkan 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 yang ditautkan.
Id Item Kerja Target TargetWorkItemId Int32 ID yang ditetapkan ke item kerja target yang ditautkan.

Properti navigasi untuk jenis entitas WorkItemLink meliputi Projects, , SourceWorkItemdan TargetWorkItem.

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

WorkItemTypeFields

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

Nama tampilan Nama Jenis data Keterangan
Nama Bidang FieldName String Nama yang mudah diingat ditetapkan ke bidang oleh sistem atau saat dibuat.
Nama Referensi Bidang FieldReferenceName String Nama referensi yang ditetapkan ke bidang oleh sistem atau saat bidang kustom dibuat.
Tipe Bidang FieldType String Jenis data yang ditetapkan ke bidang.
Tipe Item Kerja WorkItemType String Nama tipe item kerja yang didefinisikan bidangnya.

Properti navigasi meliputi Project.

Untuk indeks semua bidang yang ditentukan untuk proyek, lihat Deskripsi bidang untuk bidang item kerja. Untuk informasi tambahan, lihat 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 Membuat kueri OData untuk Analytics, komponen URL untuk mengkueri metadata. Contoh berikut menyediakan 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>