다음을 통해 공유

가져오기 및 내보내기 프로세스 구성[witadmin]

  • 아티클

TWA(Team Web Access)를 통해 표시되는 Agile 계획 도구 페이지의 표시를 수정하도록 프로세스 구성을 사용자 지정합니다. 몇 가지 추가 도구에서는 워크플로 상태를 metastate 매핑에 매핑해야 합니다.

Agile 계획 도구 페이지를 사용자 지정하는 방법에 대한 개요는 팀 프로젝트의 Agile 계획 도구 구성 및 사용자 지정을 참조하세요.

참고

오류 메시지 TF400917이 표시되면 TWA의 구성이 잘못된 것입니다.이 경우에는 witadmin importcommonprocessconfig를 사용하여 프로세스 구성 파일을 팀 프로젝트로 다시 가져옵니다.그러면 오류를 해결하는 데 필요한 메시지가 표시됩니다.

팀 프로젝트의 프로세스 구성을 관리하려면 witadmin 명령줄 도구를 사용하여 프로세스 구성 XML 정의 파일을 내보내고 가져옵니다. 프로세스 구성에 대한 자세한 내용은 프로세스 구성 XML 요소 참조를 참조하세요.

WIT 개체를 사용자 지정하는 프로세스

  • exportprocessconfig: 프로세스 구성 정의를 XML 파일 또는 명령 프롬프트 창으로 내보냅니다.

  • importprocessconfig: 프로세스 구성 정의 XML 파일을 가져옵니다.

witadmin 명령줄 도구를 실행하려면 Visual Studio 또는 팀 탐색기가 설치된 명령 프롬프트 창을 열고 다음을 입력합니다.

cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE

32비트 버전의 Windows에서는 **%programfiles(x86)%**를 **%programfiles%**로 바꿉니다.

요구 사항

  • 프로세스 구성 정의를 내보내려면 팀 프로젝트 또는 컬렉션의 유효한 사용자여야 합니다.

  • 프로세스 구성 정의를 가져오려면 Team Foundation Administrators 보안 그룹 또는 Project Administrators 보안 그룹의 멤버여야 합니다.

자세한 내용은 Team Foundation Server에 대한 사용 권한 참조을 참조하십시오.

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

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

매개 변수

매개 변수

설명

/collection:CollectionURLx

필수 요소. 컬렉션의 URL을 지정합니다. URI는 http://ServerName:Port/VirtualDirectoryName/CollectionName 형식으로 지정해야 합니다.

가상 디렉터리를 지정하지 않는 경우

http://ServerName:Port/CollectionName 형식의 URI를 지정해야 합니다.

/p:ProjectName

필수 요소. 프로세스 구성을 내보내거나 가져올 팀 프로젝트를 지정합니다. /collection 매개 변수를 사용하여 지정한 컬렉션에서 이 팀 프로젝트를 정의해야 합니다. /v 스위치를 지정할 때는 팀 프로젝트를 지정하지 않아도 됩니다.

/f:FileName

내보내거나 가져올 프로세스 구성의 XML 정의 파일 경로와 이름입니다.

참고

클라이언트 컴퓨터에서 Windows Vista를 실행하는 경우에는 특정 폴더에 대한 권한이 없을 수 있습니다.권한이 없는 위치로 전역 목록을 내보내면 레지스트리 가상화 기술이 내보낸 파일을 자동으로 리디렉션하여 가상 저장소에 저장합니다.자세한 내용은 Microsoft 웹 사이트에서 레지스트리 가상화 및 Windows Vista에서 일반 파일 및 레지스트리 가상화 문제 페이지를 참조하세요.이러한 리디렉션을 방지하려면 권한이 있는 위치로 파일을 내보내면 됩니다.

/e:Encoding

선택 사항입니다. .NET Framework 2.0 인코딩 형식의 이름입니다. 지정한 인코딩이 XML 데이터를 가져오거나 내보내는 데 사용됩니다. 예를 들어 /e utf-7은 유니코드(UTF-7) 인코딩을 지정합니다. 이 매개 변수를 생략하면 witadmin에서 인코딩 검색을 시도하고 검색에 실패하면 UTF-8을 사용합니다.

/v

선택 사항입니다. 프로세스 구성을 정의하는 XML의 유효성을 검사하되 정의 파일을 가져오지는 않습니다.

/? 또는 help

명령 프롬프트 창에 명령에 대한 도움말을 표시합니다.

설명

참고

VS TFS 2013을 설치하면 기존 팀 프로젝트가 업그레이드됩니다.이러한 프로젝트는 Agile 구성 파일과 TFS 2012에서 지원되는 공통 구성 파일이 결합된 프로세스 구성 파일을 사용합니다.다음 witadmin 명령은 해당 구성 파일에서 더 이상 함께 사용되지 않습니다.

  • exportagileprocessconfig

  • exportcommonprocessconfig

  • importagileprocessconfig

  • importcommonprocessconfig

업그레이드된 팀 프로젝트를 업데이트하는 경우 TFS 업그레이드 후 기능 구성을 참조하세요.

TFS 2013.3으로 업그레이드한 후 기존 테스트 계획 또는 테스트 도구 모음에 액세스하는 데 문제가 있는 경우 팀 프로젝트를 수동으로 업데이트하여 테스트 관리 지원을 참조하세요.

예제

각 예제에는 다음과 같은 값이 적용됩니다.

  • 컬렉션 URL: http://AdventureWorksServer:8080/tfs/DefaultCollection

  • 팀 프로젝트: Contoso

  • 서버 웹 사이트의 포트 번호: 8080

빠른 추가 패널에 필드를 추가하려면

빠른 추가 패널에 대해 필드를 추가할 수 있습니다. 예를 들어 다음 예제에서는 비즈니스 가치를 제품 백로그 패널에 추가합니다.

비즈니스 가치 필드가 추가된 백로그 패널

패널에는 선택한 WIT에 대한 WIT 정의의 FIELDS 섹션에 포함된 필드만 표시됩니다. 예를 들어 버그 WIT를 선택하면 버그에 대한 비즈니스 가치가 정의되어 있지 않으므로 제목만 표시됩니다. 패널에 또 다른 WIT를 추가하려면 여기에 설명된 대로 요구 사항 범주에 추가합니다.

  1. 팀 프로젝트에 대해 관리 권한이 없는 경우 권한을 얻으십시오.

  2. Visual Studio 또는 팀 탐색기가 설치된 명령 프롬프트 창을 열고 다음을 입력합니다.

    cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE

    32비트 버전의 Windows에서는 %programfiles(x86)%를 %programfiles%로 바꿉니다. 팀 탐색기를 무료로 다운로드할 수 있습니다.

  3. 프로세스 구성 파일을 내보냅니다.

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

    CollectionURL의 예로는 http://MyServer:8080/tfs/TeamProjectCollectionName이 있습니다.

  4. AddPanel 섹션에 필드 참조 이름을 추가합니다.

    예를 들어 다음 구문은 패널에 우선 순위 요소를 추가합니다.

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

    팁:

    • 이 인덱스를 사용하여 필드의 참조 이름을 조회할 수 있습니다.

    • 요구 사항 범주에 대해 정의된 작업 항목 형식에 모든 필수 필드를 추가합니다. 그러면 패널을 통해 백로그 항목을 추가할 때 작업 항목 폼을 열어서 필드에 값을 입력하지 않아도 됩니다.

  5. 프로세스 구성 파일을 가져옵니다.

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

  6. 백로그 페이지를 새로 고쳐서 업데이트된 패널을 확인합니다.

Test Manager를 지원하도록 metastate 매핑 업데이트

테스트 계획 또는 테스트 도구 모음의 WORKFLOW 섹션을 사용자 지정하면 상태를 metastate로 매핑해야 합니다. 이렇게 하면 Visual Studio 2013.2 이전 버전에 있는 Test Manager 클라이언트가 지원됩니다.

다음 예제에서 테스트 계획 워크플로는 디자인, 테스트 및 로그오프 상태를 사용하도록 업데이트되었습니다. 이전 버전과의 호환성을 지원하기 위해 TestPlanWorkItems가 프로세스 구성 정의의 ProjectProcessConfiguration 섹션에 추가됩니다.

WORKFLOW

Metastate 매핑

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

테스트 도구 모음 워크플로를 수정한 경우 새 상태를 매핑하려면 유사한 업데이트를 수행해야 합니다. TestSuiteWorkItems 섹션 안에서 업데이트를 추가합니다. 프로세스 구성 XML 요소 참조을 참조하세요.

Q & A

Q: TFS 업그레이드 후에 어떤 사용자 지정을 수행할 수 있으며 기능 구성 마법사를 계속 사용하여 팀 프로젝트를 업데이트할 수 있나요?

A: 빠른 추가 패널을 사용자 지정할 수 있습니다. 기능 구성 마법사에서는 팀 프로젝트를 업데이트하며, 그러면 최신 기능에 액세스할 수 있게 됩니다.

기타 변경을 수행하려면 팀 프로젝트 업데이트 시 몇 가지 수동 작업을 수행해야 할 수도 있습니다. 수행해도 안전한 사용자 지정 작업과 수행하지 않아야 하는 작업에 대한 자세한 내용은 작업 추적 환경 사용자 지정: 사용자 지정 전에 유지 관리 및 업그레이드의 영향 파악을 참조하세요.

Q: 언제 워크플로 상태를 metastate에 매핑해야 합니까?

A: 워크플로 상태를 다음 WIT에 추가하거나 제거할 경우 해당하는 metastate 매핑을 추가 또는 제거하도록 프로세스 구성을 업데이트하는 것을 고려해야 합니다.

  • 요구 사항 범주 또는 작업 범주에 속하는 WIT: Metastate 매핑은 Agile 계획 도구의 표시를 지원합니다.

  • 버그 범주에 속하는 WIT: Metastate 매핑은 내 작업 도구(Agile 및 CMMI 기반 팀 프로젝트)를 지원합니다.

  • 테스트 계획 및 테스트 도구 모음: 이러한 WIT 워크플로에 대한 업데이트는 Visual Studio 2013.2 이전 버전을 기반으로 하는 Test Manager 버전에서 TFS에 연결하는 팀 멤버를 지원하는 경우에만 매핑되어야 합니다.

    테스트 계획 및 테스트 도구 모음 WIT는 이 다운로드 페이지에서 제공하는 TFS 2013.3으로의 업그레이드를 수행하는 경우에만 사용 가능합니다.

    팀 프로젝트에 연결하는 경우 응용 프로그램에서 예기치 않은 오류를 발견했습니다. 오류가 발생하면 metastate 매핑을 업데이트합니다.

    TFS 업그레이드 후 응용 프로그램 결함 오류 메시지

프로세스 구성 오류를 어떻게 해결합니까?

A: 팀 프로젝트에 대해 다음 변경 중 하나를 수행하면 WIT, 범주 또는 프로세스 구성에 대한 정의를 업데이트해야 합니다. 오류를 방지하기 위해 항상 (1) WIT, (2) 범주, (3) 프로세스 구성 순서로 변경합니다.

사용자 지정

WIT 정의 업데이트 또는 확인

프로세스 구성 정의 업데이트 또는 확인

요구 사항 범주에 WIT 추가

(WIT는 요구 사항 범주 또는 작업 범주에 속할 수 있지만 둘 모두에 속하지는 않습니다.)

다음 필드를 포함하려면:

  • 백로그 우선 순위(Scrum) 또는 스택 순위(Agile 또는 CMMI)

    (프로세스 구성 파일의 type=Order에 할당된 필드 값과 일치해야 함)

  • 활동(Scrum), 스토리 점수(Agile) 또는 크기(CMMI)

    (프로세스 구성 파일의 type=Effort에 할당된 필드 값과 일치해야 함)

  • 프로세스 구성 파일의 type=Team에 할당된 영역 경로 또는 필드 값

  • 프로세스 구성 파일의 AddPanel 섹션에 포함되는 모든 필드(필드는 FIELDS 섹션 내에서 정의되어야 하지만 FORM 섹션 안에 포함될 필요는 없습니다.)

필요한 metastate 매핑을 포함하려면:

  • 각 워크플로 상태의 시작을 type="Proposed"에 매핑

  • Kanban 보드에 표시할 각 중간 워크플로 상태를 type="InProgress"에 매핑

  • 각 워크플로 상태의 끝 부분을 type="Complete"에 매핑

    한 개 상태만 type="Complete"에 매핑시킬 수 있습니다.

WIT와 연결된 색상 코드를 정의하는 항목을 포함하려면. 예를 들면 다음과 같습니다.

<WorkItemColor primary="FF009CCC" secondary="FFD6ECF2" name="Product Backlog Item" />

요구 사항 범주의 WIT의 워크플로 변경

N/A

요구 사항 범주에 대한 WIT 추가를 위해 위에서 설명한 대로 필요한 metastate 매핑을 포함하려면.

작업 범주에 WIT 추가

다음 필드를 포함하려면:

  • 백로그 우선 순위(Scrum) 또는 스택 순위(Agile 또는 CMMI)

  • 활동(Scrum 및 Agile) 또는 분야(CMMI)

    (프로세스 구성 파일의 type=Activity에 할당된 필드 값과 일치해야 함)

  • 남은 작업

    (프로세스 구성 파일의 type=RemainingWork에 할당된 필드 값과 일치해야 함)

  • 프로세스 구성 파일의 type=Team에 할당된 영역 경로 또는 필드 값

  • (옵션) 원래 작업 및 완료된 작업(Agile 및 CMMI에만 해당)

필요한 metastate 매핑을 포함하려면:

  • 각 워크플로 상태의 시작을 type="Proposed"에 매핑

  • 작업 보드에 표시할 각 중간 워크플로 상태를 type="InProgress"에 매핑

  • 각 워크플로 상태의 끝 부분을 type="Complete"에 매핑

    한 개 상태만 type="Complete"에 매핑시킬 수 있습니다.

WIT와 연결된 색상 코드를 정의하는 항목을 포함하려면. 예를 들면 다음과 같습니다.

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

작업 범주의 WIT의 워크플로 변경

N/A

작업 범주에 대한 WIT 추가에 대해 위에서 설명한 대로 필요한 metastate 매핑을 포함하려면.

버그 범주에 WIT 추가(Agile 및 CMMI에만 해당)

버그 범주에서 WIT의 워크플로 변경(Agile 및 CMMI에만 해당)

N/A

필요한 metastate 매핑을 포함하려면:

  • 각 워크플로 상태의 시작을 type="Proposed"에 매핑

  • 내 작업에 표시할 각 중간 워크플로 상태를 type="InProgress"에 매핑

  • 각 워크플로 상태의 끝 부분을 type="Complete"에 매핑

    한 개 상태만 type="Complete"에 매핑시킬 수 있습니다.

자세한 내용은 내 작업을 사용하여 버그 업데이트 상태 지원을 참조하세요.

요구 사항 범주 또는 작업 범주에서 WIT 제거

N/A

해당 WIT와만 연결된 모든 metastate 매핑을 제거하려면

팀 프로젝트에서 WIT 제거

범주 파일에서 WIT를 제거하려면.

제거한 WIT와만 연결된 모든 metastaet 매핑과 제거한 WIT의 색상 코드를 정의하는 WorkItemColor 요소를 제거하려면.

Q: TWA에서 Agile 계획 도구에 표시되는 다른 기능을 사용자 지정하려면 어떻게 해야 합니까?

A: 일부 사용자 지정은 사용자 인터페이스를 통해 수행할 수 있습니다. 나머지는 프로세스 구성 또는 다른 팀 프로젝트 개체를 편집해야 합니다. 전체적인 개요를 보려면 팀 프로젝트의 Agile 계획 도구 구성 및 사용자 지정를 참조하세요.

Q: 둘 이상의 포트폴리오 백로그로 작업하시겠습니까?

A: 기본 환경에서는 한 수준의 포트폴리오 백로그를 지원합니다. Agile 포트폴리오 관리에 백로그 추가에 설명된 대로 최대 5개까지 수준을 추가할 수 있습니다.

Q: 작업 보드 또는 제품 백로그에 나타나는 WIT를 추가하거나 변경하시겠습니까?

A: 사용자 지정 WIT를 추가한 경우 필요에 따라 백로그 또는 작업 보드에 추가할 수 있습니다. 그러나 두 장소에 모두 표시할 수는 없습니다. 백로그 또는 작업 보드에 버그 추가를 참조하여 방법을 알아보세요.