Points d’extensibilité

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

Les extensions améliorent l’expérience utilisateur Azure DevOps en contribuant à de nouvelles fonctionnalités. Dans cet article, nous mettons en évidence les points d’extensibilité les plus courants que votre extension peut cibler. Pour plus d’informations sur le modèle d’extensibilité Azure DevOps, consultez le modèle de contribution.

L’extension Du Guide des contributions est un exemple d’extension. Installez cette extension dans votre organisation. Une fois l’installation terminée, vous voyez les points d’extensibilité disponibles. Nous vous recommandons d’installer cette extension dans une organisation personnelle ou de test. La source de cette extension est également disponible.

Pour en savoir plus, consultez les références suivantes :

• azure-devops-extension-api
• azure-devops-extension-sdk
• azure-devops-extension-sample
• API d’extension installée

Hubs et groupes hub

Les hubs et les groupes hub sont les principaux éléments de navigation dans Azure DevOps. Les fichiers, versions, backlogs et requêtes sont des exemples de hubs. Un hub appartient à un groupe hub. Le hub Files appartient, par exemple, au groupe de hubs Azure Repos au niveau du projet. Les groupes hub peuvent exister au niveau de l’organisation ou de la collection ou au niveau du projet. La plupart des extensions contribuent au niveau du projet.

Le tableau suivant décrit les groupes de hubs les plus courants dans Azure DevOps auxquels vous pouvez contribuer.

Nom	id	Niveau	Aperçu de l'image
Azure Boards	ms.vss-work-web.work-hub-group	Projet/équipe
Azure Repos	ms.vss-code-web.code-hub-group	Projet/équipe
Azure Pipelines	ms.vss-build-web.build-release-hub-group	Projet/équipe
Azure Test Plans	ms.vss-test-web.test-hub-group	Projet/équipe
Paramètres du projet	ms.vss-web.project-admin-hub-group	Project
Paramètres de l’organisation	ms.vss-web.collection-admin-hub-group	Organisation ou collection

Exemple

L’exemple suivant montre comment contribuer à un hub au groupe Du hub de code :

{
    ...
    "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 est le type de cette contribution. Ce type est défini dans l’extension vss-web publiée sous l’éditeur ms . Ce type déclare les propriétés facultatives et obligatoires requises par les contributions de ce type (par exemple, nom, ordre, etc.).
• ms.vss-code-web.code-hub-group est l’ID complet de la contribution du groupe hub que ce hub cible. Cette contribution est déclarée dans l’extension publiée sous l’éditeur vss-code-web ms
• my-custom-hub est l’ID court de cette contribution ; {publisherId}.{extensionId}.my-custom-hub est l’ID complet

Ajouter une icône à votre menu ou barre d’outils

Ajoutez une propriété d’icône, afin qu’elle puisse être utilisée directement par nom.

Nous vous recommandons de fournir votre propre icône. À l’aide de votre propre exemple d’icône :

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

Utilisation de l’exemple d’icônes Office UI Fabric :

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

Paramètres des menus et des barres d’outils

Nom	ID de la cible
Barre d’outils Vue d’ensemble de l’organisation/collection	ms.vss-admin-web.collection-overview-toolbar-menu
Grille des projets de vue d’ensemble des regroupements	ms.vss-admin-web.projects-grid-menu
Barre d’outils Vue d’ensemble du projet	ms.vss-admin-web.project-overview-toolbar-menu
Grille des équipes de vue d’ensemble du projet	ms.vss-admin-web.teams-grid-menu

Menu et barre d’outils Azure Boards

Nom	ID de la cible	Aperçu de l'image
Menu requête d’élément de travail	ms.vss-work-web.work-item-query-menu
Menu de la barre d’outils résultats des requêtes d’élément de travail	ms.vss-work-web.work-item-query-results-toolbar-menu
Élément de menu Résultats de requête d’élément de travail	ms.vss-work-web.query-result-work-item-menu
Onglet Résultats de la requête d’élément de travail	ms.vss-work-web.query-tabs
Élément de travail pour le menu contextuel	ms.vss-work-web.work-item-toolbar-menu
Menu Élément du backlog	ms.vss-work-web.backlog-item-menu
Menu de filtre croisé dynamique du tableau sprint	ms.vss-work-web.sprint-board-pivot-filter-menu
Menu filtre croisé dynamique de tableau croisé dynamique	ms.vss-work-web.backlog-board-pivot-filter-menu
Menu Carte	ms.vss-work-web.backlog-board-card-item-menu
Onglet Backlog produit	ms.vss-work-web.product-backlog-tabs
Onglet backlog d’itération	ms.vss-work-web.iteration-backlog-tabs
Volet Du backlog de portefeuille	ms.vss-work-web.portfolio-backlog-toolpane
Volet Du backlog de produit	ms.vss-work-web.requirement-backlog-toolpane
Volet backlog d’itération	ms.vss-work-web.iteration-backlog-toolpane

Menu et barre d’outils Azure Pipelines

Nom	ID de la cible	Aperçu
Menu build terminé	ms.vss-build-web.completed-build-menu
Action de barre d’outils des résultats des tests	ms.vss-test-web.test-results-actions-menu
Onglet Détails du résultat de test	ms.vss-test-web.test-result-details-tab-items
Menu contextuel de l’Explorateur de pipelines de mise en production	ms.vss-releaseManagement-web.release-definition-explorer-context-menu
Mode Détails du pipeline, bouton d’en-tête	ms.vss-build-web.pipelines-header-menu
Vue détails du pipeline, menu contextuel dossier	ms.vss-build-web.pipelines-folder-menu

Tâches Azure Pipelines

Les tâches effectuent des tâches dans une build ou une version. Pour plus d’informations, découvrez comment contribuer à une tâche de génération ou de mise en production.

Menu Et barre d’outils Azure Repos

Nom	ID de la cible	Aperçu de l'image
Menu Élément source (grille)	ms.vss-code-web.source-grid-item-menu
Menu Élément source (arborescence)	ms.vss-code-web.source-tree-item-menu
Menu Élément source (grille et arborescence)	ms.vss-code-web.source-item-menu
Menu Modifier l’élément de liste	ms.vss-code-web.change-list-item-menu
Menu Modifier le résumé de la liste	ms.vss-code-web.change-list-summary-item-menu
Menu arborescence des branches Git	ms.vss-code-web.git-branches-tree-menu
Menu Actions de demande de tirage Git	ms.vss-code-web.pull-request-action-menu
Onglets de demande de tirage Git (pivots)	ms.vss-code-web.pr-tabs
Menu liste des validations Git	ms.vss-code-web.git-commit-list-menu
Menu détails de validation Git	ms.vss-code-web.git-commit-details-menu

Menu et barre d’outils Plans de test Azure

Nom	ID de la cible	Aperçu de l'image
Menu Grille d’exécution de test	ms.vss-test-web.test-run-grid-menu
Menu d’arborescence des suites de plans de test	ms.vss-test-web.test-plans-suites-context
Onglet pivot du hub de plan de test	ms.vss-test-web.test-plan-pivot-tabs

Autres points d’extensibilité

• Widget de tableau de bord : une extension peut contribuer à un nouveau type de widget qui peut être ajouté par les utilisateurs à un tableau de bord. Découvrez comment contribuer à un widget de tableau de bord.
• Formulaire d’élément de travail : le formulaire élément de travail est amélioré par les extensions avec de nouvelles sections, onglets, actions et convertisseurs de champs personnalisés. Pour plus d’informations, découvrez comment étendre le formulaire d’élément de travail.
• Hooks de service : un « consommateur » est le service auquel les événements sont envoyés dans Les hooks de service. Une extension peut contribuer aux services grand public. Ces services sont configurés par un utilisateur (ou par programme) pour envoyer des événements à ce service. Pour plus d’informations, consultez contribuer à un consommateur de hooks de service.
• Fonctionnalités :

Nom : fonctionnalité en préversion (hébergée uniquement)
ID cible : ms.vss-web.managed-features