Condividi tramite

Aggiungere un'azione di menu

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

In questo esempio, aggiungiamo un'azione al menu di scelta rapida della query nell'hub delle query degli elementi di lavoro.

Consiglio

Per le linee guida più recenti per lo sviluppo di estensioni, incluse la tematizzazione e la migrazione da VSS.SDK, vedere il portale per sviluppatori di Azure DevOps Extension SDK.

Prerequisiti

Aggiornare il manifesto dell'estensione

Aggiungi la tua azione alla sezione delle contribuzioni del manifesto dell'estensione.

...
    "contributions": [
        {
            "id": "myAction",
            "type": "ms.vss-web.action",
            "description": "Run in Hello hub action",
            "targets": [
                "ms.vss-work-web.work-item-query-menu"
            ],
            "properties": {
                "text": "Run in Hello hub",
                "title": "Run in Hello hub",
                "icon": "images/icon.png",
                "groupId": "actions",
                "uri": "action.html"
            }
        }
    ]
...

Proprietà

Proprietà Descrizione
Testo Testo visualizzato nella voce di menu.
titolo Testo visualizzato nella voce di menu.
icona URL di un'icona visualizzata nella voce di menu. Gli URL relativi vengono risolti usando baseUri.
groupId (ID del gruppo) Determina la posizione in cui viene visualizzata questa voce di menu in relazione agli altri.
Uri URI a una pagina che registra il gestore dell'azione di menu (vedere di seguito).
IDOggettoRegistrato (Facoltativo) Nome del gestore dell'azione del menu registrato. Viene utilizzato come predefinito l'ID collaboratore.

Informazioni su tutte le posizioni in cui è possibile aggiungere azioni nei punti di estendibilità .

La tua Pagina HTML

L'azione di menu è rappresentata da uno script JavaScript incorporato in un file HTML. Salvare il contenuto seguente in un file e in un percorso corrispondente al riferimento nel file manifesto dell'estensione.

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Action Sample</title>
    <script src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.6/require.min.js"></script>
    <script>
        window.requirejs.config({
            enforceDefine: true,
            paths: {
                'SDK': './lib/SDK.min'
            }
        });
        window.requirejs(['SDK'], function (SDK) {
            SDK.init();
            SDK.ready().then(() => {
                // Register the menu action handler
                SDK.register(SDK.getContributionId(), {
                    execute: function (actionContext) {
                        alert("Hello, world");
                    }
                });
            });
        });
    </script>
</head>
<body>
    <div>
        The end user doesn't see the content on this page.
        It runs in the background to handle the contributed menu item being selected.
    </div>
</body>
</html>

Consiglio

Per ulteriori informazioni, vedere i punti di estendibilità, menu e barre degli strumenti , il modello di contributo , il sistema di progettazione delle formule , il riferimento API REST , gli esempi di estensioni e le risorse nella Developer Community .

Passaggi successivi

Creare un pacchetto, pubblicare e installare l'estensione.

  • Last updated on