Bővítmények hozzáadása a munkaelem-űrlaphoz a munkaelem-típusdefiníció xml-fájljának használatával
Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019
A munkaelem-típusokat xml formátumban exportálhatja az witadmin
eszközzel, amely tartalmazza a munkaelem-űrlap elrendezését. Ennek a példának a részeként hozzáadjuk a laphoz, a csoporthoz és a vezérlőelemhez tartozó hozzájárulásokat az elrendezéshez. A vezérlőt hozzáadjuk az Agile "User Story" munkaelemtípushoz is. További információ: WebLayout XML-referencia.
Feljegyzés
A munkaelemek űrlapjának xml-alapú testreszabása csak az Azure DevOps Serveren támogatott, az Azure DevOps Servicesen nem.
Bővítmény hozzáadása a munkaelem-űrlapon
Munkaelem-űrlapbővítmények telepítése az Azure DevOps Serverben.
Nyissa meg a következőt:
Developer Command Prompt
. Exportálja az xml-fájlt az asztalra az alábbi paranccsal.witadmin exportwitd /collection:CollectionURL /p:Project /n:TypeName /f:FileName
A rendszer létrehoz egy fájlt a megadott könyvtárban.
Ebben a fájlban nyissa meg a WebLayout szakaszt . A WebLayout szakaszban egy megjegyzésblob határozza meg, hogy mely telepített bővítmények célmunkaelem-űrlapok a gyűjteményhez. Minden bővítmény esetében az összes űrlap-hozzájárulás az azonosítójukkal és a bemenetükkel együtt szerepel (ha ez control-hozzájárulás). Az alábbi példában a megjegyzés a gyűjteményre telepített color-control-dev bővítményt mutatja be. A bővítmény egy vezérlő közreműködéssel rendelkezik, amely két bemenetet vesz igénybe.
<!--**********************************Work Item Extensions*************************** Extension: Name: color-control-dev Id: example.color-control-dev Control contribution: Id: example.color-control-dev.color-control-contribution Description: Inputs: Id: FieldName Description: The field associated with the control. Type: Field IsRequired: true Id: Colors Descriptions: The colors that match the values in the control. Type: String IsRequired: false
Keresse meg a bővítményazonosítót a Munkaelem-bővítmények szakaszban:
<!--**********************************Work Item Extensions*************************** Extension: Name: color-control-dev Id: example.color-control-dev ...
Adjon hozzá egy bővítménycímkét a Munkaelem-bővítmények szakasz alatt, amely az alábbiak szerint jelenik meg, hogy elérhetővé tegye a bővítményt a munkaelem-űrlapon. A hozzájárulás űrlapon belüli elhelyezéséhez a bővítményt meg kell adni a
Extensions
szakaszban.<!--**********************************Work Item Extensions*************************** ... Note: For more information on work item extensions use the following topic: https://go.microsoft.com/fwlink/?LinkId=816513 --> <Extensions> <Extension Id="example.color-control-dev" /> </Extensions>
Az xml-bővítmények megadása automatikusan az űrlapon belülre helyezi a bővítményekben definiált lap - és csoport-hozzájárulásokat is. A hozzájárulásokat az alábbi példákban helyezheti át.
Oldalbeadás hozzáadása
<Page Id="Details">
<PageContribution Id="<page contribution id>" />
...
Csoporttagság hozzáadása
<Page Id="Details">
...
<Section>
...
<GroupContribution Id="<group contribution id>" />
...
Az oldalbeosztás és a csoportbeosztás nem vehet fel más elrendezési elemeket.
Vezérlőelem-hozzájárulás hozzáadása
Az oldal- és csoportbefizetésekkel ellentétben az xml bővítményeinek megadása nem helyezi automatikusan a vezérlőbefizetéseket. Ha hozzá szeretné adni ezeket a hozzájárulásokat az űrlaphoz, adja hozzá őket egy hozzájárulási címkével az űrlapon belül. Az alábbi példa hozzáadja a ControlContributiont a Tervezési csoporthoz.
Ha egy vezérlőelem-hozzájárulás rendelkezik a szükséges bemenettel, a felhasználóknak értéket kell adniuk ehhez a bemenethez. A nem kötelező bemenetek esetében a felhasználók eldönthetik, hogy beállítanak-e értéket a bemenethez. Az alábbi példában az és Colors
a FieldName
bemenetek be lesznek állítva.
<Page Id="Details">
...
<Section>
...
<Group Id="Planning">
...
<ControlContribution Label="Priority" Id="example.color-control-dev.color-control-contribution">
<Inputs>
<Input Id="FieldName" Value="Microsoft.Azure DevOps Services.Common.Priority" />
<Input Id="Colors" Value="red;green" />
</Inputs>
</ControlContribution>
<Control Label="Risk" Type="FieldControl" FieldName="Microsoft.Azure DevOps Services.Common.Risk" />
Importálja ezt az xml-fájlt a következővel
witadmin
: .witadmin importwitd /collection:CollectionURL /p:Project /f:FileName
A bővítmény a munkaelem űrlapon keresztül van konfigurálva!