Share via


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 de geselecteerde XML-definitiebestanden van een processjabloon bij te werken. Deze functie is alleen beschikbaar wanneer gegevens worden gemigreerd naar Azure DevOps Services door gebruik te maken van Team Foundation Server Database Import Service.

Zie Werktracking aanpassen voor meer informatie over aanpassings- en procesmodellen.

Een proces is een ZIP-bestand dat een set interdependent-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 systeemstandaarden

Genegeerd

Werkitems traceren

Verstand

Categorieën

Procesconfiguratie

Gebieden en iteraties

Testbeheer

Werkitems

Werkitemquery's

Build

Labbeheer

Versiebeheer

Microsoft Project-toewijzingen

Rapporten

Portal (SharePoint-producten)

Ondersteunde procesinvoegtoepassingen en -objecten voor procesimport

Er zijn verschillen tussen wat Azure DevOps Services ondersteunt en wat on-premises Team Foundation Server ondersteunt. Zie De verschillen tussen processjabloonaanpassingen voor een overzicht van deze verschillen.

Een proces aanpassen

Wanneer u een proces aanpast, is het eenvoudiger om te beginnen met een goed gedefinieerd proces 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 zijn gesteld voor sjablonen voor importeren.

Proces instellingen openen>

U maakt, beheert en maakt aanpassingen aan processen vanuit het proces voor organisatie-instellingen>.

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

    Organisatie-instellingen openen

  2. Kies vervolgens Proces.

    Organisatie-instellingen, pagina Proces

    Belangrijk

    Als u Proces niet ziet, werkt u vanuit TFS-2018 of 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.

    Menuoptie Gehost XML-proces exporteren op procespagina >

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

  2. Wijzig de naam van het proces in het ProcessTemplate.xml bestand in de hoofdmap.

    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. Ondersteunde aanpassingen toepassen.

  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:

In de volgende sectie worden de beperkingen vermeld 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.

Processjabloon

Uw ProcessTemplate.xml-bestand moet voldoen aan de syntaxis en regels die worden beschreven in de naslaginformatie over het XML-element ProcessTemplate. Bovendien moet deze voldoen aan de volgende voorwaarden:

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

Uw proces moet ook de volgende validatiecontroles doorgeven:

  • 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 met een .exe-bestand kunt importeren, mislukt het maken van een 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 de xml-elementreferentie processconfiguration. Bovendien moet deze voldoen aan de volgende voorwaarden:

  • Hiermee geeft u alle TypeFields-elementen
  • Is beperkt tot vijf portfolioachterstanden
  • Bevat slechts één niet-gepareerde portfolioachterstand
  • Hiermee geeft u slechts één bovenliggende portfolioachterstand op voor elke onderliggende portfolioachterstand
  • Bevat vereiste status-naar-metastatetoewijzingen voor werkstroom en verwijst niet naar niet-ondersteunde metastaten

Categorieën

Het Categories.xml definitiebestand moet voldoen aan de syntaxis en regels die worden beschreven in de verwijzing naar xml-elementen 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 de verwijzing naar WITD XML-elementen. 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 refnamekenmerk dat aan een WIT is toegewezen, zijn uniek binnen de set WIT-definitiebestanden.
  • De vereiste waarde van het refname-kenmerk bevat geen niet-toegestane tekens of gebruikt het niet-toegestane naamruimtensysteem.Naam en Microsoft.Naam.
  • Verwijzingsnamen bevatten ten minste één punt (.) en alle andere tekens zijn letters zonder spaties.
  • Het WITD-element bevat een FORM-element dat een WebLayout-element definieert dat voldoet aan de syntaxis die is opgegeven in WebLayout- en Besturingselementen.

Werkitemvelden

Een element FIELDS en de onderliggende elementen moeten voldoen aan de syntaxis en regels die worden beschreven in de verwijzing naar HET XML-element FIELD. Bovendien moet deze voldoen aan de volgende voorwaarden:

  • De beschrijvende naam en het vereiste refnamekenmerk dat aan een WIT is toegewezen, zijn uniek binnen de set WIT-definitiebestanden.
  • De vereiste waarde van het refname-kenmerk bevat geen niet-toegestane tekens of gebruikt het niet-toegestane naamruimtensysteem.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

  • Een 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 achterstand voor procesconfiguratie definieert de velden op die worden gebruikt voor de kenmerken en waarden type=Team en type=Order.
  • Geef voor alle WIT's in een categorie die een reguliere achterstand of portfolioachterstand definieert het veld op dat wordt gebruikt voor type=Effort.
  • Geef voor alle WIT's in de categorie die het element TaskBacklog definieert 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 standaardveldregelbeperkingen worden de volgende beperkingen afgedwongen:

  • Veldregelelementen kunnen niet de kenmerken voor en niet opgeven.
  • VELDelementen kunnen de onderliggende regelelementen CANNOTLOSEVALUE, NOTSAMEAS, MATCH en PROHIBITEDVALUES bevatten.
  • Met uitzondering van de volgende velden, VELD-definities 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 VEREIST, STANDAARD, ALLOWEXISTINGVALUE en VALIDUSER bevatten.

Consistente namen en kenmerken

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

Identiteitsvelden

Identiteitsvelden komen overeen met velden die worden gebruikt voor account-, gebruikers- of groepsnamen. 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)
  • Gesloten door (Microsoft.VSTS.Common.ClosedBy)
  • Opgelost door (Microsoft.VSTS.Common.ResolvedBy)
Een aangepast identiteitsveld toevoegen

Een tekenreeksveld wordt herkend als een identiteitsveld wanneer u de kenmerksynchronisatienaamwisselingen opgeeft als True.

Regelbeperkingen voor identiteitsvelden

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

  • VOORGESTELDE WAARDEN
  • 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 niet geldig omdat hiermee wordt aangegeven:

  • Een ALLOWEDVALUES element.
  • Een DEFAULT element dat de tekenreeks voor niet-id's value="Not Assigned"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>

Workflow

Een WERKSTROOM-element en de onderliggende elementen moeten voldoen aan de syntaxis en regels die worden beschreven in de verwijzing naar HET XML-element van WORKFLOW. 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
  • Hiermee definieert u 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 statuscategorie en toewijzingen.

Algemene lijsten

Voor het model voor het gehoste XML-proces worden de volgende limieten voor het importeren van algemene lijsten geplaatst:

  • Er zijn maximaal 64 globale lijsten.
  • Er zijn maximaal 1024 items per lijst.
  • Ongeveer 10.000 items kunnen in totaal worden gedefinieerd in alle globale lijsten die zijn opgegeven in alle WIT's.

Formulierindeling

Een FORM-element en de onderliggende elementen moeten voldoen aan de syntaxis en regels die worden beschreven in de naslaginformatie over FORM XML-elementen.

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