Skip to content

Commit 3fdbcd8

Browse files
committed
update data available and cross-links
AB#1972624: Data Available and versioning? (Get started, Update-Consolidate, Phase 1)
1 parent 85f16dd commit 3fdbcd8

14 files changed

+37
-24
lines changed

docs/report/analytics/analytics-best-practices.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -45,7 +45,7 @@ Query the Analytics metadata to gain familiarity with the entity types, entity s
4545

4646
In addition, you can review select information from these resources:
4747
- [Analytics OData metadata](../extend-analytics/analytics-metadata.md)
48-
- [Analytics work item fields reference](../powerbi/analytics-fields-reference.md)
48+
- [Work item properties reference](../powerbi/analytics-fields-reference.md)
4949

5050

5151
## Structure your query to return the data you need
@@ -106,7 +106,7 @@ You specify columns of data to return using the `$select` clause. With customiza
106106

107107
For example, to return the ID, Work Item Type, Title, and State fields for a filtered set of work items, specify the following `$select` clause: `$select=WorkItemId, WorkItemType, Title, State`.
108108

109-
To lookup the list of properties and their corresponding field names, see [Analytics work item fields reference](../powerbi/analytics-fields-reference.md).
109+
To lookup the list of properties and their corresponding field names, see [Work item properties reference](../powerbi/analytics-fields-reference.md).
110110

111111
<!--- General info
112112
Analytics is built on top of a Columnstore Index technology. That means that data is both storage and query processing is column-based. So, the more properties that a query references, the more expensive it's to process.

docs/report/extend-analytics/analytics-metadata.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -231,7 +231,7 @@ Aggregation annotations define the set of [transformations](./odata-supported-fe
231231
- [Organization and project-scoped queries](account-scoped-queries.md).
232232
- [Data available from Analytics](../powerbi/data-available-in-analytics.md)
233233
- [Query work tracking data using Analytics](analytics-recipes.md)
234-
- [Analytics work item fields reference](../powerbi/analytics-fields-reference.md)
234+
- [Work item properties reference](../powerbi/analytics-fields-reference.md)
235235
236236
237237
## Related resources

docs/report/extend-analytics/analytics-recipes.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ Analytics. You can adapt most of these queries to meet your needs.
2020

2121
[!INCLUDE [temp](../includes/analytics-preview.md)]
2222

23-
For prerequisites and other information for getting started, see [Query your work tracking data using OData Analytics](wit-analytics.md) and [Analytics work item fields reference](../powerbi/analytics-fields-reference.md). All examples are scoped to a project on Azure DevOps. For examples of organization-level scoping or Azure DevOps Server, see [Project and organization-scoped queries](account-scoped-queries.md).
23+
For prerequisites and other information for getting started, see [Query your work tracking data using OData Analytics](wit-analytics.md) and [Work item properties reference](../powerbi/analytics-fields-reference.md). All examples are scoped to a project on Azure DevOps. For examples of organization-level scoping or Azure DevOps Server, see [Project and organization-scoped queries](account-scoped-queries.md).
2424

2525
::: moniker range="azure-devops"
2626
> [!TIP]

docs/report/extend-analytics/quick-ref.md

+4-4
Original file line numberDiff line numberDiff line change
@@ -92,11 +92,11 @@ Using OData, you can directly query Analytics for Azure DevOps from a supported
9292
:::column span="2":::
9393
- [Outcome summary](../powerbi/sample-pipelines-outcome-summary.md) (Power BI)
9494
- [Outcome summary for all pipelines](../powerbi/sample-pipelines-allpipelines.md) (Power BI)
95-
- [Pass rate trend](../powerbi/sample-pipelines-pass-rate-trend.md) (Power BI)
96-
- [Stage wise failures](../sample-pipelines-stagewise-failures.md) (Power BI)
95+
- [Pass rate trend](../powerbi/sample-pipelines-pass-rate-trend.md) (Power BI)
96+
- [Stage wise failures](../powerbi/sample-pipelines-stagewise-failures.md) (Power BI)
9797
- [Duration](../powerbi/sample-pipelines-duration.md) (Power BI)
98-
- [Duration trend](../powerbi/sample-pipelines-duration-trend.md) (Power BI)
99-
- [Task duration](../powerbi/sample-pipelines-task-duration.md) (Power BI)
98+
- [Duration trend](../powerbi/sample-pipelines-duration-trend.md) (Power BI)
99+
- [Task duration](../powerbi/sample-pipelines-task-duration.md) (Power BI)
100100
- [Task duration trend](../powerbi/sample-pipelines-task-duration-trend.md) (Power BI)
101101
:::column-end:::
102102
:::column span="2":::

docs/report/powerbi/analytics-default-views.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -64,7 +64,7 @@ Each default Analytics view provides a combination of options for work item type
6464

6565
Default views automatically include the most common fields for the included work item types used for reporting. All custom fields are included.
6666

67-
For example, the following fields are included when filtered for bugs and user stories. You can look up the description of most of these fields from the [Analytics work item fields reference](analytics-fields-reference.md) or [Work item field index](../../boards/work-items/guidance/work-item-field.md).
67+
For example, the following fields are included when filtered for bugs and user stories. You can look up the description of most of these fields from the [Work item properties reference](analytics-fields-reference.md) or [Work item field index](../../boards/work-items/guidance/work-item-field.md).
6868

6969
> [!div class="mx-imgBorder"]
7070
> ![Analytics views common fields](media/editable-views/common-fields.png)
@@ -84,7 +84,7 @@ In these cases, you can [create a custom Analytics view](analytics-views-create.
8484
- [Data available from Analytics](data-available-in-analytics.md)
8585
- [Dataset design for the Power BI Azure DevOps Connector](data-connector-dataset.md)
8686
- [Grant permissions to access Analytics](./analytics-security.md)
87-
- [Analytics work item fields reference](analytics-fields-reference.md)
87+
- [Work item properties reference](analytics-fields-reference.md)
8888

8989

9090
## Related resources

docs/report/powerbi/analytics-fields-reference.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ ms.date: 05/26/2022
1111
---
1212

1313

14-
# Analytics work item fields reference
14+
# Work item properties reference
1515

1616
[!INCLUDE [version-gt-eq-2019](../../includes/version-gt-eq-2019.md)]
1717

docs/report/powerbi/analytics-historical-filtering.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -84,5 +84,5 @@ To restate, when reporting on historical data, all filters are applied to the wo
8484

8585
## Related articles
8686

87-
- [Analytics work item fields reference](analytics-fields-reference.md)
87+
- [Work item properties reference](analytics-fields-reference.md)
8888
- [Data model for Analytics](../extend-analytics/data-model-analytics-service.md)

docs/report/powerbi/analytics-views-create.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -74,7 +74,7 @@ Enter a name for the view and provide a description. To allow others to view and
7474

7575
### Specify Work items filters
7676

77-
Specify filters to reduce the number of results returned by your view. In the work items section, you can add different filters on work item fields to scope your data. For a description of each available field, see [Analytics work item fields reference](analytics-fields-reference.md).
77+
Specify filters to reduce the number of results returned by your view. In the work items section, you can add different filters on work item fields to scope your data. For a description of each available field, see [Work item properties reference](analytics-fields-reference.md).
7878
> [!div class="mx-imgBorder"]
7979
> ![Specify Work items filters.](media/editable-views/work-items-default.png)
8080

docs/report/powerbi/analytics-views-manage.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -104,7 +104,7 @@ To delete a view, select the :::image type="icon" source="../media/icons/actions
104104
- [Grant permissions to access Analytics](./analytics-security.md)
105105
- [Power BI integration overview](overview.md)
106106
- [Query work tracking data using Analytics](../extend-analytics/analytics-recipes.md)
107-
- [Analytics work item fields reference](analytics-fields-reference.md)
107+
- [Work item properties reference](analytics-fields-reference.md)
108108

109109

110110
## Related resources

docs/report/powerbi/data-available-in-analytics.md

+19-6
Original file line numberDiff line numberDiff line change
@@ -14,8 +14,7 @@ ms.date: 08/12/2022
1414

1515
[!INCLUDE [version-gt-eq-2019](../../includes/version-gt-eq-2019.md)]
1616

17-
Analytics provides the reporting platform for Azure DevOps. Analytics is generally available for Azure DevOps Services and Azure DevOps Server 2020 and later versions. It is in preview for Azure DevOps Server 2019.
18-
17+
The data available to you from Analytics depends on the Azure DevOps platform and version you're using and the Analytics version you query.
1918

2019
::: moniker range=">= azure-devops-2019 < azure-devops-2022"
2120

@@ -24,7 +23,12 @@ Analytics provides the reporting platform for Azure DevOps. Analytics is general
2423
2524
::: moniker-end
2625

27-
Currently, you can access the following data from Analytics. This information was last updated on July 20, 2020.
26+
## Data available by platform version
27+
28+
Refer to the following table to determine the data you have access to. To determine the platform and version you're using, see [Get support and provide feedback, What platform am I using?](../../user-guide/provide-feedback.md#what-platformversion-am-i-using)
29+
30+
> [!NOTE]
31+
> The following table was last updated on August 2022.
2832
2933

3034
|**Service**|**Azure DevOps Services**<br/>**Azure DevOps Server 2020**<br/>**Azure DevOps Server 2022** |**Azure DevOps Server 2019**|**Future availability**|
@@ -36,13 +40,22 @@ Currently, you can access the following data from Analytics. This information wa
3640
|[Artifacts](https://azure.microsoft.com/services/devops/artifacts/) | None | None | Under investigation |
3741

3842

39-
> [!NOTE]
40-
> Analytics doesn't support reporting on plain text and HTML fields.
43+
## Analytics version
44+
45+
When you query Analytics, you always specify an Analytics version. The latest versions provides access to all supported EntityTypes and EntitySets. For details on the supported EntityTypes and EntitySets, see [Data model for Analytics](../extend-analytics/data-model-analytics-service.md).
4146

47+
| Analytics version | Supported Azure DevOps services |
48+
|------------------|----------------|
49+
| **v4.0-preview** | v3.0-preview plus snapshots related to pipeline jobs, task agent pool size, and task agent requests |
50+
| **v3.0-preview** | Azure Boards, Test Plans, and Azure Pipelines |
51+
| **v2.0** | Azure Boards only including Process data |
52+
| **v1.0** | Azure Boards only excluding Process data |
53+
54+
4255
## Next step
4356

4457
> [!div class="nextstepaction"]
45-
> [Dataset design for the Power BI Azure DevOps Connector](data-connector-dataset.md)
58+
> [Query Analytics in Azure DevOps](../analytics/analytics-query-parts.md)
4659
4760
## Related articles
4861

docs/report/powerbi/data-connector-dataset.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,7 @@ You can select all work tracking fields in an Analytics view, except for the fol
4848
> [!IMPORTANT]
4949
> Identity or person-name fields, such as Created By, Assigned To, etc., are selectable fields, however you can't select these fields at this time as field criteria for the purposes of filtering work items.
5050
51-
For a description of each work item tracking fields, see [Analytics work item fields reference](analytics-fields-reference.md).
51+
For a description of each work item tracking fields, see [Work item properties reference](analytics-fields-reference.md).
5252

5353

5454
### Analytics data store fields

docs/report/powerbi/toc.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -164,7 +164,7 @@ items:
164164
href: ../extend-analytics/data-model-analytics-service.md
165165
- name: Explore Analytics metadata
166166
href: ../extend-analytics/analytics-metadata.md
167-
- name: Analytics work item fields
167+
- name: Work item properties reference
168168
href: ../powerbi/analytics-fields-reference.md
169169
- name: Analytics views dataset design
170170
href: data-connector-dataset.md

docs/report/powerbi/what-are-analytics-views.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -91,7 +91,7 @@ For more information on how the dataset is modeled when using the Power BI Data
9191
- [What is Power BI Desktop?](/power-bi/fundamentals/desktop-what-is-desktop)
9292
- [Data available from Analytics](data-available-in-analytics.md)
9393
- [Query work tracking data using Analytics](../extend-analytics/analytics-recipes.md)
94-
- [Analytics work item fields reference](analytics-fields-reference.md)
94+
- [Work item properties reference](analytics-fields-reference.md)
9595

9696

9797
## Related resources

docs/report/sql-reports/analytics-insights-comparable-sql-reports.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -300,7 +300,7 @@ The following table summarizes Analytics reports, widgets, and other tools that
300300

301301
## Next steps
302302
> [!div class="nextstepaction"]
303-
> [Analytics work item fields reference](../powerbi/analytics-fields-reference.md)
303+
> [Work item properties reference](../powerbi/analytics-fields-reference.md)
304304
305305

306306
## Related articles

0 commit comments

Comments
 (0)