# Image Linker

> Łączy każdy artefakt z obrazami w jego tekście, aby zmieniony obraz był widoczny w analizie wpływu.

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

- Dyscyplina: Linki i identyfikowalność
- Działa w: Moduł IBM DOORS Next
- Obsługiwane produkty: RM (IBM Engineering Requirements Management DOORS Next (Requirements Management))
- Zmienia dane
- Keywords: osadzone obrazy, obrazy w wymaganiach, analiza wpływu, identyfikowalność, traceability, linkowanie obrazów, osadzone artefakty, diagramy, zbiorcze tworzenie linków, IBM DOORS Next
- Wersja: 1.22 (Data wydania 2026-10-28)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- Przebieg pracy: 1. Settings: typ linku, kierunek, co się liczy → 2. Find embedded pictures in module (W razie potrzeby: Albo zaznacz artefakty: sprawdzane same) → 3. Przejrzyj artefakty i ich obrazy → 4. Create links: po potwierdzeniu → 5. Raport zmian w Excelu

## Czym jest i dlaczego powstał
Wymagania często pokazują obrazy: układy ekranów, diagramy, zdjęcia, tabele sygnałów. W IBM DOORS Next obraz wstawiony do tekstu artefaktu jest osobnym artefaktem, ale nic nie łączy z nim wymagania. Gdy ktoś podmieni lub zmieni obraz, analiza wpływu i widoki identyfikowalności nie pokazują, które wymagania od niego zależą.

Image Linker znajduje każdy obraz osadzony w tekście artefaktów modułu (lub zaznaczonych artefaktów) i w jednym kontrolowanym przebiegu tworzy link wybranego typu z każdego artefaktu do jego obrazów. Na życzenie łączy też inne osadzone artefakty, na przykład osadzone tabele lub diagramy.

## Jakie problemy rozwiązuje
- Obrazy w tekstach wymagań niewidoczne dla analizy wpływu.
- Zmieniony diagram lub układ ekranu, którego wymagań nikt nie potrafi znaleźć.
- Setki osadzonych obrazów, które trzeba by łączyć ręcznie, artefakt po artefakcie.
- Brak informacji, które linki do obrazów istnieją i które obrazy pochodzą spoza DOORS Next.

## Korzyści
- **Podgląd przed każdą zmianą:** każdy osadzony obraz jest pokazany jako To link, Already linked lub Not resolvable.
- **Nigdy nie zgaduje:** obrazy z innych stron lub serwerów albo zapisane w samym tekście są tylko wymienione, nigdy łączone.
- **Twój typ linku i kierunek:** dowolny typ linku projektu, wychodzący lub przychodzący; tylko obrazy albo każdy osadzony artefakt.
- **Bezpieczne ustawienia domyślne:** linki powstają w kontekście modułu, tak jak robi to DOORS Next wewnątrz modułu; linki na artefaktach bazowych tylko na Twoje życzenie.
- **Długie przebiegi pod kontrolą:** całe moduły dowolnej wielkości, istniejące linki pomijane, postęp i Stop, kontynuacja po zatrzymaniu w bardzo dużych modułach, błędy z Retry i raport zmian w Excelu.

## Jak używać
1. Dodaj widget do ELM Mini Dashboard obok modułu.
2. W **Settings** kliknij **Change** i wybierz **Link type**, **Direction** (**Outgoing** albo **Incoming**) oraz **What counts** (**Pictures only** albo **Any embedded artifact**); zaznacz **Create the links on base artifacts** tylko wtedy, gdy linki mają powstać na artefaktach bazowych. Kliknij **Done**.
3. W sekcji **Links** wybierz **Whole module** i kliknij **Find embedded pictures** albo zaznacz artefakty i wybierz **Selection**: zaznaczenie jest sprawdzane samo. Przejrzyj artefakty i ich obrazy w **Embedded items**.
4. Kliknij **Create links**, przeczytaj potwierdzenie i kliknij **Create N links**. Bez wcześniejszego wyszukiwania **Create links** dla całego modułu wyszukuje i łączy w jednym przebiegu.
5. Sprawdź blok wyniku i w razie potrzeby pobierz raport zmian przez **Log**.

## Warto wiedzieć
- Każdy artefakt jest czytany ponownie tuż przed utworzeniem jego linków, więc obrazy dodane lub usunięte po wyszukaniu są uwzględniane.
- Ten sam obraz dwa razy w jednym tekście daje jeden link; obraz użyty w wielu artefaktach dostaje link z każdego z nich.
- Połączyć można tylko obrazy zapisane w DOORS Next na tym samym serwerze; pozostałe są oznaczone jako Not resolvable.
- Lista pokazuje nazwy i identyfikatory, a nie miniatury, więc nawet bardzo duże moduły mało obciążają przeglądarkę.
- Zawsze pracuj w change secie: jego odrzucenie to jedyny sposób na wycofanie utworzonych linków.