프로세스 템플릿 XML 요소 참조

Azure DevOps Server 2022 - Azure DevOps Server 2019 | TFS 2018

프로세스 템플릿의 루트 파일을 사용자 지정하여 플러그 인 파일을 추가하거나 제거할 수 있습니다. 루트 파일은 Azure DevOps Services 또는 온-프레미스 TFS(Team Foundation Server)에서 프로젝트를 만드는 데 사용되는 모든 플러그 인 및 작업을 정의합니다. ProcessTemplate이라는 루트 파일은 프로세스 템플릿 파일의 컨테이너 폴더에 있습니다. 자세한 내용은 프로세스 템플릿 파일 개요를 참조하세요.

루트 플러그 인 파일의 부모 요소는 하나의 메타데이터와 하나의 그룹 요소만 정의해야 하는 ProcessTemplate 요소입니다. 프로젝트 컬렉션 내의 각 프로세스 템플릿에 고유한 이름을 할당해야 하며 이름은 124자를 초과할 수 없습니다.

참고

호스트된 XML 프로세스 모델의 경우: 기존 프로세스와 동일한 이름 및 GUID를 가진 프로세스 템플릿을 가져오는 경우 해당 프로세스를 참조하는 모든 프로젝트와 함께 기존 프로세스가 업데이트됩니다.

온-프레미스 XML 프로세스 모델의 경우: 기존 템플릿과 이름이 같은 프로세스 템플릿을 업로드하면 기존 템플릿을 덮어씁니다.

ProcessTemplate 구문 구조

프로세스 템플릿에 대한 루트 플러그 인은 ProcessTemplate 컨테이너 요소의 자체 파일에 지정되어야 하며 프로세스 템플릿에 대한 스키마를 준수해야 합니다.

다음 예제에서는 루트 ProcessTemplate 요소의 구조를 보여줍니다. 보다 광범위한 예제는 루트 작업 정의를 참조하세요.

<?xml version="1.0" encoding="utf-8"?>  
<ProcessTemplate>  
      <metadata> . . . </metadata>  
      <groups> . . .</groups>  
</ProcessTemplate>  

Metadata 요소 참조

다음 구문은 메타데이터 요소 및 해당 자식 요소의 구조를 보여 주었습니다.

<metadata>  
    <name>ProcessTemplateName</name>  
    <description>ProcessTemplateDescription </description>  
    <version type="ID" major="Number1" minor="Number2" />  
    <plugins>  
      <plugin name="Microsoft.ProjectCreationWizard.pluginID" wizardPage="true | false" />  
. . .  
    </plugins>  
</metadata>  
요소 설명 및 구문
description 메타데이터의 필수 자식 요소입니다. 프로세스 템플릿에 대해 새 팀 프로젝트 마법사에 표시되는 설명 텍스트를 정의합니다.
<description>ProcessTemplateDescription</description>
metadata ProcessTemplate의 필수 자식 요소입니다. 새 팀 프로젝트 마법사에서 처리할 플러그 인에 대한 필수 정보를 지정하기 위한 컨테이너 요소입니다.
<metadata>
<name> . . . </name>
<description> . . . </description>
<version type="ID" major="Number1" minor="Number2/>
<plugins> . . . </plugins>
</metadata>
name 메타데이터의 필수 자식 요소입니다. 프로젝트 컬렉션에서 고유해야 하는 프로세스 템플릿의 이름을 정의합니다. 이름의 최대 길이는 124자입니다.
<name>ProcessTemplateName</name>
플러그인 플러그 인의 필수 자식 요소입니다. 프로세스 템플릿 생성에 포함할 플러그 인의 이름을 지정하며 새 팀 프로젝트 마법사에 플러그 인 관련 페이지를 표시할지 여부를 지정합니다.
<plugin name="Microsoft.ProjectCreationWizard.PluginName wizardPage="true &#124; false" />
플러그인 메타데이터의 필수 자식 요소입니다. 프로세스 템플릿에 대한 플러그 인을 정의하는 컨테이너 요소입니다.
<plugins>
<plugin> . . . </plugin>
</plugins>
version 메타데이터의 필수 자식 요소입니다.< 프로세스 템플릿의 버전을 식별하기 위해 고유 ID 및 주 및 부 수정 번호를 지정합니다.
<version type="ID" major="Number1" minor="Number2 " />

그룹 요소 참조

다음 구문에서는 그룹 요소 및 해당 자식 요소의 구조를 보여 집니다.

<groups>  
      <group id="groupId" description="GroupDescription" completionMessage="SuccessMessage">  
      <dependencies>   
         <dependency groupId="dependentGroupId" />  
. . .  
      </dependencies>  
      <taskList filename="RelativePathAndFileName" />  
      </group>  
. . .  
</groups>  
요소 설명 및 구문
종속성 그룹의 필수 자식 요소 입니다. 그룹 간의 종속 관계를 지정합니다.
<dependencies>
<dependency>. . . </dependency>
</dependencies>
종속성 종속성의 선택적 자식 요소입니다. 이 그룹이 종속되는 다른 작업 그룹의 ID를 지정합니다. 이 작업 그룹을 시작하려면 먼저 다른 그룹의 작업을 완료해야 합니다.
<dependency groupId="groupId" />
group 그룹의 필수 자식 요소 입니다. 프로젝트를 만드는 동안 플러그 인이 수행해야 하는 작업 집합을 식별합니다. 각 특성에 유효한 값은 다음과 같습니다.
- id: 작업 그룹을 식별하는 이름을 지정합니다. 이 그룹에 종속되는 다른 작업 그룹도 같은 ID를 참조합니다. 플러그 인 파일 내에서 고유한 값을 ID에 할당해야 합니다.
- description: 프로젝트를 만드는 동안 작업 그룹이 처리되고 있음을 나타내는 메시지를 지정합니다.
- completionMessage: 프로젝트를 만드는 동안 작업 그룹이 성공적으로 완료되었음을 나타내는 메시지를 지정합니다. 최대 길이는 256자입니다.
- failureMessage: 프로젝트를 만드는 동안 작업 그룹이 성공적으로 완료되지 못했음을 나타내는 메시지를 지정합니다.

<group id="TaskGroupId" description="TaskGroupDescription" completionMessage="SuccessMessage" failureMessage="FailureMessage">
<dependencies> . . . <dependencies>
<taskList> . . . </taskList>
</group>
그룹 ProcessTemplate의 필수 자식 요소입니다. 프로젝트를 만드는 동안 실행될 작업 그룹 집합을 정의하는 컨테이너 요소입니다.
<groups>
<group> . . . </group>
</groups>
tasklist 실행할 작업 목록을 포함하는 XML 파일을 지정합니다. 그룹의 작업 목록은 항상 별도의 XML 파일에 있어야 합니다. 이러한 파일을 지정하는 방법에 대한 자세한 내용은 플러그 인을 처리하는 작업 정의를 참조하세요.
<taskList filename="filePath" />