히스토리

• GitLab 17.11에서 custom_fields_feature라는 이름의 기능 플래그와 함께 도입되었습니다.
• GitLab 18.0에서 일반 제공되었습니다. 기능 플래그 custom_fields_feature가 제거되었습니다.

커스텀 필드는 이슈와 에픽 같은 작업 항목에 조직의 계획 방식에 맞는 전용 정보를 추가합니다. 그룹에 커스텀 필드를 구성하면 비즈니스 가치, 위험 평가, 우선순위 순위, 팀 속성 같은 데이터 항목을 추적할 수 있습니다. 이 필드는 해당 그룹과 하위 그룹, 프로젝트의 모든 작업 항목에 나타납니다.

커스텀 필드를 사용하면 팀이 워크플로 전반에서 정보를 기록하고 보고하는 방식을 표준화할 수 있습니다. 이 표준화는 프로젝트 간 일관성을 확보하고 더 정교한 필터링과 보고를 가능하게 합니다. 데이터 요구 사항과 계획 시나리오에 맞추어 다음 필드 유형 중에서 선택합니다.

• 단일 선택
• 다중 선택
• 숫자
• 텍스트

그룹에 대한 커스텀 필드 구성#

최상위 그룹에 커스텀 필드를 구성하면 해당 그룹과 하위 그룹, 프로젝트의 작업 항목에서 그 필드를 사용할 수 있습니다.

커스텀 필드 만들기#

팀이 추적해야 하는 특정 정보를 담도록 커스텀 필드를 만듭니다. 각 필드는 하나 이상의 작업 항목 유형에 대해 구성할 수 있으므로 조직의 요구 사항에 맞게 워크플로를 조정할 수 있습니다.

다음 제한을 고려합니다.

• 최상위 그룹은 활성 커스텀 필드를 최대 50개까지 가질 수 있습니다.
• 작업 항목 유형 하나에는 최대 10개의 커스텀 필드를 할당할 수 있습니다.

사전 요구 사항:

• 그룹에 대한 Maintainer 또는 Owner 권한이 있어야 합니다.

커스텀 필드를 만들려면 다음 단계를 수행합니다.

1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다. 이 그룹은 최상위 그룹이어야 합니다.
2. 왼쪽 사이드바에서 Settings > Work items를 선택합니다.
3. Create field를 선택합니다.
4. 다음 항목을 입력합니다.

   • Type에서 필드의 유형을 선택합니다.

     • 단일 선택
     • 다중 선택
     • 숫자
     • 텍스트 필드

     필드 유형은 필드를 만든 뒤에는 변경할 수 없습니다.

   • Use on에서 이 필드를 사용할 작업 항목 유형을 선택합니다.

   • 단일 선택 및 다중 선택 필드의 Options에서 선택 가능한 옵션을 입력합니다. 단일 선택 또는 다중 선택 필드는 최대 50개의 선택 옵션을 가질 수 있습니다.

     • 각 옵션 왼쪽의 그립 아이콘([grip])을 끌어 옵션 순서를 변경합니다.
     • 여러 옵션을 한 번에 추가하려면 입력란을 선택하고 항목 목록을 한 줄에 하나씩 붙여 넣습니다.
5. Save를 선택합니다.

커스텀 필드 편집#

조직의 변화하는 요구 사항을 반영하도록 기존 커스텀 필드를 편집합니다. 기존 데이터를 잃지 않고 필드의 이름, 적용 대상 작업 항목 유형, 사용 가능한 옵션을 수정할 수 있습니다.

사전 요구 사항:

• 그룹에 대한 Maintainer 또는 Owner 권한이 있어야 합니다.

커스텀 필드를 편집하려면 다음 단계를 수행합니다.

1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다. 이 그룹은 최상위 그룹이어야 합니다.
2. 왼쪽 사이드바에서 Settings > Work items를 선택합니다.
3. 편집할 필드 옆에서 Edit <field name>(✏️)를 선택합니다.
4. 원하는 항목을 변경합니다.
5. Update를 선택합니다.

커스텀 필드 아카이브#

더 이상 필요하지 않은 커스텀 필드를 과거 데이터를 보존한 채 아카이브합니다. 아카이브하면 해당 필드를 가지고 있던 모든 작업 항목에서 필드가 제거됩니다.

사전 요구 사항:

• 그룹에 대한 Maintainer 또는 Owner 권한이 있어야 합니다.

커스텀 필드를 아카이브하려면 다음 단계를 수행합니다.

1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다. 이 그룹은 최상위 그룹이어야 합니다.
2. 왼쪽 사이드바에서 Settings > Work items를 선택합니다.
3. 아카이브할 필드 옆에서 Archive <field name>([archive])를 선택합니다.

커스텀 필드 아카이브 해제#

이전에 아카이브한 커스텀 필드를 다시 사용해야 할 때 복원합니다. 이 필드에 값이 설정되어 있던 작업 항목은 아카이브 이전과 같은 값을 그대로 유지합니다.

사전 요구 사항:

• 그룹에 대한 Maintainer 또는 Owner 권한이 있어야 합니다.

커스텀 필드의 아카이브를 해제하려면 다음 단계를 수행합니다.

1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다. 이 그룹은 최상위 그룹이어야 합니다.
2. 왼쪽 사이드바에서 Settings > Work items를 선택합니다.
3. Archived를 선택하여 아카이브된 필드를 표시합니다.
4. 아카이브를 해제할 필드 옆에서 Unarchive <field name>([redo])를 선택합니다.

작업 항목에 커스텀 필드 값 설정#

그룹에 구성된 커스텀 필드를 사용하여 작업 항목에 필요한 정보를 추가합니다.

사전 요구 사항:

• 작업 항목이 속한 프로젝트 또는 그룹에 대한 Planner, Reporter, Developer, Maintainer 또는 Owner 권한이 있어야 합니다.
• Guest 권한만 있다면 작업 항목을 만들 때만 커스텀 필드를 설정할 수 있습니다.

1. 작업 항목으로 이동합니다.
2. 오른쪽 사이드바에서 편집할 커스텀 필드의 섹션을 찾은 다음 Edit를 선택합니다.
3. 원하는 값을 입력하거나 선택합니다.
   • 텍스트 필드 값은 최대 1024자까지 입력할 수 있습니다.
4. 필드 바깥의 아무 영역이나 선택합니다.

필드 유형 선택 가이드#

커스텀 필드를 만들 때는 추적하려는 데이터의 성격에 맞는 필드 유형을 선택합니다. 적절한 필드 유형은 데이터 품질을 높이고 보고를 더 효과적으로 만듭니다.

단일 선택 필드#

다음과 같은 경우 단일 선택 필드를 사용합니다.

• 사용자가 미리 정의된 목록에서 정확히 하나의 옵션을 선택해야 합니다.
• 옵션이 서로 배타적입니다.
• 일관성을 강제하고 자유 입력을 막으려고 합니다.

단일 선택 필드는 다음 용도에 적합합니다.

• 우선순위 표시(High, Medium, Low 등)
• 범주 지정
• 팀 지정
• 승인 상태
• 우선순위 수준

다중 선택 필드#

다음과 같은 경우 다중 선택 필드를 사용합니다.

• 여러 값이 동시에 적용될 수 있습니다.
• 서로 겹치는 속성을 추적해야 합니다.
• 항목이 여러 범주에 속할 수 있습니다.

다중 선택 필드는 다음 용도에 적합합니다.

• 태그 또는 레이블
• 필요한 기술
• 영향을 받는 구성 요소
• 이해관계자 그룹
• 기능 역량

숫자 필드#

다음과 같은 경우 숫자 필드를 사용합니다.

• 정량 데이터를 수집해야 합니다.
• 계산이나 집계를 수행하려고 합니다.
• 정보를 숫자 기준으로 정렬해야 합니다.

숫자 필드는 다음 용도에 적합합니다.

• 비용 추정치
• 시간 추정치
• 비즈니스 가치 점수
• 순위 또는 우선순위 점수
• 완료 비율

텍스트 필드#

다음과 같은 경우 텍스트 필드를 사용합니다.

• 미리 정의된 범주에 들어맞지 않는 고유한 정보를 담아야 합니다.
• 데이터의 편차가 매우 큽니다.
• 컨텍스트나 세부 내용을 제공해야 합니다.

텍스트 필드는 다음 용도에 적합합니다.

• 추가 컨텍스트
• 외부 참조 ID
• 연락처 정보
• 간단한 메모 또는 의견
• URL 또는 링크

커스텀 필드 명명 규칙#

커스텀 필드의 명명 규칙이 일관되면 필드를 이해하고 사용하기가 쉬워집니다. 좋은 필드 이름은 사용 정착도와 데이터 품질을 높입니다.

일반 지침#

• 이름은 간결하되 내용을 드러내도록 짓습니다.
• 조직이 이해할 수 있는 명확하고 구체적인 표현을 사용합니다.
• 대소문자 표기를 일관되게 유지합니다(타이틀 케이스를 권장합니다).
• 널리 통용되는 경우가 아니라면 약어를 피합니다.
• 해당하는 경우 측정 단위를 포함합니다.

단일 선택 및 다중 선택 필드 명명#

범주 이름으로 시작한 다음 설명어를 덧붙입니다. 예를 들면 다음과 같습니다.

• Risk 대신 Risk Level
• Segment 대신 Customer Segment
• Phase 대신 Development Phase
• Status 대신 Approval Status

숫자 필드 명명#

필드 이름에 측정 단위를 포함합니다. 예를 들면 다음과 같습니다.

• Points 대신 Effort Points
• Budget 대신 Budget Estimate ($)
• Time 대신 Implementation Time (days)
• Value 대신 Business Value Score

텍스트 필드 명명#

어떤 정보를 입력해야 하는지 명확히 드러냅니다. 예를 들면 다음과 같습니다.

• Reference 대신 External Reference ID
• Notes 대신 Implementation Notes
• Source 대신 Requirements Source

팀별 접두사#

여러 팀이 같은 GitLab 인스턴스를 사용한다면 혼동을 막기 위해 팀 접두사를 붙이는 방법을 고려합니다.

• DEV: Sprint Priority
• QA: Test Environment
• UX: Design Status
• PM: Market Segment

이 방식은 각 팀이 자신의 업무와 관련된 필드를 빠르게 식별하는 데 도움이 됩니다.