Erweiterungspunkte

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019 | TFS 2018

Erweiterungen verbessern die Benutzererfahrung von Azure DevOps, indem sie neue Funktionen bereitstellen. In diesem Artikel werden die gängigsten Erweiterbarkeitspunkte hervorgehoben, auf die Ihre Erweiterung ausgerichtet werden kann. Weitere Informationen zum Azure DevOps-Erweiterbarkeitsmodell finden Sie im Beitragsmodell.

Die Beitragsleitfaden-Erweiterung ist eine Beispielerweiterung. Installieren Sie diese Erweiterung in Ihrem organization. Nach der Installation werden die verfügbaren Erweiterbarkeitspunkte angezeigt. Es wird empfohlen, diese Erweiterung in einer persönlichen oder Test-organization zu installieren. Die Quelle für diese Erweiterung ist ebenfalls verfügbar. Außerdem finden Sie hier ein Beispiel für einen Erweiterungspunkt für die Repositoryerstellung.

Weitere Informationen finden Sie in den folgenden Referenzen:

• azure-devops-extension-api
• azure-devops-extension-sdk
• azure-devops-extension-sample
• installierte Erweiterungs-API

Hubs und Hubgruppen

Hubs und Hubgruppen sind die primären Navigationselemente in Azure DevOps. Dateien, Releases, Backlogs und Abfragen sind Beispiele für Hubs. Ein Hub gehört zu einer Hubgruppe. Der Files-Hub gehört beispielsweise zur Azure Repos Hubgruppe auf Projektebene. Hubgruppen können auf organization- oder Sammlungsebene oder auf Projektebene vorhanden sein. Die meisten Erweiterungen tragen zur Projektebene bei.

In der folgenden Tabelle werden die gängigsten Hubgruppen in Azure DevOps beschrieben, zu denen Sie Hubs beitragen können.

Name	id	Ebene	Vorschaubild
Azure Boards	ms.vss-work-web.work-hub-group	Projekt/Team
Azure Repos	ms.vss-code-web.code-hub-group	Projekt/Team
Azure Pipelines	ms.vss-build-web.build-release-hub-group	Projekt/Team
Azure Test Plans	ms.vss-test-web.test-hub-group	Projekt/Team
Projekteinstellungen	ms.vss-web.project-admin-hub-group	Project
Organisationseinstellungen	ms.vss-web.collection-admin-hub-group	Organisation oder Sammlung

Beispiel

Das folgende Beispiel zeigt, wie Sie einen Hub zur Code-Hubgruppe beitragen:

{
    ...
    "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 ist der Typ dieses Beitrags. Dieser Typ wird in der Erweiterung definiert, die vss-web unter dem ms Herausgeber veröffentlicht wird. Dieser Typ deklariert optionale und erforderliche Eigenschaften, die für Beiträge dieses Typs erforderlich sind (z. B. Name, Reihenfolge usw.).
• ms.vss-code-web.code-hub-group ist die vollständige ID des Hubgruppenbeitrags, auf den dieser Hub abzielt. Dieser Beitrag wird in der unter dem vss-code-web Herausgeber veröffentlichten ms Erweiterung deklariert.
• my-custom-hub ist die Kurz-ID dieses Beitrags; {publisherId}.{extensionId}.my-custom-hub ist die vollständige ID.

Hinzufügen eines Symbols zu Ihrem Menü oder ihrer Symbolleiste

Fügen Sie eine Symboleigenschaft hinzu, damit sie direkt nach Namen verwendet werden kann.

Es wird empfohlen, Ein eigenes Symbol bereitzustellen. Beispiel für ein eigenes Symbol:

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

Verwenden des Office UI Fabric Icons-Beispiels:

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

Einstellungen für Menüs und Symbolleisten

Name	Ziel-ID
Übersichtssymbolleiste "Organisation/Sammlung"	ms.vss-admin-web.collection-overview-toolbar-menu
Übersichtsraster für Sammlungsprojekte	ms.vss-admin-web.projects-grid-menu
Projektübersichtssymbolleiste	ms.vss-admin-web.project-overview-toolbar-menu
Teams-Raster "Projektübersicht"	ms.vss-admin-web.teams-grid-menu

Azure Boards Menü und Symbolleiste

Name	Ziel-ID	Vorschaubild
Arbeitselementabfragemenü	ms.vss-work-web.work-item-query-menu
Symbolleistenmenü für Arbeitselementabfrageergebnisse	ms.vss-work-web.work-item-query-results-toolbar-menu
Menüelement "Arbeitselementabfrageergebnisse"	ms.vss-work-web.query-result-work-item-menu
Registerkarte "Arbeitselementabfrageergebnisse"	ms.vss-work-web.query-tabs
Arbeitselement für Das Kontextmenü	ms.vss-work-web.work-item-toolbar-menu
Menü "Backlogelement"	ms.vss-work-web.backlog-item-menu
Pivotfiltermenü des Sprintboards	ms.vss-work-web.sprint-board-pivot-filter-menu
Board-Pivotfiltermenü	ms.vss-work-web.backlog-board-pivot-filter-menu
Kartenmenü	ms.vss-work-web.backlog-board-card-item-menu
Registerkarte "Product Backlog"	ms.vss-work-web.product-backlog-tabs
Registerkarte "Iterationsbacklog"	ms.vss-work-web.iteration-backlog-tabs
Bereich "Portfoliobacklog"	ms.vss-work-web.portfolio-backlog-toolpane
Bereich "Product Backlog"	ms.vss-work-web.requirement-backlog-toolpane
Bereich "Iterationsbacklog"	ms.vss-work-web.iteration-backlog-toolpane

Menü und Symbolleiste von Azure Pipelines

Name	Ziel-ID	Vorschau
Buildmenü abgeschlossen	ms.vss-build-web.completed-build-menu
Menü "Builddefinitionen"	ms.vss-build-web.build-definition-menu
Symbolleistenaktion "Ergebnisse testen"	ms.vss-test-web.test-results-actions-menu
Registerkarte "Testergebnisdetails"	ms.vss-test-web.test-result-details-tab-items
Kontextmenü des Releasepipeline-Explorers	ms.vss-releaseManagement-web.release-definition-explorer-context-menu
Symbolleistenmenü des Releasepipeline-Explorers	ms.vss-releaseManagement-web.release-definition-explorer-toolbar-menu
Symbolleistenmenü "Releasezusammenfassung"	ms.vss-releaseManagement-web.release-editor-tool-bar-menu
Registerkarte "Releasezusammenfassung"	ms.vss-releaseManagement-web.release-details-view
Abschnitt "Releasezusammenfassung"	ms.vss-releaseManagement-web.release-details-summary-tab
Pipelinedetailsesicht, Headerschaltfläche	ms.vss-build-web.pipelines-header-menu
Pipelinedetailsesicht, Ordnerkontextmenü	ms.vss-build-web.pipelines-folder-menu

Azure Pipelines-Aufgaben

Aufgaben führen Aufgaben in einem Build oder Release aus. Weitere Informationen finden Sie in diesem Artikel, wie Sie einen Build- oder Releasetask beisteuern.

Azure Repos Menü und Symbolleiste

Name	Ziel-ID	Vorschaubild
Quellelement (Raster) Menü	ms.vss-code-web.source-grid-item-menu
Quellelement (Struktur) Menü	ms.vss-code-web.source-tree-item-menu
Quellelementmenü (Raster und Struktur)	ms.vss-code-web.source-item-menu
Menü "Listenelement ändern"	ms.vss-code-web.change-list-item-menu
Menü "Listenzusammenfassung ändern"	ms.vss-code-web.change-list-summary-item-menu
Menü "Git Branches"-Struktur	ms.vss-code-web.git-branches-tree-menu
Git-Pull Request-Menü "Aktionen"	ms.vss-code-web.pull-request-action-menu
Git-Pull Request-Registerkarten (Pivots)	ms.vss-code-web.pr-tabs
Git-Commit-Auflistungsmenü	ms.vss-code-web.git-commit-list-menu
Menü "Git-Commitdetails"	ms.vss-code-web.git-commit-details-menu

Azure Test Plans Menü und Symbolleiste

Name	Ziel-ID	Vorschaubild
Menü "Testlaufraster"	ms.vss-test-web.test-run-grid-menu
Strukturmenü "Testplansammlungen"	ms.vss-test-web.test-plans-suites-context
Pivotregisterkarte "Testplanhub"	ms.vss-test-web.test-plan-pivot-tabs

Weitere Erweiterbarkeitspunkte

• Dashboardwidget: Eine Erweiterung kann einen neuen Widgettyp beitragen, der von Benutzern einer Dashboard hinzugefügt werden kann. Erfahren Sie, wie Sie ein Dashboard Widget beitragen.
• Arbeitselementformular: Das Arbeitselementformular wird durch Erweiterungen mit neuen Abschnitten, Registerkarten, Aktionen und benutzerdefinierten Feldrenderern erweitert. Weitere Informationen finden Sie unter Erweitern des Arbeitselementformulars.
• Diensthooks: Ein "Consumer" ist der Dienst, an den Ereignisse in Service Hooks gesendet werden. Eine Erweiterung kann zu Consumerdiensten beitragen. Diese Dienste werden von einem Benutzer (oder programmgesteuert) konfiguriert, um Ereignisse an diesen Dienst zu senden. Weitere Informationen finden Sie unter Beitragen eines Service Hooks-Consumers.
• Features:

Namen: Vorschaufeature (nur gehostet)
Ziel-ID: ms.vss-web.managed-features