Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
PR(끌어오기 요청)에 작업 항목을 연결하는 경우 PR을 완료하면 해당 작업 항목을 자동으로 완료할 수 있습니다. 또는 워크플로 상태를 지정하여 PR을 병합할 때 작업 항목을 전환할 수 있습니다.
이 자동화는 작업 항목이 수동 개입 없이 코드 변경의 현재 상태를 반영하도록 하여 개발 워크플로를 간소화합니다.
자세한 내용은 끌어오기 요청 만들기, 보기 및 관리를 참조 하세요.
필수 조건
| 범주 | 요구 사항 |
|---|---|
| 사용 권한 | - 작업 항목 보기, 팔로우 및 편집: 이 노드에서 작업 항목 보기는 , 편집 권한은로 설정되어 있습니다. 권한은 허용로 설정되었습니다. 기본적으로 기여자 그룹에는 이러한 권한이 있습니다. 자세한 내용은 작업 추적 권한 설정을 참조 하세요. - 작업 항목에 태그를 추가하려면: 프로젝트 수준에서 새 태그 정의를 만드는 사용 권한 집합이 허용으로 설정되어 있어야 합니다. 기본적으로 기여자 그룹에는 이 권한이 있습니다. |
| 액세스 수준 |
-
프로젝트 멤버. - 작업 항목에 새 태그를 추가하거나 끌어오기 요청을 보거나 따르려면 최소한 기본 액세스가 필요합니다. - 작업 항목을 보거나 따라가려면: 적어도 관련자 액세스 권한이 필요합니다. 자세한 내용은 액세스 수준 정보를 참조 하세요. - 읽기 권한자 그룹에 포함된 모든 프로젝트 멤버는 작업 항목이 포함된 전자 메일을 보낼 수 있습니다. |
작업 항목 자동 완성
끌어오기 요청을 병합할 때 연결된 작업 항목의 자동 완성을 사용하도록 설정하려면 다음 이미지와 같이 병합 후 연결된 작업 항목 완료 확인란을 선택합니다. 시스템은 선택 항목을 이후의 PR에 대한 기본값으로 저장합니다.
자동 완성이 발생하지 않는 경우
시스템은 다음과 같은 상황에서 WIT(작업 항목 유형)에 대한 작업 항목 상태를 완료, 닫힘 또는 완료된 범주로 자동으로 업데이트하지 않습니다.
- 이미 해결된 상태의 작업 항목: WIT에서 상속 프로세스 모델을 사용하는 작업 항목이 이미 해결됨 상태입니다. 이 경우 시스템은 상태를 업데이트하지 않습니다. 예를 들어 Agile 프로세스에서 파생된 버그가 해결됨 상태인 경우 시스템에서 닫힘으로 전환하지 않습니다.
- 작업 항목이 이미 완료되었습니다. 작업 항목이 이미 완료된 상태 범주에 있습니다. 더 이상 전환이 필요하지 않습니다.
- 워크플로 규칙은 전환을 방지합니다. WIT에는 작업 항목이 다음 상태로 진행되지 않도록 하는 워크플로 필드 규칙이 포함됩니다. 예를 들어 규칙에서는 작업 항목을 닫을 때 다른 필드를 정의해야 할 수 있습니다.
- 온-프레미스 워크플로 구성: 온-프레미스 배포 및 Azure Boards 호스트 프로세스 모델의 경우 워크플로를 전환할 때 수행할 작업(ACTION 요소)을 지정하도록 워크플로를 수정해야 합니다. 자세한 내용은 WIT에 대한 워크플로 변경, 작업 지정을 참조하세요.
워크플로 사용자 지정에 대한 자세한 내용은 작업 추적 환경 사용자 지정을 참조하세요.
연결된 작업 항목의 워크플로 상태 지정
끌어오기 요청 설명에 정보를 입력하여 작업 항목을 특정 워크플로 상태로 전환할 수 있습니다. 언급된 작업 항목에 대한 유효한 워크플로 상태를 #ID을 앞에 붙여 지정합니다. 이 방법을 사용하면 코드를 병합할 때 작업 항목이 전환되는 방식을 정확하게 제어할 수 있습니다.
다음 예제에서는 해결됨 상태로 전환되고 다른 하나는 검토 상태로 전환되는 사용자 스토리를 보여줍니다. 또한 시스템은 두 작업을 완료로 표시 합니다.
상태 전환 구문
끌어오기 요청 설명에서 다음 구문 패턴을 사용하여 상태 전환을 지정합니다.
-
Resolves #123- 작업 항목 123을 해결됨 상태로 전환 -
Fixes #456- 작업 항목 456을 적절한 완료 상태로 전환 -
Closes #789- 작업 항목 789를 닫힌 상태로 전환 -
Review #101- 작업 항목 101을 검토 상태로 전환
시스템은 일반적인 키워드를 인식하고 작업 항목 유형의 워크플로 구성에 따라 적절한 상태 전환을 적용합니다.
연결된 작업 항목의 자동 완성 사용 안 함
사용자가 끌어오기 요청을 완료할 때 연결된 작업 항목의 자동 완성을 사용하지 않도록 설정하려면 다음 단계를 수행합니다.
- 프로젝트 설정>리포지>토리로 이동하여 리포지토리를 선택합니다.
- 설정 탭에서 커밋 멘션 작업 항목 확인에 대한 토글을 끕니다.
이 설정을 사용하지 않도록 설정하면 시스템에서 커밋 주석의 멘션을 사용하여 작업 항목을 닫을 수 없습니다(예: "수정 #123"). 이 설정은 끌어오기 요청 완료 및 직접 커밋 멘션 모두에 영향을 줍니다.
모범 사례
자동 작업 항목 완성을 사용하는 경우 다음 모범 사례를 고려합니다.
- 작업 항목 상태 검토: 자동 완성을 사용하도록 설정하기 전에 작업 항목 상태가 팀의 워크플로 기대치에 부합하는지 확인합니다.
- 특정 상태 전환 사용: 정확한 제어가 필요한 경우 기본 완료 동작에 의존하지 않고 끌어오기 요청 설명에 상태 전환 구문을 사용합니다.
- 워크플로 규칙 테스트: 사용자 지정 워크플로 규칙이 자동 상태 전환을 방지하지 않는지 확인합니다.
- 팀과 통신: 모든 팀 구성원이 자동 완성이 작업 항목 추적에 미치는 영향을 이해하도록 합니다.
Troubleshooting
작업 항목이 예상대로 자동으로 완료되지 않는 경우:
- 사용 권한 확인: 작업 항목을 편집하는 데 필요한 권한이 있는지 확인합니다.
- 워크플로 규칙 검토: 상태 전환을 방지하는 워크플로 필드 규칙이 없는지 확인합니다.
- 작업 항목 링크 유효성 검사: 작업 항목이 끌어오기 요청에 제대로 연결되어 있는지 확인합니다.
- 현재 상태 확인: 작업 항목이 아직 완료된 상태가 아닌지 확인합니다.
- 리포지토리 설정 검토: 리포지토리 설정에서 자동 완성이 사용하도록 설정되어 있는지 확인합니다.