Importieren und Exportieren der Prozesskonfiguration

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

Sie passen die Prozesskonfiguration an, um die Anzeige des Webportals Agile-Tools zu ändern. Einige zusätzliche Tools erfordern, dass Sie Workflowzustände metastate-Zuordnungen zuordnen.

Verwenden Sie zum Verwalten der Prozesskonfiguration für ein Projekt das witadmin Befehlszeilentool, um die XML-Definitionsdatei für die Prozesskonfiguration zu exportieren und zu importieren. Weitere Informationen zur Prozesskonfiguration finden Sie unter ProcessConfiguration.

• exportprocessconfig: Exportiert die Prozesskonfigurationsdefinition in eine XML-Datei oder das Eingabeaufforderungsfenster.
• importprocessconfig: Importiert die XML-Datei der Prozesskonfigurationsdefinition.

Ausführen des witadmin Befehlszeilentools

Um das witadmin Befehlszeilentool auszuführen, öffnen Sie ein Eingabeaufforderungsfenster, in dem Visual Studio installiert ist. Das witadmin Befehlszeilentool wird mit einer beliebigen Version von Visual Studio installiert. Sie können auf dieses Tool zugreifen, indem Sie die kostenlose Version von Visual Studio Community oder Visual Studio Team Explorer installieren.

Für Visual Studio 2022

%programfiles(x86)%\Microsoft Visual Studio\2022\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

oder Professional Enterprise anstelle von Community, abhängig von der Version, die Sie installiert haben.

Für Visual Studio 2019

%programfiles(x86)%\Microsoft Visual Studio\2019\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

oder Professional Enterprise anstelle von Community, abhängig von der Version, die Sie installiert haben.

Visual Studio 2017

%programfiles(x86)%\Microsoft Visual Studio\2017\Enterprise\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

oder TeamExplorer Professional anstelle von Enterprise, abhängig von der Version, die Sie installiert haben.

Ersetzen Sie in einer 32-Bit-Edition von Windows %programfiles(x86)% durch %programfiles%. Sie können Visual Studio Community (die Zugriff auf Team Explorer bietet) oder Visual Studio Team Explorer 2017 kostenlos installieren.

Voraussetzungen

• Zum Exportieren von Prozesskonfigurationsdefinitionen müssen Sie ein gültiger Benutzer des Projekts oder der Sammlung sein.
• Zum Importieren von Prozesskonfigurationsdefinitionen müssen Sie Mitglied der folgenden Sicherheitsgruppen sein: Team Foundation-Administratoren oder Projektadministratoren.

Weitere Informationen finden Sie unter Ändern von Berechtigungen auf Projektsammlungsebene.

Syntax

witadmin exportprocessconfig /collection:CollectionURL /p:ProjectName [/f:FileName] [/e:encoding]    
witadmin importprocessconfig /collection:CollectionURL [/p:ProjectName] /f:FileName [/e:encoding] [/v]  

Parameter

Hinweise

Installieren der neuesten Version von Azure DevOps aktualisiert vorhandene Projekte. Wenn Sie ein aktualisiertes Projekt aktualisieren, lesen Sie " Konfigurieren von Features nach einem Upgrade".

Wenn nach einem Upgrade Probleme beim Zugriff auf vorhandene Testpläne oder Testsammlungen auftreten, lesen Sie manuelle Updates zur Unterstützung der Testverwaltung.

Beispiele

Die folgenden Werte gelten in jedem Beispiel:

• URL für die Sammlung: http://AdventureWorksServer:8080/tfs/DefaultCollection
• Projekt: Contoso
• Portnummer für die Serverwebsite: 8080

So fügen Sie dem Schnell-Add-Bereich ein Feld hinzu

Sie können Felder für ein beliebiges Quick Add-Panel hinzufügen. Im folgenden Beispiel wird beispielsweise dem Bereich "Produktrücklog" der Geschäftswert hinzugefügt.

Im Bereich werden nur Felder angezeigt, die FIELDS im Abschnitt der WIT-Definition für das ausgewählte WIT enthalten sind. Wenn Sie z. B. den Fehler WIT auswählen, wird nur "Titel" angezeigt, da der Geschäftswert nicht für Fehler definiert ist. Um dem Bereich weitere WIT hinzuzufügen, fügen Sie es der Kategorie "Anforderungen" hinzu. Siehe Hinzufügen eines Arbeitsaufgabentyps zu einem Backlog und Board.

1. Wenn Sie keine Administratorberechtigungen für Ihr Projekt besitzen, rufen Sie sie ab.

2. Öffnen Sie ein Eingabeaufforderungsfenster entsprechend den Anweisungen, die unter "Ausführen des Befehlszeilentools witadmin" angegeben sind. Zum Beispiel:

   cd %programfiles(x86)%\Microsoft Visual Studio\2017\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer
   

3. Exportieren Sie die Prozesskonfigurationsdatei.

   witadmin exportprocessconfig /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\ProcessConfiguration.xml"  
   

   Ein Beispiel für eine CollectionURL ist http://MyServer:8080/tfs/TeamProjectCollectionName.

4. Fügen Sie dem AddPanel Abschnitt den Feldverweisnamen hinzu.

   Die folgende Syntax fügt z. B. dem Panel das Priority-Element hinzu.

   <AddPanel>  
      <Fields>  
         <Field refname="System.Title" />  
         <Field refname="Microsoft.VSTS.Common.BusinessValue" />  
      </Fields>  
   </AddPanel>  
   

   Tipp

   • Sie können den Verweisnamen für ein Feld anhand dieses Indexes nachschlagen.
   • Fügen Sie alle erforderlichen Felder für Arbeitsaufgabentypen hinzu, die für die Kategorie "Anforderungen" definiert sind. Auf diese Weise müssen Sie das Arbeitsaufgabenformular nicht öffnen, um sie auszufüllen, wenn Sie Backlog-Elemente über den Bereich hinzufügen.

5. Importieren Sie die Prozesskonfigurationsdatei.

   witadmin importprocessconfig /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\ProcessConfiguration.xml"  
   

6. Aktualisieren Sie Die Backlog-Seite, um den aktualisierten Bereich anzuzeigen.

Aktualisieren von Metastatuszuordnungen zur Unterstützung des Test-Managers

Wenn Sie den WORKFLOW Abschnitt des Testplans oder der Testsuite anpassen, müssen Sie die Zustände metastates zuordnen.

Im folgenden Beispiel wurde der Testplanworkflow aktualisiert, um den Status "Entwurf", "Tests" und "Signed Off" zu verwenden. Zur Unterstützung der Abwärtskompatibilität wird der TestPlanWorkItems ProjectProcessConfiguration Abschnitt der Prozesskonfigurationsdefinition hinzugefügt.

Workflow

<WORKFLOW>
      <STATES>
        <STATE value="Design" />
        <STATE value="Testing" />
        <STATE value="Signed Off" />
      </STATES>
      <TRANSITIONS>
        <TRANSITION from="" to="Design">
          <REASONS>
            <DEFAULTREASON value="New test plan" />
          </REASONS>
        </TRANSITION>
     <TRANSITION from="Design" to="Testing">
          <REASONS>
            <DEFAULTREASON value="Authoring complete" />
          </REASONS>
        </TRANSITION>        
     <TRANSITION from="Testing" to="Signed Off">
          <REASONS>
            <DEFAULTREASON value="Signed Off testing" />
          </REASONS>
        </TRANSITION>
        <TRANSITION from="Signed Off" to="Design">
          <REASONS>
            <DEFAULTREASON value="Reactivating to authoring phase" />
          </REASONS>
        </TRANSITION>
        <TRANSITION from="Signed Off" to="Testing">
          <REASONS>
            <DEFAULTREASON value="Reactivating to run tests" />
          </REASONS>
        </TRANSITION>
        <TRANSITION from="Testing" to="Design">
          <REASONS>
            <DEFAULTREASON value="Back to authoring" />
          </REASONS>
        </TRANSITION>
      </TRANSITIONS>
    </WORKFLOW>

Metastate-Zuordnungen

<TestPlanWorkItems category="Microsoft.TestPlanCategory" pluralName="Test Plans" singularName="Test Plan">
    <States>
      <State type="InProgress" value="Design" />
      <State type="InProgress" value="Testing" />
      <State type="Complete" value="Signed Off" />
    </States>
  </TestPlanWorkItems>
<TestSuiteWorkItems category="Microsoft.TestSuiteCategory" pluralName="Test Suites" singularName="Test Suite">
    <States>
      <State type="Proposed" value="In Planning" />
      <State type="InProgress" value="In Progress" />
      <State type="Complete" value="Completed" />
    </States>
  </TestSuiteWorkItems>

Wenn Sie den Workflow der Testsuite ändern, müssen Sie ein ähnliches Update vornehmen, wenn Sie neue Zustände zuordnen möchten. Sie würden ihn in einem TestSuiteWorkItems Abschnitt hinzufügen. Siehe ProcessConfiguration.

Fragen und Antworten

F: Wann muss ich Workflowzustände metastates zuordnen?

A: Wenn Sie Workflowzustände zu den folgenden Arbeitsaufgabentypen hinzufügen oder entfernen, sollten Sie die Prozesskonfiguration aktualisieren, um entsprechende Metastatezuordnungen hinzuzufügen oder zu entfernen.

• Arbeitsaufgabentypen, die zur Anforderungskategorie oder Aufgabenkategorie gehören: Metastate-Zuordnungen unterstützen die Anzeige der Agile-Planungstools.

• Arbeitsaufgabentypen, die zur Fehlerkategorie gehören: Metastate-Zuordnungen zur Unterstützung von My Work-Tools (Agile- und CMMI-basierte Projekte).

• Testplan und Test Suite: Updates für den Workflow dieser Arbeitsaufgabentypen müssen nur zugeordnet werden, wenn Sie Teammitglieder unterstützen, die eine Verbindung mit Azure DevOps von einer Version des Test-Managers herstellen, die auf Visual Studio 2013.2 oder einer früheren Version basiert.

  Aktualisieren Sie die Metastatuszuordnungen, wenn eine Anwendung beim Herstellen einer Verbindung mit Ihrem Projekt einen unerwarteten Fehlerfehler erkannt hat.

  

Gewusst wie Prozesskonfigurationsfehler beheben?

A: Wenn Sie eine der folgenden Änderungen an einem Projekt vornehmen, müssen Sie die Definitionen für den Arbeitsaufgabentyp, die Kategorien oder die Prozesskonfiguration aktualisieren. Um Fehler zu vermeiden, nehmen Sie immer Ihre Änderungen in dieser Reihenfolge vor: (1) Arbeitsaufgabentypen, (2) Kategorien und (3) Prozesskonfiguration.

F: Möchten Sie mit zwei oder mehr Portfolio-Backlogs arbeiten?

A: Die Standardoberfläche unterstützt eine Ebene des Portfolio-Backlogs. Sie können bis zu fünf Ebenen hinzufügen, wie in "Portfolio-Backlogs zu Agile-Tools hinzufügen" beschrieben.

F: Möchten Sie die Arbeitsaufgabentypen hinzufügen oder ändern, die in Ihrem Task Board oder Produktrückstand angezeigt werden?

A: Wenn Sie einen benutzerdefinierten Arbeitsaufgabentyp hinzugefügt haben und diese dem Backlog oder Task Board hinzufügen möchten, können Sie dies auch. Sie können sie nur nicht an beiden Stellen anzeigen lassen. Erfahren Sie, wie Sie unter "Arbeitsaufgabentypen zu Backlogs und Boards hinzufügen" lesen.

Verwandte Artikel

• Konfigurieren von Features nach einem Upgrade
• Steuerelement-XML-Elementreferenz
• Ändern des Arbeitsaufgabenformularlayouts
• Bearbeiten einer Arbeitsaufgabentypdefinition zum Hinzufügen von Webinhalten zu einem Arbeitsaufgabenformular
• Anpassen ihrer Arbeitsverfolgungserfahrung
• Feldindex des Workitems
• witAdmin: Anpassen und Verwalten von Objekten für die Arbeitsnachverfolgung