Sdílet prostřednictvím

Konkrétní body rozšiřitelnosti

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

Rozšíření přidávají možnosti do uživatelského rozhraní Azure DevOps a rozhraní REST. Tento článek obsahuje seznam nejběžnějších bodů rozšiřitelnosti, na které můžete cílit, a zobrazuje ID, která používáte v manifestu rozšíření. Přehled modelů rozšíření a vzorů příspěvků najdete v modelu přispívání.

Návod

Pokud spouštíte nové rozšíření Azure DevOps, vyzkoušejte nejdřív tyto spravované ukázkové kolekce – pracují s aktuálními buildy produktů a pokrývají moderní scénáře (například přidávání karet na stránkách žádostí o přijetí změn).

Pokud ukázka ve vaší organizaci nefunguje, nainstalujte ji do osobní nebo testovací organizace a porovnejte cílové ID manifestu rozšíření a verze rozhraní API s aktuálními dokumenty. Referenční informace a rozhraní API najdete tady:

Centra a skupiny center

Centra a skupiny center poskytují primární navigaci v Azure DevOps (například soubory, vydané verze, backlogy, dotazy). Centrum patří do skupiny rozbočovačů; například rozbočovač Soubory patří do skupiny rozbočovačů úrovně projektu Azure Repos. Skupiny centra můžou existovat na úrovni organizace nebo kolekce nebo na úrovni projektu. Většina rozšíření přispívá na úrovni projektu.

V následující tabulce jsou uvedeny společné skupiny center a JEJICH ID příspěvků.

Název ID Úroveň Náhled obrázku
Azure Boards ms.vss-work-web.work-hub-group Projekt nebo tým Snímek obrazovky vlastního pracovního centra přidaného do Azure Boards.
Azure Repos ms.vss-code-web.code-hub-group Projekt nebo tým Snímek obrazovky vlastního pracovního centra přidaného do Azure Repos.
Azure Pipelines ms.vss-build-web.build-release-hub-group Projekt nebo tým Snímek obrazovky vlastního centra přidaného do Azure Pipelines.
Azure Test Plans ms.vss-test-web.test-hub-group Projekt nebo tým Snímek obrazovky vlastního centra přidaného do Azure Test Plans.
Nastavení projektu ms.vss-web.project-admin-hub-group Projekt Snímek obrazovky vlastního centra pro správu projektu.
Nastavení organizace ms.vss-web.collection-admin-hub-group Organizace nebo kolekce Snímek obrazovky vlastního centra pro správu organizace.

Přispějte centrum

Tento příklad ukazuje příspěvek centra, který cílí na skupinu Centra kódu:

{
  "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 je typ příspěvku. Toto vss-web rozšíření publikované pod vydavatelem ms definuje tento typ. Tento typ definuje volitelné a požadované vlastnosti pro příspěvky tohoto typu (například název, objednávka).
  • ms.vss-code-web.code-hub-group je úplné ID příspěvku skupiny hub, na který se toto centrum zaměřuje. Toto vss-code-web rozšíření publikované pod vydavatelem ms deklaruje tento příspěvek.
  • my-custom-hub je zkrácené ID tohoto příspěvku; {publisherId}.{extensionId}.my-custom-hub je úplný průkaz totožnosti.

Přidejte ikonu do nabídky nebo panelu nástrojů

Přidejte vlastnost ikony, abyste na ni mohli odkazovat přímo podle názvu.

Doporučujeme vám poskytnout vlastní ikonu. Použití vlastního příkladu ikony:

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

Příklad s ikonami Office UI Fabric Icons:

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

Poznámka:

icon Ikony a iconName vlastnosti nepodporují příspěvky tabulátoru. Fungují jenom pro centra, nabídky a panely nástrojů.

Nastavení nabídek a panelů nástrojů

Název ID cíle
Panel nástrojů pro přehled organizace/kolekce ms.vss-admin-web.collection-overview-toolbar-menu
Mřížka projektů přehledu kolekcí ms.vss-admin-web.projects-grid-menu
Panel nástrojů Přehled projektu ms.vss-admin-web.project-overview-toolbar-menu
Mřížka přehledu týmů projektu ms.vss-admin-web.teams-grid-menu

Nabídka a panel nástrojů Azure Boards

Název ID cíle Náhled obrázku
Nabídka dotazu na pracovní položku ms.vss-work-web.work-item-query-menu Snímek obrazovky vlastní akce dotazu byl přidán do nabídky dotazu.
Nabídka panelu nástrojů výsledků dotazu na pracovní položku ms.vss-work-web.work-item-query-results-toolbar-menu Snímek obrazovky s akcí nabídky vlastního panelu nástrojů Výsledky dotazu.
Položka nabídky výsledků dotazu na pracovní položku ms.vss-work-web.query-result-work-item-menu Snímek obrazovky vlastní akce nabídky položky Výsledky dotazu.
Karta výsledků dotazu na pracovní položky ms.vss-work-web.query-tabs Snímek obrazovky vlastní kontingenční karty panelu nástrojů dotazu.
Položka nabídky pro kontextové menu ms.vss-work-web.work-item-toolbar-menu Snímek obrazovky s akcemi panelu nástrojů vlastní pracovní položky.
Nabídka položky backlogu ms.vss-work-web.backlog-item-menu Snímek obrazovky s akcemi nevyřízených položek Vlastní možnosti nabídky.
Nabídka kontingenčního filtru panelu sprintu ms.vss-work-web.sprint-board-pivot-filter-menu Snímek obrazovky nabídky kontingenčního filtru sprintové desky.
Nabídka filtru kontingenční tabulky na desce ms.vss-work-web.backlog-board-pivot-filter-menu Snímek obrazovky s akcemi kontingenčního filtru panelu nevyřízených položek.
Karta nabídky ms.vss-work-web.backlog-board-card-item-menu
Záložka produktového backlogu ms.vss-work-web.product-backlog-tabs Snímek obrazovky vlastní karty produktového backlogu.
Záložka backlogu iterace ms.vss-work-web.iteration-backlog-tabs Snímek obrazovky iterací Backlog Custom Tab.
Podokno backlogu portfolia ms.vss-work-web.portfolio-backlog-toolpane Snímek obrazovky vlastního podokna Backlog portfolia.
Podokno backlogu produktu ms.vss-work-web.requirement-backlog-toolpane Snímek obrazovky vlastního podokna produktového backlogu.
Podokno backlogu iterace ms.vss-work-web.iteration-backlog-toolpane Snímek obrazovky vlastního podokna Backlog iterace.

Nabídka a panel nástrojů Azure Pipelines

Název ID cíle Náhled
Dokončené menu sestavení ms.vss-build-web.completed-build-menu Snímek obrazovky s dokončenými akcemi sestavení.
Nabídka Sestavení definic ms.vss-build-web.build-definition-menu Snímek obrazovky s akcemi definice sestavení.
Akce na panelu nástrojů pro výsledky testu ms.vss-test-web.test-results-actions-menu Snímek obrazovky s akcí panelu nástrojů výsledků testu.
Karta Podrobnosti o výsledku testu ms.vss-test-web.test-result-details-tab-items Snímek obrazovky s podrobnostmi o výsledku testu.
Místní nabídka Průzkumníka uvolňovacího kanálu ms.vss-releaseManagement-web.release-definition-explorer-context-menu Snímek obrazovky kontextové nabídky průzkumníka definic.
Nabídka panelu nástrojů Průzkumníka kanálu verze ms.vss-releaseManagement-web.release-definition-explorer-toolbar-menu Snímek obrazovky s nabídkou panelu nástrojů průzkumníka definic.
Nabídka panelu nástrojů souhrnu vydaných verzí ms.vss-releaseManagement-web.release-editor-tool-bar-menu Snímek obrazovky s nabídkou panelu nástrojů souhrnu vydání.
Karta Souhrn vydaných verzí ms.vss-releaseManagement-web.release-details-view Snímek obrazovky karty se shrnutím verze.
Oddíl souhrnu vydaných verzí ms.vss-releaseManagement-web.release-details-summary-tab Snímek obrazovky části se shrnutím verze.

Nabídka a panel nástrojů Azure Pipelines

Název ID cíle Náhled
Dokončené menu sestavení ms.vss-build-web.completed-build-menu Snímek obrazovky s dokončenými akcemi sestavení.
Akce na panelu nástrojů pro výsledky testu ms.vss-test-web.test-results-actions-menu Snímek obrazovky s akcí panelu nástrojů výsledků testu.
Karta Podrobnosti o výsledku testu ms.vss-test-web.test-result-details-tab-items Snímek obrazovky s podrobnostmi o výsledku testu.
Místní nabídka Průzkumníka uvolňovacího kanálu ms.vss-releaseManagement-web.release-definition-explorer-context-menu Snímek obrazovky kontextové nabídky průzkumníka definic.
Zobrazení podrobností kanálu, tlačítko záhlaví ms.vss-build-web.pipelines-header-menu Snímek obrazovky zobrazení podrobností kanálu, nabídka záhlaví.
Zobrazení podrobností potrubí, místní nabídka složky ms.vss-build-web.pipelines-folder-menu Snímek obrazovky zobrazení podrobností kanálu, kontextová nabídka složky.

Úlohy Azure Pipelines

Úkoly provádějí práci v sestavení nebo vydané verzi. Další informace najdete v tématu Přidání vlastního rozšíření úlohy pipelines.

Nabídka a panel nástrojů Azure Repos

Název ID cíle Náhled obrázku
Nabídka pro položku zdroje (mřížka) ms.vss-code-web.source-grid-item-menu Snímek obrazovky s akcemi mřížky položek v úložištích.
Nabídka položky zdroje (strom) ms.vss-code-web.source-tree-item-menu Snímek obrazovky s akcemi stromu položek v repozitářích.
Nabídka zdrojové položky (mřížka a strom) ms.vss-code-web.source-item-menu Snímek obrazovky s akcemi položek v úložištích.
Změnit položku v nabídce seznamu ms.vss-code-web.change-list-item-menu
Nabídka Změnit souhrnnou položku seznamu ms.vss-code-web.change-list-summary-item-menu
Nabídka stromu větví Gitu ms.vss-code-web.git-branches-tree-menu Snímek stromu git branchs.
Nabídka akcí žádosti o přijetí změn Gitu ms.vss-code-web.pull-request-action-menu Snímek obrazovky s akcemi žádosti o přijetí změn Git.
Karty žádostí o přijetí změn Gitu (pivoty) ms.vss-code-web.pr-tabs Snímek obrazovky karty žádosti o přijetí změn Git.
Nabídka výpisu potvrzení Gitu ms.vss-code-web.git-commit-list-menu Snímek obrazovky nabídky seznamu git commitů.
Nabídka podrobností o Commitu Git ms.vss-code-web.git-commit-details-menu Snímek obrazovky detailního menu git commitu.

Nabídka a panel nástrojů Azure Test Plans

Název ID cíle Náhled obrázku
Nabídka mřížky testovacího spuštění ms.vss-test-web.test-run-grid-menu Snímek obrazovky s nabídkou mřížky zkušebního běhu.
Nabídka stromu testovacích sad ms.vss-test-web.test-plans-suites-context Snímek obrazovky kontextu sad testovacích plánů.
Karta Pivot centra testovacího plánu ms.vss-test-web.test-plan-pivot-tabs Snímek obrazovky s kartou kontingenčního centra testovacího centra.

Další body rozšiřitelnosti

  • Widget řídicího panelu: Rozšíření může přispět novým typem widgetu, který uživatelé můžou přidat na řídicí panel. Naučte se přidat widget na řídicí panel.
  • Formulář pracovní položky: Rozšíření vylepšují formulář pracovní položky novými oddíly, kartami, akcemi a vykreslovači vlastních polí. Chcete-li se dozvědět více, naučte se, jak rozšířit formulář pracovní položky.
  • Service Hooks: Spotřebitelem je služba, do které služba Service Hooks odesílá události. Rozšíření může poskytovat spotřebitelské služby. Uživatel (nebo programově) tyto služby nakonfiguruje tak, aby odesílaly události do této služby. Další informace naleznete v tématu Vytvoření vlastního příjemce pro zavěšení služby.
  • Last updated on