Bagikan melalui

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

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

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 dengan menggunakan hubungan antar entitas.
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

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.

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 TanggalWaktu Tanggal kalender tertentu.
Nama Hari DayName String Nama hari, seperti Senin, Selasa, Rabu, dan sebagainya.
Singkatan Nama Hari DayShortName String Nama pendek yang ditetapkan untuk sehari, seperti Mon, Tue, Wed, dan sebagainya.
Hari Dalam Seminggu DayOfWeek Int32 Nomor yang terkait dengan hari dalam sepekan.
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 TanggalWaktu Tanggal yang terkait dengan awal minggu.
Tanggal Akhir Minggu WeekEndingDate TanggalWaktu 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 bulan, seperti Januari, Februari, Maret, dan sebagainya.
Nama Pendek Bulan MonthShortName String Singkatan nama bulan, seperti Jan, Feb, Mar, dan seterusnya.
Bulan Dalam Setahun MonthOfYear Int32 Nomor yang ditetapkan ke sebuah bulan. 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, 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 rekaman jepret, Anda harus menyertakan kolom DateSK atau DateValue dalam klausul groupby seperti yang 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 ditetapkan 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 cakupan proyek dan organisasi.

Nama tampilan Nama Jenis data Keterangan
AnalyticsUpdatedDate TanggalWaktu Tanda air yang menunjukkan dengan kapan 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.
Keterlihatan 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 anggota tipe enumerasi

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

Nama anggota Nilai Nama tampilan
Private 0 Privat
Organization 1 Organisasi
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 TanggalWaktu Tanda air yang menunjukkan dengan kapan 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 Kustom Jenis pengguna. Nilai yang valid tercantum di bawah ini untuk UserType.

Anggota tipe enumerasi UserType

Anggota berikut didefinisikan untuk tipe enumerasi UserType.

Nama anggota Nilai Nama tampilan
Unknown 0 Tidak dikenal
Unrecognized 1 Tidak dikenal
User 2 Pengguna
Organization 3 Organisasi
Bot 4 Bot
  • Last updated on