다음을 통해 공유


플러그 인을 처리하도록 작업 정의

tasks 요소 및 해당 자식 요소를 사용하여 업로드할 아티팩트나 플러그 인에 대해 만들 특정 요소를 정의합니다. 작업(task)은 새 팀 프로젝트의 프로세스에 고유한 요소를 구성하기 위해 실행해야 할 작업(work)을 지정합니다. 작업을 정의 하 여 여러 작업 항목 형식, 작업 항목 쿼리, 문서 및 팀 프로젝트에 보고서를 업로드 합니다. 정의할 수 있는 다른 작업은 Team Foundation Build, Visual Studio Lab Management, 테스트 관리자, Team Foundation 버전 제어 등 Visual Studio Application Lifecycle Management의 기타 영역을 구성합니다.

항목 내용

  • 작업 구문 구조

  • 작업 요소 참조

  • 함수별 taskXML 요소에 대한 인덱스

  • 예제: 작업 항목 형식 정의

작업 구문 구조

플러그 인 내에서 여러 작업을 지정할 수 있으며, 이러한 작업은 서로 종속될 수 있습니다. 각 플러그 인에 대해 정의한 작업은 Tasks.xsd 파일에 정의된 tasks의 스키마 정의를 준수해야 하며, tasks 컨테이너 요소를 사용하여 해당 파일에 지정되어 있어야 합니다.

다음 구문은 tasks 요소와 해당 자식 요소의 고급 구조를 보여 줍니다.

<tasks>
   <task>
      <dependencies>
        <dependency />
        . . .    
      </dependencies />
      <taskXml>
        . . .    
      </taskXml>
   <task/>
</tasks>

맨 위로 이동

작업 요소 참조

다음 표에서는 플러그인의 작업을 정의할 수 있는 각 요소에 대해 설명합니다.

요소

구문

설명

dependencies

<dependencies>
<dependency>. . . </dependency>
</dependencies>

task의 선택적 자식 요소입니다.

그룹이 종속되는 다른 그룹을 지정합니다.

dependency

<dependency taskId="taskId" />

dependencies의 선택적 자식 요소입니다.

이 작업이 종속되는 다른 작업의 ID를 지정합니다. 이 작업을 시작하려면 먼저 다른 작업을 완료해야 합니다.

ProcessTemplate

<ProcessTemplate Type="FileType" Filename="LocalPathAndFileName" 
   Description="FileDescription" 
   ServerPath="UploadLocation" />

여기서 각 특성은 다음과 같이 정의됩니다.

  • Type: 업로드 중인 파일의 형식입니다. 다음 값을 사용할 수 있습니다. 빌드 템플릿 파일의 경우 Default 및 Upgrade, 랩 템플릿 파일의 경우 Custom.

  • Filename: 업로드할 파일의 이름과 로컬 디렉터리 경로입니다.

  • Description: 업로드할 파일을 설명하는 짧은 텍스트 문자열입니다.

  • ServerPath: Team Foundation Server를 실행 중인 서버의 경로로, 여기에 파일을 업로드해야 합니다. 올바른 업로드 위치는 $/$$PROJECTNAME$$/BuildProcessTemplates뿐입니다.

빌드 및 랩 플러그 인에 대한 taskXml 요소의 선택적 자식 요소입니다.

팀 프로젝트에 대한 빌드 프로세스를 지원하기 위해 업로드할 파일의 이름, 위치 및 설명을 지정합니다.

task

<task id="task id" name="name of task" 
   plugin="Microsoft.ProjectCreationWizard.<PluginName>" 
   completionMessage="SuccessfulCompletionMessage" 
   completionDescription="InProcessMessage">
    <dependencies>. . . </dependencies>
    <taskXml>. . . </taskXml>
</task>

tasks의 필수적 자식 요소입니다.

새 팀 프로젝트의 프로세스에 고유한 요소를 구성하기 위해 실행해야 할 작업을 지정합니다.

  • id: 작업을 식별하는 이름을 지정합니다. 이 작업에 종속되는 다른 작업도 같은 ID를 참조합니다. 플러그 인 파일 내에서 고유한 값을 ID에 할당해야 합니다.

  • name: 작업의 용도를 설명합니다.

  • plugin: 이 작업을 실행해야 하는 플러그 인을 식별합니다.

  • completionMessage: 팀 프로젝트를 만드는 동안 작업이 완료되었음을 나타내기 위해 표시할 메시지를 지정합니다. 최대 길이는 256자입니다.

  • completionDescription: 팀 프로젝트를 만드는 동안 작업이 처리 중임을 나타내기 위해 표시할 메시지를 지정합니다. 최소 길이는 1자입니다.

tasks

<tasks>
    <task>. . . </task>
</tasks>

taskXml의 필수적 자식 요소입니다.

새 팀 프로젝트의 프로세스에 고유한 요소를 구성하기 위해 실행해야 할 작업을 지정하는 각 task 요소의 컬렉션이 들어 있습니다.

taskXml

<taskXml> . . . </taskXml>

플러그 인 파일의 필수적 루트 요소입니다.

이 작업을 수행하는 데 필요한 작업을 설명합니다. 이 요소 블록 내의 XML은 각 플러그 인에 따라 달라집니다.

참고

XML 프로세서는 요소 내의 콘텐트 유효성을 검사하지 않습니다.

맨 위로 이동

함수별 taskXML 요소에 대한 인덱스

각 플러그 인에 대해 지정할 수 있는 XML 태그 요소와 관련된 자세한 내용은 다음 항목 중 하나를 참조하십시오.

맨 위로 이동

예제: 작업 항목 형식 정의

다음 예제에서는 각 형식의 정의 파일을 참조하여 6가지 작업 항목 형식을 만드는 작업(task)을 보여 줍니다.

<task
   id="WITs"
   name="WorkItemType definitions"
   plugin="Microsoft.ProjectCreationWizard.WorkItemTracking"
   completionMessage="WorkItemTypes created"         
   completionDescription = "Processing work item types used by work item tracking">
   <taskXml>
   <WORKITEMTYPES>
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Bug.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\SharedStep.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Task.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\TestCase.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\UserStory.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Issue.xml" />
   </WORKITEMTYPES>
   </taskXml>
</task>

맨 위로 이동

참고 항목

개념

플러그 인 파일에서 작업 그룹 및 작업에 대한 종속성 정의

프로세스 템플릿 파일 개요