작업 항목 추적 개체의 명명 규칙
Visual Studio Team Foundation Server(TFS)에서는 모든 작업 항목 추적 개체가 하나 이상의 이름과 연결됩니다. 대부분의 개체에 표시 이름이 있으며, 작업 항목 형식과 전역 목록을 제외한 모든 개체가 참조 이름과 연결됩니다. 이름은 사용자에게 표시되는 필드의 고유 식별자입니다. 이름을 사용하면 프로젝트 컬렉션의 모든 팀 프로젝트와 작업 항목 형식에 대해 일관성이 보장됩니다. TFS는 내부적으로 참조 이름을 사용하며, 정의된 후에는 변경할 수 없습니다.
다음 표에서는 각 항목 추적 개체에 대해 지켜야 하는 명명 요구 사항을 간단히 보여 줍니다.
작업 항목 추적 개체 |
참조 이름 |
이름 |
|---|---|---|
작업 항목 형식 |
해당 없음 |
각 작업 항목 형식의 이름은 최대 255자의 유니코드 문자를 포함할 수 있으며 팀 프로젝트에서 고유해야 합니다. |
작업 항목 필드 |
필수 요소. 참조 이름 요구 사항을 참조하십시오. |
필드 이름은 최대 128자의 유니코드 문자를 포함할 수 있으며 팀 프로젝트 컬렉션에서 고유해야 합니다. |
링크 형식 |
필수 요소. 참조 이름 요구 사항을 참조하십시오. |
각 링크 형식에 대해 정방향 이름과 역방향 이름이라는 두 개의 이름을 정의합니다. 이 두 이름은 최대 128자의 유니코드 문자를 포함할 수 있으며 팀 프로젝트 컬렉션에서 모든 링크 형식에 대해 고유해야 합니다. |
범주 |
필수 요소. 참조 이름 요구 사항을 참조하십시오. |
범주 이름은 최대 128자의 유니코드 문자를 포함할 수 있으며 팀 프로젝트에서 고유해야 합니다. |
전역 목록 |
해당 없음 |
각 전역 목록의 이름은 최대 254자의 유니코드 문자를 포함할 수 있으며 팀 프로젝트 컬렉션에서 고유해야 합니다. |
이름 요구 사항
정의되는 이름은 이 항목의 앞부분에서 나온 표에 요약된 요구 사항 외에도 다음 요구 사항을 충족해야 합니다.
전역 목록 이름은 비어 있지 않아야 합니다.
이름에 선행 또는 후행 공백을 사용할 수 없습니다.
이름에 백슬래시(\) 문자를 사용할 수 없습니다.
필드 이름에 백슬래시(\), 마침표(.), 여는 대괄호와 닫는 대괄호([])를 사용할 수 없습니다.
이름에 두 개 이상의 연속된 공백을 사용할 수 없습니다.
참조 이름 요구 사항
작업 항목 필드, 링크 형식 또는 범주를 추가하거나 만들 때마다 참조 이름을 정의해야 합니다. 모든 참조 이름은 최대 70자의 유니코드 문자로 지정할 수 있습니다.
영숫자, 밑줄 및 하이픈 문자를 사용하여 참조 이름을 정의할 수 있습니다. 각 참조 이름에 마침표(.)가 적어도 한 개 이상 포함되어야 하지만 마침표가 이름의 맨 앞이나 끝에는 올 수 없습니다. 참조 이름은 숫자나 밑줄로 시작할 수 없으며 (--)처럼 여러 개의 하이픈을 연속해서 사용할 수 없습니다.
필드 참조 이름 및 이식성
작업 항목 형식 정의 언어에는 필드 참조 이름이라는 개념이 포함되어 있습니다. 필드 참조 이름은 Team Foundation 프로젝트 컬렉션 간의 정의를 연결하는 것뿐만 아니라 타사의 통합 시스템을 사용하여 특정 필드를 찾고 참조하는 것에도 도움을 줄 수 있습니다. .NET Framework 응용 프로그램의 네임스페이스가 전역적으로 고유하듯이 이 이름도 전역적으로 고유합니다.
필드 참조 이름은 바꿀 수 없습니다. 예를 들어 필드 이름을 "Title"에서 "Header"로 변경해도 이 필드의 필드 참조 이름은 그대로 유지됩니다. 필드를 통합하거나 내부에서 표현할 경우에는 필드 이름 대신 필드 참조 이름을 사용해야 합니다.
System 네임스페이스는 Team Foundation 시스템 함수에 반드시 필요한 모든 핵심 시스템 필드를 정의하는 데만 사용됩니다. Team Foundation Server 기능을 방해할 수 있으므로 Team Foundation Server에서는 사용자 지정 System.X 필드를 만들 수 없습니다.
Microsoft 네임스페이스는 작업 항목 추적 필드를 정의하는 데 사용됩니다. 이러한 필드는 TFS 프로세스 템플릿의 작업 항목 형식 정의에서 정의됩니다. TFS에서 사용자 지정 Microsoft.X 필드를 만들 수는 있습니다. 그러나 이 작업은 Team Foundation Server TFS 기능이나 TFS 업그레이드 후 기능 구성 마법사에서 팀 프로젝트를 업데이트하는 기능에 방해가 될 수 있으므로 수행하지 않는 것이 좋습니다.
고객과 협력업체에서도 사용자 지정 작업 항목 형식에 대해 고유한 필드 네임스페이스를 만들 수 있습니다.
TFS 프로세스 템플릿에 정의된 필드 및 시스템 필드에 대한 설명은 Visual Studio ALM의 작업 항목 필드 참조을 참조하십시오.
필드 참조 이름의 예
다음 예제에서는 다양한 네임스페이스에 사용되는 유효한 필드 참조 이름을 보여 줍니다.
System 네임스페이스 예제
System.Id
System.Title
System.CreatedBy
System.CreationDate
System.ChangedBy
System.ChangedDate
System.State
System.Reason
Microsoft 네임스페이스 예제
Microsoft.Common.Status
Microsoft.Common.Priority
Microsoft.Scheduling.Duration
Microsoft.Scheduling.PercentComplete
Microsoft.Testing.TestCaseName
다른 네임스페이스의 예제
고객과 협력업체에서도 자체적으로 네임스페이스를 정의하여 사용자 지정 작업 항목 형식을 지원할 수 있습니다. 예를 들어 Trey Research라는 가상의 회사에서 다음과 같은 사용자 지정 작업 항목 형식을 정의할 수 있습니다.
TreyResearch.Common.Severity
TreyResearch.Common.Phase
TreyResearch.RiskManagement.RiskType
TreyResearch.RiskManagement.Resolution
가상의 소프트웨어 회사인 A. Datum Corporation에서는 다음과 같은 작업 항목 형식을 정의할 수 있습니다.
A_Datum.Common.BusinessPriority
A_Datum.Bug.FoundInPhase
A_Datum.Bug.FixInPhase