Share via

Hozzájárulási modell

  • Cikk

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

A bővítmények új képességeket adnak a rendszerbe hozzájárulások biztosításával és más bővítmények csatlakoztatási módjának meghatározásával. A hozzájárulási típus definiál valamit, amely hozzáadható a rendszerhez. A hozzájárulás egy adott típusú hozzájárulási példány. Például hub egy, a Microsoft által biztosított alapvető bővítmény által definiált hozzájárulási típus. A Explorer Build Hub csoport alatt lévő központ egy adott típusú hubhozzájárulás.

További információkért tekintse meg az alábbi hivatkozásokat:

Hozzájárulási típusok

A hozzájárulási típus olyan szerződést határoz meg, amelyet az adott típusú rendszerhez való összes hozzájárulásnak be kell tartania. A hozzájárulási típus egy másik hozzájárulási típustól is terjedhet. A következő hozzájárulástípusok az adott típusú példányok által beállított tulajdonságokat határozzák meg:

  • hub
  • action
  • build-task

Minden tulajdonságdefiníció a következő szempontokat határozza meg:

  • Tulajdonságtípus, például sztring, logikai stb.
  • Szükség van-e a tulajdonságra
  • Alapértelmezett érték, ha a hozzájárulás nem adja meg (nem kötelező).

Példa

Íme egy példa egy bővítményjegyzékben szereplő hozzájárulástípus-deklarációra:

{
    ...
    "contributionTypes": [
        {
            "id": "hub",
            "name": "Web Access Hub",
            "description": "A hub that appears in the hubs menu at the top of web pages.",
            "properties": {
                "name": {
                    "description": "The text to display for the hub",
                    "type": "string",
                    "required": true
                },
                "uri": {
                    "description": "URI of the contents of the hub page",
                    "type": "string",
                    "required": true
                },
                "order": {
                    "description": "An optional ordering value which can indicate in which position to place the hub within the hub group",
                    "type": "integer"
                }
				...
            }
        }
    ]
}

Hozzájárulások

A hozzájárulás a hozzájárulási típus egy példánya. A Work Hub csoport alatti központ például egy típusú hub hozzájárulás, a Publish Test Results buildelési feladat pedig Queries egy típusú build-taskhozzájárulás.

Minden hozzájárulásnak meg kell adnia egy típust, és meg kell adnia az adott hozzájárulástípus által megkövetelt tulajdonságok értékeit.

Példa

Íme egy példa egy hub-hozzájárulási deklarációra egy bővítményjegyzékben:

{
    "contributions": [
        {
            "id": "build-explorer-hub",
            "type": "ms.vss-web.hub",
            "targets": [
                ".build-hub-group"
            ],
            "properties": {
                "name": "Explorer",
                "uri": "/_build",
                "order": 22
            }
        }
    ]
}

Cél-hozzájárulások

A hozzájárulások egy vagy több egyéb hozzájárulást célozhatnak meg, ami kapcsolatot teremt a hozzájárulás és az egyes célok között. A rendszer futásidőben képes felderíteni a célhoz tartozó hozzájárulásokat. Egy hozzájárulás () például hub egy adott hub-group hozzájárulást (ExplorerBuild) célozhat meg.

{
    "id": "build-explorer-hub",
    "type": "ms.vss-web.hub",
    "targets": [
        ".build-hub-group"
    ]
}

Amikor a hubcsoport renderel, a rendszer lekérdezheti az összes olyan hub-hozzájárulást, amely a hubcsoportot célozza, hogy megtudja, mely hubokat szeretné megjeleníteni.

Közreműködések és típusok azonosítása

Minden hozzájárulási és hozzájárulási típusnak egyedi azonosítóval kell rendelkeznie a deklarált bővítményen belül.

A teljes hozzájárulási azonosító a következő elemeket tartalmazza, amelyeket ponttal . elválaszt:

  • Közzétevő azonosítója
  • Bővítmény azonosítója
  • Hozzájárulás/típus azonosítója

Például: ms.vss-web.hub a következő hozzájárulás teljes azonosítója:

  • Közzétevő azonosítója: ms
  • Bővítmény azonosítója: vss-web
  • Hozzájárulás/típus azonosítója: hub

A bővítményjegyzékben lévő relatív hozzájárulási hivatkozásokat használhatja arra, hogy a hozzájárulás egy másik hozzájárulásra vagy hozzájárulástípusra hivatkozzon ugyanazon a bővítményen belül. Ebben az esetben a közzétevő és a bővítményazonosító nem szerepel benne, az azonosító pedig egy pont . , amelyet a hozzájárulás azonosítója követ. Használhatja például .hub a vss-web korábban említett bővítményben a parancsikonként ms.vss-web.hub.