# Captions

> Numeruje każdy podpis rysunku i tabeli w module według rozdziału, Fig. 2.1, Table 2.1, w jednym przebiegu.

Source: https://widgets.doorsnext.com/pl/widgets/captions/

- Dyscyplina: Jakość treści
- Działa w: Moduł IBM DOORS Next
- Obsługiwane produkty: RM (IBM Engineering Requirements Management DOORS Next (Requirements Management))
- Zmienia dane
- Keywords: numerowanie podpisów, numery rysunków, numery tabel, numerowane podpisy, podpisy rysunków w wymaganiach, podpisy tabel, numerowanie dokumentów DOORS Next
- Wersja: 2.6 (Data wydania 2026-10-28)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- Przebieg pracy: 1. Otwórz moduł → 2. Podgląd każdego numeru → 3. Potwierdź Number captions → 4. Podpisy ponumerowane według rozdziałów → 5. Raport zmian w Excelu

## Czym jest i dlaczego powstał
Specyfikacje eksportowane do Worda lub PDF potrzebują rysunków i tabel numerowanych według rozdziałów: Fig. 2.1, Fig. 2.2, Table 2.1. W DOORS Next podpis jest osobnym artefaktem, umieszczonym pod rysunkiem lub tabelą, którą opisuje, a jego numer to zwykły tekst. Każdy nowy rysunek, każda przeniesiona sekcja i każdy nowy rozdział psuje numerację, a poprawianie jej ręcznie oznacza otwieranie podpisu za podpisem.

Captions numeruje wszystkie podpisy w module w jednym przebiegu. Odczytuje rozdziały modułu, wylicza numer każdego podpisu rysunku i tabeli, najpierw je pokazuje, a potem zapisuje, zastępując tylko stary numer na początku każdego podpisu.

## Jakie problemy rozwiązuje
- Numery rysunków i tabel, które po dodaniu, przeniesieniu lub usunięciu sekcji nie pasują już do rozdziałów.
- Dwa rysunki z tym samym numerem albo luki w numeracji, zauważone dopiero w wyeksportowanym dokumencie.
- Godziny otwierania podpisu za podpisem, żeby ręcznie wpisać numery przed przeglądem lub wydaniem.
- Podpisy z różnymi stylami numeracji („Figure 3:”, „Fig. 1.2”, brak numeru) w jednym dokumencie.

## Korzyści
- **Numeracja według rozdziałów:** Fig. 2.1, Fig. 2.2, Table 2.1, z osobnym licznikiem dla rysunków i tabel, który w każdym rozdziale zaczyna się od nowa.
- **Najpierw podgląd:** zanim cokolwiek się zmieni, podgląd pokazuje każdy podpis z obecnym i nowym numerem.
- **Tekst podpisu zostaje:** zastępowany jest tylko stary numer; słowa i ich pogrubienie lub kursywa pozostają bez zmian.
- **Można bezpiecznie uruchomić ponownie:** podpisy, które mają już właściwy numer, nie są zapisywane, a raport zmian w Excelu zachowuje każdy tekst przed i po.

## Jak używać
1. **Wymagane:** Captions działa tylko wtedy, gdy w projekcie istnieje typ artefaktu o nazwie **Caption**. Podpisy są artefaktami tego typu, każdy pod swoim rysunkiem lub tabelą; atrybut Caption Type (Figure lub Table) jest opcjonalny.
2. Otwórz moduł. W **Settings** kliknij **Change**, w **New number at headings up to** wybierz, który poziom nagłówka zaczyna nową numerację (poziom 1: 1.1, 1.2 … potem 2.1), a w **Caption text after the number** wybierz **Keep the text**, **Only the number (remove the text)** albo atrybut rysunku lub tabeli, np. **Name**. Kliknij **Done**.
3. W sekcji **Module** kliknij **Preview**, aby w **Captions** zobaczyć każdy podpis z obecnym numerem, nowym numerem i nowym tekstem. Rozwiń wiersz i kliknij **Show in module**, aby pokazać ten podpis w module.
4. Kliknij **Number**, przeczytaj potwierdzenie i kliknij **Number captions**. Blok wyniku pokazuje, ile podpisów ponumerowano, dodano, ile było już poprawnych, a ile się nie udało, a **Log** pobiera raport zmian.

## Warto wiedzieć
- Uruchamiaj Captions w zestawie zmian (change set), aby móc go odrzucić, jeśli wynik nie jest taki, jak trzeba.
- Podpisy przed pierwszym rozdziałem dostają rozdział 0 (Fig. 0.1). Podpis bez Caption Type jest numerowany bez słowa, z własnym licznikiem.
- Atrybut Caption Type jest opcjonalny: bez niego Captions rozpoznaje rysunek lub tabelę po słowie w starym numerze (Fig., Table) albo po rysunku lub tabeli obok podpisu. Rysunek lub tabela bez podpisu dostaje nowy podpis tuż pod sobą; można to wyłączyć w Settings.
- Domyślnie podpis jest wyśrodkowany, a nazwa jego artefaktu czyszczona, jak w oryginalnym widżecie Captions; obie opcje można wyłączyć w Settings.
- Typ podpisu, jego atrybut i słowa przed numerami (Fig., Table) można zmienić w ustawieniach widżetu, na przykład dla podpisów w innym języku.
- Captions może też wpisać tekst podpisu za Ciebie: w Settings wybierz atrybut rysunku lub tabeli (na przykład jego Name), a jego wartość zostanie wpisana po numerze w miejsce starego tekstu, jak w Fig. 1.2 Battery pack layout; pusta wartość zostawia sam numer. Wybierz Only the number, aby usunąć tekst ze wszystkich podpisów, albo Keep the text, aby zmienić tylko numery.