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, mettiamo in evidenza i punti di estensione più comuni che la tua estensione può utilizzare. 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 il sorgente 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 di hub

Hub e gruppi di hub sono gli elementi di navigazione 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
Piani di Test di Azure	ms.vss-test-web.test-hub-group	Progetto/team
Impostazioni del progetto	ms.vss-web.project-admin-hub-group	Progetto
Impostazioni dell'organizzazione	ms.vss-web.collection-admin-hub-group	Organizzazione o raccolta

Esempio

L'esempio seguente illustra come contribuire con un hub al gruppo Hub del 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 a cui questo hub è destinato. Questo contributo viene specificato nell'estensione pubblicata sotto il publisher vss-code-webms
• 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

Aggiungi una proprietà di icona, in modo che possa essere utilizzata direttamente per nome.

È consigliabile fornire un'icona personalizzata. Utilizzando il tuo esempio di icona personalizzata:

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

Esempio di utilizzo delle icone 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 panoramica dei progetti 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 di interrogazione degli elementi di lavoro	ms.vss-work-web.work-item-query-menu
Menu della barra degli strumenti dei risultati della query di elemento di lavoro	ms.vss-work-web.work-item-query-results-toolbar-menu
Voce di menu dei risultati delle query degli elementi di lavoro	ms.vss-work-web.query-result-work-item-menu
Scheda Risultati della query di elementi 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 di 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 pannello	ms.vss-work-web.backlog-board-pivot-filter-menu
Menu della scheda	ms.vss-work-web.backlog-board-card-item-menu
Scheda Backlog prodotto	ms.vss-work-web.product-backlog-tabs
Scheda di backlog dell'iterazione	ms.vss-work-web.iteration-backlog-tabs
Riquadro del backlog del portfolio	ms.vss-work-web.portfolio-backlog-toolpane
Riquadro del 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 per i risultati dei test	ms.vss-test-web.test-results-actions-menu
Scheda dei Dettagli del Risultato del Test	ms.vss-test-web.test-result-details-tab-items
Menu di scelta rapida dell'esploratore delle pipeline di rilascio	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
Cambia voce nel menu elenco	ms.vss-code-web.change-list-item-menu
Menu di modifica dell'elemento di riepilogo dell'elenco	ms.vss-code-web.change-list-summary-item-menu
Menu ad albero dei rami Git	ms.vss-code-web.git-branches-tree-menu
Menu azioni Pull Request Git	ms.vss-code-web.pull-request-action-menu
Schede delle richieste pull di Git	ms.vss-code-web.pr-tabs
Menu elenco di commit Git	ms.vss-code-web.git-commit-list-menu
Menu dettagli Git commit	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 della Griglia di Esecuzione Test	ms.vss-test-web.test-run-grid-menu
Struttura ad albero suite 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 ulteriori informazioni, scopri come estendere il modulo dell'elemento di lavoro.
• Service Hook: un "consumatore" è il servizio a cui vengono inviati eventi nei Service Hooks. Un'estensione può contribuire ai servizi rivolti ai consumatori. Questi servizi vengono configurati da un utente (o a livello di codice) per inviare eventi a tale servizio. Per ulteriori informazioni, vedere contribuire a un consumer per hook di servizio.
• Funzionalità:

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