擴充點

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

延伸模組藉由貢獻新功能來增強 Azure DevOps 用戶體驗。 在本文中，我們會反白顯示擴充功能可鎖定的最常見擴充點。 如需 Azure DevOps 擴充性模型的詳細資訊，請參閱 貢獻模型。

貢獻 指南延伸模組 是範例延伸模組。 將此延伸模組安裝到您的組織中。 安裝之後，您會看到可用的擴充點。 建議您將此延伸模組安裝到個人或測試組織。 此延伸模組的來源也可供使用。

如需詳細資訊，請參閱下列參考資料：

• azure-devops-extension-api
• azure-devops-extension-sdk
• azure-devops-extension-sample
• 已安裝的擴充功能 API

中樞和中樞群組

中樞和中樞群組是 Azure DevOps 中的主要導覽元素。 檔案、 版本、 待辦項目和 查詢 是中樞的範例。 中樞屬於中樞群組。 例如，檔案中樞屬於專案層級的 Azure Repos 中樞群組。 中樞群組可以存在於組織或集合層級或專案層級。 大部分的延伸模組都會參與專案層級。

下表說明 Azure DevOps 中最常見的中樞群組，您可以參與中樞。

名稱	識別碼	層級	預覽影像
Azure Boards	ms.vss-work-web.work-hub-group	專案/小組
Azure Repos	ms.vss-code-web.code-hub-group	專案/小組
Azure Pipelines	ms.vss-build-web.build-release-hub-group	專案/小組
Azure Test Plans	ms.vss-test-web.test-hub-group	專案/小組
專案設定	ms.vss-web.project-admin-hub-group	專案
組織設定	ms.vss-web.collection-admin-hub-group	組織或集合

範例

下列範例示範如何將中樞貢獻至程式代碼中樞群組：

{
    ...
    "contributions": [
        {
            "id": "my-custom-hub",
            "type": "ms.vss-web.hub",
            "targets": [
                "ms.vss-code-web.code-hub-group"
            ],
            "properties": {
                "name": "Code Hub",
                "order": 30,
                "uri": "/views/code/custom.html"
            }
        }
    ]
}

• ms.vss-web.hub 是此貢獻的類型。 此類型定義於發行者下所發行的 vss-web 延伸模組中 ms 。 此類型會宣告此類型貢獻所需的選擇性和必要屬性（例如名稱、順序等等）。
• ms.vss-code-web.code-hub-group 是此中樞的目標中樞群組貢獻的完整標識符。 此貢獻會在發行者下ms發佈的延伸模組中vss-code-web宣告
• my-custom-hub 是此貢獻的簡短標識符; {publisherId}.{extensionId}.my-custom-hub 是完整標識碼

將圖示新增至功能表或工具列

新增圖示屬性，以便直接依名稱使用。

建議您提供您自己的圖示。 使用您自己的圖示範例：

           "name": "Sample hub",
           "uri": "dist/Hub/Hub.html",
           "icon": "asset://static/sample-icon.png",
           "supportsMobile": true
       }

使用 Office UI 網狀架構圖示範例：

            "iconName": "Code",
            "name": "Code Hub",
            "order": 30,
            "uri": "/views/code/custom.html"
        }

功能表和工具列的設定

名稱	目標標識碼
組織/集合概觀工具列	ms.vss-admin-web.collection-overview-toolbar-menu
集合概觀專案方格	ms.vss-admin-web.projects-grid-menu
專案概觀工具列	ms.vss-admin-web.project-overview-toolbar-menu
專案概觀Teams方格	ms.vss-admin-web.teams-grid-menu

Azure Boards 功能表和工具列

名稱	目標標識碼	預覽影像
工作項目查詢功能表	ms.vss-work-web.work-item-query-menu
工作專案查詢結果工具列功能表	ms.vss-work-web.work-item-query-results-toolbar-menu
工作專案查詢結果功能表項	ms.vss-work-web.query-result-work-item-menu
工作專案查詢結果索引標籤	ms.vss-work-web.query-tabs
操作功能表的工作專案	ms.vss-work-web.work-item-toolbar-menu
待辦專案功能表	ms.vss-work-web.backlog-item-menu
短期衝刺面板樞紐篩選功能表	ms.vss-work-web.sprint-board-pivot-filter-menu
面板樞紐篩選功能表	ms.vss-work-web.backlog-board-pivot-filter-menu
卡片功能表	ms.vss-work-web.backlog-board-card-item-menu
產品待辦專案索引標籤	ms.vss-work-web.product-backlog-tabs
反覆專案待辦專案索引標籤	ms.vss-work-web.iteration-backlog-tabs
公事包待辦專案窗格	ms.vss-work-web.portfolio-backlog-toolpane
產品待辦專案窗格	ms.vss-work-web.requirement-backlog-toolpane
反覆專案待辦專案窗格	ms.vss-work-web.iteration-backlog-toolpane

Azure Pipelines 功能表和工具列

名稱	目標標識碼	預覽​​
已完成建置功能表	ms.vss-build-web.completed-build-menu
測試結果工具列動作	ms.vss-test-web.test-results-actions-menu
測試結果詳細數據索引標籤	ms.vss-test-web.test-result-details-tab-items
發行管線總管操作功能表	ms.vss-releaseManagement-web.release-definition-explorer-context-menu
管線詳細數據檢視，標頭按鈕	ms.vss-build-web.pipelines-header-menu
管線詳細數據檢視，資料夾操作功能表	ms.vss-build-web.pipelines-folder-menu

Azure Pipelines 工作

工作會在組建或版本中執行工作。 如需詳細資訊，請瞭解如何 參與建置或發行工作。

Azure Repos 功能表和工具列

名稱	目標標識碼	預覽影像
來源專案 （方格） 功能表	ms.vss-code-web.source-grid-item-menu
來源專案 （樹狀結構） 功能表	ms.vss-code-web.source-tree-item-menu
來源專案 （方格和樹狀結構） 功能表	ms.vss-code-web.source-item-menu
變更清單項目功能表	ms.vss-code-web.change-list-item-menu
變更清單摘要項目功能表	ms.vss-code-web.change-list-summary-item-menu
Git 分支樹狀目錄功能表	ms.vss-code-web.git-branches-tree-menu
Git 提取要求動作功能表	ms.vss-code-web.pull-request-action-menu
Git 提取要求索引卷標 （樞紐）	ms.vss-code-web.pr-tabs
Git 認可清單功能表	ms.vss-code-web.git-commit-list-menu
Git 認可詳細數據功能表	ms.vss-code-web.git-commit-details-menu

Azure 測試計劃功能表和工具列

名稱	目標標識碼	預覽影像
測試執行方格功能表	ms.vss-test-web.test-run-grid-menu
測試計劃套件樹狀目錄功能表	ms.vss-test-web.test-plans-suites-context
測試計劃中樞樞紐索引標籤	ms.vss-test-web.test-plan-pivot-tabs

其他擴充點

• 儀錶板小工具：延伸模組可以貢獻使用者可新增至 儀錶板的新小工具類型。 瞭解如何 貢獻儀錶板小工具。
• 工作項目表單：工作項目窗體是由具有新區段、索引卷標、動作和自定義欄位轉譯器的延伸模組所增強。 如需詳細資訊，請瞭解如何 擴充工作項目窗體。
• 服務攔截：「取用者」是事件在服務攔截中傳送至的服務。 延伸模組可以參與取用者服務。 這些服務是由用戶設定的，或以程序設計方式將事件傳送至該服務。 如需詳細資訊，請參閱 參與服務勾點取用者。
• 功能：

名稱： 預覽功能（僅限裝載）
目標標識碼： ms.vss-web.managed-features