Sdílet prostřednictvím

Přidání rozšíření ve formuláři pracovní položky prostřednictvím xml definice typu pracovní položky

  • Článek

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

Typ pracovní položky můžete exportovat jako xml pomocí witadmin nástroje, který zahrnuje rozložení formuláře pracovní položky. V rámci tohoto příkladu přidáme do rozložení příspěvky stránky, skupiny a řízení. Ovládací prvek přidáme také do typu agilní pracovní položky "Uživatelský scénář". Další informace naleznete v tématu WebLayout xml reference.

Poznámka:

Přizpůsobení formuláře pracovní položky prostřednictvím xml se podporuje jenom na Azure DevOps Serveru, nikoli v Azure DevOps Services.

Přidání rozšíření ve formuláři pracovní položky

  1. Nainstalujte rozšíření formulářů pracovních položek na Azure DevOps Server.

  2. Otevřete třídu Developer Command Prompt. Pomocí následujícího příkazu vyexportujte soubor XML do plochy.

    witadmin exportwitd /collection:CollectionURL /p:Project /n:TypeName /f:FileName

    Soubor se vytvoří v zadaném adresáři.

  3. V tomto souboru přejděte do části WebLayout . V oddílu WebLayout určuje objekt blob komentáře, který instalovaná rozšíření cílí na formuláře pracovních položek pro vaši kolekci. U každého rozšíření jsou všechny jeho příspěvky ve formuláři uvedeny se svými ID a vstupy (pokud se jedná o příspěvek k řízení). V následujícím příkladu komentář zobrazuje rozšíření color-control-dev nainstalované v kolekci. Rozšíření má jeden kontrolní příspěvek, který přebírá dva vstupy.

         <!--**********************************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. Id rozšíření najdete v části Rozšíření pracovních položek:

         <!--**********************************Work Item Extensions*************************** 

 Extension:
     Name: color-control-dev
     Id: example.color-control-dev
     ...

  5. Přidejte značku rozšíření pod oddíl Rozšíření pracovních položek, jak je znázorněno níže, abyste rozšíření zpřístupněte formuláři pracovní položky. Pokud chcete příspěvek umístit do formuláře, musí být jeho rozšíření uvedeno v oddílu Extensions .

         <!--**********************************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. Zadáním přípon v souboru XML se automaticky umístí příspěvky stránky i skupiny definované v rozšířeních ve formuláři. Příspěvky můžete přesunout v následujících příkladech.

Přidání příspěvku na stránce

    <Page Id="Details">
    <PageContribution Id="<page contribution id>" />
    ...

Přidání příspěvku skupiny

    <Page Id="Details">
    ...
        <Section>
        ...
            <GroupContribution Id="<group contribution id>" />
            ...

Příspěvek na stránce a příspěvek ke skupině nemůžou přijímat žádné další prvky rozložení.

Přidání příspěvku k řízení

Na rozdíl od příspěvků na stránce a skupině se zadání rozšíření v souboru XML automaticky neumisťuje kontrolní příspěvky. Pokud chcete tyto příspěvky přidat do formuláře, přidejte je do formuláře se značkou příspěvku. Následující příklad přidá ControlContribution do skupiny Plánování .

Pokud má příspěvek ovládacího prvku definovaný požadovaný vstup, musí uživatelé zadat hodnotu pro tento vstup. U jakéhokoli nepožadování vstupu se uživatelé můžou rozhodnout, jestli se má nastavit hodnota pro vstup. V následujícím příkladu se FieldName hodnoty a Colors vstupy nastaví.

    <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. Naimportujte tento soubor XML pomocí witadmin.

    witadmin importwitd /collection:CollectionURL /p:Project /f:FileName

Vaše rozšíření je nakonfigurováno prostřednictvím formuláře pracovní položky!