Bagikan melalui

Referensi metadata tanggal kalender, Proyek, dan Pengguna untuk Azure DevOps Analytics

  • Artikel

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

Jenis entitas dan set entitas yang tercantum dalam tabel berikut dapat digunakan untuk memfilter dan membangun laporan berdasarkan data Analytics.

EntitySet EntityType Deskripsi
Tanggal CalendarDate Tanggal yang digunakan untuk memfilter dan mengelompokkan entitas lain menggunakan hubungan.
Proyek Proyek Proyek yang ditentukan untuk organisasi (cloud) atau koleksi proyek (lokal).
Pengguna Pengguna Informasi pengguna yang digunakan untuk memperluas atau memfilter berbagai properti item kerja, misalnya Ditetapkan Ke, Dibuat Oleh.

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.

Tanggal

Properti berikut ini valid untuk jenis entitas CalendarDate . Kunci pengganti yang terkait dengan CalendarDate adalah DateSK. Anda dapat menentukan properti tanggal kalender untuk memfilter dan menyusun laporan.

Nama tampilan Nama Jenis data Keterangan
IsLastDayOfPeriod Disebutkan Gunakan untuk memfilter data untuk menentukan apakah hari selesai dalam periode yang berbeda seperti hari, minggu, bulan, atau tahun. Nilai yang valid tercantum di bawah ini untuk Periode.
Tanggal Date DateTime Tanggal kalender tertentu.
Nama Hari DayName String Nama hari, seperti Senin, Selasa, Rabu, dan sebagainya.
Nama Pendek Hari DayShortName String Nama pendek yang ditetapkan untuk sehari, seperti Mon, Tue, Wed, dan sebagainya.
Hari Dalam Seminggu DayOfWeek Int32 Jumlah yang terkait dengan hari dalam seminggu.
Hari Dalam Sebulan DayOfMonth Int32 Angka yang terkait dengan hari dalam sebulan.
Hari Dalam Setahun DayOfYear Int32 Angka yang terkait dengan hari dalam setahun.
Tanggal Mulai Minggu WeekStartingDate DateTime Tanggal yang terkait dengan awal minggu.
Tanggal Akhir Minggu WeekEndingDate DateTime Tanggal yang terkait dengan akhir minggu.
Bulan Month String Nama singkatan dari sebulan dan tahun, misalnya, Jan 2022, Feb 2022, Mar 2022, dan sebagainya.
Nama Bulan MonthName String Nama sebulan, seperti Januari, Februari, Maret, dan sebagainya.
Nama Pendek Bulan MonthShortName String Singkatan nama sebulan, seperti Jan, Feb, Mar, dan sebagainya.
Bulan Dalam Setahun MonthOfYear Int32 Nomor yang ditetapkan ke sebulan. Misalnya 1, 2, dan 3 yang sesuai dengan Januari, Februari, dan Maret.
YearMonth YearMonth Int32 Angka yang sesuai dengan tahun dan bulan yang digabungkan. Misalnya, 202201, 202202, dan 202203 sesuai dengan Januari, Februari, dan Maret 2022.
Tahun Year Int32 Tahun berjalan, seperti 2019, 2020, 2021 dan sebagainya.

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.

Saat Menggabungkan data untuk entitas rekam jepret, Anda harus menyertakan DateSK atau DateValue kolom dalam klausul seperti yang groupby dijelaskan dalam panduan kueri OData. Misalnya laporan yang menentukan filter tanggal, lihat artikel berikut ini:

Jenis anggota yang dijumlahkan periode

Anggota berikut didefinisikan untuk Period jenis enumerasi yang bisa Anda gunakan dengan ekspresi filter lain untuk menghapus hari yang tidak menyelesaikan minggu atau bulan tertentu. Referensikan salah satu anggota ini untuk menentukan periode mingguan atau bulanan untuk kueri tren yang mencakup periode waktu yang lama. Jenis Period enumerasi memiliki atribut tunggal, IsFlags, yang diatur ke True.

Nama anggota Nilai Nama tampilan
None 0 Tidak
Day 1 Hari
WeekEndingOnSunday 2 Minggu berakhir pada hari Minggu
WeekEndingOnMonday 4 Minggu berakhir pada hari Senin
WeekEndingOnTuesday 8 Minggu berakhir pada hari Selasa
WeekEndingOnWednesday 16 Akhir Pekan Pada Hari Rabu
WeekEndingOnThursday 32 Akhir Pekan Pada Hari Kamis
WeekEndingOnFriday 64 Minggu berakhir pada hari Jumat
WeekEndingOnSaturday 128 Minggu berakhir pada hari Sabtu
Month 256 Month
Quarter 512 Kuartal
Year 1024 Tahun
All 2047 Semua

Proyek

Properti berikut ini valid untuk kumpulan entitas Proyek dan kunci ProjectSKpenggantinya . Saat membuat kueri cakupan organisasi, Anda bisa fokus pada satu atau beberapa proyek dengan menentukan satu atau beberapa Nama Proyek. Untuk informasi selengkapnya, lihat Kueri proyek dan cakupan organisasi.

Nama tampilan Nama Jenis data Keterangan
AnalyticsUpdatedDate DateTime Marka air yang menunjukkan terakhir kali data Analytics diperbarui.
Id Proyek ProjectId GUID Pengidentifikasi unik yang ditetapkan ke proyek saat dibuat.
Nama Proyek ProjectName String Nama yang ditetapkan ke proyek saat dibuat.
Visibilitas Proyek ProjectVisibility Disebutkan Menunjukkan apakah proyek bersifat publik atau privat. Nilai yang valid tercantum di bawah ini untuk ProjectVisibility.

Properti navigasi berikut ini valid untuk jenis entitas Proyek .

ProjectVisibility enumerated type members

Anggota berikut didefinisikan untuk ProjectVisibility jenis enumerasi. Referensikan salah satu anggota ini untuk memfilter proyek tertentu.

Nama anggota Nilai Nama tampilan
Private 0 Privat
Organization 1 Organization
Public 2 Publik

Pengguna

Properti berikut ini valid untuk kumpulan entitas Pengguna dan jenis entitas Pengguna dengan kunci UserSKpengganti .

Nama tampilan Nama Jenis data Keterangan
AnalyticsUpdatedDate DateTime Marka air yang menunjukkan terakhir kali data Analytics diperbarui.
Email Pengguna UserEmail String Email yang terkait dengan identitas akun pengguna.
Id Pengguna UserId GUID Pengidentifikasi unik yang ditetapkan ke identitas akun pengguna.
Nama Pengguna UserName String Nama yang ditetapkan untuk pengguna saat identitas akun pengguna dibuat.
Id Pengguna GitHub GitHubUserId String ID pengguna GitHub yang terkait dengan akun pengguna.
Jenis Pengguna UserType Adat Jenis pengguna. Nilai yang valid tercantum di bawah ini untuk UserType.

Anggota jenis enumerasi UserType

Anggota berikut didefinisikan untuk UserType jenis enumerasi.

Nama anggota Nilai Nama tampilan
Unknown 0 Tidak dikenal
Unrecognized 1 Tidak dikenal
User 2 Pengguna
Organization 3 Organization
Bot 4 Bot