Points d’extensibilité

  • Article

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 :

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 Hub personnalisé ajouté à Azure Boards.
Azure Repos ms.vss-code-web.code-hub-group Projet/équipe Hub personnalisé ajouté à Azure Repos.
Azure Pipelines ms.vss-build-web.build-release-hub-group Projet/équipe Hub personnalisé ajouté à Azure Pipelines.
Azure Test Plans ms.vss-test-web.test-hub-group Projet/équipe Hub personnalisé ajouté aux plans de test Azure.
Paramètres du projet ms.vss-web.project-admin-hub-group Project Hub d’administration de projet personnalisé.
Paramètres de l’organisation ms.vss-web.collection-admin-hub-group Organisation ou collection Hub d’administration d’organisation personnalisé.

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 Action de requête personnalisée ajoutée au menu de requête.
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 Action de menu de barre d’outils personnalisée résultats de requête
Élément de menu Résultats de requête d’élément de travail ms.vss-work-web.query-result-work-item-menu Action personnalisée du menu Élément de résultat de requête.
Onglet Résultats de la requête d’élément de travail ms.vss-work-web.query-tabs Onglet de tableau croisé dynamique personnalisé de la barre d’outils de requête
Élément de travail pour le menu contextuel ms.vss-work-web.work-item-toolbar-menu Actions de barre d’outils d’élément de travail personnalisées.
Menu Élément du backlog ms.vss-work-web.backlog-item-menu Options de menu personnalisées des actions d’élément de backlog.
Menu de filtre croisé dynamique du tableau sprint ms.vss-work-web.sprint-board-pivot-filter-menu Menu de filtre croisé dynamique du tableau sprint
Menu filtre croisé dynamique de tableau croisé dynamique ms.vss-work-web.backlog-board-pivot-filter-menu Actions de filtre croisé dynamique du tableau de backlog.
Menu Carte ms.vss-work-web.backlog-board-card-item-menu
Onglet Backlog produit ms.vss-work-web.product-backlog-tabs Capture d’écran de l’onglet Personnalisé backlog du produit.
Onglet backlog d’itération ms.vss-work-web.iteration-backlog-tabs Capture d’écran de l’onglet Personnalisé backlog.
Volet Du backlog de portefeuille ms.vss-work-web.portfolio-backlog-toolpane Capture d’écran du volet personnalisé du backlog de portefeuille.
Volet Du backlog de produit ms.vss-work-web.requirement-backlog-toolpane Capture d’écran du volet personnalisé du backlog de produit.
Volet backlog d’itération ms.vss-work-web.iteration-backlog-toolpane Capture d’écran du volet personnalisé du backlog d’itération.

Menu et barre d’outils Azure Pipelines

Nom ID de la cible Aperçu
Menu build terminé ms.vss-build-web.completed-build-menu Actions de génération terminées
Menu Définitions de build ms.vss-build-web.build-definition-menu Actions de définition de build
Action de barre d’outils des résultats des tests ms.vss-test-web.test-results-actions-menu Action de la barre d’outils Résultats de test
Onglet Détails du résultat de test ms.vss-test-web.test-result-details-tab-items Onglet Détails du résultat de test
Menu contextuel de l’Explorateur de pipelines de mise en production ms.vss-releaseManagement-web.release-definition-explorer-context-menu Menu contextuel de l’Explorateur de définitions
Menu de la barre d’outils de l’Explorateur de pipelines de mise en ms.vss-releaseManagement-web.release-definition-explorer-toolbar-menu Menu de la barre d’outils de l’Explorateur de définitions
Menu de la barre d’outils Résumé de mise en production ms.vss-releaseManagement-web.release-editor-tool-bar-menu Menu de la barre d’outils Résumé de mise en production
Onglet Résumé des mises en production ms.vss-releaseManagement-web.release-details-view Onglet Résumé de mise en production
Section Résumé des mises en production ms.vss-releaseManagement-web.release-details-summary-tab Section Résumé des mises en production

Menu et barre d’outils Azure Pipelines

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

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 Actions de grille d’éléments de repos
Menu Élément source (arborescence) ms.vss-code-web.source-tree-item-menu Actions de l’arborescence des éléments de repos
Menu Élément source (grille et arborescence) ms.vss-code-web.source-item-menu Actions d’élément de repos
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 Arborescence des branches Git
Menu Actions de demande de tirage Git ms.vss-code-web.pull-request-action-menu Actions de demande de tirage Git
Onglets de demande de tirage Git (pivots) ms.vss-code-web.pr-tabs Onglet Demande de tirage Git
Menu liste des validations Git ms.vss-code-web.git-commit-list-menu Menu Liste de validation Git
Menu détails de validation Git ms.vss-code-web.git-commit-details-menu Menu Détails de validation Git

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 Grille d’exécution de test
Menu d’arborescence des suites de plans de test ms.vss-test-web.test-plans-suites-context Contexte des suites de plans de test
Onglet pivot du hub de plan de test ms.vss-test-web.test-plan-pivot-tabs Onglet pivot du hub de test

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

Nom : Fonctionnalité (localement uniquement)
ID cible : ms.vss-web.managed-features-onprem