Azure DevOps Services |Azure DevOps Server |Azure DevOps Server 2022
Azure DevOps 用 Data Connector には、クエリ作成者が使用できる Power Query M 関数が含まれています。 これらの関数は、認証などの Azure DevOps 固有の要件を処理できます。 この記事では、関数の引数と、それらを使用して Analytics に接続する方法について説明します。
VSTS。AccountContents 関数は、Power Query M 関数 Web.Contents に代わる関数です。 より高度なシナリオ (VSTS) を対象としています。AccountContents は、Analytics の URL からダウンロードしたコンテンツをバイナリ値として返します。 これを使用して 、AzureDevOps REST API を呼び出すことができます。
Important
- VSTS を使用します。AccountContents は 、Analytics で使用できないデータにアクセスする場合にのみ使用します。 Azure DevOps からデータを直接プルし、他の Azure DevOps ユーザーを保護するために、調整の影響を受けやすくなります。 VSTS でサポートされているサブドメインを参照してください。AccountContents セクションについては、この記事の後半で説明します。 その他の方法については、 Power BI 統合の概要を参照してください。
- VSTS。AccountContents では、Azure Boards データ (作業項目) のみがサポートされます。 データ コネクタは、パイプラインなどの他のデータ型をサポートしていません。 現時点では、他のデータ型をサポートするようにコネクタを更新する予定はありません。
VSTS。AccountContents
Analytics の URL からダウンロードした内容をバイナリ値として返す高度な関数。
VSTS.AccountContents関数には、Web.Contentsと同じ引数、オプション、戻り値の形式があります。 詳細については、「 Power Query (M) 数式リファレンス - Web.Contents」を参照してください。
Web.Contentsを使用して Analytics (REST API または OData) から作業追跡データに既にアクセスしている場合は、データ コネクタ認証を使用するVSTS.AccountContentsに置き換えることができます。 これらの要求が同じデータ ソースを参照していることを Power BI に通知します。 Power BI Service の単一のデータ ソース制約に違反することなく、データを結合できます。 ただし、 VSTS.AccountContent は Azure Boards からのデータのみをサポートしており、パイプラインやその他のサービスのクエリをサポートするために使用することはできません。
'VSTS。AccountContents' には、"OData.Contents" で使用できる引数とオプションのサブセットが用意されています。 具体的な制限事項については、次の表を参照してください。
VSTS の引数。内容
| Argument | Description |
|---|---|
url |
Azure DevOps サービス エンドポイントの 1 つへの URL。 |
options |
この関数の動作を制御するオプション レコード。 |
VSTS のオプション フィールド。内容
| フィールド | Description |
|---|---|
IsRetry |
この論理値を true に指定すると、データのフェッチ時にキャッシュ内の既存の応答が無視されます。 |
ManualStatusHandling |
この値をリストとして指定すると、応答にこれらの状態コードのいずれかが含まれる HTTP 要求に対する組み込み処理が禁止されます。 |
MaxSize |
クライアントが関心を持つテーブルの最大サイズを制御します。 要求がこの制限を超えた場合、サーバーはすぐに要求を失敗させることができます。 既定値は 0 で、サーバー サーバーに既定値を使用するように指示します。 |
Query |
プログラムによって URL にクエリ パラメーターを追加します。 |
RelativePath |
要求を行う前に、この値をテキストでベース URL に追加するように指定します。 |
Timeout |
期間としてこの値を指定すると、HTTP 要求のタイムアウトが変更されます。 既定値は 600 秒です。 |
Version |
データ モデルのバージョン。 このオプションは、診断のプライマリです。 |
VSTS でサポートされているサブドメイン。AccountContents
現在、 VSTS.AccountContents() メソッドは、以下に示すサブドメインでのみ機能します。 リリース サービスなどの他のサービスはまだサポートされていません。
https://dev.azure.com/https://analytics.dev.azure.com/https://vsrm.dev.azure.com/