Erweiterungspunkte

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

Erweiterungen verbessern die Benutzererfahrung von Azure DevOps durch einen Beitrag zu neuen Funktionen. In diesem Artikel werden die am häufigsten verwendeten Erweiterbarkeitspunkte hervorgehoben, auf die Ihre Erweiterung ausgerichtet werden kann. Weitere Informationen zum Azure DevOps-Erweiterbarkeitsmodell finden Sie im Beitragsmodell.

Die Erweiterung "Beitragsleitfaden " ist eine Beispielerweiterung. Installieren Sie diese Erweiterung in Ihrer Organisation. Nach der Installation werden die erweiterbaren Punkte angezeigt, die verfügbar sind. Es wird empfohlen, diese Erweiterung in einer persönlichen oder Testorganisation zu installieren. Die Quelle für diese Erweiterung ist ebenfalls verfügbar. Hier finden Sie auch 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, Versionen, Backlogs und Abfragen sind Beispiele für Hubs. Ein Hub gehört zu einer Hubgruppe. Der Dateien-Hub gehört beispielsweise zur Azure Repos-Hubgruppe auf Projektebene. Hubgruppen können auf Organisation- oder Sammlungsebene oder auf Projektebene vorhanden sein. Die meisten Erweiterungen tragen zur Projektebene bei.

In der folgenden Tabelle werden die am häufigsten verwendeten Hubgruppen in Azure DevOps beschrieben, zu denen Sie Hubs beitragen können.

Name	Kennung	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	Projekt
Organisationseinstellungen	ms.vss-web.collection-admin-hub-group	Organisation oder Sammlung

Beispiel

Das folgende Beispiel zeigt, wie Sie einen Hub zur Code Hub-Gruppe 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 die Art dieses Beitrags. Dieser Typ wird in der vss-web unter dem ms Herausgeber veröffentlichten Erweiterung definiert. 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 ausgerichtet ist. Dieser Beitrag wird in der vss-code-web unter dem ms Herausgeber veröffentlichten Erweiterung deklariert.
• my-custom-hub ist die kurze ID dieses Beitrags; {publisherId}.{extensionId}.my-custom-hub ist die vollständige ID

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

Fügen Sie eine Symboleigenschaft hinzu, damit sie direkt anhand des Namens verwendet werden kann.

Es wird empfohlen, Ihr 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
       }

Beispiel für Office UI Fabric-Symbole :

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

Einstellungen für Menüs und Symbolleisten

Name	Ziel-ID
Übersichtssymbolleiste für Organisation/Sammlung	ms.vss-admin-web.collection-overview-toolbar-menu
Übersichtsraster für Auflistungen	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ü 'Ergebnisse der Arbeitsaufgabe-Abfrage'	ms.vss-work-web.work-item-query-results-toolbar-menu
Ergebniselement für Arbeitsaufgabenabfragen	ms.vss-work-web.query-result-work-item-menu
Registerkarte "Ergebnisse der Arbeitsaufgabe"-Abfrage	ms.vss-work-web.query-tabs
Arbeitsaufgabe für Kontextmenü	ms.vss-work-web.work-item-toolbar-menu
Menü "Backlog"-Element	ms.vss-work-web.backlog-item-menu
Sprintboard-Pivotfiltermenü	ms.vss-work-web.sprint-board-pivot-filter-menu
Pivotfiltermenü 'Board'	ms.vss-work-web.backlog-board-pivot-filter-menu
Kartenmenü	ms.vss-work-web.backlog-board-card-item-menu
Registerkarte "Produktrückmelde"	ms.vss-work-web.product-backlog-tabs
Registerkarte "Iterationsbacklog"	ms.vss-work-web.iteration-backlog-tabs
Portfolio-Backlog-Bereich	ms.vss-work-web.portfolio-backlog-toolpane
Bereich "Produktrücklog"	ms.vss-work-web.requirement-backlog-toolpane
Iterations-Backlogbereich	ms.vss-work-web.iteration-backlog-toolpane

Azure Pipelines-Menü und Symbolleiste

Name	Ziel-ID	Vorschau
Fertiges Buildmenü	ms.vss-build-web.completed-build-menu
Testergebnissymbolleistenaktion	ms.vss-test-web.test-results-actions-menu
Registerkarte "Testergebnisdetails"	ms.vss-test-web.test-result-details-tab-items
Kontextmenü des Pipeline-Explorers freigeben	ms.vss-releaseManagement-web.release-definition-explorer-context-menu
Pipelinedetailseite, Kopfzeilenschaltfläche	ms.vss-build-web.pipelines-header-menu
Pipelinedetailseite, Ordnerkontextmenü	ms.vss-build-web.pipelines-folder-menu

Azure Pipelines-Aufgaben

Aufgaben führen Arbeit in einem Build oder release aus. Weitere Informationen finden Sie unter "Mitwirken einer Build- oder Freigabeaufgabe".

Azure Repos-Menü und Symbolleiste

Name	Ziel-ID	Vorschaubild
Quellelementmenü (Raster)	ms.vss-code-web.source-grid-item-menu
Quellelementmenü (Struktur)	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ü 'Listenzusammenfassungselement ändern'	ms.vss-code-web.change-list-summary-item-menu
Git Branches Tree Menu	ms.vss-code-web.git-branches-tree-menu
Menü 'Git-Pullanforderungsaktionen'	ms.vss-code-web.pull-request-action-menu
Registerkarten für Git-Pullanforderung (Pivots)	ms.vss-code-web.pr-tabs
Git Commit-Eintragsmenü	ms.vss-code-web.git-commit-list-menu
Git Commit-Detailmenü	ms.vss-code-web.git-commit-details-menu

Menü und Symbolleiste für Azure-Testpläne

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

Weitere Erweiterbarkeitspunkte

• Dashboard-Widget: Eine Erweiterung kann einen neuen Widgettyp hinzufügen, der von Benutzern zu einem Dashboard hinzugefügt werden kann. Erfahren Sie, wie Sie ein Dashboard-Widget mitwirken.
• Arbeitselementformular: Das Arbeitsaufgabenformular wird durch Erweiterungen mit neuen Abschnitten, Registerkarten, Aktionen und benutzerdefinierten Feldrenderern erweitert. Weitere Informationen finden Sie im Erweitern des Arbeitsaufgabenformulars.
• Service-Hooks: Ein "Verbraucher" ist der Dienst, an den Ereignisse in Service Hooks gesendet werden. Eine Erweiterung kann zu Verbraucherdiensten beitragen. Diese Dienste werden von einem Benutzer (oder programmgesteuert) konfiguriert, um Ereignisse an diesen Dienst zu senden. Weitere Informationen finden Sie unter "Mitwirken eines Service hooks Consumers".
• Funktionen:

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