Structure Writer

무엇이고 왜 만들어졌는가

DOORS Next 모듈에서 요구사항의 위치, 즉 어느 장에 있는지, 번호가 무엇인지, 문서의 어디에 나오는지는 모듈 보기 안에서만 보입니다. 아티팩트가 여러 모듈에 걸친 보기, 내보내기, 필터, 보고서 또는 다른 도구에 나타나는 순간 그 맥락은 사라집니다. DOORS 9에서 넘어온 팀은 "SRS-1234" 같은 익숙한 문서 ID도 아쉬워합니다.

Structure Writer는 구조를 속성에 복사하여 아티팩트와 함께 이동하게 합니다. 모듈의 각 아티팩트에 대해 상위 장의 경로("1 소개 > 1.2 범위"), 접두사·아티팩트 ID·접미사로 이루어진 형식화된 ID("SRS-001234-A"), 모듈 순서대로 증가하는 정렬용 번호를 기록할 수 있습니다. 세 값 중 무엇이 필요한지, 각각 어느 속성에 기록할지 직접 선택합니다.

해결하는 문제

• 내보내기와 여러 모듈 보기에서는 요구사항이 속한 장이 사라집니다.
• 모듈 밖에서는 요구사항을 문서 순서대로 정렬할 수 없습니다.
• 마이그레이션한 프로젝트에는 접두사가 붙은 문서 스타일 ID가 필요하지만, 직접 입력하면 느리고 실수가 잦습니다.
• 예전 번호 매기기 도구는 아티팩트를 하나씩 수정해 100개마다 몇 분씩 걸렸습니다.
• 장을 옮기거나 삽입하면 직접 관리하던 경로와 번호가 아무도 모르게 틀어집니다.

이점

• 한 번 실행으로 세 가지 값: 계층 경로, 형식화된 ID, 일련번호. 모두 선택 사항이며 각각 자신의 속성에 기록됩니다.
• 유연한 경로: 각 수준을 섹션 번호와 이름, 번호만, 이름만, ID, ID와 이름으로 표시하고, 구분자를 직접 정하며, 아티팩트 자신을 포함할지 선택합니다.
• 모듈 전체를 빠르게: 200개 아티팩트 제한이 없습니다. 구조는 한 번만 읽고 값은 묶음으로 저장합니다.
• 먼저 확인: 선택한 아티팩트의 경우 Write 타일이 몇 개가 바뀌는지, 확인 화면이 경로·ID·번호를 각각 몇 개 기록하는지 알려 줍니다. 이미 올바른 값은 다시 저장하지 않습니다.
• 항상 정확: 구조를 바꾼 뒤 다시 실행하면 바뀐 값만 업데이트됩니다.
• 근거 자료: 모든 값의 변경 전후를 담은 Excel 변경 보고서.

사용 방법

1. Rules에서 필요한 값을 켜고 각 값의 대상 속성을 고릅니다. 계층 경로(수준 형식과 구분자), 형식화된 ID(접두사, 접미사, 0 채우기), 일련번호(시작 값과 증가 폭)입니다.
2. 필요하면 실행을 한 가지 아티팩트 유형으로 제한하거나, 제목을 제외하거나, 비어 있는 대상만 채웁니다 (Additional settings).
3. 모듈을 열고 Whole module(모듈 전체)을 선택한 뒤 Write(기록)를 클릭합니다. 확인 내용을 읽고 Write values를 클릭합니다. 값은 한 번의 처리로 모듈 전체에 기록되며 실제로 바뀌는 값만 저장됩니다.
4. 또는 모듈에서 일부 아티팩트를 선택하고 Selection(선택)을 고릅니다. Write 타일에 그중 몇 개가 바뀌는지 표시됩니다. Write를 클릭하고 Write values로 확인합니다. 경로와 번호는 여전히 모듈 전체를 기준으로 합니다.
5. 결과에는 기록됨, 이미 올바름, 건너뜀, 저장 실패 아티팩트 수가 표시됩니다. 기록이 필요하면 Log(로그)로 변경 보고서를 저장합니다.

알아 두면 좋은 점

• 항상 변경 세트 안에서 작업하세요. 값은 구조를 따르므로 기본적으로 기존 값을 덮어씁니다. 직접 입력한 값을 지키려면 "Only fill empty targets"를 켜세요.
• 속성 값은 모듈 안의 위치가 아니라 아티팩트에 속합니다. 모듈에서 두 번 쓰인 아티팩트는 첫 번째 위치의 값을 받고, 다른 모듈에서도 쓰이는 아티팩트는 위젯을 마지막으로 실행한 모듈의 값을 받습니다.
• 최상위 아티팩트에는 상위 장이 없으므로 아티팩트 자신을 포함할 때만 경로가 생깁니다.
• 일련번호는 기록되는 아티팩트만 모듈에 나오는 순서대로 셉니다.
• 매우 큰 모듈에서는 실행을 멈추고 페이지를 새로 고친 뒤, 같은 설정으로 멈춘 곳부터 계속할 수 있습니다.