# Image Linker

> 각 아티팩트를 텍스트 안의 이미지에 링크하여 변경된 이미지가 영향 분석에 나타나게 합니다.

Source: https://widgets.doorsnext.com/ko/widgets/image-linker/

- 분야: 링크 및 추적성
- 사용 위치: IBM DOORS Next 모듈
- 지원 제품: RM (IBM Engineering Requirements Management DOORS Next (Requirements Management))
- 데이터 변경
- Keywords: 포함된 이미지, 요구사항의 이미지, 영향 분석, 추적성, 이미지 링크, 포함된 아티팩트, 다이어그램, 대량 링크 생성, IBM DOORS Next
- 버전: 1.21 (릴리스 날짜 2026-10-28)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- 작업 흐름: 1. Settings: 링크 유형, 방향, 대상 → 2. Find embedded pictures in module (필요한 경우: 또는 아티팩트 선택: 자동으로 확인) → 3. 아티팩트와 이미지 확인 → 4. Create links: 확인 후 생성 → 5. Excel 변경 보고서

## 개요 및 개발 배경
요구사항에는 화면 레이아웃, 다이어그램, 사진, 신호 표 같은 이미지가 자주 들어 있습니다. IBM DOORS Next에서 아티팩트 텍스트에 넣은 이미지는 그 자체로 하나의 아티팩트이지만, 요구사항과 이미지를 잇는 링크는 없습니다. 누군가 이미지를 바꾸거나 수정해도 영향 분석과 추적성 보기에는 어떤 요구사항이 그 이미지에 의존하는지 나타나지 않습니다.

Image Linker는 모듈의 아티팩트(또는 선택한 아티팩트) 텍스트에 포함된 모든 이미지를 찾아, 한 번의 통제된 실행으로 각 아티팩트에서 해당 이미지로 선택한 유형의 링크를 만듭니다. 원하면 포함된 표나 다이어그램 같은 다른 포함 아티팩트도 링크합니다.

## 해결하는 문제
- 영향 분석에서 보이지 않는 요구사항 텍스트 속 이미지.
- 변경된 다이어그램이나 화면 레이아웃의 영향을 받는 요구사항을 아무도 찾지 못하는 문제.
- 아티팩트마다 손으로 링크해야 하는 수백 개의 포함된 이미지.
- 어떤 이미지 링크가 있고 어떤 이미지가 DOORS Next 외부에서 왔는지 기록이 없는 문제.

## 이점
- **변경 전 미리 보기:** 포함된 각 이미지가 To link, Already linked 또는 Not resolvable로 표시됩니다.
- **추측하지 않음:** 다른 웹사이트나 서버의 이미지, 텍스트 안에 저장된 이미지는 목록에만 표시되고 링크되지 않습니다.
- **원하는 링크 유형과 방향:** 프로젝트의 모든 링크 유형, 나가는 링크 또는 들어오는 링크; 이미지만 또는 모든 포함 아티팩트.
- **안전한 기본값:** 링크는 DOORS Next가 모듈 안에서 하는 것처럼 모듈 컨텍스트에서 만들어집니다. 기본 아티팩트의 링크는 선택한 경우에만 만듭니다.
- **긴 실행도 통제 가능:** 크기와 관계없는 전체 모듈, 기존 링크 건너뛰기, 진행률과 Stop, 매우 큰 모듈에서 중지 후 계속, 실패 항목 Retry, Excel 변경 보고서.

## 사용 방법
1. 모듈 옆의 ELM Mini Dashboard에 위젯을 추가합니다.
2. **Settings**에서 **Change**를 클릭하고 **Link type**, **Direction**(**Outgoing** 또는 **Incoming**), **What counts**(**Pictures only** 또는 **Any embedded artifact**)를 선택합니다. 링크를 기본 아티팩트에 만들어야 할 때만 **Create the links on base artifacts**를 선택합니다. **Done**을 클릭합니다.
3. **Links**에서 **Whole module**을 선택하고 **Find embedded pictures**를 클릭하거나, 아티팩트를 선택하고 **Selection**을 고릅니다. 선택은 자동으로 확인됩니다. **Embedded items**에서 아티팩트와 이미지를 확인합니다.
4. **Create links**를 클릭하고 확인 내용을 읽은 뒤 **Create N links**를 클릭합니다. 먼저 검색하지 않으면 모듈 전체의 **Create links**가 한 번의 실행으로 찾기와 링크 만들기를 합니다.
5. 결과 블록을 확인하고 필요하면 **Log**로 변경 보고서를 내려받습니다.

## 참고 사항
- 각 아티팩트는 링크를 만들기 직전에 다시 읽으므로, 검색 후 추가되거나 제거된 이미지도 반영됩니다.
- 한 텍스트에 같은 이미지가 두 번 있어도 링크는 하나입니다. 여러 아티팩트에서 쓰이는 이미지는 각 아티팩트에서 하나씩 링크를 받습니다.
- 같은 서버의 DOORS Next에 저장된 이미지만 링크할 수 있으며, 나머지는 Not resolvable로 표시됩니다.
- 목록에는 축소판이 아니라 이름과 ID가 표시되므로 매우 큰 모듈에서도 브라우저 부담이 적습니다.
- 항상 change set 안에서 작업하십시오. 만들어진 링크를 되돌리는 유일한 방법은 change set을 폐기하는 것입니다.