Hozzájárulási modell
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ú hub
hozzá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-task
hozzá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 (Explorer
Build
) 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
.