# Publishing URLs

> Tworzy gotowe adresy URL źródeł danych dla IBM Engineering Publishing z dowolnego miejsca w DOORS Next, dzięki czemu szablony dokumentów są podłączone w kilka minut.

Source: https://widgets.doorsnext.com/pl/widgets/publishing-urls/

- Dyscyplina: Raportowanie i publikacja
- Działa w: Moduł IBM DOORS Next
- Obsługiwane produkty: RM (IBM Engineering Requirements Management DOORS Next (Requirements Management)), PUB (IBM Engineering Lifecycle Optimization – Publishing)
- Tylko odczyt
- Keywords: IBM Engineering Publishing, RPE, Rational Publishing Engine, Reportable REST, URL źródła danych, URL schematu, generowanie dokumentów, szablony raportów, data source URL, IBM DOORS Next
- Wersja: 1.23 (Data wydania 2026-10-19)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- Przebieg pracy: 1. Otwórz moduł, w razie potrzeby zaznacz artefakty lub otwórz widok → 2. Pokazuje kontekst adresów URL → 3. Wybierz porównanie, atrybuty i dodatki w Settings → 4. Adresy źródła danych i schematu do skopiowania do RPE

## Czym jest i dlaczego powstał
Specyfikacje, plany testów i dokumenty zgodności są często generowane z DOORS Next za pomocą IBM Engineering Publishing (dawniej Rational Publishing Engine). Każdy szablon wymaga adresów URL źródeł danych wskazujących właściwy projekt, konfigurację, moduł, widok lub artefakty, a także odpowiadających im adresów URL schematów.

Ręczne pisanie tych adresów Reportable REST wymaga znajomości wielu parametrów oraz wewnętrznych identyfikatorów projektów, modułów i konfiguracji. Jeden błąd oznacza pusty lub błędny dokument. Publishing URLs tworzy poprawne adresy URL na podstawie miejsca, w którym użytkownik znajduje się w DOORS Next.

## Jakie problemy rozwiązuje
- Ręczne pisanie adresów URL źródeł danych z wewnętrznymi identyfikatorami i wieloma parametrami.
- Dokumenty generowane z niewłaściwej konfiguracji, strumienia lub linii bazowej.
- Czas tracony na szukanie w dokumentacji właściwego parametru.
- Zależność od nielicznych specjalistów znających interfejs Reportable REST.

## Korzyści
- **Poprawne adresy URL w kilka sekund** dla modułu, jego artefaktów, widoku, zaznaczenia lub całego projektu.
- **Również adresy URL schematów,** których wymaga szablon publikacji.
- **Właściwa konfiguracja:** strumień, linia bazowa, zestaw zmian lub Global Configuration, pobrane z bieżącego kontekstu.
- **Kopiowanie i otwieranie** każdego adresu URL jednym kliknięciem lub skopiowanie wszystkich naraz.
- **Tylko odczyt** i bezpieczeństwo.

## Jak używać
1. Otworzyć projekt, konfigurację i moduł, których dotyczy dokument. Zaznaczyć artefakty, jeśli tylko one mają zostać opublikowane, i otworzyć zapisany widok w DOORS Next, jeśli potrzebne są adresy widoku.
2. Sprawdzić sekcję **Context**, która pokazuje, na podstawie czego tworzone są adresy URL.
3. W **Settings** kliknąć **Change** i wybrać konfigurację w **Compare with (Diff)**, atrybuty w **Attributes** i to, co ma się znaleźć w **Include**, na przykład **Cover page variables**.
4. W sekcji **Data source URLs** otworzyć grupę i skopiować adres źródła danych oraz jego adres schematu do szablonu publikacji. Ikona otwarcia pokazuje najpierw odpowiedź serwera; ikona kopiowania przy nagłówku kopiuje wszystkie adresy naraz.

## Warto wiedzieć
- Adresy URL, które nie pasują do bieżącego kontekstu, są wyświetlane wraz z przyczyną, na przykład gdy żaden moduł nie jest otwarty.
- Bardzo długie adresy URL, powstające przy dużych zaznaczeniach, są oznaczane ostrzeżeniem, ponieważ niektóre narzędzia ograniczają długość adresu.