Een gehost XML-proces aanpassen

Azure DevOps Services

Azure DevOps Services ondersteunt het toevoegen en bijwerken van processen via een beheerervaring, hetgeen een web-based importproces is. Nadat u een proces hebt toegevoegd, kunt u er een of meer projecten van maken. U kunt het proces op elk gewenst moment bijwerken door het opnieuw te importeren. De wijzigingen in de processjabloon worden vervolgens toegepast op alle projecten die het proces gebruiken.

Belangrijk

Met het gehoste XML-procesmodel kunt u het bijhouden van werk aanpassen door geselecteerde XML-definitiebestanden van een processjabloon bij te werken. Deze functie is alleen beschikbaar wanneer gegevens worden gemigreerd naar Azure DevOps Services met behulp van Team Foundation Server Database Import Service.

Zie Werk bijhouden aanpassen voor meer informatie over aanpassings- en procesmodellen.

Een proces is een zip-bestand dat een set van onderling afhankelijke bestanden bevat. Deze bestanden definiëren de bouwstenen van het systeem voor het bijhouden van werkitems en andere subsystemen in Azure DevOps Services. Sommige bouwstenen werken bestaande projecten bij, terwijl andere alleen van toepassing zijn op nieuwe projecten. Zie de volgende tabel voor de volledige lijst met bouwstenen.

Wordt gebruikt bij het importeren/bijwerken van een proces

Wordt gebruikt bij het maken van een nieuw project

Vervangen door standaardinstellingen van het systeem

Genegeerd

Werkitems traceren

Verstand

Categorieën

Procesconfiguratie

Gebieden en iteraties

Testbeheer

Werkitems

Werkitemquery's

Ontwikkelen

Labbeheer

Versiebeheer

Microsoft Project-toewijzingen

Rapporten

Portal (SharePoint-producten)

Er zijn verschillen tussen wat Azure DevOps Services ondersteunt en wat on-premises Team Foundation Server ondersteunt. Zie Verschillen in aanpassingen van processjablonen voor een overzicht van deze verschillen.

Een proces aanpassen

Wanneer u een proces aanpast, is het starten met een goed gedefinieerd proces eenvoudiger dan het bouwen van een nieuw proces.

Als u een bestaand proces bijwerkt dat u hebt gebruikt met on-premises Team Foundation Server, moet u ervoor zorgen dat het voldoet aan de beperkingen die gelden voor sjablonen voor importeren.

Proces instellingen>openen

U kunt processen maken, beheren en aanpassen vanuit Organisatie-instellingen>Proces.

1. Kies het Azure DevOps-logo om Projecten te openen. Kies vervolgens Organisatie-instellingen.

   

2. Kies vervolgens Proces.

   

   Belangrijk

   Als u Proces niet ziet, werkt u vanaf TFS-2018 of een eerdere versie. De pagina Proces wordt niet ondersteund. U moet de functies gebruiken die worden ondersteund voor het on-premises XML-procesmodel.

Een proces exporteren en importeren

1. Selecteer op het tabblad Processen het beletselteken (...) om het snelmenu te openen voor het gehoste XML-proces dat u wilt exporteren. U kunt alleen gehoste XML-processen exporteren.

   

   Sla het zip-bestand op en pak alle bestanden uit.

2. Wijzig de naam van het proces in het ProcessTemplate.xml-bestand dat zich in de hoofdmap bevindt.

   Geef het proces een naam om het te onderscheiden van bestaande.

   <name>MyCompany Agile Process </name>

   Wijzig het versietype en wijzig de primaire en secundaire getallen. Geef een afzonderlijke GUID op voor het type, zoals in dit voorbeeld:

   <version type="F50EFC58-C2FC-4C66-9814-E395D90778A3" major="1" minor="1"/>

3. Pas ondersteunde aanpassingen toe.

4. Maak een zip-bestand van alle bestanden en mappen in de hoofdmap.

5. Importeer het zip-bestand van uw aangepaste proces.

Ondersteunde aanpassingen

U kunt de volgende aanpassingen toepassen op uw proces:

• Een WIT toevoegen, verwijderen of wijzigen.
• Een veld toevoegen of wijzigen.
• Tel maximaal vijf portfolioachterstanden op.
• Voeg categorieën toe die u in uw procesconfiguratie gaat gebruiken.
• Procesconfiguratie wijzigen.
• Algemene lijsten toevoegen.

De volgende sectie bevat beperkingen die het systeem oplegt.

Beperkingen

U kunt maximaal 32 processen importeren in Azure DevOps-services. Uw aangepaste processen moeten voldoen aan alle volgende samengevatte regels. Anders kunnen er validatiefoutberichten optreden bij het importeren.

• Proces
  • Procesconfiguratie
  • Categorieën
  • Typen werkitems
    • Fields
      • Limieten
      • Vereiste velden
      • Regelbeperkingen
      • Consistente namen en kenmerken
      • Identiteitsvelden
      • Werkstroom
      • Algemene lijsten
    • Werkstroom
    • Formulierindeling

Processjabloon

Uw ProcessTemplate.xml-bestand moet voldoen aan de syntaxis en regels die worden beschreven in Xml-elementreferentie ProcessTemplate. Het moet ook aan de volgende voorwaarden voldoen:

• Beperkt het aantal gedefinieerde WIT's tot 64
• Bevat slechts één Categories.xml definitiebestand
• Bevat slechts één ProcessConfiguration.xml definitiebestand
• Maakt gebruik van unieke beschrijvende namen in alle velden en WIT-definities

Bovendien moet uw proces voldoen aan de volgende validatiecontroles:

• Procesnamen zijn uniek en bevatten maximaal 155 Unicode-tekens.
  • Een sjabloon met dezelfde naam en versie-GUID als een bestaand proces overschrijft dat proces.
  • Een sjabloon met dezelfde naam, maar een andere versie-GUID genereert een fout.
  • Procesnamen mogen niet de volgende speciale tekens bevatten: . , ; ' ` : / \ * | ? " & % $ ! + = ( ) [ ] { } < >.
    Zie Naamgevingsbeperkingen voor aanvullende beperkingen.
• Procesmappen bevatten geen .exe bestanden. Zelfs als u een proces kunt importeren dat een .exe-bestand bevat, mislukt het maken van het project.
• De totale grootte van het proces is maximaal 2 GB. Anders mislukt het maken van het project.

Procesconfiguratie

Het ProcessConfiguration.xml definitiebestand moet voldoen aan de syntaxis en regels die worden beschreven in Naslaginformatie over HET XML-element ProcessConfiguration. Bovendien moet deze voldoen aan de volgende voorwaarden:

• Hiermee geeft u alle TypeFields-elementen op
• Is beperkt tot vijf portfolioachterstanden
• Bevat slechts één niet-geparente portfolioachterstand
• Hiermee geeft u slechts één achterstallig portfolio op voor elke onderliggende portfolioachterstand
• Bevat vereiste toewijzingen van werkstroomstatus naar metastate en verwijst niet naar niet-ondersteunde metastaten

Categorieën

Het Categories.xml definitiebestand moet voldoen aan de syntaxis en regels die worden beschreven in Verwijzing naar XML-elementen van categorieën. Bovendien moet deze voldoen aan de volgende voorwaarden:

• Is beperkt tot 32 categorieën
• Definieert alle categorieën waarnaar wordt verwezen in het ProcessConfiguration.xml-bestand

Typen werkitems

Een WITD-element en de onderliggende elementen moeten voldoen aan de syntaxis en regels die worden beschreven in WITD XML-elementverwijzing. Bovendien moet deze voldoen aan de volgende voorwaarden:

• Er zijn maximaal 512 velden binnen één WIT en 512 velden voor alle WIT's.
• De beschrijvende naam en het vereiste kenmerk refname die zijn toegewezen aan een WIT zijn uniek binnen de set WIT-definitiebestanden.
• De vereiste kenmerkwaarde refname bevat geen niet-toegestane tekens of gebruikt de niet-toegestane naamruimten System. Naam en Microsoft. Naam.
• Verwijzingsnamen bevatten ten minste één punt (.) en alle andere tekens zijn letters zonder spaties.
• Het element WITD bevat een FORM-element dat een WebLayout-element definieert dat voldoet aan de syntaxis die is opgegeven in de elementen WebLayout en Besturingselement.

Werkitemvelden

Een FIELDS-element en de onderliggende elementen moeten voldoen aan de syntaxis en regels die worden beschreven in XML-elementreferentie voor veld. Bovendien moet deze voldoen aan de volgende voorwaarden:

• De beschrijvende naam en het vereiste kenmerk refname die zijn toegewezen aan een WIT zijn uniek binnen de set WIT-definitiebestanden.
• De vereiste kenmerkwaarde refname bevat geen niet-toegestane tekens of gebruikt de niet-toegestane naamruimten System. Naam en Microsoft. Naam.
• Verwijzingsnamen bevatten ten minste één punt (.) en alle andere tekens zijn letters zonder spaties.

Een FIELD-element en de onderliggende elementen kunnen een GLOBALLIST-element bevatten.

Beperkingen beperken

• Het element FIELDS is beperkt tot 512 velden.
• Een werkitemtype is beperkt tot 64 persoonsnaamvelden. Een persoonsnaamveld is een veld met het kenmerk en de waarde syncnamechanges=true.
• Een ELEMENT ALLOWEDVALUES of SUGGESTEDVALUES is beperkt tot 512 LISTITEM-elementen .
• Een veld is beperkt tot 1024 regels.

Vereiste velden

De volgende velden worden opgegeven in het ProcessConfiguration.xml-bestand:

• Geef voor alle WIT's in een categorie die een procesconfiguratieachterstand definieert de velden op die worden gebruikt voor de kenmerken en waarden type=Team en type=Order.
• Voor alle WIT's in een categorie die een reguliere achterstand of portfolioachterstand definieert, geeft u het veld op dat wordt gebruikt voor type=Effort.
• Voor alle WIT's in de categorie die het element TaskBacklog definieert, geeft u het volgende op:
  • Het veld dat wordt gebruikt voor type=RemainingWork.
  • Het veld dat wordt gebruikt voor type=Activity.
  • De regel ALLOWEDVALUES voor het veld dat wordt gebruikt voor type=Activity.

Regelbeperkingen

Naast de standaard beperkingen voor veldregels worden de volgende beperkingen afgedwongen:

• Veldregelelementen kunnen de voor en niet kenmerken opgeven.
• VELDelementen mogen de onderliggende regelelementen CANNOTLOSEVALUE, NOTSAMEAS, MATCH en PROHIBITEDVALUES bevatten.
• Met uitzondering van de volgende velden, VELDdefinities voor Systeem. Naamvelden mogen geen veldregels bevatten.
  • System.Title kan de regels VEREIST en STANDAARD bevatten.
  • System.Description kan de regels VEREIST en STANDAARD bevatten.
  • System.AssignedTo kan de regels VEREIST, STANDAARD, ALLOWEXISTINGVALUE en VALIDUSER bevatten.
  • System.ChangedBy kan de regels REQUIRED, DEFAULT, ALLOWEXISTINGVALUE en VALIDUSER bevatten.

Consistente namen en kenmerken

Binnen een proces- of projectverzameling moeten de naam, het type en andere kenmerken die door een FIELD-element worden gedefinieerd, hetzelfde zijn voor alle WIT-definities.

Identiteitsvelden

Identiteitsvelden komen overeen met velden die worden gebruikt om account-, gebruikers- of groepsnamen te bevatten. De volgende kernsysteemvelden zijn in code vastgelegd als identiteitsvelden:

• Toegewezen aan (system.assignedTo)
• Geautoriseerd als (System.AuthorizedAs)
• Gewijzigd door (System.ChangedBy)
• Gemaakt door (system.createdBy)
• Geactiveerd door (Microsoft.VSTS.Common.ActivatedBy)
• Closed By (Microsoft.VSTS.Common.ClosedBy)
• Opgelost door (Microsoft.VSTS.Common.ResolvedBy)

Een aangepast identiteitsveld toevoegen

Een tekenreeksveld wordt herkend als een identiteitsveld wanneer u het kenmerk syncnamechanges opgeeft als True.

Regelbeperkingen voor identiteitsvelden

Geef voor de huidige release van het importeren van het proces geen van de volgende regels op binnen een FIELD-definitie .

• SUGGESTEDVALUES
• Regels die niet-id-waarden bevatten.

Correct voorbeeld

Als u de accountnamen wilt beperken die geldig zijn binnen een identiteitsveld, geeft u het VALIDUSER element op met een groepsnaamkenmerk.

    <FIELD name="Project Manager" refname="Fabrikam.ProgramManager" type="String" reportable="dimension" syncnamechanges="true">
        <ALLOWEXISTINGVALUE />
        <VALIDUSER group="[PROJECT]\Program Manager Group" />
        <HELPTEXT>The program manager responsible for signing off on the user story.</HELPTEXT>
    </FIELD>

Voordat u het proces importeert, moet u ervoor zorgen dat u de groep hebt gemaakt in de projecten die door het proces worden bijgewerkt.

Onjuist voorbeeld

Het volgende voorbeeld is ongeldig omdat het het volgende aangeeft:

• Een ALLOWEDVALUES element.
• Een DEFAULT element dat de tekenreeks value="Not Assigned"voor niet-id's aangeeft.

    <FIELD name="Project Manager" refname="Fabrikam.ProgramManager" type="String" reportable="dimension" syncnamechanges="true">
        <ALLOWEXISTINGVALUE />
        <ALLOWEDVALUES>
          <LISTITEM value="[PROJECT]\Program Manager Group" />
          <LISTITEM value="Not Assigned" />
        </ALLOWEDVALUES>
        <DEFAULT from="value" value="Not Assigned" />
        <VALIDUSER />
        <HELPTEXT>The program manager responsible for signing off on the user story.</HELPTEXT>
    </FIELD>

Werkstroom

Een WORKFLOW-element en de onderliggende elementen moeten voldoen aan de syntaxis en regels die worden beschreven in naslaginformatie over XML-elementen voor werkstroom. Bovendien moet deze voldoen aan de volgende voorwaarden:

• Beperkt elke WIT tot 16 werkstroomstatussen
• Definieert alle werkstroomstatussen die zijn toegewezen aan metastaten in het definitiebestand ProcessConfiguration
• Definieert een overgang tussen alle werkstroomstatussen die zijn toegewezen aan de statuscategorie Voorgesteld en werkstroomstatussen die zijn toegewezen aan de statuscategorie 'InProgress'
• Definieert een overgang tussen alle werkstroomstatussen die zijn toegewezen aan de statuscategorie 'InProgress' en werkstroomstatussen die zijn toegewezen aan de statuscategorie 'Voltooid'.

Zie Werkstroomstatussen en statuscategorieën voor een beschrijving van de statuscategorie en toewijzingen.

Algemene lijsten

Voor het gehoste XML-procesmodel worden de volgende limieten gesteld aan het importeren van globale lijsten:

• Er zijn maximaal 64 algemene lijsten.
• Er zijn maximaal 512 items per lijst.
• Er kunnen in totaal ongeveer 10.000 items worden gedefinieerd in alle globale lijsten die zijn opgegeven voor alle WIT's.

Formulierindeling

Een FORM-element en de onderliggende elementen moeten voldoen aan de syntaxis en regels die worden beschreven in de verwijzing naar XML-elementen van FORM.

Een besturingselementelement kan geen aangepast besturingselement opgeven. Aangepaste besturingselementen worden niet ondersteund.

Verwante artikelen:

• Een gehost XML-proces importeren en exporteren
• Evaluatie van regels en regels
• Een project wijzigen van gehoste XML in een overgenomen proces
• Een gehost XML-proces klonen naar een overnameproces
• Ondersteunde bewerkingen wanneer u overstapt van gehoste XML naar een overgenomen proces