# Module Fill

> 아티팩트 ID와 레벨로 이루어진 간단한 목록으로 비어 있는 모듈의 전체 구조를 한 번에 구성합니다.

Source: https://widgets.doorsnext.com/ko/widgets/module-fill/

- 영역: 모듈 구조
- 사용 위치: IBM DOORS Next 모듈
- 지원 제품: RM (IBM Engineering Requirements Management DOORS Next (Requirements Management))
- 데이터 변경
- Keywords: 모듈 채우기, 모듈 구조 생성, 아티팩트 ID 목록, 마이그레이션, CSV로 모듈 생성, 아티팩트 삽입, 모듈 계층
- 버전: 2.17 (릴리스 날짜 2026-10-06)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)

## 개요 및 개발 배경
다른 도구에서 마이그레이션한 후, 프로젝트를 재편한 후, 또는 기존 요구사항으로 문서를 구성해야 할 때, 아티팩트는 이미 DOORS Next에 있지만 이를 담아야 할 모듈은 비어 있습니다. 수백 개의 아티팩트를 올바른 순서와 레벨에 맞춰 수작업으로 모듈에 배치하는 일은 느리고 오류가 발생하기 쉽습니다.

Module Fill은 바로 이 단계를 위해 개발되었습니다. `[231,1][3513,1.1][67452,1.1.1]`처럼 쌍으로 이루어진 간단한 목록으로 구조를 제공하면 위젯이 모듈을 구성합니다. 이 목록은 Excel에서 준비하거나 원본 도구에서 내보낼 수 있습니다.

## 해결하는 문제
- 수백 개의 기존 아티팩트를 정확한 순서와 계층 구조로 채워야 하는 빈 모듈.
- 원본 도구에서는 문서 구조를 알고 있지만 DOORS Next에서 다시 구성해야 하는 마이그레이션.
- 순서나 레벨이 잘못될 위험이 높은 수작업 끌어서 놓기.
- 수작업이 중단되어 일부만 구성된 모듈.

## 이점
- **며칠이 아닌 몇 분:** 대규모 문서 구조도 빠르게 구성합니다.
- **실행 전 검사:** 입력하는 동안 목록을 검증하고, 모든 ID를 조회하며, 계획된 모듈을 표로 보여 줍니다.
- **전부 아니면 전무:** 구조를 한 번의 변경으로 생성하므로 모듈이 반쯤 채워진 상태로 남지 않습니다.
- **반복 가능:** 같은 목록을 다시 사용할 수 있습니다. 예를 들어 테스트 프로젝트에서 먼저 실행해 볼 수 있습니다.
- **제목 자동 인식:** 아티팩트 유형을 기준으로 제목을 자동으로 인식합니다.

## 사용 방법
1. **empty**(비어 있는) 모듈을 엽니다.
2. `[ID,level]` 쌍의 목록을 모듈 순서대로 붙여 넣습니다. 레벨은 1, 1.1, 1.1.1과 같은 형식으로 씁니다. 입력하는 동안 오류와 경고가 표시됩니다.
3. **Find artifacts (N)**(아티팩트 찾기)을 클릭합니다. 위젯이 모든 아티팩트를 찾고, 현재 구성에 존재하지 않는 ID를 목록으로 보여 줍니다.
4. 표에서 계획된 구조를 확인합니다.
5. **Fill module (N)**(모듈 채우기)을 클릭하고 확인합니다. 완료되면 모듈을 다시 로드하여 결과를 확인합니다.

## 참고 사항
- Module Fill은 빈 모듈에서만 작동하므로 새 구조가 기존 콘텐츠와 섞이는 일이 없습니다.
- 아티팩트는 작업 중인 프로젝트와 구성에 이미 존재해야 합니다.
- 어떤 아티팩트 유형을 제목으로 추가할지는 설정에서 지정합니다(기본값은 *Heading*).
