Share via

Importowanie i eksportowanie konfiguracji procesu

  • Artykuł

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

Ważne

W przypadku lokalnego modelu procesów XML można użyć narzędzia witadmin do wyświetlania listy, importowania, eksportowania i modyfikowania procesu dla projektu. W przypadku modeli procesów Dziedziczone i Hostowane xml można używać tylko narzędzia witadmin do wyświetlania listy i eksportowania informacji o procesie. Aby zapoznać się z omówieniem modeli procesów i obsługiwanymi elementami, zobacz Dostosowywanie środowiska śledzenia pracy.

Konfigurację procesu można dostosować, aby zmodyfikować wyświetlanie narzędzi Agile portalu internetowego. Kilka dodatkowych narzędzi wymaga mapowania stanów przepływu pracy na mapowania metastate.

Uwaga

Jeśli zostanie wyświetlony komunikat o błędzie TF400917, wystąpiła nieprawidłowa konfiguracja. Zaimportuj ponownie plik konfiguracji procesu do projektu przy użyciu polecenia witadmin importprocessconfig. Otrzymasz komunikaty potrzebne do rozwiązania błędu.

Aby zarządzać konfiguracją procesu dla projektu, użyj witadmin narzędzia wiersza polecenia, aby wyeksportować i zaimportować plik definicji XML konfiguracji procesu. Aby dowiedzieć się więcej o konfiguracji procesu, zobacz ProcessConfiguration.

  • exportprocessconfig: eksportuje definicję konfiguracji procesu do pliku XML lub okna wiersza polecenia.
  • importprocessconfig: Importuje plik XML definicji konfiguracji procesu.

witadmin Uruchamianie narzędzia wiersza polecenia

Aby uruchomić witadmin narzędzie wiersza polecenia, otwórz okno wiersza polecenia, w którym jest zainstalowany program Visual Studio. Narzędzie witadmin wiersza polecenia jest instalowane z dowolną wersją programu Visual Studio. Dostęp do tego narzędzia można uzyskać, instalując bezpłatną wersję programu Visual Studio Community lub Visual Studio Team Explorer.

Uwaga

Aby nawiązać połączenie z usługą Azure DevOps Services, zalecamy użycie najnowszej wersji programu Visual Studio lub Visual Studio Community.

Uwaga

Aby nawiązać połączenie z serwerem lokalnym, zalecamy użycie tej samej lub nowszej wersji programu Visual Studio co serwer Usługi Azure DevOps. Jeśli na przykład połączysz się z usługą Azure DevOps Server 2019, połącz się z projektem z wersji programu Visual Studio 2019.

Dla programu Visual Studio 2022

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

lub ProfessionalEnterprise zamiast programu , w zależności od zainstalowanej Communitywersji.

Dla programu Visual Studio 2019

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

lub ProfessionalEnterprise zamiast programu , w zależności od zainstalowanej Communitywersji.

Dla programu Visual Studio 2017

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

lub TeamExplorerProfessional zamiast programu , w zależności od zainstalowanej Enterprisewersji.

W 32-bitowej wersji systemu Windows zastąp ciąg %programfiles(x86)% ciągiem %programfiles%. Możesz zainstalować program Visual Studio Community (który zapewnia dostęp do programu Team Explorer) lub Visual Studio Team Explorer 2017 bezpłatnie.

Napiwek

Za pomocą narzędzia witadmin można importować i eksportować pliki definicji. Inne narzędzia, których można użyć, obejmują Edytor procesów (wymaga zainstalowania wersji programu Visual Studio). Zainstaluj edytor szablonu procesu z witryny Visual Studio Marketplace.

Wymagania wstępne

  • Aby wyeksportować definicje konfiguracji procesu, musisz być prawidłowym użytkownikiem projektu lub kolekcji.
  • Aby zaimportować definicje konfiguracji procesu, musisz być członkiem następujących grup zabezpieczeń: Team Foundation Administracja istrators lub Project Administracja istrators.

Aby uzyskać więcej informacji, zobacz Zmienianie uprawnień na poziomie kolekcji projektów.

Składnia

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

Parametry

Parametr

Opis

/collection:CollectionURLx

Określa identyfikator URI kolekcji projektu. Na przykład:

Lokalny format usługi Azure DevOps:http://ServerName:Port/VirtualDirectoryName/CollectionName

Jeśli nie jest używany żaden katalog wirtualny, format identyfikatora URI jest następujący: http://ServerName:Port/CollectionName.

/p:ProjectName

Wymagany. Określa projekt, dla którego chcesz wyeksportować lub zaimportować konfigurację procesu. Ten projekt musi być zdefiniowany w kolekcji określonej przy użyciu /collection parametru. Nie trzeba określać projektu podczas określania przełącznika /v .

/f**:FileName

Ścieżka i nazwa pliku definicji XML konfiguracji procesu do wyeksportowania lub zaimportowania.

Uwaga

Jeśli na komputerze klienckim jest uruchomiony system Windows Vista, być może nie masz uprawnień do niektórych folderów. Jeśli spróbujesz wyeksportować listę globalną do lokalizacji, w której nie masz uprawnień, technologia wirtualizacji rejestru automatycznie przekierowuje wyeksportowany plik i zapisuje go w magazynie wirtualnym. Aby uzyskać więcej informacji, zobacz stronę Wirtualizacja rejestru w witrynie internetowej firmy Microsoft. Aby uniknąć tego przekierowania, możesz wyeksportować plik do lokalizacji, w której masz uprawnienia.

/e:Encoding

Opcjonalny. Nazwa formatu kodowania .NET Framework 2.0. Określone kodowanie będzie używane do eksportowania lub importowania danych XML. Na przykład /e utf-7 określa kodowanie Unicode (UTF-7). Jeśli pominiesz ten parametr, witadmin próbuje wykryć kodowanie i używa utF-8 w przypadku niepowodzenia wykrywania.

/v

Opcjonalny. Weryfikuje kod XML definiujący konfigurację procesu, ale nie importuje pliku definicji.

/? lub help

Wyświetla pomoc dotyczącą polecenia w oknie wiersza polecenia.

Uwagi

Instalowanie najnowszej wersji usługi Azure DevOps uaktualnia istniejące projekty. Jeśli aktualizujesz uaktualniony projekt, zobacz Konfigurowanie funkcji po uaktualnieniu.

Jeśli po uaktualnieniu wystąpią problemy z uzyskiwaniem dostępu do istniejących planów testów lub zestawami testów, zobacz Ręczne aktualizacje do obsługi zarządzania testami.

Przykłady

W każdym przykładzie mają zastosowanie następujące wartości:

  • Adres URL kolekcji: http://AdventureWorksServer:8080/tfs/DefaultCollection
  • Projektu: Contoso
  • Numer portu witryny sieci Web serwera: 8080

Aby dodać pole do panelu szybkiego dodawania

Możesz dodawać pola dla dowolnego panelu szybkiego dodawania. Na przykład poniższy przykład dodaje wartość biznesową do panelu listy prac produktu.

Panel listy prac z dodanym polem Wartość biznesowa

Na panelu są wyświetlane tylko pola uwzględnione w FIELDS sekcji definicji funkcji WIT wybranej funkcji WIT. Jeśli na przykład wybierzesz usterkę WIT, zostanie wyświetlona tylko pozycja Tytuł, ponieważ wartość biznesowa nie jest zdefiniowana dla usterek. Aby dodać kolejny element WIT do panelu, należy dodać go do kategorii wymagań. Zobacz Dodawanie typu elementu roboczego do listy prac i tablicy.

  1. Jeśli nie masz uprawnień administracyjnych dla projektu, pobierz je.

  2. Otwórz okno wiersza polecenia zgodnie z instrukcjami podanymi w temacie Jak uruchomić narzędzie wiersza polecenia witadmin. Na przykład:

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

  3. Wyeksportuj plik konfiguracji procesu.

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

    Przykład kolekcjiURL tohttp://MyServer:8080/tfs/TeamProjectCollectionName.

  4. Dodaj nazwę odwołania do pola do AddPanel sekcji.

    Na przykład następująca składnia dodaje element Priority do panelu.

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

    Napiwek

    • Możesz wyszukać nazwę odwołania dla pola przy użyciu tego indeksu.
    • Dodaj wszystkie wymagane pola dla typów elementów roboczych zdefiniowanych dla kategorii Wymagania. Dzięki temu nie trzeba otwierać formularza elementu roboczego, aby wypełnić je podczas dodawania elementów listy prac za pośrednictwem panelu.

  5. Zaimportuj plik konfiguracji procesu.

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

  6. Odśwież stronę listy prac, aby wyświetlić zaktualizowany panel.

Aktualizowanie mapowań metadanych w celu obsługi menedżera testów

Jeśli dostosujesz sekcję WORKFLOW planu testu lub zestawu testów, musisz zamapować stany na metastany.

W poniższym przykładzie przepływ pracy planu testów został zaktualizowany w celu używania stanów Projektowanie, Testowanie i Wylogowywane. Aby zapewnić zgodność z poprzednimi wersjami, element TestPlanWorkItems zostanie dodany do ProjectProcessConfiguration sekcji definicji konfiguracji procesu.

Przepływ pracy

<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>

Mapowania metadanych

<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>

Jeśli zmodyfikujesz przepływ pracy zestawu testów, musisz wprowadzić podobną aktualizację, jeśli chcesz mapować nowe stany. Można dodać go w TestSuiteWorkItems sekcji. Zobacz ProcessConfiguration.

Pytania i odpowiedzi

Pyt.: Kiedy muszę mapować stany przepływu pracy na metastany?

1: Podczas dodawania lub usuwania stanów przepływu pracy do następujących typów elementów roboczych należy rozważyć zaktualizowanie konfiguracji procesu w celu dodania lub usunięcia odpowiednich mapowań metastanu.

  • Typy elementów roboczych należące do kategorii wymagań lub kategorii zadań: mapowania metastate obsługują wyświetlanie narzędzi do planowania Agile.

  • Typy elementów roboczych należących do kategorii usterek: mapowania metastanów w celu obsługi narzędzia Moja praca (projekty zwinne i oparte na cmMI).

  • Plan testów i pakiet testów: Aktualizacje do przepływu pracy tych typów elementów roboczych muszą być mapowane tylko wtedy, gdy członkowie zespołu pomocy technicznej łączą się z usługą Azure DevOps z wersji Menedżera testów opartej na programie Visual Studio 2013.2 lub starszej wersji.

    Zaktualizuj mapowania metastanu, jeśli podczas nawiązywania połączenia z projektem aplikacja wykryła nieoczekiwany błąd błędu .

    Komunikat o błędzie aplikacji po uaktualnieniu serwera TFS

Jak mogę usunąć błędy konfiguracji procesu?

1: Po wprowadzeniu jednej z następujących zmian w projekcie należy zaktualizować definicje dla typu elementu roboczego, kategorii lub konfiguracji procesu. Aby uniknąć błędów, należy zawsze wprowadzać zmiany w tej kolejności: (1) typy elementów roboczych, (2) kategorie i (3) konfiguracja procesu.

Dostosowywanie

Aktualizowanie lub weryfikowanie definicji typu elementu roboczego

Aktualizowanie lub weryfikowanie definicji konfiguracji procesu

Dodawanie typu elementu roboczego do kategorii Wymagania

(Typ elementu roboczego może należeć do kategorii wymagań lub kategorii zadań, ale nie obu tych elementów).

Aby uwzględnić następujące pola:

  • Priorytet listy prac (Scrum) lub Ranga stosu (Agile lub CMMI)

    (musi być zgodna z wartością pola przypisaną do type=Order w pliku konfiguracji procesu)
  • Nakład pracy (Scrum), punkty historii (Agile) lub rozmiar (CMMI)

    (musi być zgodna z wartością pola przypisaną w type=Effort pliku konfiguracji procesu)
  • Ścieżka obszaru lub wartość pola przypisana w type=Team pliku konfiguracji procesu

  • Wszystkie pola uwzględnione w AddPanel sekcji pliku konfiguracji procesu (pola muszą być zdefiniowane w FIELDS sekcji, ale nie muszą być uwzględnione w FORM sekcji.

Aby zawierać niezbędne mapowania metadanych:

  • Mapuj początek każdego stanu przepływu pracy na type="Proposed"
  • Zamapuj każdy stan pośredniego przepływu pracy, który ma być wyświetlany na tablicy Kanban type="InProgress"
  • Mapuj koniec każdego stanu przepływu pracy na type="Complete"
    Możesz mieć tylko jeden stan zamapowany na type="Complete"

    Aby zawierać wpis w celu zdefiniowania kodów kolorów skojarzonych z funkcją WIT. Na przykład:
    <WorkItemColor primary="FF009CCC" secondary="FFD6ECF2" name="Product Backlog Item" />

Zmienianie przepływu pracy typu elementu roboczego w kategorii Wymagania

Nie dotyczy

Aby zawierać niezbędne mapowania metadanych zgodnie z powyższym opisem w celu dodania typu elementu roboczego do kategorii wymagań.

Dodawanie typu elementu roboczego do kategorii zadań

Aby uwzględnić następujące pola:

  • Priorytet listy prac (Scrum) lub Ranga stosu (Agile lub CMMI)
  • Działanie (Scrum lub Agile) lub dyscyplina (CMMI)
    (musi być zgodna z wartością pola przypisaną w type=Activity pliku konfiguracji procesu)
  • Praca pozostała
    (musi być zgodna z wartością pola przypisaną w type=RemainingWork pliku konfiguracji procesu)
  • Ścieżka obszaru lub wartość pola przypisana w type=Team pliku konfiguracji procesu
  • (Opcjonalnie) Praca oryginalna i ukończona (tylko agile i CMMI)

Aby zawierać niezbędne mapowania metadanych:

  • Mapuj początek każdego stanu przepływu pracy na typ="Proponowane"
  • Zamapuj każdy stan pośredniego przepływu pracy, który ma być wyświetlany na tablicy zadań type="InProgress"
  • Mapuj koniec każdego stanu przepływu pracy na type="Complete"

    Możesz mieć tylko jeden stan zamapowany na type="Complete"

Aby zawierać wpis w celu zdefiniowania kodów kolorów skojarzonych z funkcją WIT. Na przykład:

<WorkItemColor primary="FFF2CB1D" secondary="FFF6F5D2" name="Task" />

Zmienianie przepływu pracy typu elementu roboczego w kategorii zadań

Nie dotyczy

Aby zawierać niezbędne mapowania metadanych zgodnie z powyższym opisem w celu dodania typu elementu roboczego do kategorii zadań.

Dodaj typ elementu roboczego do kategorii usterek (tylko Agile i CMMI)
Zmienianie przepływu pracy typu elementu roboczego w kategorii usterek (tylko Agile i CMMI)

Nie dotyczy

Aby zawierać niezbędne mapowania metadanych:

  • Mapuj początek każdego stanu przepływu pracy na type="Proposed"
  • Zamapuj każdy stan pośredniego przepływu pracy, który ma być wyświetlany dla mojej pracy type="InProgress"
  • Mapuj koniec każdego typu stanu przepływu pracy="Complete"

Możesz mieć tylko jeden stan zamapowany na type="Complete"

Aby dowiedzieć się więcej, zobacz Temat Obsługa stanu aktualizacji usterek przy użyciu funkcji Moja praca.

Usuwanie typu elementu roboczego z kategorii wymagań lub kategorii zadań

Nie dotyczy

Aby usunąć wszystkie mapowania metastate, które są skojarzone tylko z tym typem elementu roboczego

Usuwanie typu elementu roboczego z projektu

Aby usunąć typ elementu roboczego z pliku kategorii.

Aby usunąć wszystkie mapowania metastate, które są skojarzone tylko z usuniętym typem elementu roboczego i WorkItemColor elementem definiującym kody kolorów usuniętego typu elementu roboczego.

Pyt.: Czy chcesz pracować z co najmniej dwoma listami prac portfela?

1: Domyślne środowisko obsługuje jeden poziom listy prac portfela. Możesz dodać do pięciu poziomów zgodnie z opisem w temacie Dodawanie list prac portfela do narzędzi Agile.

Pyt.: Czy chcesz dodać lub zmienić typy elementów roboczych, które są wyświetlane na tablicy zadań lub liście prac produktu?

1: Jeśli dodano niestandardowy typ elementu roboczego i chcesz dodać go do listy prac lub tablicy zadań, możesz. Po prostu nie można ich wyświetlić w obu miejscach. Dowiedz się, jak przeczytać artykuł Dodawanie typów elementów roboczych do list prac i tablic.