擴充性點

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 Pipelines。
微軟 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 是此貢獻的類型。 此類型定義於由 ms 發行者發布的 vss-web 延伸模組。 此類型會宣告此類型貢獻所需的選擇性和必要屬性（例如名稱、順序等等）。
• ms.vss-code-web.code-hub-group 是該中樞目標的中樞群組貢獻的完整識別號。 此貢獻會在發行者下vss-code-web發佈的延伸模組中ms宣告
• 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 Fabric Icons 的範例：

            "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
專案概觀團隊網格	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