Punti di estendibilità

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

Le estensioni migliorano l'esperienza utente di Azure DevOps contribuendo a nuove funzionalità. In questo articolo vengono evidenziati i punti di estendibilità più comuni di destinazione dell'estensione. Per altre informazioni sul modello di estendibilità di Azure DevOps, vedere il modello di contributo.

L'estensione Della Guida ai contributi è un'estensione di esempio. Installare questa estensione nell'organizzazione. Dopo l'installazione, vengono visualizzati i punti di estendibilità disponibili. È consigliabile installare questa estensione in un'organizzazione personale o di test. È disponibile anche l'origine per questa estensione .

Per altre informazioni, consultare i riferimenti seguenti:

• azure-devops-extension-api
• azure-devops-extension-sdk
• azure-devops-extension-sample
• API dell'estensione installata

Hub e gruppi hub

Hub e gruppi hub sono gli elementi di spostamento principali in Azure DevOps. File, versioni, backlog e query sono esempi di hub. Un hub appartiene a un gruppo hub. L'hub File, ad esempio, appartiene al gruppo hub Azure Repos a livello di progetto. I gruppi hub possono esistere a livello di organizzazione o raccolta o a livello di progetto. La maggior parte delle estensioni contribuisce al livello di progetto.

La tabella seguente descrive i gruppi hub più comuni in Azure DevOps a cui è possibile contribuire gli hub.

Nome	ID	Livello	Anteprima immagine
Azure Boards	ms.vss-work-web.work-hub-group	Progetto/team
Azure Repos	ms.vss-code-web.code-hub-group	Progetto/team
Azure Pipelines	ms.vss-build-web.build-release-hub-group	Progetto/team
Azure Test Plans	ms.vss-test-web.test-hub-group	Progetto/team
Impostazioni del progetto	ms.vss-web.project-admin-hub-group	Project
Impostazioni dell'organizzazione	ms.vss-web.collection-admin-hub-group	Organizzazione o raccolta

Esempio

L'esempio seguente illustra come contribuire a un hub al gruppo hub di codice:

{
    ...
    "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 è il tipo di questo contributo. Questo tipo viene definito nell'estensione vss-web pubblicata nel server ms di pubblicazione. Questo tipo dichiara proprietà facoltative e obbligatorie richieste dai contributi di questo tipo (ad esempio, nome, ordine e così via).
• ms.vss-code-web.code-hub-group è l'ID completo del contributo del gruppo hub destinato a questo hub. Questo contributo viene dichiarato nell'estensione pubblicata nell'editore vss-code-web ms
• my-custom-hub è l'ID breve di questo contributo; {publisherId}.{extensionId}.my-custom-hub è l'ID completo

Aggiungere un'icona al menu o alla barra degli strumenti

Aggiungere una proprietà icona, in modo che possa essere usata direttamente in base al nome.

È consigliabile fornire un'icona personalizzata. Esempio di icona personalizzata:

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

Uso dell'esempio di icone di Office UI Fabric:

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

Impostazioni per menu e barre degli strumenti

Nome	ID di destinazione
Barra degli strumenti di panoramica dell'organizzazione/raccolta	ms.vss-admin-web.collection-overview-toolbar-menu
Griglia dei progetti di panoramica della raccolta	ms.vss-admin-web.projects-grid-menu
Barra degli strumenti panoramica del progetto	ms.vss-admin-web.project-overview-toolbar-menu
Griglia dei team di panoramica del progetto	ms.vss-admin-web.teams-grid-menu

Menu e barra degli strumenti di Azure Boards

Nome	ID di destinazione	Anteprima immagine
Menu query elemento di lavoro	ms.vss-work-web.work-item-query-menu
Menu della barra degli strumenti risultati query elemento di lavoro	ms.vss-work-web.work-item-query-results-toolbar-menu
Voce di menu Risultati query elemento di lavoro	ms.vss-work-web.query-result-work-item-menu
Scheda Risultati query elemento di lavoro	ms.vss-work-web.query-tabs
Elemento di lavoro per il menu di scelta rapida	ms.vss-work-web.work-item-toolbar-menu
Menu Voce backlog	ms.vss-work-web.backlog-item-menu
Menu filtro pivot della scheda Sprint	ms.vss-work-web.sprint-board-pivot-filter-menu
Menu filtro pivot scheda	ms.vss-work-web.backlog-board-pivot-filter-menu
Menu Scheda	ms.vss-work-web.backlog-board-card-item-menu
Scheda Backlog prodotto	ms.vss-work-web.product-backlog-tabs
Scheda Backlog di iterazione	ms.vss-work-web.iteration-backlog-tabs
Riquadro backlog portfolio	ms.vss-work-web.portfolio-backlog-toolpane
Riquadro Backlog prodotto	ms.vss-work-web.requirement-backlog-toolpane
Riquadro backlog di iterazione	ms.vss-work-web.iteration-backlog-toolpane

Menu e barra degli strumenti di Azure Pipelines

Nome	ID di destinazione	Anteprima
Menu compilazione completato	ms.vss-build-web.completed-build-menu
Azione della barra degli strumenti Risultati test	ms.vss-test-web.test-results-actions-menu
Scheda Dettagli risultato test	ms.vss-test-web.test-result-details-tab-items
Menu di scelta rapida di Esplora pipeline di versione	ms.vss-releaseManagement-web.release-definition-explorer-context-menu
Visualizzazione dettagli pipeline, pulsante intestazione	ms.vss-build-web.pipelines-header-menu
Visualizzazione dettagli pipeline, menu di scelta rapida della cartella	ms.vss-build-web.pipelines-folder-menu

Attività di Azure Pipelines

Le attività eseguono operazioni in una compilazione o in una versione. Per altre informazioni, vedere come contribuire a un'attività di compilazione o versione.

Menu e barra degli strumenti di Azure Repos

Nome	ID di destinazione	Anteprima immagine
Menu Voce di origine (griglia)	ms.vss-code-web.source-grid-item-menu
Menu Elemento di origine (albero)	ms.vss-code-web.source-tree-item-menu
Menu Elemento di origine (griglia e albero)	ms.vss-code-web.source-item-menu
Menu Cambia voce di elenco	ms.vss-code-web.change-list-item-menu
Menu Cambia voce di riepilogo elenco	ms.vss-code-web.change-list-summary-item-menu
Menu albero dei rami Git	ms.vss-code-web.git-branches-tree-menu
Menu Azioni richiesta pull Git	ms.vss-code-web.pull-request-action-menu
Schede delle richieste pull Git (pivot)	ms.vss-code-web.pr-tabs
Menu elenco commit Git	ms.vss-code-web.git-commit-list-menu
Menu dettagli commit Git	ms.vss-code-web.git-commit-details-menu

Menu e barra degli strumenti dei piani di test di Azure

Nome	ID di destinazione	Anteprima immagine
Menu Griglia esecuzione test	ms.vss-test-web.test-run-grid-menu
Menu albero gruppi di piani di test	ms.vss-test-web.test-plans-suites-context
Scheda Pivot dell'hub del piano di test	ms.vss-test-web.test-plan-pivot-tabs

Altri punti di estendibilità

• Widget dashboard: un'estensione può contribuire a un nuovo tipo di widget che può essere aggiunto dagli utenti a un dashboard. Informazioni su come contribuire a un widget del dashboard.
• Modulo elemento di lavoro: il modulo dell'elemento di lavoro è migliorato dalle estensioni con nuove sezioni, schede, azioni e renderer di campi personalizzati. Per altre informazioni, vedere come estendere il modulo dell'elemento di lavoro.
• Hook del servizio: un "consumer" è il servizio a cui vengono inviati eventi negli hook del servizio. Un'estensione può contribuire ai servizi consumer. Questi servizi vengono configurati da un utente (o a livello di codice) per inviare eventi a tale servizio. Per altre informazioni, vedere Contribuire a un consumer di hook del servizio.
• Funzionalità:

Nome: Funzionalità di anteprima (solo ospitata)
ID di destinazione: ms.vss-web.managed-features