次の方法で共有

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

  • [アーティクル]

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

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

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

Note

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

Dates

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 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 年など)。

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

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

Period 列挙型メンバー

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

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

プロジェクト

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

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

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

ProjectVisibility 列挙型メンバー

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

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

Users

次のプロパティは、代理キーUserSKを持つ Users エンティティ セットと 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 ボット