Megosztás a következőn keresztül:


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

  1. Munkaelem-űrlapbővítmények telepítése az Azure DevOps Serverben.

  2. 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.

  3. 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
    
  4. 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
         ...
    
  5. 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>
    
  6. 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" />
  1. 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!