From b78a10ccfe93104d7831d09190586eda63d9eb6b Mon Sep 17 00:00:00 2001 From: KathrynEE Date: Wed, 17 Mar 2021 12:00:17 -0700 Subject: [PATCH] marketplace toc and repos toc changes. (#2925) * marketplace toc and repos toc changes. AB#1788546: Get Started with the Marketplace * build fix * AB#1788546: Get Started with the Marketplace * updates to Develop extensions TOC * AB#1788547: Get Started developing extensions * fix build warnings * further refinements to toc * table format fix * 2nd level refinements * finishing up * editorial fix * format change * fix broken link --- docs/boards/get-started/manage-boards.md | 2 +- docs/extend/develop/add-query-result-tabs.md | 2 +- .../develop/media/query-results-pivot-tab.png | Bin 0 -> 6244 bytes docs/extend/develop/web-navigation.md | 4 +- docs/extend/toc.yml | 120 +++--- .../concepts/cross-origin-resource-sharing.md | 4 +- .../concepts/dotnet-client-libraries.md | 42 +- docs/integrate/concepts/rate-limits.md | 80 +++- .../authentication/authentication-guidance.md | 2 +- docs/integrate/index.md | 43 +-- .../quickstarts/work-item-quickstart.md | 11 +- docs/integrate/toc.yml | 358 +----------------- docs/marketplace-extensibility/toc.yml | 70 +++- docs/marketplace/faq-extensions.md | 158 -------- docs/marketplace/faq-extensions.yml | 138 +++++++ docs/marketplace/get-tfs-extensions.md | 16 +- .../uninstall-disable-extensions-tfs.md | 2 +- docs/marketplace/install-extension.md | 6 +- .../marketplace/media/top-publisher-badge.png | Bin 0 -> 1371 bytes docs/marketplace/overview.md | 4 +- docs/marketplace/request-extensions.md | 2 +- docs/marketplace/toc.yml | 20 +- docs/marketplace/trust.md | 88 ++++- ...group-global-organization-notifications.md | 14 +- .../accounts/change-time-zone.md | 4 +- docs/organizations/accounts/toc.yml | 2 + .../settings/set-your-preferences.md | 2 +- ...nd-usage.md => timezone-settings-usage.md} | 0 docs/organizations/toc.yml | 2 +- docs/report/dashboards/analytics-extension.md | 2 +- docs/repos/get-started/index.md | 6 +- docs/repos/get-started/toc.yml | 10 +- docs/repos/toc.yml | 9 +- 33 files changed, 491 insertions(+), 732 deletions(-) create mode 100644 docs/extend/develop/media/query-results-pivot-tab.png delete mode 100644 docs/marketplace/faq-extensions.md create mode 100644 docs/marketplace/faq-extensions.yml create mode 100644 docs/marketplace/media/top-publisher-badge.png rename docs/organizations/settings/{timezone-settings-and-usage.md => timezone-settings-usage.md} (100%) diff --git a/docs/boards/get-started/manage-boards.md b/docs/boards/get-started/manage-boards.md index eac91d8cf62..5573b53e265 100644 --- a/docs/boards/get-started/manage-boards.md +++ b/docs/boards/get-started/manage-boards.md @@ -114,7 +114,7 @@ If users believe they're getting too many notifications, they can [opt out of a ## Install and manage extensions -To add new features and capabilities to Azure Boards, install extensions from the [Azure DevOps Marketplace](https://marketplace.visualstudio.com/azuredevops). You can install [free, preview, or paid](../../marketplace/faq-extensions.md#difference) +To add new features and capabilities to Azure Boards, install extensions from the [Azure DevOps Marketplace](https://marketplace.visualstudio.com/azuredevops). You can install [free, preview, or paid](../../marketplace/faq-extensions.yml) To learn more, see [Install free extensions for Azure DevOps](../../marketplace/install-extension.md). To learn about building your own Azure DevOps extensions, see [developing](../../extend/overview.md) and [publishing](../../extend/publish/overview.md) extensions. diff --git a/docs/extend/develop/add-query-result-tabs.md b/docs/extend/develop/add-query-result-tabs.md index 5f0b3027719..e5221d6e42c 100644 --- a/docs/extend/develop/add-query-result-tabs.md +++ b/docs/extend/develop/add-query-result-tabs.md @@ -19,7 +19,7 @@ ms.date: 05/15/2018 If you have a web page that can be hosted in an iframe, it can be hosted in Azure DevOps as a tab on the query result pages. In this example, we'll add a simple Hello World tab on query results. -![Tab location on the Azure DevOps Query Results](/previous-versions/azure/devops/docs/extend/reference/targets/vss/work/web/media/queryResultsPivotTab.png) +![Tab location on the Azure DevOps Query Results.](media/query-results-pivot-tab.png) ## Create your web page diff --git a/docs/extend/develop/media/query-results-pivot-tab.png b/docs/extend/develop/media/query-results-pivot-tab.png new file mode 100644 index 0000000000000000000000000000000000000000..7e1f5e5911f2f0f69e085f003cbf6e999af6384b GIT binary patch literal 6244 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 [!TIP] @@ -52,32 +50,32 @@ Client libraries are available for .NET developers who build Windows apps and se ### REST packages -|Packages |Description |Binaries | -|---------|---------|---------| -|[Microsoft.VisualStudio.Services.Client​](https://www.nuget.org/packages/Microsoft.VisualStudio.Services.Client/) |Provides access to shared platform services, such as organization, profile, identity, security, and more, via public REST APIs. |`Microsoft.VisualStudio.Services.WebApi.dll`, `Microsoft.VisualStudio.Services.Common.dll`, `Microsoft.TeamFoundation.Common.dll` | -|[Microsoft.TeamFoundationServer.Client](https://www.nuget.org/packages/Microsoft.TeamFoundationServer.Client/)​ | Provides access to version control, work item tracking, build, and more via public REST APIs. | `Microsoft.TeamFoundation.Build2.WebApi.dll`, `Microsoft.TeamFoundation.Core.WebApi.dll`, `Microsoft.TeamFoundation.WorkItemTracking.Process.WebApi.dll`, `Microsoft.TeamFoundation.SourceControl.WebApi.dll`, `Microsoft.TeamFoundation.TestManagement.WebApi.dll`, and so on. | -|[Microsoft.VisualStudio.Services.InteractiveClient](https://www.nuget.org/packages/Microsoft.VisualStudio.Services.InteractiveClient/)​ |Supports applications that require interactive sign-in by a user. | `Microsoft.VisualStudio.Services.Client.Interactive.dll` | -|[Microsoft.VisualStudio.Services.Release.Client​](https://www.nuget.org/packages/Microsoft.VisualStudio.Services.Release.Client/) | Provides access to the Release Service via public REST APIs. |`Microsoft.VisualStudio.Services.ReleaseManagement.WebApi.dll` | -|[Microsoft.TeamFoundation.DistributedTask.Common.Contracts​](https://www.nuget.org/packages/Microsoft.TeamFoundation.DistributedTask.Common.Contracts) |Provides the models used to access the Distributed Task Service via public REST APIs. |`Microsoft.TeamFoundation.DistributedTask.Common.Contracts.dll` | -|[Microsoft.TeamFoundation.DistributedTask.WebApi](https://www.nuget.org/packages/Microsoft.TeamFoundation.DistributedTask.WebApi) |Provides access to the Distributed Task Service via public REST APIs. | `Microsoft.TeamFoundation.DistributedTask.WebApi.dll` | -|[Microsoft.VisualStudio.Services.ServiceHooks.WebApi](https://www.nuget.org/packages/Microsoft.VisualStudio.Services.ServiceHooks.WebApi)​ | Provides access to the Service Hooks Service via public REST APIs. |`Microsoft.VisualStudio.Services.ServiceHooks.WebApi.dll` | -|[Microsoft.VisualStudio.Services.Gallery.WebApi](https://www.nuget.org/packages/Microsoft.VisualStudio.Services.Gallery.WebApi) |Provides access to the Gallery Service via public REST APIs. |`Microsoft.VisualStudio.Services.Gallery.WebApi.dll` | -|[Microsoft.VisualStudio.Services.Notifications.WebApi](https://www.nuget.org/packages/Microsoft.VisualStudio.Services.Notifications.WebApi)​ | Provides access to the Notifications Service via public REST APIs. |`Microsoft.VisualStudio.Services.Notifications.WebApi.dll` | -|[Microsoft.VisualStudio.Services.ExtensionManagement.WebApi](https://www.nuget.org/packages/Microsoft.VisualStudio.Services.ExtensionManagement.WebApi) |Provides access to the Extension Management Service via public REST APIs. |`Microsoft.VisualStudio.Services.ExtensionManagement.WebApi.dll` | -|[Microsoft.VisualStudio.Services.MemberEntitlementManagement.WebApi](https://www.nuget.org/packages/Microsoft.VisualStudio.Services.MemberEntitlementManagement.WebApi) |Provides access to the Member Entitlement Management Service via public REST APIs. |`Microsoft.VisualStudio.Services.MemberEntitlementManagement.WebApi.dll` | -|[Microsoft.VisualStudio.Services.ServiceEndpoints.WebApi](https://www.nuget.org/packages/Microsoft.VisualStudio.Services.ServiceEndpoints.WebApi) ​ |Provides access to the Service Endpoints via public REST APIs. |`Microsoft.VisualStudio.Services.ServiceEndpoints.WebApi.dll` | -|[Microsoft.VisualStudio.Services.Search.Client](https://www.nuget.org/packages/Microsoft.VisualStudio.Services.Search.Client)|Provides access to the Search Service via public REST APIs. |`Microsoft.VisualStudio.Services.Search.Shared.WebApi.dll`, `Microsoft.VisualStudio.Services.Search.WebApi.dll` | -|[Microsoft.TeamFoundation.PublishTestResults​](https://www.nuget.org/packages/Microsoft.TeamFoundation.PublishTestResults) |This task can be used to Publish test results and upload test attachments on Azure DevOps. The following results formats are supported with this package: 1. JUnit - publish tests from Junit projects, 2. NUnit- publish tests from Nunit projects, 3. VSTest- publish tests from Visual Studio projects, 4. Xunit- publish tests from Xunit projects |`Microsoft.TeamFoundation.TestClient.PublishTestResults.dll` | -|[Microsoft.VisualStudio.Services.Audit.WebApi](https://www.nuget.org/packages/Microsoft.VisualStudio.Services.Audit.WebApi)​ | Provides access to the Audit Service via public REST APIs.|`Microsoft.VisualStudio.Services.Audit.WebApi.dll` | +|Packages and Description |Binaries | +|---------|--------------| +|[Microsoft.VisualStudio.Services.Client​](https://www.nuget.org/packages/Microsoft.VisualStudio.Services.Client/)
Provides access to shared platform services, such as organization, profile, identity, security, and more, via public REST APIs. |`Microsoft.VisualStudio.Services.WebApi.dll`, `Microsoft.VisualStudio.Services.Common.dll`, `Microsoft.TeamFoundation.Common.dll` | +|[Microsoft.TeamFoundationServer.Client](https://www.nuget.org/packages/Microsoft.TeamFoundationServer.Client/)​
Provides access to version control, work item tracking, build, and more via public REST APIs. | `Microsoft.TeamFoundation.Build2.WebApi.dll`, `Microsoft.TeamFoundation.Core.WebApi.dll`, `Microsoft.TeamFoundation.WorkItemTracking.Process.WebApi.dll`, `Microsoft.TeamFoundation.SourceControl.WebApi.dll`, `Microsoft.TeamFoundation.TestManagement.WebApi.dll`, and so on. | +|[Microsoft.VisualStudio.Services.InteractiveClient](https://www.nuget.org/packages/Microsoft.VisualStudio.Services.InteractiveClient/)​
Supports applications that require interactive sign-in by a user. | `Microsoft.VisualStudio.Services.Client.Interactive.dll` | +|[Microsoft.VisualStudio.Services.Release.Client​](https://www.nuget.org/packages/Microsoft.VisualStudio.Services.Release.Client/)
Provides access to the Release Service via public REST APIs. |`Microsoft.VisualStudio.Services.ReleaseManagement.WebApi.dll` | +|[Microsoft.TeamFoundation.DistributedTask.Common.Contracts​](https://www.nuget.org/packages/Microsoft.TeamFoundation.DistributedTask.Common.Contracts)
Provides the models used to access the Distributed Task Service via public REST APIs. |`Microsoft.TeamFoundation.DistributedTask.Common.Contracts.dll` | +|[Microsoft.TeamFoundation.DistributedTask.WebApi](https://www.nuget.org/packages/Microsoft.TeamFoundation.DistributedTask.WebApi)
Provides access to the Distributed Task Service via public REST APIs. | `Microsoft.TeamFoundation.DistributedTask.WebApi.dll` | +|[Microsoft.VisualStudio.Services.ServiceHooks.WebApi](https://www.nuget.org/packages/Microsoft.VisualStudio.Services.ServiceHooks.WebApi)​
Provides access to the Service Hooks Service via public REST APIs. |`Microsoft.VisualStudio.Services.ServiceHooks.WebApi.dll` | +|[Microsoft.VisualStudio.Services.Gallery.WebApi](https://www.nuget.org/packages/Microsoft.VisualStudio.Services.Gallery.WebApi)
Provides access to the Gallery Service via public REST APIs. |`Microsoft.VisualStudio.Services.Gallery.WebApi.dll` | +|[Microsoft.VisualStudio.Services.Notifications.WebApi](https://www.nuget.org/packages/Microsoft.VisualStudio.Services.Notifications.WebApi)​
Provides access to the Notifications Service via public REST APIs. |`Microsoft.VisualStudio.Services.Notifications.WebApi.dll` | +|[Microsoft.VisualStudio.Services.ExtensionManagement.WebApi](https://www.nuget.org/packages/Microsoft.VisualStudio.Services.ExtensionManagement.WebApi)
Provides access to the Extension Management Service via public REST APIs. |`Microsoft.VisualStudio.Services.ExtensionManagement.WebApi.dll` | +|[Microsoft.VisualStudio.Services.MemberEntitlementManagement.WebApi](https://www.nuget.org/packages/Microsoft.VisualStudio.Services.MemberEntitlementManagement.WebApi)
Provides access to the Member Entitlement Management Service via public REST APIs. |`Microsoft.VisualStudio.Services.MemberEntitlementManagement.WebApi.dll` | +|[Microsoft.VisualStudio.Services.ServiceEndpoints.WebApi](https://www.nuget.org/packages/Microsoft.VisualStudio.Services.ServiceEndpoints.WebApi)
Provides access to the Service Endpoints via public REST APIs. |`Microsoft.VisualStudio.Services.ServiceEndpoints.WebApi.dll` | +|[Microsoft.VisualStudio.Services.Search.Client](https://www.nuget.org/packages/Microsoft.VisualStudio.Services.Search.Client)
Provides access to the Search Service via public REST APIs. |`Microsoft.VisualStudio.Services.Search.Shared.WebApi.dll`, `Microsoft.VisualStudio.Services.Search.WebApi.dll` | +|[Microsoft.TeamFoundation.PublishTestResults​](https://www.nuget.org/packages/Microsoft.TeamFoundation.PublishTestResults)
This task can be used to Publish test results and upload test attachments on Azure DevOps. The following results formats are supported with this package: 1. JUnit - publish tests from Junit projects, 2. NUnit- publish tests from Nunit projects, 3. VSTest- publish tests from Visual Studio projects, 4. Xunit- publish tests from Xunit projects |`Microsoft.TeamFoundation.TestClient.PublishTestResults.dll` | +|[Microsoft.VisualStudio.Services.Audit.WebApi](https://www.nuget.org/packages/Microsoft.VisualStudio.Services.Audit.WebApi)​
Provides access to the Audit Service via public REST APIs.|`Microsoft.VisualStudio.Services.Audit.WebApi.dll` | > [!TIP] > If you have an existing Windows application or service that uses the TFS Client Object Model, use Microsoft.TeamFoundationServer.ExtendedClient. ### Soap package -|Package |Description |Binaries | -|---------|---------|---------| -|[Microsoft.TeamFoundationServer.ExtendedClient​](https://www.nuget.org/packages/Microsoft.TeamFoundationServer.ExtendedClient/) | Work with and manage version control, work items, and build, and other resources from your client application. This package doesn't support Net Standard Client OM. Only use this package when our REST APIs don't offer the functionality you need (for example, creating workspaces in TFVC)|`Microsoft.TeamFoundation.Build.Client.dll`, `Microsoft.TeamFoundation.DeleteTeamProject.dll`, `Microsoft.TeamFoundation.Diff.dll`, `Microsoft.TeamFoundation.Git.Client.dll`, `Microsoft.TeamFoundation.SharePointReporting.Integration.dll` , and so on. | +|**Package and Description** |**Binaries** | +|---------|------------| +|[Microsoft.TeamFoundationServer.ExtendedClient​](https://www.nuget.org/packages/Microsoft.TeamFoundationServer.ExtendedClient/)
Work with and manage version control, work items, and build, and other resources from your client application. This package doesn't support Net Standard Client OM. Only use this package when our REST APIs don't offer the functionality you need (for example, creating workspaces in TFVC) |`Microsoft.TeamFoundation.Build.Client.dll`, `Microsoft.TeamFoundation.DeleteTeamProject.dll`, `Microsoft.TeamFoundation.Diff.dll`, `Microsoft.TeamFoundation.Git.Client.dll`, `Microsoft.TeamFoundation.SharePointReporting.Integration.dll`, and so on. | ### Install diff --git a/docs/integrate/concepts/rate-limits.md b/docs/integrate/concepts/rate-limits.md index 1eab1bd8e26..b3a777b0845 100644 --- a/docs/integrate/concepts/rate-limits.md +++ b/docs/integrate/concepts/rate-limits.md @@ -83,6 +83,7 @@ If a pipeline is delayed or blocked by rate limiting, a message appears in the a @@ -110,19 +112,77 @@ The following table lists the headers available and what they mean. Except for `X-RateLimit-Delay`, all of these headers get sent before requests start getting delayed. This design gives clients the opportunity to proactively slow down their rate of requests. -| Header name | Description | -|-------------|-------------| -| `Retry-After` | The [RFC 6585](https://tools.ietf.org/html/rfc6585#section-4")-specified header sent to tell you how long to wait before you send your next request to fall under the detection threshold. Units: seconds. | -| `X-RateLimit-Resource` | A custom header indicating the service and type of threshold that was reached. Threshold types and service names may vary over time and without warning. We recommend displaying this string to a human, but not relying on it for computation. | -| `X-RateLimit-Delay` | How long the request was delayed. Units: seconds with up to 3 decimal places (milliseconds). | -| `X-RateLimit-Limit` | Total number of TSTUs allowed before delays are imposed. | -| `X-RateLimit-Remaining` | Number of TSTUs remaining before being delayed. If requests are already being delayed or blocked, it's 0. | -| `X-RateLimit-Reset` | Time at which, if all resource consumption stopped immediately, tracked usage would return to 0 TSTUs. Expressed in Unix epoch time. | + + +:::row::: + :::column span="1"::: + **Header name** + :::column-end::: + :::column span="2"::: + **Description** + :::column-end::: +:::row-end::: +--- +:::row::: + :::column span="1"::: + `Retry-After` + :::column-end::: + :::column span="2"::: + The [RFC 6585](https://tools.ietf.org/html/rfc6585#section-4")-specified header sent to tell you how long to wait before you send your next request to fall under the detection threshold. Units: seconds. + :::column-end::: +:::row-end::: +--- +:::row::: + :::column span="1"::: + `X-RateLimit-Resource` + :::column-end::: + :::column span="2"::: + A custom header indicating the service and type of threshold that was reached. Threshold types and service names may vary over time and without warning. We recommend displaying this string to a human, but not relying on it for computation. + :::column-end::: +:::row-end::: +--- +:::row::: + :::column span="1"::: + `X-RateLimit-Delay` + :::column-end::: + :::column span="2"::: + How long the request was delayed. Units: seconds with up to 3 decimal places (milliseconds). + :::column-end::: +:::row-end::: +--- +:::row::: + :::column span="1"::: + `X-RateLimit-Limit` + :::column-end::: + :::column span="2"::: + Total number of TSTUs allowed before delays are imposed. + :::column-end::: +:::row-end::: +--- +:::row::: + :::column span="1"::: + `X-RateLimit-Remaining` + :::column-end::: + :::column span="2"::: + Number of TSTUs remaining before being delayed. If requests are already being delayed or blocked, it's 0. + :::column-end::: +:::row-end::: +--- +:::row::: + :::column span="1"::: + `X-RateLimit-Reset` + :::column-end::: + :::column span="2"::: + Time at which, if all resource consumption stopped immediately, tracked usage would return to 0 TSTUs. Expressed in Unix epoch time. + :::column-end::: +:::row-end::: +--- + ### Recommendations -We recommend that you at least respond to the `Retry-After` header. -If you detect a `Retry-After` header in any response, wait until that amount of time has passed before sending another request. +We recommend that you at least respond to the `Retry-After` header. +If you detect a `Retry-After` header in any response, wait until that amount of time has passed before sending another request. Doing so helps your client application experience fewer enforced delays. If possible, we further recommend that you monitor `X-RateLimit-Remaining` and `X-RateLimit-Limit` headers. diff --git a/docs/integrate/get-started/authentication/authentication-guidance.md b/docs/integrate/get-started/authentication/authentication-guidance.md index 661995b0b47..febe6fe6aba 100644 --- a/docs/integrate/get-started/authentication/authentication-guidance.md +++ b/docs/integrate/get-started/authentication/authentication-guidance.md @@ -11,7 +11,7 @@ author: chcomley ms.date: 03/05/2021 --- -# Choosing the right authentication mechanism +# Choose the right authentication mechanism [!INCLUDE [version-all](../../../includes/version-all.md)] diff --git a/docs/integrate/index.md b/docs/integrate/index.md index 2345ec7b7a7..d97c2987a5a 100644 --- a/docs/integrate/index.md +++ b/docs/integrate/index.md @@ -4,56 +4,25 @@ ms.topic: conceptual title: Integrating custom apps and third party services with Azure DevOps description: Overview of integrating with Azure DevOps. ms.assetid: c9b97ad7-ffd8-4657-8322-74f764eec5c9 -monikerRange: "<= azure-devops" +monikerRange: ">= tfs-2018" ms.author: chcomley author: chcomley -ms.date: 08/23/2016 +ms.date: 03/15/2021 --- # Integrate applications -[!INCLUDE [version-all](../includes/version-all.md)] +[!INCLUDE [version-all](../includes/version-vsts-tfs-2018.md)] -You can build custom applications or services that integrate with your Azure DevOps accounts by using the **REST APIs** to make direct HTTP calls, or utilize our **.NET Client Libraries**. +You can build custom applications or services that integrate with Azure DevOps by using the **REST APIs** to make direct HTTP calls, or use our **.NET Client Libraries**. Along with interacting with Azure DevOps in your application, you can also integrate with popular third-party services such as Slack or Jenkins. -## 5-minute quickstarts - -Check out the quick starts to get you started: +To get started, see: - [Create a bug](./quickstarts/create-bug-quickstart.md) - [Get work items using queries](./quickstarts/work-item-quickstart.md) - -## Concepts - -- [Best practices](./concepts/integration-bestpractices.md) -- [.NET client libraries](./concepts/dotnet-client-libraries.md) -- [Authentication](./get-started/authentication/authentication-guidance.md) -- [Service hooks](./concepts/service-hooks.md) -- [REST API overview](rest-api-overview.md) -- [REST API versioning](./concepts/rest-api-versioning.md) -- [Cross-origin resource sharing](./concepts/cross-origin-resource-sharing.md) -- [Rate limits](./concepts/rate-limits.md) -- [Deprecation of Work Item Tracking (WIT) & Test Client OM](./concepts/wit-client-om-deprecation.md) -- [Migration Guide](./concepts/migration-guide.md) - -## Samples - -- [Custom application samples](./get-started/client-libraries/samples.md) -- [.NET samples for Azure DevOps on GitHub](https://github.com/Microsoft/vsts-dotnet-samples) - -## How-to guides - -- [Get started with REST APIs](how-to/call-rest-api.md) -- [Authenticate with PATs](../organizations/accounts/use-personal-access-tokens-to-authenticate.md) -- [Authenticate with OAuth 2.0](./get-started/authentication/oauth.md) -- [Create service hooks subscriptions programmatically](../service-hooks/create-subscription.md?toc=/azure/devops/integrate/toc.json) - -## Reference - -- [Service hooks consumers and action reference](../service-hooks/consumers.md?toc=/azure/devops/integrate/toc.json) -- [Service hooks events reference](../service-hooks/events.md?toc=/azure/devops/integrate/toc.json) + ## Resources diff --git a/docs/integrate/quickstarts/work-item-quickstart.md b/docs/integrate/quickstarts/work-item-quickstart.md index 285839f2dcd..5dec7874580 100644 --- a/docs/integrate/quickstarts/work-item-quickstart.md +++ b/docs/integrate/quickstarts/work-item-quickstart.md @@ -10,13 +10,14 @@ author: chcomley ms.date: 06/27/2017 --- -# Fetch work items with queries programmatically in Azure DevOps Services +# Fetch work items with queries programmatically [!INCLUDE [version-vsts-only](../../includes/version-vsts-only.md)] A common scenario in Azure DevOps Services is to fetch work items using queries. This guide details how to implement that scenario programmatically using our REST APIs or .NET client libraries. ## Prerequisites + You need the following prerequisites: * An organization in Azure DevOps Services. If you don't have one, you can [create one for free](https://go.microsoft.com/fwlink/?LinkId=307137) @@ -28,6 +29,7 @@ You need the following prerequisites: To learn about C# programming within Visual Studio, find the [Visual Studio C# programming documentation](/dotnet/csharp/programming-guide/inside-a-program/) ## C# code content + There are a few things happening in the following code sample: 1. Authenticating @@ -39,6 +41,7 @@ There are a few things happening in the following code sample: 3. Get each of the work items by ID ## C# code snippet + ```cs // nuget:Microsoft.TeamFoundationServer.Client using System; @@ -138,7 +141,7 @@ public class QueryExecutor } ``` -## Next Steps +## Related articles -* Check out another Quickstart: [Create a bug](./create-bug-quickstart.md) -* Explore the [integrate samples](../get-started/client-libraries/samples.md) +- [Create a bug](./create-bug-quickstart.md) +- [Integrate samples](../get-started/client-libraries/samples.md) diff --git a/docs/integrate/toc.yml b/docs/integrate/toc.yml index 3836be96cff..4d6a12458cf 100644 --- a/docs/integrate/toc.yml +++ b/docs/integrate/toc.yml @@ -1,364 +1,34 @@ - name: Integrate applications href: index.md?toc=/azure/devops/marketplace-extensibility/toc.json&bc=/azure/devops/marketplace-extensibility/breadcrumb/toc.json -- name: Quickstarts +- name: Get started items: - name: Create a bug href: quickstarts/create-bug-quickstart.md - name: Query work items href: quickstarts/work-item-quickstart.md -- name: Samples - items: - - name: .NET - href: get-started/client-libraries/samples.md - - name: .NET (Legacy) - href: get-started/client-libraries/soapSamples.md - - name: REST API Samples - href: get-started/rest/samples.md -- name: Concepts - items: - name: Best practices href: ./concepts/integration-bestpractices.md - - name: .NET client libraries - href: ./concepts/dotnet-client-libraries.md - - name: Authentication - href: ./get-started/authentication/authentication-guidance.md - name: Service hooks href: ./concepts/service-hooks.md + - name: Create service hooks subscriptions programmatically + href: ../service-hooks/create-subscription.md + - name: Call REST API + href: how-to/call-rest-api.md - name: REST API versioning href: ./concepts/rest-api-versioning.md + - name: .NET client libraries + href: ./concepts/dotnet-client-libraries.md - name: Cross-origin resource sharing href: ./concepts/cross-origin-resource-sharing.md - - name: Rate limits - href: ./concepts/rate-limits.md - - name: Deprecation of WIT & Test client OM - href: ./concepts/wit-client-om-deprecation.md - - name: Migration Guide - href: ./concepts/migration-guide.md -- name: How-to guides +- name: Samples items: - - name: Authenticate with PATs - href: ../organizations/accounts/use-personal-access-tokens-to-authenticate.md?bc=%252fazure%252fdevops%252fmarketplace-extensibility%252fbreadcrumb%252ftoc.json&toc=%252fazure%252fdevops%252fmarketplace-extensibility%252ftoc.json - - name: Authenticate with OAuth 2.0 - href: ./get-started/authentication/oauth.md - - name: Cross-platform CLI for Azure DevOps using PATs - href: ./get-started/auth/tfs-basic-auth.md - - name: Create service hooks subscriptions programmatically - href: ../service-hooks/create-subscription.md - - name: Call REST API - href: how-to/call-rest-api.md + - name: .NET + href: get-started/client-libraries/samples.md + - name: .NET (Legacy) + href: get-started/client-libraries/soapSamples.md + - name: REST API Samples + href: get-started/rest/samples.md - name: Create a PR status server href: ../repos/git/create-pr-status-server.md?toc=/azure/devops/marketplace-extensibility/toc.json&bc=/azure/devops/marketplace-extensibility/breadcrumb/toc.json - name: Use Azure Functions to create custom branch policies href: ../repos/git/create-pr-status-server-with-azure-functions.md?toc=/azure/devops/marketplace-extensibility/toc.json&bc=/azure/devops/marketplace-extensibility/breadcrumb/toc.json -- name: Reference - items: - - name: REST API reference overview - href: rest-api-overview.md - - name: Azure DevOps Services REST API - href: /rest/api/azure/devops/?view=azure-devops-rest-5.1 - - name: REST APIs for TFS 2015, 2017, and 2018 - items: - - name: Overview - href: /previous-versions/azure/devops/integrate/previous-apis/overview - - name: Build - href: /previous-versions/azure/devops/integrate/previous-apis/build/overview - items: - - name: Builds - href: /previous-versions/azure/devops/integrate/previous-apis/build/builds - - name: Definition templates - href: /previous-versions/azure/devops/integrate/previous-apis/build/definition-templates - - name: Definitions - href: /previous-versions/azure/devops/integrate/previous-apis/build/definitions - - name: Tags - href: /previous-versions/azure/devops/integrate/previous-apis/build/tags - - name: Chat - href: /previous-versions/azure/devops/integrate/previous-apis/chat/overview - items: - - name: Messages - href: /previous-versions/azure/devops/integrate/previous-apis/chat/messages - - name: Rooms - href: /previous-versions/azure/devops/integrate/previous-apis/chat/rooms - - name: Users - href: /previous-versions/azure/devops/integrate/previous-apis/chat/users - - name: Dashboards - href: /previous-versions/azure/devops/integrate/previous-apis/dashboard/overview - items: - - name: Dashboards - href: /previous-versions/azure/devops/integrate/previous-apis/dashboard/dashboards - - name: Widgets - href: /previous-versions/azure/devops/integrate/previous-apis/dashboard/widgets - - name: Endpoints - href: /previous-versions/azure/devops/integrate/previous-apis/endpoints/overview - items: - - name: Endpoints - href: /previous-versions/azure/devops/integrate/previous-apis/endpoints/endpoints - - name: Endpoint types - href: /previous-versions/azure/devops/integrate/previous-apis/endpoints/endpoint-types - - name: Git - href: /previous-versions/azure/devops/integrate/previous-apis/git/overview - items: - - name: Annotated Tags - href: /previous-versions/azure/devops/integrate/previous-apis/git/annotatedtags - - name: Blobs - href: /previous-versions/azure/devops/integrate/previous-apis/git/blobs - - name: Commits - href: /previous-versions/azure/devops/integrate/previous-apis/git/commits - - name: Diffs - href: /previous-versions/azure/devops/integrate/previous-apis/git/diffs - - name: Import requests - href: /previous-versions/azure/devops/integrate/previous-apis/git/import-requests - - name: Items - href: /previous-versions/azure/devops/integrate/previous-apis/git/items - - name: Pull Requests - href: /previous-versions/azure/devops/integrate/previous-apis/git/pull-requests/overview - items: - - name: Iterations - href: /previous-versions/azure/devops/integrate/previous-apis/git/pull-requests/iterations - - name: Pull requests - href: /previous-versions/azure/devops/integrate/previous-apis/git/pull-requests/pull-requests - - name: Reviewers - href: /previous-versions/azure/devops/integrate/previous-apis/git/pull-requests/reviewers - - name: Threads - href: /previous-versions/azure/devops/integrate/previous-apis/git/pull-requests/threads - - name: Work items - href: /previous-versions/azure/devops/integrate/previous-apis/git/pull-requests/work-items - - name: Pushes - href: /previous-versions/azure/devops/integrate/previous-apis/git/pushes - - name: References - href: /previous-versions/azure/devops/integrate/previous-apis/git/refs - - name: Repositories - href: /previous-versions/azure/devops/integrate/previous-apis/git/repositories - - name: Stats - href: /previous-versions/azure/devops/integrate/previous-apis/git/stats - - name: Trees - href: /previous-versions/azure/devops/integrate/previous-apis/git/trees - - name: Hooks - href: /previous-versions/azure/devops/integrate/previous-apis/hooks/overview - items: - - name: Consumers - href: /previous-versions/azure/devops/integrate/previous-apis/hooks/consumers - - name: Publishers - href: /previous-versions/azure/devops/integrate/previous-apis/hooks/publishers - - name: Subscriptions - href: /previous-versions/azure/devops/integrate/previous-apis/hooks/subscriptions - - name: Notification - href: /previous-versions/azure/devops/integrate/previous-apis/notification/overview - items: - - name: Contracts - href: /previous-versions/azure/devops/integrate/previous-apis/notification/contracts - - name: Event types - href: /previous-versions/azure/devops/integrate/previous-apis/notification/eventtypes - - name: Subscriptions - href: /previous-versions/azure/devops/integrate/previous-apis/notification/subscriptions - - name: Packaging - href: /previous-versions/azure/devops/integrate/previous-apis/packaging/overview - items: - - name: Feeds - href: /previous-versions/azure/devops/integrate/previous-apis/packaging/feeds - - name: Maven - href: /previous-versions/azure/devops/integrate/previous-apis/packaging/maven - - name: Npm - href: /previous-versions/azure/devops/integrate/previous-apis/packaging/npm - - name: NuGet - href: /previous-versions/azure/devops/integrate/previous-apis/packaging/nuget - - name: Packages - href: /previous-versions/azure/devops/integrate/previous-apis/packaging/packages - - name: Permissions - href: /previous-versions/azure/devops/integrate/previous-apis/packaging/permissions - - name: Polling - href: /previous-versions/azure/devops/integrate/previous-apis/packaging/polling - - name: Views - href: /previous-versions/azure/devops/integrate/previous-apis/packaging/views - - name: Policy - href: /previous-versions/azure/devops/integrate/previous-apis/policy/overview - items: - - name: Configurations - href: /previous-versions/azure/devops/integrate/previous-apis/policy/configurations - - name: Settings - href: /previous-versions/azure/devops/integrate/previous-apis/policy/settings - - name: Types - href: /previous-versions/azure/devops/integrate/previous-apis/policy/types - - name: Queues - href: /previous-versions/azure/devops/integrate/previous-apis/queues/overview - - name: Release management - href: /previous-versions/azure/devops/integrate/previous-apis/rm/overview - items: - - name: Approvals - href: /previous-versions/azure/devops/integrate/previous-apis/rm/approvals - - name: Contracts - href: /previous-versions/azure/devops/integrate/previous-apis/rm/contracts - - name: Definitions - href: /previous-versions/azure/devops/integrate/previous-apis/rm/definitions - - name: Releases - href: /previous-versions/azure/devops/integrate/previous-apis/rm/releases - - name: Security - href: /previous-versions/azure/devops/integrate/previous-apis/security/overview - items: - - name: Access Control Entries (ACEs) - href: /previous-versions/azure/devops/integrate/previous-apis/security/aces - - name: Access Control Lists (ACLs) - href: /previous-versions/azure/devops/integrate/previous-apis/security/acls - - name: Permissions - href: /previous-versions/azure/devops/integrate/previous-apis/security/permissions - - name: Security namespaces - href: /previous-versions/azure/devops/integrate/previous-apis/security/securitynamespaces - - name: Tokens - href: /previous-versions/azure/devops/integrate/previous-apis/security/tokens - - name: Test - href: /previous-versions/azure/devops/integrate/previous-apis/test/overview - items: - - name: Attachments - href: /previous-versions/azure/devops/integrate/previous-apis/test/attachments - - name: Cases - href: /previous-versions/azure/devops/integrate/previous-apis/test/cases - - name: Clone operations - href: /previous-versions/azure/devops/integrate/previous-apis/test/cloneOperations - - name: Code coverage - href: /previous-versions/azure/devops/integrate/previous-apis/test/code-coverage - - name: Configurations - href: /previous-versions/azure/devops/integrate/previous-apis/test/configurations - - name: Plans - href: /previous-versions/azure/devops/integrate/previous-apis/test/plans - - name: Points - href: /previous-versions/azure/devops/integrate/previous-apis/test/points - - name: Result retention settings - href: /previous-versions/azure/devops/integrate/previous-apis/test/resultretentionsettings - - name: Results 1.0 - href: /previous-versions/azure/devops/integrate/previous-apis/test/results_1_0 - - name: Results - href: /previous-versions/azure/devops/integrate/previous-apis/test/results - - name: Runs - href: /previous-versions/azure/devops/integrate/previous-apis/test/runs - - name: Sessions - href: /previous-versions/azure/devops/integrate/previous-apis/test/sessions - - name: Suite entries - href: /previous-versions/azure/devops/integrate/previous-apis/test/suite-entries - - name: Suites - href: /previous-versions/azure/devops/integrate/previous-apis/test/suites - - name: Variables - href: /previous-versions/azure/devops/integrate/previous-apis/test/variables - - name: TFS - href: /previous-versions/azure/devops/integrate/previous-apis/tfs/overview - items: - - name: Contracts - href: /previous-versions/azure/devops/integrate/previous-apis/tfs/contracts - - name: Processes - href: /previous-versions/azure/devops/integrate/previous-apis/tfs/processes - - name: Project collections - href: /previous-versions/azure/devops/integrate/previous-apis/tfs/project-collections - - name: Projects - href: /previous-versions/azure/devops/integrate/previous-apis/tfs/projects - - name: Samples - href: /previous-versions/azure/devops/integrate/previous-apis/tfs/samples - - name: Teams - href: /previous-versions/azure/devops/integrate/previous-apis/tfs/teams - - name: TFVC - href: /previous-versions/azure/devops/integrate/previous-apis/tfvc/overview - items: - - name: Branches - href: /previous-versions/azure/devops/integrate/previous-apis/tfvc/branches - - name: Changesets - href: /previous-versions/azure/devops/integrate/previous-apis/tfvc/changesets - - name: Items - href: /previous-versions/azure/devops/integrate/previous-apis/tfvc/items - - name: Labels - href: /previous-versions/azure/devops/integrate/previous-apis/tfvc/labels - - name: Shelvesets - href: /previous-versions/azure/devops/integrate/previous-apis/tfvc/shelvesets - - name: Work item tracking - href: /previous-versions/azure/devops/integrate/previous-apis/wit/overview - items: - - name: Artifact link types - href: /previous-versions/azure/devops/integrate/previous-apis/wit/artifactlinktypes - - name: Artifact URI query - href: /previous-versions/azure/devops/integrate/previous-apis/wit/artifacturiquery - - name: Attachments - href: /previous-versions/azure/devops/integrate/previous-apis/wit/attachments - - name: Batch - href: /previous-versions/azure/devops/integrate/previous-apis/wit/batch - - name: Categories - href: /previous-versions/azure/devops/integrate/previous-apis/wit/categories - - name: Classification nodes - href: /previous-versions/azure/devops/integrate/previous-apis/wit/classification-nodes - - name: Comments - href: /previous-versions/azure/devops/integrate/previous-apis/wit/comments - - name: Fields - href: /previous-versions/azure/devops/integrate/previous-apis/wit/fields - - name: History - href: /previous-versions/azure/devops/integrate/previous-apis/wit/history - - name: Queries - href: /previous-versions/azure/devops/integrate/previous-apis/wit/queries - - name: Recycle Bin - href: /previous-versions/azure/devops/integrate/previous-apis/wit/recycle-bin - - name: Relation types - href: /previous-versions/azure/devops/integrate/previous-apis/wit/relation-types - - name: Reporting work item links - href: /previous-versions/azure/devops/integrate/previous-apis/wit/reporting-work-item-links - - name: Reporting work item revisions - href: /previous-versions/azure/devops/integrate/previous-apis/wit/reporting-work-item-revisions - - name: Revisions - href: /previous-versions/azure/devops/integrate/previous-apis/wit/revisions - - name: Samples - href: /previous-versions/azure/devops/integrate/previous-apis/wit/samples - - name: Tags - href: /previous-versions/azure/devops/integrate/previous-apis/wit/tags - - name: Templates - href: /previous-versions/azure/devops/integrate/previous-apis/wit/templates - - name: Updates - href: /previous-versions/azure/devops/integrate/previous-apis/wit/updates - - name: Work item query language - href: /previous-versions/azure/devops/integrate/previous-apis/wit/wiql - - name: Work item types - href: /previous-versions/azure/devops/integrate/previous-apis/wit/work-item-types - - name: Work items - href: /previous-versions/azure/devops/integrate/previous-apis/wit/work-items - - name: Work - href: /previous-versions/azure/devops/integrate/previous-apis/work/overview - items: - - name: Backlog configuration - href: /previous-versions/azure/devops/integrate/previous-apis/work/backlog-configuration - - name: Boards - href: /previous-versions/azure/devops/integrate/previous-apis/work/boards - - name: Capacity - href: /previous-versions/azure/devops/integrate/previous-apis/work/capacity - - name: Card fields - href: /previous-versions/azure/devops/integrate/previous-apis/work/card-fields - - name: Card rules - href: /previous-versions/azure/devops/integrate/previous-apis/work/card-rules - - name: Charts - href: /previous-versions/azure/devops/integrate/previous-apis/work/charts - - name: Columns - href: /previous-versions/azure/devops/integrate/previous-apis/work/columns - - name: Delivery timeline - href: /previous-versions/azure/devops/integrate/previous-apis/work/delivery-timeline - - name: Iterations - href: /previous-versions/azure/devops/integrate/previous-apis/work/iterations - - name: Plans - href: /previous-versions/azure/devops/integrate/previous-apis/work/plans - - name: Process configuration - href: /previous-versions/azure/devops/integrate/previous-apis/work/process-configuration - - name: Rows - href: /previous-versions/azure/devops/integrate/previous-apis/work/rows - - name: Team days off - href: /previous-versions/azure/devops/integrate/previous-apis/work/team-days-off - - name: Team field values - href: /previous-versions/azure/devops/integrate/previous-apis/work/team-field-values - - name: Team settings - href: /previous-versions/azure/devops/integrate/previous-apis/work/team-settings - - name: XAML Build - href: /previous-versions/azure/devops/integrate/previous-apis/xamlbuild/overview - items: - - name: Builds - href: /previous-versions/azure/devops/integrate/previous-apis/xamlbuild/builds - - name: Definition - href: /previous-versions/azure/devops/integrate/previous-apis/xamlbuild/definitions - - name: Qualities - href: /previous-versions/azure/devops/integrate/previous-apis/xamlbuild/qualities - - name: Queues - href: /previous-versions/azure/devops/integrate/previous-apis/xamlbuild/queues - - name: Requests - href: /previous-versions/azure/devops/integrate/previous-apis/xamlbuild/requests -- name: Troubleshooting - items: - - name: IIS Basic Authentication and PATs - href: get-started/authentication/iis-basic-auth.md \ No newline at end of file diff --git a/docs/marketplace-extensibility/toc.yml b/docs/marketplace-extensibility/toc.yml index 3d31eb71ba6..d81a450b5ae 100644 --- a/docs/marketplace-extensibility/toc.yml +++ b/docs/marketplace-extensibility/toc.yml @@ -1,34 +1,71 @@ - name: Marketplace & extensibility href: index.yml -- name: Discover & manage extensions +- name: What are extensions? + href: ../extend/overview.md +- name: Marketplace extensions + href: ../marketplace/overview.md +- name: Get started href: ../marketplace/toc.yml + items: +- name: Authenticate + items: + - name: Guide to authentication + href: ../integrate/get-started/authentication/authentication-guidance.md + - name: Authenticate extensions and security + href: ../extend/develop/auth.md + - name: Authenticate with PATs + href: ../organizations/accounts/use-personal-access-tokens-to-authenticate.md?bc=%252fazure%252fdevops%252fmarketplace-extensibility%252fbreadcrumb%252ftoc.json&toc=%252fazure%252fdevops%252fmarketplace-extensibility%252ftoc.json + - name: Authenticate with OAuth 2.0 + href: ../integrate/get-started/authentication/oauth.md + - name: Cross-platform CLI for Azure DevOps using PATs + href: ../integrate/get-started/auth/tfs-basic-auth.md + - name: IIS Basic Authentication and PATs + href: ../integrate/get-started/authentication/iis-basic-auth.md - name: Develop extensions href: ../extend/toc.yml +- name: Integrate with Service Hooks + href: ../service-hooks/toc.yml - name: Integrate applications href: ../integrate/toc.yml -- name: Service hooks - href: ../service-hooks/toc.yml -- name: Additional integrations +- name: Microsoft Teams & Slack items: - name: Azure Boards with Slack href: ../boards/integrations/boards-slack.md?toc=/azure/devops/marketplace-extensibility/toc.json&bc=/azure/devops/marketplace-extensibility/breadcrumb/toc.json + - name: Azure Boards with Microsoft Teams + href: ../boards/integrations/boards-teams.md?toc=/azure/devops/marketplace-extensibility/toc.json&bc=/azure/devops/marketplace-extensibility/breadcrumb/toc.json - name: Azure Pipelines with Slack href: ../pipelines/integrations/slack.md?toc=/azure/devops/marketplace-extensibility/toc.json&bc=/azure/devops/marketplace-extensibility/breadcrumb/toc.json - name: Azure Pipelines with Microsoft Teams href: ../pipelines/integrations/microsoft-teams.md?toc=/azure/devops/marketplace-extensibility/toc.json&bc=/azure/devops/marketplace-extensibility/breadcrumb/toc.json -- name: REST API and Client Reference + - name: Azure Repos with Slack + href: ../repos/integrations/repos-slack.md?toc=/azure/devops/marketplace-extensibility/toc.json&bc=/azure/devops/marketplace-extensibility/breadcrumb/toc.json + - name: Azure Repos with Microsoft Teams + href: ../repos/integrations/repos-teams.md?toc=/azure/devops/marketplace-extensibility/toc.json&bc=/azure/devops/marketplace-extensibility/breadcrumb/toc.json +- name: Reference items: - - name: REST APIs - href: /rest/api/azure/devops/ - - name: .NET client libraries reference - href: /dotnet/api/index?view=azure-devops-dotnet -- name: Marketplace Extensions + - name: REST API reference overview + href: ../integrate/rest-api-overview.md + - name: Rate limits + href: ../integrate/concepts/rate-limits.md + - name: Deprecation of WIT & Test client OM + href: ../integrate/concepts/wit-client-om-deprecation.md + - name: Migrate code to REST-based .NET Client Libraries + href: ../integrate/concepts/migration-guide.md + - name: .NET client libraries reference + href: /dotnet/api/index?view=azure-devops-dotnet + - name: Azure DevOps Services REST API >> + href: /rest/api/azure/devops/ + - name: REST APIs for TFS 2015, 2017, and 2018 >> + href: /previous-versions/azure/devops/integrate/previous-apis/overview +- name: Marketplace extensions items: - - name: Visual Studio Marketplace - href: https://marketplace.visualstudio.com/ - - name: Find and use Visual Studio extensions + - name: Extensions for Azure DevOps >> + href: https://marketplace.visualstudio.com/azuredevops + - name: Azure Boards extensions developed by Microsoft + href: ../boards/extensions/index.md?toc=/azure/devops/marketplace-extensibility/toc.json&bc=/azure/devops/marketplace-extensibility/breadcrumb/toc.json + - name: Find and use Visual Studio extensions >> href: /visualstudio/ide/finding-and-using-visual-studio-extensions - - name: Install Visual Studio Code extensions + - name: Install Visual Studio Code extensions >> href: https://code.visualstudio.com/docs/editor/extension-gallery - name: Resources items: @@ -36,11 +73,10 @@ href: https://visualstudio.microsoft.com/team-services/tfs-pricing/ - name: Billing href: ../organizations/billing/overview.md - - name: Manage & Configure Resources - href: ../organizations/index.yml - name: Build Visual Studio extensions href: /visualstudio/extensibility/shipping-visual-studio-extensions - name: Build apps for Windows href: /windows/apps/ - name: Mobile application development in Microsoft - href: /azure/mobile-apps/ \ No newline at end of file + href: /azure/mobile-apps/ + diff --git a/docs/marketplace/faq-extensions.md b/docs/marketplace/faq-extensions.md deleted file mode 100644 index 5c4d408831b..00000000000 --- a/docs/marketplace/faq-extensions.md +++ /dev/null @@ -1,158 +0,0 @@ ---- -title: FAQs about getting extensions for Azure DevOps -description: Frequently asked questions about getting and paying for extensions for Azure DevOps. -ms.technology: devops-marketplace -ms.assetid: fecee97a-b715-4d8d-b500-7b3b559eacc7 -ms.author: chcomley -author: chcomley -ms.date: 07/23/2020 -monikerRange: '>= tfs-2015' -ms.topic: conceptual ---- - -# FAQs - getting extensions for Azure DevOps - -[!INCLUDE [version-ts-tfs-2015-2016](../includes/version-ts-tfs-2015-2016.md)] - -In this article, find frequently asked questions and answers about getting extensions for Azure DevOps. Included are FAQs about installing, requesting, assigning, and accessing extensions. You can also find [links to get support](#q-how-do-i-get-support-for-the-marketplace). - -::: moniker range="azure-devops" - -### Q: Who can install extensions for Azure DevOps? - -A: The organization Owner and Project Collection Administrator can install extensions. If you don't have permissions, but you're an organization member, -you can [request extensions](request-extensions.md) instead. - - - -### Q: How do I find the organization Owner? - -If you have at least Basic access, you can find the current owner in your organization settings. - -1. Go to your **Organization settings**. - - ![Open Organization settings](../media/settings/open-admin-settings-vert.png) - -2. Find the current owner. - - ![Find the current owner in organization information](../media/find-organization-owner.png) - - - -[!INCLUDE [no-organizations](../organizations/billing/includes/qa-no-organizations.md)] - -### Q: Why can't I install extensions for Azure DevOps? - -A: You can't install extensions for one of the following reasons. - - - -* You must have [Project Collection Administrator or organization Owner permissions](../organizations/security/lookup-organization-owner-admin.md). -If you don't have permissions, but you're an organization member, you can [request extensions](request-extensions.md) instead. - - - -* If you get an "already installed or requested" error check with your Project Collection Administrator -or organization Owner, and ask them to assign the extension to you. - -::: moniker-end - -::: moniker range="<= azure-devops-2020" - - - - - -### Q: How do I get other help or support for Azure subscriptions and billing? - -A: Check these [articles about Azure billing and subscriptions](/azure/?tag=billing), -the [Azure Billing and Subscription FAQ](https://azure.microsoft.com/documentation/articles/billing-subscription-faq/), -or try [Azure Support](https://azure.microsoft.com/support/options/). - -[!INCLUDE [what-happened-preview-extensions](../includes/qa-what-happened-preview-extensions.md)] - - - - - - - -### Q: Why can't I install extensions for Azure DevOps Server? - -A: You can't install extensions for Azure DevOps Server for one of the following reasons: - -* You must be a member of the [Project Collection Administrators group](../organizations/security/set-project-collection-level-permissions.md) -with [**Edit collection-level information** permissions](../organizations/security/permissions.md#collection) in the project collection where you want to install extensions. If you don't have permissions, you can [request extensions](./request-extensions.md) instead. - -* If you get an error that your extension is already installed or requested, check with your Project Collection Administrator and ask them to assign the extension to you. - - - - - -### Q: Why don't I see the project collection I want? - -A: You must be a member of your project collection. -Follow these steps to check your identity that you use -to sign in to the Marketplace. - -1. On your Azure DevOps Server web portal home page (```https://{server}:8080/tfs/```), - go to the top-right corner of the page, and select your user name to view your profile. -2. On the left side of your profile, make sure that your email address and directory are correct. -3. Close all browser windows. -4. Open a private or incognito browsing session. -5. Sign in to your Azure DevOps Server home page (```https://{server}:8080/tfs/```) - with the identity that's a user in the project collection - where you want to install the extension. - - If you're asked to choose "work or school organization" or "personal account", this means you used an email address that's the same for a Microsoft account and a "work or school account" that's managed by your organization in Azure Active Directory. Although these identities have the same email address, they're still separate identities with different profiles, security settings, and permissions. Choose the identity that's the user in your project collection. - -6. From your project collection, go to the Marketplace. - - - -### Q: Why doesn't the extension that I want show a download button? - -A: Some extensions work only with Azure DevOps Services for one of the following reasons: - -- The extension uses Azure DevOps features that aren't released yet for Azure DevOps Server. -- The [extension manifest](../extend/develop/manifest.md) indicates that the extension -is available only for Azure DevOps Services (targets = Microsoft.Visualstudio.Services.Cloud). -- The extension manifest indicates that the extension is an integration (targets = Microsoft.Visualstudio.Services.Integration). - - - -### Q: Why can't I upload extensions to Azure DevOps Server? - -A: You must be a member of the -[Team Foundation Administrators group](/azure/devops/server/admin/add-administrator#add-a-user-to-the-server-administrators-group). You must also have [**Edit instance-level information** permissions](../organizations/security/permissions.md#server) -for the Azure DevOps Server where you want to upload extensions. - - - -[!INCLUDE [no-access-extension-features](../includes/qa-no-access-extension-features.md)] - - - - - -[!INCLUDE [marketplace-support](includes/qa-marketplace-support.md)] - -::: moniker-end - -### Q: How do I get support for the Marketplace? - -A: Depending on the support you need, choose from the following links: - -* Billing questions - [Azure billing support](https://portal.azure.com/#blade/Microsoft_Azure_Support/HelpAndSupportBlade) -* Visual Studio subscriptions - [subscriptions support](https://visualstudio.microsoft.com/subscriptions/support) -* Help with Azure DevOps - [Azure DevOps support](https://developercommunity.visualstudio.com/spaces/21/index.html) -* General Marketplace help - [Contact the Marketplace team](mailto:vsmarketplace@microsoft.com) - -## Related articles - -- [Azure DevOps billing overview](../organizations/billing/overview.md) -- [Azure DevOps billing FAQ](../organizations/billing/billing-faq.md) -- [How to pay for Azure DevOps Server users](../organizations/billing/buy-access-tfs-test-hub.md) -- [How to buy Visual Studio cloud subscriptions](/visualstudio/subscriptions/vscloud-overview) -- [Visual Studio cloud subscription billing FAQ](/visualstudio/subscriptions/vscloud-billing-faq) \ No newline at end of file diff --git a/docs/marketplace/faq-extensions.yml b/docs/marketplace/faq-extensions.yml new file mode 100644 index 00000000000..4c7773f5a8f --- /dev/null +++ b/docs/marketplace/faq-extensions.yml @@ -0,0 +1,138 @@ +### YamlMime:FAQ +metadata: + title: FAQs about getting extensions for Azure DevOps + description: Frequently asked questions about getting and paying for extensions for Azure DevOps + titleSuffix: Azure DevOps + ms.technology: devops-marketplace + ms.author: chcomley + author: chcomley + ms.topic: troubleshooting + monikerRange: '>= tfs-2015' + ms.date: 03/15/2021 + + +title: FAQs for acquiring Azure DevOps extensions + + +summary: | + **Azure Boards | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2015** + + Find frequently asked questions and answers about getting extensions for Azure DevOps. Included are FAQs about installing, requesting, assigning, and accessing extensions. + +sections: + - name: FAQs + + questions: + + - question: Who can install extensions? + answer: | + A member of the Project Collection Administrators group can install extensions. If you don't have permissions, but you're a project member, + you can [request extensions](request-extensions.md) instead. + + - question: How do I find a member of the Project Administrators group? + answer: | + See [Increase permission levels, find an admin](../organizations/security/lookup-organization-owner-admin.md). + + - question: Why don't I see my organization from the Marketplace install page? + answer: | + If you don't see your organization when buying from the Azure DevOps Marketplace, try these steps: + + 1. Check the identity that you use to sign in to the Visual Studio Marketplace. In the upper-right corner, select your user name to view your profile. + 1. On the left, make sure your email address and directory are correct. + 1. Close all browser windows. + 1. Open a private or incognito browsing session. + 1. Sign in to the Visual Studio Marketplace. Use the identity of a user in the organization that you want. + + > [!TIP] + > If you're asked to choose "work or school account" or "personal account", then you used an email address that's the same for a Microsoft account and a "work or school account" that's managed by your organization in Azure Active Directory. Although these identities have the same email address, they're still separate identities with different profiles, security settings, and permissions. + > + > Choose the identity for the user in the organization that you want to select. + + - question: Why can't I install an extension? + answer: | + You can't install extensions for one of the following reasons. + - You must have [Project Collection Administrator or organization Owner permissions](../organizations/security/lookup-organization-owner-admin.md). If you don't have permissions, but you're a project member, you can [request extensions](request-extensions.md) instead. + - If you get an "already installed or requested" error check with your Project Collection Administrator, and ask them to assign the extension to you. + + + - question: Why can't users access extension features? + answer: | + Users may be unable to access an extension for one of the following reasons: + - Most extensions require that users have at least Basic access, not Stakeholder. For example, you can install the free [Code Search extension](https://marketplace.visualstudio.com/items?itemName=ms.vss-code-search), but each user must have at least Basic access to search for code. To help your team improve app quality, you can install the free [Test & Feedback extension](https://marketplace.visualstudio.com/items?itemName=ms.vss-exploratorytesting-web), but you'll get different capabilities based on your access level and whether you work offline or connected to Azure DevOps Services or on-premises Azure DevOps Server. For more details, see the extension's description in the [Visual Studio Marketplace](https://marketplace.visualstudio.com/azuredevops), Azure DevOps tab. + + - If you're using an organization, and you started a free extension trial, your trial might have expired. To check whether your trial expired: + 1. On your organization toolbar, go to **Users**. + 2. Go to the extension pane. + 3. Check for an expiration message to find if or when your extension expired. + + - If you're using an organization, and you paid for this extension, make sure that you assigned this extension to users. + 1. On your organization toolbar, go to **Users**. + 2. Go to the extension pane. + 3. Check whether the extension is assigned to the user. If it is not, assign the extension to the user. + + Learn more about [assigning extensions to users](../marketplace/install-extension.md). + + - question: How do I get other help or support for Azure subscriptions and billing? + answer: | + Check these [articles about Azure billing and subscriptions](https://docs.microsoft.com/search/?terms=billing&scope=%22Azure%20DevOps%22), the [Azure Billing and Subscription FAQ](https://azure.microsoft.com/en-us/pricing/faq/), or try [Azure Support](https://azure.microsoft.com/support/options/). + + - question: What happened to my preview extension? + answer: | + Your extension imay have been moved out of preview. After a preview period, an extension longer is generally available as a paid extension. A grace period may be offered before you have to buy the extension. All preview extensions automatically convert to a [free trial](../organizations/billing/try-additional-features-vs.md) before you have to buy the extension. + + - question: Why can't I install extensions for Azure DevOps Server? (on-premises) + answer: | + You can't install extensions for Azure DevOps Server for one of the following reasons: + - You must be a member of the [Project Collection Administrators group](../organizations/security/set-project-collection-level-permissions.md) with [**Edit collection-level information** permissions](../organizations/security/permissions.md#collection) in the project collection where you want to install extensions. If you don't have permissions, you can [request extensions](./request-extensions.md) instead. + - If you get an error that your extension is already installed or requested, check with your Project Collection Administrator and ask them to assign the extension to you. + + - question: Why don't I see the project collection I want? (on-premises) + answer: | + You must be a member of your project collection. Follow these steps to check your identity that you use to sign in to the Marketplace. + + 1. On your Azure DevOps Server web portal home page (```https://{server}:8080/tfs/```), go to the top-right corner of the page, and select your user name to view your profile. + 2. On the left side of your profile, make sure that your email address and directory are correct. + 3. Close all browser windows. + 4. Open a private or incognito browsing session. + 5. Sign in to your Azure DevOps Server home page (```https://{server}:8080/tfs/```) with the identity that's a user in the project collection where you want to install the extension. + + If you're asked to choose "work or school organization" or "personal account", this means you used an email address that's the same for a Microsoft account and a "work or school account" that's managed by your organization in Azure Active Directory. Although these identities have the same email address, they're still separate identities with different profiles, security settings, and permissions. Choose the identity that's the user in your project collection. + + 6. From your project collection, go to the Marketplace. + + - question: Why doesn't the extension that I want show a download button? (on-premises) + answer: | + Some extensions work only with Azure DevOps Services for one of the following reasons: + - The extension uses Azure DevOps features that aren't released yet for Azure DevOps Server. + - The [extension manifest](../extend/develop/manifest.md) indicates that the extension is available only for Azure DevOps Services (targets = Microsoft.Visualstudio.Services.Cloud). + - The extension manifest indicates that the extension is an integration (targets = Microsoft.Visualstudio.Services.Integration). + + - question: Why can't I upload extensions to Azure DevOps Server? (on-premises) + answer: | + You must be a member of the [Team Foundation Administrators group](/azure/devops/server/admin/add-administrator#add-a-user-to-the-server-administrators-group). You must also have [**Edit instance-level information** permissions](../organizations/security/permissions.md#server) for the Azure DevOps Server where you want to upload extensions. + + - question: How do I get support for the Azure DevOps Marketplace? + answer: | + Depending on the support you need, choose from the following: + - Billing questions -- [Azure billing support](https://portal.azure.com/#blade/Microsoft_Azure_Support/HelpAndSupportBlade) + - Visual Studio subscriptions -- [subscriptions support](https://visualstudio.microsoft.com/subscriptions/support) + - Help with Azure DevOps -- [Azure DevOps support](https://developercommunity.visualstudio.com/spaces/21/index.html) + - General Marketplace help -- [Contact the Azure DevOps Marketplace team](mailto:vsmarketplace@microsoft.com) + + - question: How do I get support for the Marketplace? + answer: | + Depending on the support you need, choose from the following links: + - Billing questions - [Azure billing support](https://portal.azure.com/#blade/Microsoft_Azure_Support/HelpAndSupportBlade) + - Visual Studio subscriptions - [subscriptions support](https://visualstudio.microsoft.com/subscriptions/support) + - Help with Azure DevOps - [Azure DevOps support](https://developercommunity.visualstudio.com/spaces/21/index.html) + - General Marketplace help - [Contact the Marketplace team](mailto:vsmarketplace@microsoft.com) + +additionalContent: | + ## Related articles + - [Azure DevOps billing overview](../organizations/billing/overview.md) + - [Azure DevOps billing FAQ](../organizations/billing/billing-faq.md) + - [How to pay for Azure DevOps Server users](../organizations/billing/buy-access-tfs-test-hub.md) + - [How to buy Visual Studio cloud subscriptions](/visualstudio/subscriptions/vscloud-overview) + - [Visual Studio cloud subscription billing FAQ](/visualstudio/subscriptions/vscloud-billing-faq) + + *Have a question that didn't get answered? Feel free to ask it through one of the feedback links provided below.* \ No newline at end of file diff --git a/docs/marketplace/get-tfs-extensions.md b/docs/marketplace/get-tfs-extensions.md index 3bd27859df5..17d39964910 100644 --- a/docs/marketplace/get-tfs-extensions.md +++ b/docs/marketplace/get-tfs-extensions.md @@ -1,6 +1,6 @@ --- title: Install extensions for on-premises servers -description: Find and install extensions for Azure DevOps Server from the Visual Studio Marketplace. +description: Find and install extensions for Azure DevOps Server from the Azure DevOps Marketplace. ms.topic: conceptual ms.technology: devops-marketplace ms.assetid: 0ff7d264-68b7-4f4a-a666-b57175b5fdb8 @@ -12,10 +12,10 @@ monikerRange: '>= tfs-2015 < azure-devops' # Install extensions for on-premises servers -[!INCLUDE [version-tfs-all-versions](../includes/version-tfs-all-versions.md)] +[!INCLUDE [version-tfs-all-versions](../includes/version-ts-tfs-2015-2016.md)] To add new features and capabilities to your Azure DevOps Server, -install extensions from the [Visual Studio Marketplace](https://marketplace.visualstudio.com/azuredevops). +install extensions from the [Azure DevOps Marketplace](https://marketplace.visualstudio.com/azuredevops). > [!TIP] > To learn more about building your own extensions, see [developing](../extend/overview.md) and [publishing](../extend/publish/overview.md) extensions. @@ -37,7 +37,7 @@ If you don't have permissions, you can [request extensions](request-extensions.m Your project collection reuses your Azure subscription for future Marketplace purchases. -[Where can I find more info about Azure billing?](faq-extensions.md#q-how-do-i-get-support-for-the-visual-studio-marketplace)] +[Where can I find more info about Azure billing?](faq-extensions.yml)] ::: moniker range="<= tfs-2018" @@ -57,7 +57,7 @@ for future Marketplace purchases. * Working with TFS 2015 Update 3, or disconnected from TFS 2017? [Download extensions, then upload them to TFS](#disconnected-tfs) to -[install free and preview extensions](faq-extensions.md#difference). +[install free and preview extensions](faq-extensions.yml). ::: moniker-end @@ -92,7 +92,7 @@ for future Marketplace purchases. Extension installed - [Need help?](faq-extensions.md) + [Need help?](faq-extensions.yml) @@ -173,7 +173,7 @@ can install extensions. If you don't have permissions, you can [request extensio Find and upload your downloaded extension - [Why can't I upload extensions?](faq-extensions.md#q-why-cant-i-upload-extensions-to-azure-devops-server) + [Why can't I upload extensions?](faq-extensions.yml) ### Install extension in your project collection @@ -320,4 +320,4 @@ Use the **Extensions** page to manage installed extensions. - [Uninstall or disable extensions](how-to/uninstall-disable-extensions-tfs.md) - [Request extensions](request-extensions.md) -- [[About permissions](../organizations/security/about-permissions.md) \ No newline at end of file +- [About permissions](../organizations/security/about-permissions.md) \ No newline at end of file diff --git a/docs/marketplace/how-to/uninstall-disable-extensions-tfs.md b/docs/marketplace/how-to/uninstall-disable-extensions-tfs.md index cb7978b5682..ac25a27bec6 100644 --- a/docs/marketplace/how-to/uninstall-disable-extensions-tfs.md +++ b/docs/marketplace/how-to/uninstall-disable-extensions-tfs.md @@ -43,4 +43,4 @@ can uninstall or disable extensions. Uninstall or disable an extension - [[Need help?](../faq-extensions.md#q-how-do-i-get-support-for-the-visual-studio-marketplace)] \ No newline at end of file + [[Need help?](../faq-extensions.yml)] \ No newline at end of file diff --git a/docs/marketplace/install-extension.md b/docs/marketplace/install-extension.md index 95b04d80545..60aab64da7b 100644 --- a/docs/marketplace/install-extension.md +++ b/docs/marketplace/install-extension.md @@ -22,7 +22,7 @@ To learn about building your own Azure DevOps extensions, see [developing](../ex ## Prerequisites -* Only [Project Collection Administrators or organization Owners](faq-extensions.md#find-owner) can install extensions. If you don't have permissions, you can [request extensions](./request-extensions.md) instead. +* Only [Project Collection Administrators or organization Owners](faq-extensions.yml) can install extensions. If you don't have permissions, you can [request extensions](./request-extensions.md) instead. * Private extensions must be shared with your organization to be installed. Check out the [publishing documentation](../extend/publish/overview.md#upload) for information on how to share private extensions. @@ -46,9 +46,9 @@ To learn about building your own Azure DevOps extensions, see [developing](../ex ![Select organization for this extension](media/get-vsts-extensions/select-install-extension.png) - * [Why don't I see any organizations?](./faq-extensions.md#no-organizations) + * [Why don't I see any organizations?](./faq-extensions.yml) - * [Why can't I install this extension?](./faq-extensions.md#no-permissions) + * [Why can't I install this extension?](./faq-extensions.yml) Your extension is now installed! You can now go to your organization to use your extension. Also, tell your team about this extension, so they can start using its capabilities. diff --git a/docs/marketplace/media/top-publisher-badge.png b/docs/marketplace/media/top-publisher-badge.png new file mode 100644 index 0000000000000000000000000000000000000000..816cf7249dc4c28809b4effe8b72884dcd103bf3 GIT binary patch literal 1371 zcmV-h1*H0kP)Px#1ZP1_K>z@;j|==^1poj532;bRa{vGi!vFvd!vV){sAK>D1n@~jK~!i%?U~VQ z+eR3`1^ycZeKBDWO6NB{rG-Jm1~UuHBrx)lIS-vP);cd1eTbZqxh27jxwWAsAqB-0 z9I}El64bGInBfvU+_53XTE+Hyjh*DB6b5_UM&0jDCtHdnTTVPdXZ^Sb`J}s(e){y? zNoHCeuHcDw2~V_3c%ogx6YUb7XqV_Ax>-B8vh?KKQgy4=pj95H!a{VT+T7l2K1N5V zahSdJgjpcvEBVt4KJJsR<7;K%^Us)J#pm<+{r<_x$@TSh>dP4?MWg2j*Wy&}+e?~d zQr?2lR=4Bz?dNDXsn_epVsUwSnd7*zv9aCVT`H~@CebxCrITw@_OmrQ@Gt|qA;2Am zwn=o|ndmwlY{U>K_=>ge@cdQr(8|I>PLFr%-G*B>_NU?|Vi ziMh>0xTLvu})_gD}Qja#+Ms)n~U$0t!SHG)TTPDR2(G-Jd z<%e|SvL9!Gk?}}IeTs>Q`LsAU4m;S35%Cc@w2h@`y_)v68v7}c48dNyB9`#(j_7=h zrY}WGOmpgK2$I%AA|s5C;C7LFq#Z)?10i&tg{sjH6Os%Sq^nt8fd0GRIfS5Z>d}U7 zIXYJU^A+r~v5bp8M^kj7%d7C@hf)Qlj$|nb+tE!>P0l_L5z7ivD&ky#xtydIs?rgy zlv21+4jS2u4$Q2Upr^7J2{7YdLQiJV63;T>HEfQ8dtib$C0UX4F^*w*Y+n*Mj?d$x z{iqGUL>a20Hx3DN9={m%+4&1QQRd@Q!(F0mX z8%4jIbGItR@6J8LCzYk`U-AdfrYnpj7f{;UkV2Aycc>ZNs8x zK)4>KqWfEQsKA@yq)Dr(ba^xEh$bTRse|KpwA8`zIk;e@l%8VQS>xpy^-(ITA%+d# zsVIt^gNI!wn!76ET9TT=8_<)bXhJy+o$x!>qLs}k3#YY-&jk`uas%2q72U@=y3Lti z!F8e`+wIUNb|5VLrPV8f9@miG{FUba){V#Bdf-M)rGNVv|HHC> z|L31z5kp5f6K}TYfqjoQ19uFjR9L>i-NTt~xB&@+`G>{hKf)935}s(6@I Azure DevOps](https://marketplace.visualstudio.com/azuredevops). 2. Install the extension from the Marketplace and start using it in Azure DevOps. -To upload, install, or assign extensions you need [Project Collection Administrator or organization Owner permissions](./faq-extensions.md#find-owner). +To upload, install, or assign extensions you need [Project Collection Administrator or organization Owner permissions](./faq-extensions.yml). #### [Azure DevOps CLI](#tab/azure-devops-cli/) @@ -101,4 +101,4 @@ Publisher Id Extension Id Name - [Request extensions and approve extension requests](request-extensions.md) - [Manage extension permissions](how-to/grant-permissions.md) - [Uninstall or disable extensions](uninstall-disable-extensions.md) -- [Extension FAQs](faq-extensions.md) \ No newline at end of file +- [Extension FAQs](faq-extensions.yml) \ No newline at end of file diff --git a/docs/marketplace/request-extensions.md b/docs/marketplace/request-extensions.md index 6e33ecef58c..1532d104615 100644 --- a/docs/marketplace/request-extensions.md +++ b/docs/marketplace/request-extensions.md @@ -139,7 +139,7 @@ Tell your team about installed extensions, so they can start using their capabil ## Related articles -- [FAQs](faq-extensions.md) +- [FAQs](faq-extensions.yml) - [Set up billing](../organizations/billing/set-up-billing-for-your-organization-vs.md) - [Azure DevOps pricing](https://azure.microsoft.com/pricing/details/devops/azure-devops-services/) - [Azure DevOps billing support](https://azure.microsoft.com/support/devops/) diff --git a/docs/marketplace/toc.yml b/docs/marketplace/toc.yml index 56f587cab88..b2c0772df6c 100644 --- a/docs/marketplace/toc.yml +++ b/docs/marketplace/toc.yml @@ -1,22 +1,14 @@ -- name: Marketplace extensions - href: overview.md -- name: Trusting Marketplace offerings - href: trust.md -- name: Install extensions +- name: Install an extension href: install-extension.md -- name: Request and approve extensions +- name: Request and approve an extension href: request-extensions.md -- name: Install extensions on-premises +- name: Install an extension on-premises href: get-tfs-extensions.md - name: Uninstall or disable extensions href: uninstall-disable-extensions.md +- name: Evaluate a Marketplace extension + href: trust.md - name: Manage extension permissions href: how-to/grant-permissions.md - name: FAQs about extensions - href: faq-extensions.md -- name: Resources - items: - - name: Azure Boards extensions developed by Microsoft - href: ../boards/extensions/index.md - - name: Get extensions for Visual Studio - href: /visualstudio/ide/finding-and-using-visual-studio-extensions?view=vs-2019#install-or-uninstall-visual-studio-extensions \ No newline at end of file + href: faq-extensions.yml diff --git a/docs/marketplace/trust.md b/docs/marketplace/trust.md index 2ad127876d9..72c8f4aab4b 100644 --- a/docs/marketplace/trust.md +++ b/docs/marketplace/trust.md @@ -6,34 +6,90 @@ ms.technology: devops-marketplace ms.author: chcomley author: chcomley monikerRange: '>= tfs-2015' -ms.date: 07/18/2019 +ms.date: 03/15/2021 ms.topic: conceptual --- -# Trusting a publisher in the Marketplace +# Evaluate a Marketplace extension publisher [!INCLUDE [version-ts-tfs-2015-2016](../includes/version-ts-tfs-2015-2016.md)] -## Can I trust an offering in the Marketplace? +*Can you trust an offering in the Marketplace?* -The Marketplace provides you with the following resources to make an informed decision about the extensions and integrations you use or evaluate: -| Activity | Implication | -|:---------|:------------| -| Look for the Top Publisher badge Top Publisher badge | The publisher has demonstrated commitment to its customers and the Marketplace through excellent policies, quality, reliability, and support. Note: the Top Publisher program is currently only applicable to publishers of Azure DevOps offerings (extensions/integrations).| -| Read the ratings and reviews | They tell you how others perceive the offering. | -| Read the Q&A section | It may answer the questions you have and is a good mechanism to engage with the extension’s publisher(s) to have a meaningful dialogue to make yourself comfortable. Use it to understand the development, testing, and security practices the publisher follows. It also gives you a sense of the publisher's responsiveness. | -| Read the privacy, license, and support policies | See if the publisher has provided them and if they meet your needs/concerns. | +We recommend you install a Marketplace extension in an isolated organization or collection first, to experience it and to eliminate any concerns. Once you're comfortable, install it on your other organizations or collections. + +> [!NOTE] +> The ecosystem clean. If a concern does surface, the Marketplace team has the means to disable an extension immediately and notify its existing customers. + +## Resources for evaluating a Marketplace extension + +To evaluate a Marketplace extension, review the information and resources described in the following table. + +:::row::: + :::column span="1"::: + **Information** + :::column-end::: + :::column span="2"::: + **Usage** + :::column-end::: +:::row-end::: +--- +:::row::: + :::column span="1"::: + **Top Publisher badge** + ![Top Publisher badge.](media/top-publisher-badge.png) + :::column-end::: + :::column span="2"::: + The publisher has demonstrated commitment to its customers and the Marketplace through excellent policies, quality, reliability, and support. Note: the Top Publisher program is currently only applicable to publishers of Azure DevOps offerings (extensions/integrations). + :::column-end::: +:::row-end::: +--- +:::row::: + :::column span="1"::: + **Rating & Review** + :::column-end::: + :::column span="2"::: + Ratings and reviews indicate how others perceive the offering. + :::column-end::: +:::row-end::: +--- +:::row::: + :::column span="1"::: + **Q & A** + :::column-end::: + :::column span="2"::: + The Q & A section of published extensions may answer questions you may have. Also, they are a good mechanism to engage with the extension’s publisher(s) to have a meaningful dialogue to make yourself comfortable. Use the Q & A information to understand the development, testing, and security practices the publisher follows. It also gives you a sense of the publisher's responsiveness. + :::column-end::: +:::row-end::: +--- +:::row::: + :::column span="1"::: + **Privacy, license, and support policies** + :::column-end::: + :::column span="2"::: + See if the publisher has provided them and if they meet your needs or concerns. + :::column-end::: +:::row-end::: +--- + +## Additional information Be aware of the following important information: -* **Malware Scan**: As a customer, you expect to not get malicious software when you acquire an extension from the Marketplace. The Marketplace runs a virus scan on each extension package that's published, to ensure its safety. The virus scan is run for each new extension and for each extension update. Until the scan is all clear, we don't publish the extension in the Marketplace for public usage. Note: stated virus scan is run at extension publish only and not during extension's execution. -* **Content scan**: The Marketplace does a content scan for every new and updated extension in the Marketplace. With these content scans, we avoid surfacing inappropriate or offensive content on the Marketplace pages. -* **Access to approved scopes only**: An extension can only operate within the scopes it has been granted. For example: an extension that has only read permissions on work items can't modify your features and bugs. Azure DevOps web extensions run in a sandboxed browser iframe. They're only able to access Azure DevOps data and APIs approved for the extension. During installation, admins are prompted to approve permissions and scopes. One way to protect yourself is to carefully review the scopes being requested by the extension. Note: if the scopes required by an extension change, the consumer must approve the update before it can become applicable on the consumer's organization or collection. -* **Third-party build and release tasks**: Tasks are implemented as code that executes on an agent machine. Tasks are only able to access secrets explicitly provided to them (see [variable secrets](../pipelines/process/variables.md?tabs=yaml%252cbatch#secret-variables)), but tasks generally have full access to the agent machine itself. To reduce risk, run builds on Microsoft-hosted agents, which are VMs isolated from other jobs and recycled after each job. Or, limit file and network access on private hosted agent machines. Learn more about [build and release agents](../pipelines/agents/agents.md?view=azure-devops&preserve-view=true#microsoft-hosted-agents). -* **Third-party code execution on the server**: There's no way for an extension to install or execute any code on Azure DevOps Server. +- **Malware Scan**: As a customer, you expect to not get malicious software when you acquire an extension from the Marketplace. The Marketplace runs a virus scan on each extension package that's published, to ensure its safety. The virus scan is run for each new extension and for each extension update. Until the scan is all clear, we don't publish the extension in the Marketplace for public usage. + > [!NOTE] + > Stated virus scan is run at extension publish only and not during extension's execution. + +- **Content scan**: The Marketplace does a content scan for every new and updated extension in the Marketplace. With these content scans, we avoid surfacing inappropriate or offensive content on the Marketplace pages. + +- **Access to approved scopes only**: An extension can only operate within the scopes it has been granted. For example: an extension that has only read permissions on work items can't modify your features and bugs. Azure DevOps web extensions run in a sandboxed browser iframe. They're only able to access Azure DevOps data and APIs approved for the extension. During installation, admins are prompted to approve permissions and scopes. One way to protect yourself is to carefully review the scopes being requested by the extension. + > [!NOTE] + > If the scopes required by an extension change, the consumer must approve the update before it can become applicable on the consumer's organization or collection. + +- **Third-party build and release tasks**: Tasks are implemented as code that executes on an agent machine. Tasks are only able to access secrets explicitly provided to them (see [variable secrets](../pipelines/process/variables.md?tabs=yaml%252cbatch#secret-variables)), but tasks generally have full access to the agent machine itself. To reduce risk, run builds on Microsoft-hosted agents, which are VMs isolated from other jobs and recycled after each job. Or, limit file and network access on private hosted agent machines. Learn more about [build and release agents](../pipelines/agents/agents.md?view=azure-devops&preserve-view=true#microsoft-hosted-agents). -Recommendation: Install an extension in an isolated organization or collection first, to experience it and to eliminate any concerns. Once you're comfortable, install it on your other organizations or collections. Note: Extension updates can change the behavior of the extension. We count on our customers and publishers to keep the ecosystem clean. If a concern does surface, Marketplace team has means to disable an extension immediately and notify its existing customers. +- **Third-party code execution on the server**: There's no way for an extension to install or execute any code on Azure DevOps Server. ## Top Publisher diff --git a/docs/notifications/manage-team-group-global-organization-notifications.md b/docs/notifications/manage-team-group-global-organization-notifications.md index 106a5786cb6..898236ef20c 100644 --- a/docs/notifications/manage-team-group-global-organization-notifications.md +++ b/docs/notifications/manage-team-group-global-organization-notifications.md @@ -67,12 +67,12 @@ A subscription lets you control what your team is notified of and how the team r Choose from one of the following delivery options: - | Delivery option | Description | - | -------------------------|---------------------| - | **Team members by role** | Only certain team members associated with the event are notified. For example, for work item changes, you might only want the current assignee of the work item to receive a notification. | - | **Team preference** | Use the team's default delivery preference. For more information, see [Manage delivery settings](#manage). | - | **Custom email address** | Send an email to a specified email address. | - | **All team members** | Send an individual email to each member of the team. | + | **Delivery option** | **Description** | + | --------------------|-------------------| + | **Team members by role** | Only certain team members associated with the event are notified. For example, for work item changes, you might only want the current assignee of the work item to receive a notification. | + | **Team preference** | Use the team's default delivery preference. For more information, see [Manage delivery settings](#manage). | + | **Custom email address** | Send an email to a specified email address. | + | **All team members** | Send an individual email to each member of the team. | For certain activities, when you select **Team members by role**, you can choose to have the user that initiated the activity receive a notification. This notification is controlled by the **Skip initiator** checkbox. By default, this box is checked, meaning the user that starts the change isn't notified about it. @@ -177,7 +177,7 @@ A subscription lets you control what your team is notified of and how the team r |**Team preference** | use the team's default delivery preference. For more information, see [Manage delivery settings](#manage). | |**Custom email address** | Send an email to a specified email address. | |**Members of Azure DevOps** | Send an individual email to each member of the team. | - |**SOAP** | Send to an email address. | + |**SOAP** | Send to an eamil address. | See the following roles and their descriptions: diff --git a/docs/organizations/accounts/change-time-zone.md b/docs/organizations/accounts/change-time-zone.md index a4eab58d753..e17cb349df3 100644 --- a/docs/organizations/accounts/change-time-zone.md +++ b/docs/organizations/accounts/change-time-zone.md @@ -23,7 +23,7 @@ The following time zones are available in Azure DevOps: * **Azure DevOps organization time zone** - the main time zone setting. This setting is where all your iteration dates, builds, and release schedules depend upon, and so on. Changing your organization time zone affects its dependencies. * **Azure DevOps user profile time zone** - only used for the user interface (UI). Your user profile time zone setting is used for a more personalized experience. It also displays timestamps for when users browse Azure DevOps using the time zone that's configured for that specific user. -If your organization time zone is EST, and user profile is PST, all date and time fields display in PST time zone. To learn more, see [Time zone settings and usage](../settings/timezone-settings-and-usage.md). +If your organization time zone is EST, and user profile is PST, all date and time fields display in PST time zone. To learn more, see [Time zone settings and usage](../settings/timezone-settings-usage.md). ## Change your organization time zone @@ -76,5 +76,5 @@ If your organization time zone is EST, and user profile is PST, all date and tim ## Related articles -- [Time zone settings and usage](../settings/timezone-settings-and-usage.md) +- [Time zone settings and usage](../settings/timezone-settings-usage.md) - [Set user preferences](../settings/set-your-preferences.md) \ No newline at end of file diff --git a/docs/organizations/accounts/toc.yml b/docs/organizations/accounts/toc.yml index 9172cd547be..f39a08d87ec 100644 --- a/docs/organizations/accounts/toc.yml +++ b/docs/organizations/accounts/toc.yml @@ -4,6 +4,8 @@ href: ../../user-guide/plan-your-azure-devops-org-structure.md?toc=/azure/devops/organizations/toc.json&bc=/azure/devops/organizations/breadcrumb/toc.json - name: Create your organization href: create-organization.md +- name: Look up organization owner + href: ../security/lookup-organization-owner-admin.md - name: Add and manage banners href: ../settings/manage-banners.md - name: Adjust organization settings diff --git a/docs/organizations/settings/set-your-preferences.md b/docs/organizations/settings/set-your-preferences.md index cbdf1bf245c..667f919cc1b 100644 --- a/docs/organizations/settings/set-your-preferences.md +++ b/docs/organizations/settings/set-your-preferences.md @@ -122,7 +122,7 @@ Your profile settings are updated. ## Related articles -- [Time zone settings and usage](../settings/timezone-settings-and-usage.md) +- [Time zone settings and usage](../settings/timezone-settings-usage.md) - [Manage personal notifications](../../notifications/manage-your-personal-notifications.md) - [Usage](../../integrate/concepts/rate-limits.md) - [Manage or enable features](../../project/navigation/preview-features.md) diff --git a/docs/organizations/settings/timezone-settings-and-usage.md b/docs/organizations/settings/timezone-settings-usage.md similarity index 100% rename from docs/organizations/settings/timezone-settings-and-usage.md rename to docs/organizations/settings/timezone-settings-usage.md diff --git a/docs/organizations/toc.yml b/docs/organizations/toc.yml index a3d220b5eee..6b9b639869f 100644 --- a/docs/organizations/toc.yml +++ b/docs/organizations/toc.yml @@ -8,7 +8,7 @@ - name: Get started as an administrator href: ../user-guide/project-admin-tutorial.md?toc=/azure/devops/organizations/toc.json&bc=/azure/devops/organizations/breadcrumb/toc.json - name: Time zone settings - href: ./settings/timezone-settings-and-usage.md + href: ./settings/timezone-settings-usage.md displayName: timezone, organization - name: Security, membership, & access href: ../organizations/security/toc.yml diff --git a/docs/report/dashboards/analytics-extension.md b/docs/report/dashboards/analytics-extension.md index 52a4ac235e2..e321baba34f 100644 --- a/docs/report/dashboards/analytics-extension.md +++ b/docs/report/dashboards/analytics-extension.md @@ -258,5 +258,5 @@ To resolve this issue, you can install the extension from a machine that hosts t - [Data available from Analytics](../powerbi/data-available-in-analytics.md) - [Grant permissions to access Analytics](../powerbi/analytics-security.md) - [The Reporting Roadmap](../powerbi/reporting-roadmap.md) -- [Extension FAQs](../../marketplace/faq-extensions.md) +- [Extension FAQs](../../marketplace/faq-extensions.yml) diff --git a/docs/repos/get-started/index.md b/docs/repos/get-started/index.md index de18a11fe69..080e4fd31c6 100644 --- a/docs/repos/get-started/index.md +++ b/docs/repos/get-started/index.md @@ -11,9 +11,9 @@ monikerRange: '>= tfs-2013' # Start using Azure Repos -Use this guide to sign up and start using Azure Repos. If you're new to Azure Repos, see [What is Azure Repos?](what-is-repos.md). +Use this guide to sign up and start using Azure Repos. If you're new to Azure Repos, see [What is Azure Repos?](what-is-repos.md) -Azure DevOps Services includes free unlimited private Git repos, so Azure Repos is easy to try out. Git is the most commonly used version control system today and is quickly becoming the standard for version control. Git is a distributed version control system, meaning that your local copy of code is a complete version control repository. These fully functional local repositories make it easy to work offline or remotely. You commit your work locally, and then sync your copy of the repository with the copy on the server. +Azure Repos includes free unlimited private Git repos, so Azure Repos is easy to try out. Git is the most commonly used version control system today and is quickly becoming the standard for version control. Git is a distributed version control system, meaning that your local copy of code is a complete version control repository. These fully functional local repositories make it easy to work offline or remotely. You commit your work locally, and then sync your copy of the repository with the copy on the server. Git in Azure Repos is standard Git. You can use the clients and tools of your choice, such as Git for Windows, Mac, partners' Git services, and tools such as Visual Studio and Visual Studio Code. @@ -24,5 +24,5 @@ After you sign up, learn how to [code with Git](code-with-git.md). Whether your Other resources to get you up and running: - [Web portal navigation](../../project/navigation/index.md) -- [Security & identity](../../organizations/security/about-security-identity.md) +- [Get started with permissions, access, and security groups](../../organizations/security/about-permissions.md) - [About projects and scaling your organization](../../organizations/projects/about-projects.md) \ No newline at end of file diff --git a/docs/repos/get-started/toc.yml b/docs/repos/get-started/toc.yml index d18121d0a05..00a362384a9 100644 --- a/docs/repos/get-started/toc.yml +++ b/docs/repos/get-started/toc.yml @@ -1,6 +1,14 @@ - name: Start using Azure Repos href: index.md +- name: Compare Git and TFVC + href: ../tfvc/comparison-git-tfvc.md - name: Sign up and invite some teammates - href: sign-up-invite-teammates.md + href: sign-up-invite-teammates.md - name: Code with Git href: ../../user-guide/code-with-git.md?toc=/azure/devops/repos/toc.json&bc=/azure/devops/repos/breadcrumb/toc.json +- name: Use Git and TFVC + href: ../git/team-projects.md +- name: Key concepts + href: key-concepts-repos.md +- name: Search code repositories + href: ../../project/search/code-search.md?toc=/azure/devops/repos/toc.json&bc=/azure/devops/repos/breadcrumb/toc.json diff --git a/docs/repos/toc.yml b/docs/repos/toc.yml index 0a259415a8a..ae42cf63a4b 100644 --- a/docs/repos/toc.yml +++ b/docs/repos/toc.yml @@ -2,14 +2,7 @@ href: index.yml - name: "What is Azure Repos?" href: get-started/what-is-repos.md -- name: Compare Git and TFVC - href: tfvc/comparison-git-tfvc.md -- name: Use Git and TFVC - href: git/team-projects.md -- name: Key concepts - href: get-started/key-concepts-repos.md -- name: Search code repositories - href: ../project/search/code-search.md?toc=/azure/devops/repos/toc.json&bc=/azure/devops/repos/breadcrumb/toc.json + - name: Get started href: get-started/toc.yml - name: Git