Lägga till eller ändra en typ av arbetsobjekt

  • Artikel

Azure DevOps Server 2022 – Azure DevOps Server 2019

Projektet innehåller ett antal typer av arbetsobjekt baserat på den process som används för att skapa projektet, till exempel Agile, Basic, Scrum eller CMMI. En typ av arbetsobjekt är det objekt som du använder för att spåra olika typer av arbete.

Kommentar

Information om Azure DevOps Services eller projektsamlingar som använder den ärvda processmodellen finns i Lägga till och hantera typer av arbetsobjekt.

Du kan ändra en befintlig typ av arbetsobjekt eller lägga till en anpassad arbetsobjekttyp baserat på teamets spårningskrav eller arbetsflödesprocesser. De vanligaste orsakerna till att ändra en typ av arbetsobjekt är att lägga till eller ändra uppsättningen med fält eller fältregler, ändra arbetsflödet eller anpassa arbetsobjektsformuläret.

Se Lägga till eller ändra ett fält om du vill lägga till ett anpassat fält eller ändra fältregler eller attribut för ett befintligt fält.

De flesta anpassningar av arbetsobjektstyp görs till XML-definitionen för arbetsobjekttypen, men andra anpassningar görs via processkonfigurationsdefinitionen eller via kommandoradsverktyget witadmin .

Kommentar

Information om Azure DevOps Services eller för samlingar som använder den ärvda processmodellen finns i Lägga till och hantera typer av arbetsobjekt.

Definition av arbetsobjekttyp

ProcessConfiguration-definition

Ändra kommandorad

Förutsättningar

  • Om du vill visa en lista över typer av arbetsobjekt måste du ha behörigheten Visa information på projektnivå för projektet i samlingen som Tillåt.
  • Om du vill lägga till eller anpassa en typ av arbetsobjekt genom att anpassa en processmall måste du vara medlem i gruppen Administratörer för projektsamling eller ha behörigheten Redigera process inställd på Tillåt.

Information om hur du läggs till som administratör finns i Ändra behörigheter på projektsamlingsnivå.

Hur påverkar ändringar av arbetsobjekttyper befintliga arbetsobjekt?

I följande tabell sammanfattas effekten på befintliga arbetsobjekt när du ändrar fält eller definitioner av arbetsobjekttyp.

Åtgärd Effekt på befintliga arbetsobjekt
Ta bort fält från en arbetsobjekttyp Data för de borttagna fälten finns kvar i datalagret. Inga nya data kan dock läggas till eftersom du har tagit bort dem från definitionen av arbetsobjekttyp.
Byt namn på ett fält Data för de omdöpta fälten finns kvar i datalagret under det nya egna namnet.
Ta bort fält Data för de borttagna fälten tas bort från datalagret.
Byt namn på en typ av arbetsobjekt Alla data förblir intakta under det nya namnet.
Ta bort en typ av arbetsobjekt Alla data för arbetsobjekt som skapats som den borttagna arbetsobjekttypen tas bort permanent utan möjlighet till återställning.

Om du vill ta bort fälten helt från datalagret använder witadmin deletefield du kommandoradsverktyget.

Importera och exportera definitionsfiler för arbetsobjektstyp

Kommentar

Om du använder den värdbaserade XML-processmodellen måste du importera och exportera den processmall som används av projektet. Mer information finns i Anpassa webbformuläret för spårning av arbetsobjekt.

  1. Om du inte har administratörsbehörighet för projektet hämtar du dem.

    1. Öppna ett kommandotolkfönster enligt anvisningarna i witAdmin: Anpassa och hantera objekt för spårningsarbete. Till exempel:

  2. Exportera definitionsfilen för arbetsobjekttyp där du vill ändra eller lägga till ett fält. Ange namnet på arbetsobjekttypen och ett namn på filen.

    witadmin exportwitd /collection:CollectionURL /p:ProjectName /n:TypeName /f:"DirectoryPath/FileName.xml"

    Ett exempel på en CollectionURL är http://MyServer:8080/tfs/TeamProjectCollectionName.

  3. Redigera filen . Mer information finns i Index till XML-elementdefinitioner.

  4. Importera definitionsfilen.

    witadmin importwitd /collection:CollectionURL /p:ProjectName /f:"DirectoryPath/FileName.xml"

  5. Öppna webbportalen eller uppdatera sidan för att visa ändringarna.

    Mer information om hur du använder finns witadmini Importera, exportera och hantera arbetsobjekttyper.

Lägga till eller ändra en typ av arbetsobjekt

Om du vill lägga till en anpassad typ av arbetsobjekt eller ändra en befintlig arbetsobjekttyp definierar eller ändrar du XML-definitionsfilen och importerar den sedan till projektet baserat på den processmodell som du använder. Du ändrar en typ av arbetsobjekt genom att ange de element som definierats i de tre huvudavsnitten i definitionsfilen: FÄLT, ARBETSFLÖDE och FORMULÄR.

Sammanfattning av element av typen arbetsobjekt

Det enklaste sättet att lägga till en ny typ av arbetsobjekt är att kopiera en befintlig arbetsobjekttyp och sedan ändra definitionsfilen.

Lägga till eller ändra ett fält, en fältregel, en etikett eller en tom text

Alla fält som du vill använda för att spåra data måste läggas till i definitionsfilen. Detta gäller för alla utom systemfält (fält vars referensnamn börjar med System.). Alla systemfält definieras för alla typer av arbetsobjekt, oavsett om du inkluderar dem i definitionen av arbetsobjektstyp eller inte. Mer information om varje fält finns i Index för arbetsobjektfält.

Du lägger till fält och fältregler i avsnittet FÄLT . För att fältet ska visas i arbetsobjektformuläret måste du också lägga till det i avsnittet FORMULÄR i definitionen.

Om du till exempel vill lägga till arbetsobjektets ID i ett formulär anger du följande XML-syntax i FORM avsnittet.

<Control FieldName="System.ID" Type="FieldControl" Label="ID" LabelPosition="Left" />

Mer information om hur du definierar fält finns i Lägga till eller ändra ett fält.

Ändra arbetsflödet

Avsnitten STATES och REASONS i WORKFLOW anger listvärdena för att välja i fälten Tillstånd och Orsak. De spårar status för arbetsobjekt. Avsnittet ÖVERGÅNGAR anger giltiga övergångar mellan tillstånd, enligt följande bild. Du anger både framåtriktade och regressiva övergångar.

Exempel på arbetsflödestillståndsdiagram, agil användarberättelse

Du ändrar arbetsflödet för att uppnå följande mål:

  • Lägga till eller ta bort ett tillstånd, en orsak eller en övergång
  • Ange ett värde för fält som ska tillämpas under en ändring i tillstånd, orsak eller övergång
  • Ange en anpassad åtgärd för att automatisera fälttilldelningar baserat på en ändring i tillstånd, orsak eller övergång.

Följ dessa två steg när du anpassar arbetsflödet:

  1. Ändra arbetsflödet för definitionen av arbetsobjekttyp.

  2. Ändra processkonfigurationen för att mappa nya arbetsflödestillstånd till metatillstånd.

    Det andra steget krävs när du ändrar arbetsflödet för en typ av arbetsobjekt som visas på en agil verktygssida. Dessa typer av arbetsobjekt tillhör antingen kategorierna Krav eller Uppgift.

Regler för arbetsflödesfält

Du kan tillämpa fältregler när du ändrar tillstånd, anger en orsak eller under en arbetsflödesövergång.

Genom att till exempel lägga till regeln TOM när tillståndet är inställt på Aktiv kan du automatiskt nullifiera fälten Stängt datum och Stängt av och göra dem skrivskyddade. Detta är användbart när du återaktiverar ett arbetsobjekt från ett stängt tillstånd.

<STATE value="Active">
   <FIELDS>
. . .
      <FIELD refname="Microsoft.VSTS.Common.ClosedDate"><EMPTY/></FIELD>
      <FIELD refname="Microsoft.VSTS.Common.ClosedBy"><EMPTY/></FIELD>
   </FIELDS>
</STATE>

Tillämpa regler för arbetsflödesfält för att utföra följande åtgärder:

  • Kvalificera det värde som ett fält kan ha genom att ange CANNOTLOSEVALUE, EMPTY, FROZEN, NOTSAMEAS, READONLY och REQUIRED
  • Kopiera ett värde till ett fält med hjälp av COPY, DEFAULT och SERVERDEFAULT
  • Begränsa vem som kan ändra ett fält
  • Framtvinga mönstermatchning i ett strängfält med hjälp av MATCH
  • Villkorligt tillämpa regler baserat på värden i andra fält med hjälp av WHEN, WHENNOT, WHENCHANGED och WHENNOTCHANGED
  • Begränsa regler som ska gälla för specifika användare eller grupper. De flesta regler stöder för - eller inte-attribut för att fokusera vem regeln gör och inte gäller för.

Mer information om hur du tillämpar regler för arbetsflödesfält finns i ELEMENTreferens för FÄLT (arbetsflöde) och Regel- och regelutvärdering.

Anpassa arbetsobjektsformuläret

Följande illustrationer belyser de vanligaste elementen i arbetsobjektsformulär. Du kan anpassa alla utom rubrikområdet och formulärkontrollerna. Vilka element du använder för att anpassa formuläret beror på om det nya formuläret har aktiverats av administratören eller inte.

Skärmbild av rubrikelement i webbformuläret för arbetsobjekt.

Du kan anpassa formuläret för att uppnå följande mål:

Lägga till eller ta bort en typ av arbetsobjekt från kvarvarande uppgifter eller aktivitetstavlan

De flexibla planeringsverktygen – kvarvarande produktuppgifter, kvarvarande sprint- och aktivitetstavlasidor – visar specifika typer av arbetsobjekt baserat på den processmall som används för att skapa projektet. Du kan lägga till eller ta bort arbetsobjekttyper som ska visas på dessa sidor. Om ditt projekt till exempel använder Scrum-arbetsobjektstyper visas både produktpost och buggar på sidorna för kvarvarande uppgifter. Men om projektet har skapats med hjälp av mallen Agile, CMMI eller annan process visas buggar inte på din kvarvarande eller aktivitetstavla.

Du kan till exempel lägga till buggar från sidan med produktloggning.

Information om hur du lägger till eller tar bort arbetsobjektstyper från kvarvarande uppgifter eller aktivitetstavla finns i Lägga till en typ av arbetsobjekt i en kvarvarande och en anslagstavla. Information om hur du lägger till en ny typ av arbetsobjekt för att stödja en portföljs kvarvarande uppgifter finns i Lägga till en portföljs kvarvarande uppgifter.

Ändra färg, ikon eller arbetsflödesstatus för en typ av arbetsobjekt

I webbportalen visas arbetsobjekt i frågeresultat och på sidorna för kvarvarande uppgifter och anslagstavlan i Agile-verktygen. Om du vill ändra färgen eller ikonen som är associerad med en befintlig arbetsobjektstyp eller lägga till den färg som ska användas för en ny arbetsobjekttyp redigerar du processkonfigurationen. Om du vill ändra färg för ett arbetsflödestillstånd redigerar du även processkonfigurationen.

Skärmbild av frågeresultat som visar färg, ikon och tillståndsfärg för arbetsobjekt.

Ändra typ av ett befintligt arbetsobjekt

Se Massflytta arbetsobjekt och ändra arbetsobjekttyp för de funktioner som är tillgängliga för dig baserat på din plattform.

Inaktivera eller inaktivera en typ av arbetsobjekt

Om du vill begränsa skapandet av en viss typ av arbetsobjekt till en grupp användare lägger du till arbetsobjekttypen i gruppen Dolda kategorier för att förhindra att de flesta deltagare skapar dem. Om du vill ge en grupp användare åtkomst kan du skapa en hyperlänk till en mall som öppnar arbetsobjektsformuläret och delar den länken med de gruppmedlemmar som du vill skapa dem.

Kommentar

Du kan inte lägga till fältregler för att begränsa arbetsflödet eftersom du inte kan tillämpa regler på systemfält.

Ta bort en typ av arbetsobjekt

Om du vill förhindra att gruppmedlemmar använder en viss typ av arbetsobjekt för att skapa ett arbetsobjekt kan du ta bort det från projektet. När du använder witadmin destroywitd*tar du bort alla arbetsobjekt som skapades permanent med den arbetsobjekttypen samt själva arbetsobjekttypen. Om ditt team till exempel inte använder "Impediment" kan du ta bort arbetsobjekttypen "Impediment" från Fabrikam-webbplatsprojektet.

witadmin destroywitd /collection:"http://FabrikamPrime:8080/tfs/DefaultCollection" /p:"Fabrikam Web Site" /n:"Impediment"

När du tar bort en typ av arbetsobjekt som tillhör en kategori måste du uppdatera kategoridefinitionen för projektet så att den återspeglar det nya namnet. Mer information finns i Importera, exportera och hantera arbetsobjektstyper och Kategorier för import och export.

Byt namn på en typ av arbetsobjekt

Om du vill byta namn på en befintlig arbetsobjekttyp använder du witadmin renamewitd. Du kan till exempel byta namn på en arbetsobjektstyp med etiketten "QoS Item" till "Service Agreement".

witadmin renamewitd /collection:"http://FabrikamPrime:8080/tfs/DefaultCollection" /p:"Fabrikam Web Site" /n:"QoS Item" /new:"Service Agreement"

När du byter namn på en typ av arbetsobjekt som tillhör en kategori måste du uppdatera kategoridefinitionen för projektet så att den återspeglar det nya namnet. I synnerhet fungerar inte kvarvarande uppgifter och tavlor förrän du uppdaterar kategoridefinitionen.

Mer information finns i Importera, exportera och hantera arbetsobjektstyper och Kategorier för import och export.

Den här artikeln beskriver hur du lägger till och anpassar arbetsobjekttyper för värdbaserade XML- och lokala XML-processmodeller. Information om hur du lägger till och anpassar arbetsobjektstyper för den ärvda processmodellen finns i Anpassa en process.

Andra relaterade ämnen eller resurser: