Power BI レポートに最終更新日を表示する

[アーティクル]
11/21/2024

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

レポートに最終更新日を追加すると、ユーザーはデータの最新の状態を理解するのに役立ちます。レポートのカードを使用して、最後のデータ更新の日付と時刻を表示できます。 Power BI でデータモデルを定期的に更新すると、すべての情報が最新の状態になります。

最後の更新日を追加する手順は、Power BI レポートのソース (Analytics ビュー、Power BI、OData クエリ) によって異なります。

Note

WorkItemRevision、WorkItem、WorkItemLink、TestRunなど、いくつかの Analytics エンティティの種類には、AnalyticsUpdatedDate プロパティが含まれます。このプロパティは、個々のエンティティ参照が更新された最新時刻を示します。

前提条件

Access:少なくとも Basic アクセス権を持つプロジェクトのメンバーである必要があります。
Permissions: 既定では、プロジェクトメンバーには Analytics にクエリを実行してビューを作成する権限があります。
サービスと機能の有効化と一般的なデータ追跡アクティビティに関するその他の前提条件の詳細については、「 Analytics にアクセスするためのアクセス許可と前提条件を参照してください。

Analytics ビューに基づいて最後の更新日を追加する

データセットの最後の更新日を含む列を追加するには、次の手順を実行します。

Power BI Desktop でビューに関連付けられている Power BI .pbix ファイルを読み込みます。
リボンの Queries セクションで、 Transform データ>Transform データを選択します。

詳細エディター を選択します。

クエリを変更しなかった場合は、Analytics ビューに一致する特定のテーブル値を使用して、次の例を確認してください。

プライベートビュー
共有ビュー

let
    Source = AzureDevOps.AnalyticsViews("{OrganizationName}", "{ProjectName}", []),
    #"Private Views_Folder" = Source{[Id="Private Views",Kind="Folder"]}[Data],
    #"{AnalyticsViewsID_Table}" = #"Private Views_Folder"{[Id="{AnalyticsViewsID}",Kind="Table"]}[Data],
    #"Added Refresh Date" = Table.AddColumn(#"{AnalyticsViewsID_Table}", "Refresh Date", each DateTimeZone.FixedUtcNow(), type datetimezone)
in
    #"Added Refresh Date"

let
    Source = AzureDevOps.AnalyticsViews("{OrganizationName}", "{ProjectName}", []),
    #"{AnalyticsViewsID_Table}" = Source{[Id="{AnalyticsViewsID}",Kind="Table"]}[Data]
in
    #"{AnalyticsViewsID_Table}"

次の構文に従ってクエリを変更します。

プライベートビュー
共有ビュー

let
    Source = AzureDevOps.AnalyticsViews("{OrganizationName}", "{ProjectName}", []),
    #"Private Views_Folder" = Source{[Id="Private Views",Kind="Folder"]}[Data],
    #"{AnalyticsViewsID_Table}" = #"Private Views_Folder"{[Id="{AnalyticsViewsID}",Kind="Table"]}[Data],
    #"Added Refresh Date" = Table.AddColumn(#"{AnalyticsViewsID_Table}", "Refresh Date", each DateTimeZone.FixedUtcNow(), type datetimezone)
in
    #"Added Refresh Date"

let
    Source = AzureDevOps.AnalyticsViews("{OrganizationName}", "{ProjectName}", []),
    #"{AnalyticsViewsID_Table}" = Source{[Id="{AnalyticsViewsID}",Kind="Table"]}[Data],
    #"Added Refresh Date" = Table.AddColumn(#"{AnalyticsViewsID_Table}", "Refresh Date", each DateTimeZone.FixedUtcNow(), type datetimezone)
in
    #"Added Refresh Date"

Note

これらの例では UTC を使用します。 DateTimeZone 関数で説明されているように、特定のタイムゾーンに基づいてクエリコードを調整できます。

完了を選択します。
[閉じる] & [適用 を選択して、データセットをすぐに更新します。

Power BI または OData クエリに基づいて最終更新日を追加する

Power BI で、 [データの取得>クエリを選択します。
クエリの名前を Last Refreshed Date に変更し、関数バーに次の数式を入力します。
日付データをテーブル形式に変換するには、 To Table>To Table を選択します。使用しているバージョンによっては、最初にInvokeパラメーターをする必要がある場合があります。

日付と共に 1 つの列が表示されます。
ヒント

To Table オプションが表示されない場合は、次の別の手順を使用して、最後の更新日時をレポートに追加できます。
1. [ Home タブを選択し、 Get Data を選択します。オプションから Blank Query を選択します。
2. [クエリ] ウィンドウで、新しいクエリを右選択し、詳細エディターを選択します。
3. 既存のコードを次のコードに置き換えて、現在の日付と時刻でテーブルを作成します。
```
let
Source = #table(
    {"Last Refresh Date"}, 
    {{DateTime.LocalNow()}}
)
in
Source
```
Transform メニューの Data Type ドロップダウンメニューを選択し、Date/Time オプションを選択します。
Column1 の名前を、Last Refresh Date など、より意味のある名前に変更します。
[ホーム] メニューの [ 閉じて適用を選択します。