次の方法で共有

Azure DevOps Analytics のカレンダー日付、プロジェクト、およびユーザー メタデータ リファレンス

  • [アーティクル]

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

次の表に示すエンティティ型とエンティティ セットを使用して、Analytics データに基づいてレポートをフィルター処理および作成できます。

EntitySet EntityType 説明
日付 CalendarDate リレーションシップを使用して他のエンティティをフィルター処理およびグループ化するために使用される日付。
プロジェクト プロジェクト 組織 (クラウド) またはプロジェクト コレクション (オンプレミス) に対して定義されたプロジェクト。
ユーザー User さまざまな作業項目のプロパティ ( 割り当て先、 作成者など) を展開またはフィルター処理するために使用されるユーザー情報。

Note

Analytics データ モデルでサポートされるエンティティ、プロパティ、列挙型の説明が提供されます。 これは初期のドラフトです。 詳細情報を取得したい領域に関するフィードバックをお寄せください。 データ モデルに対してクエリを実行するには、「 Analytics の OData クエリを作成する」を参照してください。

日付

次のプロパティは、 CalendarDate エンティティ型に対して有効です。 CalendarDateに関連付けられているサロゲート キーがDateSK。 カレンダーの日付プロパティを指定して、レポートをフィルター処理および構成できます。

[表示名] 名前 データの種類 説明
IsLastDayOfPeriod Enumerated データをフィルター処理して、日、週、月、年などの異なる期間で 1 日が終了するかどうかを判断するために使用します。 Period の有効な値を以下に示します。
日付 Date DateTime 特定のカレンダーの日付。
日の名前 DayName String 月曜日、火曜日、水曜日など、1 日の名前。
日の短い名前 DayShortName String 月、火、水など、1 日に割り当てられる短い名前。
曜日 DayOfWeek Int32 1 週間以内の日付に関連付けられた数値。
月の日 DayOfMonth Int32 1 か月以内の日に関連付けられた数値。
年の日 DayOfYear Int32 1 年の日に関連付けられた数値。
週の開始日 WeekStartingDate DateTime 週の開始日に関連付けられた日付。
週の終了日 WeekEndingDate DateTime 週の終わりに関連付けられた日付。
Month Month String 月と年の省略名 (例: Jan 2022、2022 年 2 月、2022 年 3 月など)。
月名 MonthName String 月の名前 (1 月、2 月、3 月など)。
月の短い名前 MonthShortName String 月の省略名 (1 月、2 月、3 月など)。
年の月 MonthOfYear Int32 月に割り当てられた数値。 たとえば、1 月、2 月、3 月に対応する 1、2、3 などです。
YearMonth YearMonth Int32 連結された年と月に対応する数値。 たとえば、202201、202202、202203は、2022 年 1 月、2 月、3 月に対応します。
Year Year Int32 年 (2019 年、2020 年、2021 年など)。

既定では、すべてのスナップショット テーブルは daily スナップショット ファクト テーブルとしてモデル化されます。 時間範囲のクエリを実行すると、各日の値が取得されます。 時間範囲が長い場合、多数のレコードが生成されます。 このような高精度が必要ない場合は、毎週または毎月のスナップショットを使用できます。

スナップショット エンティティのデータを集計する場合は、OData クエリ ガイドラインで説明されているように、groupby句にDateSKまたはDateValue列を含める必要があります。 日付フィルターを指定するレポートの例については、次の記事を参照してください。

Period 列挙型メンバー

次のメンバーは、特定の週または月が終了しない日を削除するために他のフィルター式と共に使用できる、 Period 列挙型に対して定義されています。 これらのメンバーのいずれかを参照して、長い期間にわたる傾向クエリの週単位または月単位の期間を指定します。 Period列挙型には、Trueに設定された 1 つの属性 (IsFlags) があります。

メンバー名 値 表示名
None 0 なし
Day 1 日付
WeekEndingOnSunday 2 日曜日に終了する週
WeekEndingOnMonday 4 月曜日に終了する週
WeekEndingOnTuesday 8 火曜日に終了する週
WeekEndingOnWednesday 16 水曜日に終了する週
WeekEndingOnThursday 32 木曜日に終了する週
WeekEndingOnFriday 64 金曜日に終了する週
WeekEndingOnSaturday 128 土曜日に終了する週
Month 256 Month
Quarter 512 四半期グラフ
Year 1024 Year
All 2047 すべて

プロジェクト

次のプロパティは、 Projects エンティティ セットとそのサロゲート キー ProjectSKに対して有効です。 組織スコープクエリを生成する場合は、1 つ以上の プロジェクト名を指定することで、1 つ以上のプロジェクトに集中できます。 詳細については、「 Project クエリと組織スコープクエリ」を参照してください。

[表示名] 名前 データの種類 説明
AnalyticsUpdatedDate DateTime 分析データが最後に更新された時刻を示す透かし。
プロジェクト ID ProjectId GUID プロジェクトの作成時に割り当てられる一意の識別子。
プロジェクト名 ProjectName String プロジェクトの作成時に割り当てられる名前。
プロジェクトの可視性 ProjectVisibility Enumerated プロジェクトがパブリックかプライベートかを示します。 ProjectVisibility の有効な値を次に示します。

次のナビゲーション プロパティは、 Project エンティティ型に対して有効です。

ProjectVisibility 列挙型メンバー

次のメンバーは、 ProjectVisibility 列挙型に対して定義されます。 これらのメンバーのいずれかを参照して、特定のプロジェクトをフィルター処理します。

メンバー名 値 表示名
Private 0 プライベート
Organization 1 組織
Public 2 パブリック

ユーザー

次のプロパティは、Users エンティティ セットおよび代理キー UserSKを持つ User エンティティ型に対して有効です。

[表示名] 名前 データの種類 説明
AnalyticsUpdatedDate DateTime 分析データが最後に更新された時刻を示す透かし。
ユーザーのメール UserEmail String ユーザー アカウント ID に関連付けられている電子メール。
ユーザー ID UserId GUID ユーザー アカウント ID に割り当てられた一意の識別子。
ユーザー名 UserName String ユーザー アカウント ID の作成時にユーザーに割り当てられる名前。
GitHub ユーザー ID GitHubUserId String ユーザー アカウントに関連付けられている GitHub ユーザー ID。
ユーザーの種類 UserType Custom ユーザーの種類。 UserType の有効な値を次に示します。

UserType 列挙型のメンバー

次のメンバーは、 UserType 列挙型に対して定義されます。

メンバー名 値 表示名
Unknown 0 認識
Unrecognized 1 認識
User 2 User
Organization 3 Organization
Bot 4 ボット